Если вы внедрили Renta Javascript SDK и перешли на сбор сторонних данных, то перед вами откроется окно возможностей для интеграций на стороне сервера. И одним из них является Facebook Conversion API.
В этом руководстве мы узнаем, как за считанные минуты настроить передачу данных в Facebook Conversion API с помощью интеграции на стороне сервера.
Если вы еще не внедрили собственный сбор данных, воспользуйтесь этой инструкцией, чтобы внедрить трекер Renta Javascript SDK на своем веб-сайте, а затем вернитесь к этому руководству.
Как это работает?
Прежде чем мы приступим к настройке, следует отметить несколько важных моментов.
Facebook Conversions API scheme
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.
Перейдем непосредственно к настройке.
Имя интеграции
Укажите любое имя.
Рекламный аккаунт
Отображает список доступных аккаунтов бизнес-менеджеров и рекламных кабинетов, к которым привязан Facebook Pixel.
Имя пикселя Facebook
Укажите пиксели Facebook, на которые вы хотите перенести события.
Тип события
Выберите событие Javascript SDK, данные которого вы хотите синхронизировать с Facebook Conversion API, например страницу.
Фильтры
Позволяет добавить дополнительную фильтрацию. Например, вам нужно отправлять события просм отра страницы только для раздела блога. Для этого можно добавить фильтр: страница содержит блог.
Название события Facebook Pixel
Выберите стандартный тип события или укажите собственное имя события, которое будет отправлено в 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.
Debug mode
Отвечает за режим отладки.
Для того чтобы протестировать работу интеграции в тестовом режиме, скопируйте test event code из интерфейса Facebook Pixel и укажите его в данном поле:
На этом server-side имплементация Facebook Pixel завершена, но давайте разберем еще один пример.
Отправка транзакции в Facebook Conversion API
Разберем пример конфигурации для отправки транзакции с персональными данными клиента (конечно же, в хэше).
В этом кейсе мы изменим только три блока:
Event type
Выберите событие Javascript SDK, которое фиксирует транзакцию.
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.
