Ошибки API конверсии Facebook и как их исправить

Настройка API конверсии Facebook может быть непонятной. Но после того, как вы проделали огромную работу по переносу отслеживания FB на сервер и надеетесь, что все в порядке, вы можете зайти в свой менеджер событий на следующий день и увидеть красные и желтые предупреждения для событий, отправленных с сервера.

Я много раз сталкивался с этой проблемой при настройке FB CAPI для клиентов. Поэтому я решил создать статью с несколькими полезными советами. В этой статье блога я опишу самые популярные ошибки и предупреждения Facebook conversion API. Кроме того, поделюсь некоторыми советами по их устранению.

Как проверить наличие ошибок Facebook pixel или Conversion APIСкопировать ссылку на этот раздел

Facebook's Events Testing Tool - это новый мощный инструмент, который позволяет отлаживать и устранять проблемы с вашими пикселями FB или событиями на сервере. Если есть ошибки, они будут отображаться на вкладке "Диагностика" на панели инструментов, чтобы вы могли более внимательно их рассмотреть.

Ошибки, помеченные красным цветом, обычно требуют быстрой реакции и должны быть исправлены немедленно. Желтые ошибки - это некритичные предупреждения, на которые следует обратить внимание и в конечном счете разобраться.

Facebook позволяет отмечать проблемы как решенные или игнорировать их. Если вы отметите ошибку как решенную и она повторится, Facebook покажет ее снова через 3 дня. Для сравнения, проигнорированные проблемы попадают в "Ignored section" и остаются там.

Когда вы устраните какие-либо проблемы с отслеживанием в FB, я рекомендую пометить их как решенные. Таким образом, вы уведомите Facebook о том, что проблемы были устранены, и платформа сообщит, если эти проблемы повторятся.

Каковы наиболее популярные ошибки в Facebook pixel и API конверсии, и как их исправить?Скопировать ссылку на этот раздел

1. New Domains Sending DataСкопировать ссылку на этот раздел

Вы можете увидеть все домены, которые отправляют данные на ваш Facebook pixel. Если FB заметит трафик с нового поддомена, платформа отправит вам это предупреждение. Вы можете внести домены в белый или черный список. С помощью этой функции вы можете заблокировать трафик с ваших тестовых сайтов или технических URL.

Скорее всего, вы также увидите трафик с сайта gtm-msr.appspot.com. Это может произойти, когда вы запускаете контейнер отладки/публикации или пользователи приходят на ваш сайт с отключенным js (некоторые боты).

Чтобы создать списки доменов, откройте event tool в Business Manager -> Нажмите settings -> Прокрутите вниз до Traffic Permissions.

2. Событие с отсутствием некоторых параметров дедупликацииСкопировать ссылку на этот раздел

Это вторая по популярности ошибка Facebook CAPI из моего опыта. Эта ошибка означает, что вы не отправляете некоторые ключи дедупликации для событий вашего сервера. Facebook нужны эти параметры для дедупликации событий: имя события и ID события.

Есть вероятность, что вы уже отправляете имена событий. Предположим, вы столкнулись с этой проблемой из-за того, что идентификатор события недействителен. Проверьте, отправляете ли вы идентификатор события для Facebook pixel и Facebook conversion API. Этот идентификатор события должен быть одинаковым для события в браузере и на сервере. В этом случае FB увидит одно и то же имя события и его ID и начнет дедупликацию.

Например, для событий PageView отправьте одинаковый ID события и имя события из Facebook pixel и FB CAPI.

Чтобы проверить ID события, откройте инструмент тестирования событий Facebook. Если все правильно, вы должны увидеть что-то похожее на скриншот. Так FB показывает, что он записал события PageView как с браузера, так и с сервера. Эти события имели один и тот же ID события. Значит, они обрабатывали события браузера и дедуплицировали события сервера.

Но может быть и другая ситуация, когда вы видите случайное срабатывание событий браузера и сервера. В этом случае проверьте идентификатор события FB. Скорее всего, идентификаторы событий не совпадают. Кстати говоря, вы можете использовать нашу пользовательскую переменную для веб-контейнера, чтобы установить ID события Facebook.

У нас также есть статья о том, как настроить дедупликацию событий Facebook.

3. Server Sending Invalid Match Key Parameters for PageView EventСкопировать ссылку на этот раздел

Здесь Facebook хочет уведомить вас о том, что значения, которые вы отправляете с сервера, не являются уникальными или отформатированы неправильно. Например, вы можете отправить IP пользователя, который включает символы, а не только цифры. Или, возможно, вы просто выбрали неправильную переменную, например, отправили номер телефона в поле электронной почты.

Чтобы проверить, что не так, откройте режим предварительного просмотра сервера Google Tag Manager и веб-контейнера (конечно, если вы использовали GTM для настройки Facebook conversion API). Вы должны увидеть, какие параметры пользователя были отправлены в Facebook и правильно ли они были отформатированы. Протестируйте событие, нажмите на тег в режиме отладки и выберите значения.

Эта ошибка также может означать, что вы забыли включить параметр или он неправильно отформатирован.

Например, у меня был клиент, который хотел отправить пользователю округ, то есть город на основе IP-адреса. Facebook ожидает увидеть фактические данные об адресе пользователя, которые он вводит на сайте, а не те, которые вы автоматически извлекли из IP. Такая настройка также отправляла ошибку о недопустимых ключевых параметрах.

Или, возможно, вы пытались схитрить и отправить одно и то же имя пользователя для всех событий, чтобы повысить качество.

4. Потенциально нарушающие персональные данные, отправленные в FacebookСкопировать ссылку на этот раздел

