Продвижение сайтов & web-аналитика

Отправить заявку    +38 096 558 75 14

Conversions API Facebook

Если Вы читаете данную статью, значит Вы столкнулись со сложностями трекинга событий Facebook Pixel и их учёта на устройствах IOS 14+.

Об отслеживании событий на устройствах IOS 14+ мы говорили ранее в нашей статье. А сегодня мы поговорим о параллельном отслеживании событий через Conversions API.

Conversions API Facebook - это возможность передачи данных о событиях пользователей напрямую с сервера сайта в обход браузера и запретов на использование cookies.

Conversions API Facebook это дополнение трекинга данных пользователей к Facebook Pixel, которое по факту может собрать данные, которые не собрал пиксель из-за ограничений iOS 14+.

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

Шаги настройки API Conversions Facebook

1

Подключение API Conversions в Events Manager Facebook

Подключение API Conversions в Events Manager Facebook

В настройках событий выбираем - Добавить события 🠖 Использование API Conversions:

Использование API Conversions

Facebook предложит Вам 2 варианта настройки:

👉 внедрить API вручную;

👉 использовать партнерскую интеграцию.

Варианты настройки API Conversions

Самый легкий способ - использовать партнерскую интеграцию. Разработчики позаботились о владельцах самых популярных платформ, и написали готовые решения.

Партнерская интеграция API Conversions

Немного об API Conversions через Google Tag Manager

Мы тестировали вариант настройки API Conversions через Google Tag Manager, абсолютно ничего сложного. Будьте готовы, что необходимо будет:

  • предоставить доступ к Tag Manager;
  • создать серверный контейнер;
  • опубликовать тег “Facebook Conversions API Tag” ;
  • иметь Google Analytics 4.

Примерные шаги настройки Conversions API через Tag Manager будут выглядеть так:

настройка Conversions API через Tag Manager

Что самое невероятное, то что Facebook в данном процессе активно взаимодействует с тегами Google Analytics, хотя это 2 конкурирующие компании.

Дальше мы рассмотрим вариант самостоятельной настройки, так как в основном мы имеем дело с кастомными проектами, а не готовыми CMS.

API Conversions - внедрение вручную

Самостоятельное внедрение API Conversions делится на 2 этапа, а именно:

  • Настройка персональных параметров на стороне Events Manager.
  • 👉 выбор учитываемых событий;

    👉 выбор пользовательских параметров передаваемых вместе с событием.

    Здесь все предельно просто

    Настройка персональных параметров на стороне Events Manager
  • Отправка данных по API.
  • На данном шаге веб-интерфейс заканчивается и идет отправка инструкции на Facebook - “мол ждите, когда Ваш программист выполнит”. Но, как показывает практика, самостоятельно никто ничего изучать не станет, программист в итоге будет ждать уточненное техническое задание. На данном шаге 90% статей в интернете заканчиваются, а мы пойдем дальше и глубже.

    Отправка данных по API
2

Построение запросов и отправка через Conversions API

Необходимо сразу понимать, что отправлять запросы придется с сервера сайта, аналогично тому, как мы уже обсуждали в Google Measurement Protocol.

Для начала Вам необходимо сгенерировать токен, который в будущем пригодится для отправки запроса

Настройка токена

Затем конструируем запрос с помощью помощника по полезным данным.

помощник по полезным данным

Сразу скажем, здесь готового решения нет, поэтому все подбирается индивидуально, в зависимости от данных, которые Вам необходимы. В помощь Вам пригодится:

После того как Вы построите запрос следует поработать над его отправкой и тестированием. Дополнительно, запрос можно построить в Graph API Explorer.

Graph API Explorer
3

Отправка запросов Conversions API

Способ отправки:

👉 согласно регламента API запросы должны отправляться способом POST, хотя в тестировщике предлагает все 3 варианта - POST, GET, DELETE.

Путь отправки:

В фигурные скобки вставляете данные своего аккаунта.

Запрос и его структура

Ну и соответственно строите свой запрос, который может выглядеть примерно так:


curl -X POST \
  -F 'data=[
       {
         "event_name": "Purchase",
         "event_time": 1636712168,
         "user_data": {
           "em": [
             "309a0a5c3e211326ae75ca18196d301a9bdbd1a882a4d2569511033da23f0abd"
           ],
           "ph": [
             "254aa248acb47dd654ca3ea53f48c2c26d641d23d7e2e93a1ec56258df7674c4",
             "6f4fcb9deaeadc8f9746ae76d97ce1239e98b404efe5da3ee0b7149740f89ad6"
           ],
           "client_ip_address": "123.123.123.123",
           "client_user_agent": "$CLIENT_USER_AGENT",
           "fbc": "fb.1.1554763741205.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890",
           "fbp": "fb.1.1558571054389.1098115397"
         },
         "contents": [
           {
             "id": "product123",
             "quantity": 1,
             "delivery_category": "home_delivery"
           }
         ],
         "custom_data": {
           "currency": "usd",
           "value": 123.45
         },
         "event_source_url": "http://jaspers-market.com/product/123",
         "action_source": "website"
       }
     ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v12.0/<PIXEL_ID>/events

И самым главным уточнением построения запроса будет хэширование (кодирование) данных, а именно - все пользовательские параметры должны быть хэшированы с использованием функции SHA256.

4

Тестирование отправки запроса

Тестирование отправки запроса доступно несколькими способами, а именно:

  • Через сервис - Graph API Explorer;
  • Через сервис - Payload Helper;
  • Через инструмент тестирования событий - Events Manager;
  • Через Ваш сервер, добавляя специальный идентификатор тестового события - “test_event_code”.

Выбираете тот, который Вам удобнее.

5

Дедупликация (склеивание событий)

Итак, после настройки Conversions API события у Вас будут поступать из двух каналов. Система в данном случае будет склеивать повторяющиеся события, а неучтенные дополнять. Данный процесс принято называть дедупликацией. В принципе, это пока все, что необходимо знать о запуске Conversions API Facebook.

В целом, этот инструмент достаточно похож на Measurement Protocol Google и имеет много сходства в алгоритмах своей работы.

В дополнение к статье рекомендуем посмотреть наше видео про Conversion API Facebook.