Если вы внедрили Renta Javascript SDK и перешли на сбор сторонних данных, то перед вами откроется окно возможностей для интеграций на стороне сервера. И одним из них является Facebook Conversion API.
В этом руководстве мы узнаем, как за считанные минуты настроить передачу данных в Facebook Conversion API с помощью интеграции на стороне сервера.
Если вы еще не внедрили собственный сбор данных, воспользуйтесь этой инструкцией, чтобы внедрить трекер Renta Javascript SDK на своем веб-сайте, а затем вернитесь к этому руководству.
Как это работает?
Прежде чем мы приступим к настройке, следует отметить несколько важных моментов.
Renta Javascript SDK – это собственная система отслеживания, основанная на серверных технологиях. Все события о действиях пользователей на сайте отправляются на выделенную серверную архитектуру для вашего проекта, что позволяет нам легко преобразовывать и отправлять входящие данные в различные места назначения, такие как Facebook Conversion API.
Facebook Conversion API – это метод передачи событий в Facebook Pixel с помощью API. Чем больше данных вы отправляете на сторону Facebook, тем больше вероятность того, что Facebook совпадет с ними.
Суть интеграции заключается в синхронизации входящих событий Javascript SDK с доступными полями Facebook CAPI.
И в заключение коротко о схеме данных.
Выходные данные Renta Javascript SDK
Каждое событие Javascript SDK поставляется со стандартными полями, такими как userAgent, IP, City или pageUrl. Полный список и описание полей доступны в документации.
Кроме того, каждое событие можно дополнить произвольными полями (назовем их свойствами). Например, вы можете указать адрес электронной почты или имя ваших пользователей.
То есть вы можете указать уникальный набор свойств для каждого отдельного события, который в дальнейшем будет доступен для передачи в Facebook CAPI.
Входные данные Facebook
Facebook CAPI рассчитывает получать входящие данные в соответствии со своей документацией. Все они доступны для интеграции через Renta. Кроме того, вам не нужно беспокоиться о формате данных — мы автоматически конвертируем их в соответствии с требованиями API.
Например, мы кэшируем персональные данные пользователей или конвертируем геоданные в формат ISO.
В результате все входящие события, поступающие на сервер, передаются в режиме реального времени в Facebook Conversion API. Чем больше данных вы передаете, тем выше вероятность совпадения данных на стороне Facebook.
Реализация API конвертации
Вот пошаговое руководство по созданию интеграции.
Шаг 1. Укажите источник данных.
Выберите созданный источник данных JavaScript SDK в каталоге интеграции. Все события, которые вы отслеживаете на сайте, будут доступны для интеграции с Facebook CAPI.
Далее вы будете перенаправлены на страницу, где необходимо указать пункт назначения. В нашем примере это Facebook Conversion API.
Шаг 2. Укажите место назначения.
Войдите в систему с учетной записью Facebook, у которой есть доступ к PIxel, на который вы планируете передавать данные.
Выберите добавленную учетную запись.
Шаг 3. Настройки конфигурации.
Этот шаг является основным. Его цель — указать поля сопоставления для синхронизации данных между собственным отслеживанием и Facebook Conversion API, что обеспечивает полный контроль над данными, которыми вы делитесь с третьей стороной, что особенно важно при соблюдении GDPR.
Перейдем непосредственно к настройке.
Имя интеграции
Укажите любое имя.
Отображается в списке созданных интеграций в интерфейсе Renta.
Рекламный аккаунт
Отображает список доступных аккаунтов бизнес-менеджеров и рекламных кабинетов, к которым привязан Facebook Pixel.
Выберите бизнес-менеджера, который содержит нужный пиксель Facebook.
Имя пикселя Facebook
Укажите пиксели Facebook, на которые вы х отите перенести события.
Тип события
Выберите событие Javascript SDK, данные которого вы хотите синхронизировать с Facebook Conversion API, например страницу.
Это означает, что каждый раз, когда вы просматриваете страницу, событие страницы инициирует активацию отправки данных в Facebook CAPI. Данные, поступающие с событием страницы, доступны для передачи в Facebook Conversion API.
Фильтры
Позволяет добавить дополнительную фильтрацию. Например, вам нужно отправлять события просмотра страницы только для раздела блога. Для этого можно добавить фильтр: страница содержит блог.
Название события Facebook Pixel
Выберите стандартный тип события или укажите собственное имя события, которое будет отправлено в Facebook CAPI.
Renta поддерживает передачу как стандартных, так и пользовательских событий. В нашем примере мы отправляем факт просмотра страницы блога. Соответственно, логичнее всего использовать стандартное событие View Content.
Источник действия
Действие происходит на сайте, поэтому мы сохраняем сайт.
Отображение данных
Это самый ответственный шаг. Здесь мы указываем конфигурацию того, как данные о событиях страницы должны быть сопоставлены с полями, которые мы передаем в Facebook CAPI.
Вы можете полностью контролировать, какие данные передавать Facebook CAPI. Ниже мы подготовили рекомендованный список параметров для передачи:
| Renta Javascript SDK fields | Facebook CAPI fields | Data type | Hashing required |
|---|---|---|---|
| eventId | Event ID | String | Do not hash |
| page | Event source URL | String | Do not hash |
| title | Content Name | String | Do not hash |
| fbc_cookie_id | Click ID | String | Do not hash |
| fbp_cookie_id | Browser ID | String | Do not hash |
| deviceIp | Client IP Address | String | Do not hash |
| deviceUserAgent | Client User Agent | String | Do not hash |
| city | City | String | Hashing required |
| country | Country | String | Hashing required |
Данных параметров достаточно, чтобы обеспечить data matching score в Facebook Ads на уровне 7/10.
Мы также рекомендуем передавать поля email и phone для событий, которые содержат данную информацию. Это позволит приблизить data matching score к максимальным значениям.
Debug mode
Отвечает за режим отладки.
Для того чтобы протестировать работу интеграции в тестовом режиме, скопируйте test event code из интерфейса Facebook Pixel и укажите его в данном поле:
Это обеспечит передачу события в тестовую среду Facebook API. После завершения тестирования отключите данную настройку. После чего сохраните интеграцию.
На этом server-side имплементация Facebook Pixel завершена, но давайте разберем еще один пример.
Отправка транзакции в Facebook Conversion API
Разберем пример конфигурации для отправки транзакции с персональными данными клиента (конечно же, в хэше).
В этом кейсе мы изменим только три блока:
Event type
Выберите событие Javascript SDK, которое фиксирует транзакцию.
В моем примере это событие типа track, где eventName равно TransactionCompleted.
Facebook Pixel event name
Purchase — это стандартное событие Facebook Pixel, которое следует использовать для фиксации транзакций.
Data mapping
К рекомендованными параметрам я добавлю пользовательские поля, которые поступают с данными выбранного события:
Где:
| Renta Javascript SDK fields | Facebook CAPI fields | Data type | Hashing required |
|---|---|---|---|
| Properties.email | String | Hashing required | |
| Properties.first_name | First Name | String | Hashing required |
| Properties.last_name | Last Name | String | Hashing required |
Таким образом, вы можете создавать безопасные потоки данных на базе server-side решений. Инфраструктура Renta автоматически преобразовывает данные п од требования Facebook Conversion API.
Выводы:
На фоне ужесточения политики относительно third-party cookies такими системами, как Intelligent Tracking Prevention от компании Apple, способность Facebook Pixel отслеживать данные уменьшается. Conversion API позволяет заполнить эти пробелы и обеспечить лучшую атрибуцию конверсий.
Использование Facebook CAPI увеличивает размер пользовательской аудитории для возможности ретаргетинга и построения look-a-like аудиторий.
Гибкие настройки конфигурации потока данных позволяют соответствовать требованиям Schrems II и GDPR.
Быстрый старт
Если вы еще не используете first-party tracking, тогда узнайте, как построить современный аналитический стек для задач продуктовой и маркетинг-аналитики на базе Renta Javascript SDK.
А также не стесняйтесь обращаться к customer success team , если вам понадобится техническая помощь при внедрении Facebook Conversion API.