Эта ошибка обычно связана с событиями браузера и означает, что Facebook обнаружил данные пользователя в URL. Некоторые CMS и другие инструменты, такие как Calendly или PayPal, отправляют данные пользователя в URL после того, как он зарегистрировался или совершил покупку.

Эту ошибку трудно исправить, и это задача для ваших разработчиков. Они должны улучшить параметры запроса URL и удалить всю пользовательскую информацию из URL.

5. Повышение качества сопоставления событийСкопировать ссылку на этот раздел

Для каждого события сервера, которое вы отправляете в FB, будет указан балл качества совпадения события. Этот балл зависит от количества пользовательских данных, которые вы отправляете в FB.

Если вы используете пользовательский поддомен для своего тега на сервере, в FB CAPI отправляются только IP пользователя, ID браузера, _fbp и _fbc. Если вы отправляете только эти параметры пользователя, качество совпадения будет около 4 из 10.

Очень важно отправить как можно больше параметров. FB использует эти данные, чтобы сопоставить пользователей на вашем сайте с пользователями в своей базе данных. Постарайтесь отправить все параметры пользователя, которые у вас есть.  Естественно, сначала нужно проверить правила политики конфиденциальности, указанные на вашем сайте. Но технически, хорошо, если вы отправите больше параметров. Это означает, что данные об аудитории и конверсии будут более точными, алгоритмы Facebook будут иметь более конкретные данные о ваших пользователях, а кампании будут работать лучше.

Как увеличить показатель качества совпадения событий? Ответ прост: нужно отправлять больше данных о пользователях. Но его реализация остается сложным процессом. Вот как это работает: Я начинаю с проверки того, реализован ли слой данных на вашем сайте и есть ли в нем все пользовательские данные. Например, если пользователь может войти на ваш сайт, вам нужно проверить, отправляются ли данные пользователя в слой данных, когда пользователи входят в систему.

Если слой данных не реализован, то поручите задачу по его настройке вашим разработчикам. 

После этого убедитесь, что вы передаете все пользовательские параметры из веба в серверный контейнер.

Еще одна вещь, которая поможет вам повысить качество совпадений, - это новая функция Data Tag. Мы добавили возможность хранить данные пользователя. Например, если пользователь отправил контактную форму на сайте, вы можете использовать Data Tag для хранения данных пользователя в локальном хранилище, а затем использовать их на других страницах. Подробнее об этой возможности вы можете прочитать здесь.

6. Один и тот же идентификатор события получен для многих случаев событияСкопировать ссылку на этот раздел

Если вы отслеживаете события Facebook как в браузере, так и на сервере, то Facebook требует, чтобы вы отправляли уникальный идентификатор события для каждого события. Для совпадения событий название события пикселя Facebook должно точно соответствовать названию события на сервере. То же самое касается идентификатора события, те же события из пикселя FB должны совпадать с событиями сервера FB. Именно тогда происходит дедупликация.

Эта ошибка возникает, когда вы отправляете один и тот же идентификатор события для многих событий. Например, пользователь перешел на страницу продукта. Это означает, что на этой странице должны сработать два события: PageView и ViewContent. Вы должны отправить уникальный ID события для каждого из них. Это означает, что события FB и идентификаторы событий должны выглядеть следующим образом:

FB browser: PageView, eventID: ‘69’

FB server: PageView, eventID: '69'

FB browser: ViewContent, eventID: '79'

FB server: ViewContent, eventID: '79'

Даже если эти события срабатывают на одной и той же странице и могут использовать один и тот же триггер в веб-контейнере и контейнере сервера Google Tag Manager, вы должны отправить уникальный идентификатор события для обоих событий.

Одинаковый идентификатор события, полученный для многих событий, появится, если у вас возникнет такая ситуация:

FB browser: PageView, eventID: ‘69’

FB server: PageView, eventID: '69'

FB browser: ViewContent, eventID: '69'

FB server: ViewContent, eventID: '69'

В этом примере мы отправляем eventID 69 для событий PageView и ViewContent. Но Facebook ожидает увидеть уникальный eventID для этих двух событий.

Решение: добавьте тестовый ID Facebook, откройте режим предварительного просмотра веб-контейнеров и серверных контейнеров, и протестируйте настройку. После того как вы выясните, когда возникает эта ошибка, мы сможем устранить проблемы.

Мы создали персонализированную переменную, которая генерирует уникальный ID события. Я предлагаю использовать эту переменную для настройки дедупликации событий FB. Вы можете добавить имя события в эту переменную, чтобы обеспечить уникальность ID события, как показано на скриншоте ниже. В этом случае, даже если ваши события будут использовать один и тот же триггер, ID события будет уникальным, поскольку он состоит из event_name_eventID. Подробнее о дедупликации событий Facebook вы можете прочитать в этой статье.

ЗаключениеСкопировать ссылку на этот раздел

Настройка API конверсии Facebook может показаться сложной и порой запутанной. Но это стоит потраченного времени и усилий. После того как вы проделаете всю эту тяжелую работу по переносу отслеживания FB на сервер, качество отслеживания и аудитория улучшатся.

Однако вы можете столкнуться с некоторыми проблемами, если в процессе новой интеграции возникнут ошибки. Проще говоря, вы можете увидеть красные и желтые предупреждения в менеджере событий.

Хорошая новость заключается в том, что большинство этих проблем не так сложны, как может показаться, и их устранение не требует больших затрат. Надеюсь, эта статья поможет вам справиться с наиболее распространенными ошибками и предупреждениями Facebook conversion API.