Conversions API

Шлюз Conversions API — устранение ошибок и предупреждений

Если вы заметили, что серверные события отсутствуют или их меньше, чем событий браузера, этот документ поможет вам устранить неполадки. Информацию об инструментах устранения неполадок см. в разделе Шлюз API Conversions — устранение неполадок.

Чтобы выявить проблему, выполните следующие действия:

  1. Перейдите в Events Manager
  2. Откройте сайт в браузере
  3. Интерфейс администратора шлюза Conversions API

Домен не сконфигурирован для отправки событий

Шлюз Conversions API будет получать события от подключенных доменов, сконфигурированных во время настройки интеграции. Если серверных событий меньше, чем браузерных, это может означать, что пиксель инициируется в доменах, еще не подключенных к Meta.

Диагностика

  • Войдите в Events Manager.
  • Выберите нужное событие.
  • Нажмите Подробнее и выберите Обзор события.
  • В раскрывающемся списке слева выберите Домены, чтобы найти домены, в которых инициируются эти браузерные события.
  • Если таких доменов нет или они отличаются от сконфигурированных, скорее всего, интересующие вас браузерные события не регистрируются.

Решение

DNS не сконфигурирована или неправильно сопоставляется

Шлюз Conversions API размещается в AWS, где при создании ему назначается IP-адрес. Чтобы к конечной точке шлюза Conversions API можно было обращаться из браузера через сторонние запросы, этот IP-адрес нужно сопоставить с поддоменом в вашем домене.

Диагностика

  • Воспользуйтесь онлайн-инструментом для проверки DNS, например https://dnschecker.org/, и убедитесь, что домен шлюза Conversions API разрешается в правильный IP-адрес и полностью распространяется. Если ваш домен не разрешается ни в один IP-адрес, обратитесь к разделу "Решение" для следующих шагов.
  • Получите IP-адрес своего сервера шлюза Conversions API в панели AWS EC2 или запросите его у контактного лица своей облачной инфраструктуры.
  • Если эти два IP-адреса отличаются, обратитесь к разделу "Решение" для следующих шагов.

Решение

  • Обратитесь к администратору службы регистрации доменов.
  • Обновите DNS-запись в службе регистрации доменов и укажите IP-адрес сервера шлюза Conversions API (тот, который отображается на панели AWS EC2).
    • Установите DNS-запись A, сопоставляющую поддомен шлюза Conversions API с IP-адресом сервера, полученным в процессе настройки.

Сертификат не выпускался

Если для шлюза Conversions API никогда не выпускался сертификат Let's Encrypt, даже спустя длительное время после правильной настройки DNS, это означает, что ваш домен настолько популярен, что Let's Encrypt отказался выпускать сертификат.

Решение

  • Рассмотрите возможность размещения AWS Load Balancer (ALB) до экземпляра шлюза Conversions API и используйте ALB для размещения принадлежащего вам сертификата.

Сертификат был выпущен, но срок его действия истек

Такая проблема возникает, если вы закрыли порт 80 после установки шлюза Conversions API или используете его старые версии.

Решение

Интерфейс шлюза недоступен

Такая проблема возникает, если вы закрыли порт 80 после установки шлюза Conversions API или используете его старые версии.

Решение

  • Убедитесь, что IP-адрес экземпляра шлюза Conversions API соответствует конфигурации DNS. Если это не так, обратитесь к разделу DNS не сконфигурирована или неправильно сопоставляется.
  • Если сервер не отвечает, это может быть связано с временной сетевой ошибкой, которая устраняется путем перезапуска экземпляра. Для запуска шлюза API Conversions может потребоваться несколько минут, поэтому перед повторным входом подождите около 10 минут.

Необходимо обновить версию шлюза

Может случиться так, что шлюз Conversions API версий, предшествующих 1.0.8, перестал отправлять события в Meta. Для максимально эффективной работы мы рекомендуем обновить его как минимум до версии 1.0.8. Это позволит возобновить поток событий и обеспечит автоматическое обновление в будущем.

Диагностика

  • Проверьте текущую версию шлюза Conversions API:
    • Откройте интерфейс администратора шлюза Conversions API:
https://<Conversions API Gateway Endpoint>/hub
  • Проверьте текущую версию своего сервера шлюза Conversions API:
    • Меню слева > Настройки > Обновления

Решение

Чтобы обновить шлюз Conversions API, выполните следующие действия:

Устранение неполадок с журналами EKS

Если у вас возникли проблемы с установкой шлюза Conversions API для версии EKS с одним или несколькими аккаунтами, для устранения неполадок можно обратиться к журналам.

Журнал установки EKS можно найти в AWS Cloudwatch под групповым именем "ConversionsAPIGateway/cloud-init-output.log". Проверьте, нет ли в нем сообщений об ошибках. К распространенным ошибкам относятся превышение лимита ресурсов AWS и отсутствие разрешений AWS.



Запись DNS с типом CAA не содержит amazonaws.com

Если запись DNS, которую требует настроить шлюз Conversions API, имеет соответствующий сертификат TLS или не имеет записи CAA, этот раздел можно игнорировать.

Если у вас есть запись CAA для домена, убедитесь, что amazonaws.com указан в качестве значения для этой записи CAA, если вы установили версию AWS EKS шлюза Conversions API (для одного аккаунта) либо версию шлюза Conversions API для нескольких аккаунтов 1.10.* или более позднюю, которая использует для создания доменов AWS Certificate Manager. Пример записи CAA:

0 issue "amazonaws.com"

Если вы установили шлюз Conversions API для нескольких аккаунтов версии 1.9.* или более ранней, убедитесь, что в качестве значения для записи CAA указан letsencrypt.org. Пример:

0 issue "letsencrypt.org"

Дополнительная информация