Внедрите Facebook Conversion API без какого-либо кода

Если вы внедрили Renta Javascript SDK и перешли на сбор first-party данных, то вам открывается множество возможностей server-side интеграций. И одна из них — Facebook Conversion API

В этом руководстве мы разберем, как за считаные минуты настроить передачу данных в Facebook Conversion API при помощи server-side интеграций. 

Если вы еще не внедрили сбор first-party данных, то при помощи данной инструкции внедрите Renta Javascript SDK трекер на ваш веб-сайт, после чего вернитесь к этому руководству. 

Навигация

Unfortunately, the navigation through the article could not be displayed. Check if JavaScript is enabled in your browser
Навигация
К сожалению, не удалось отобразить навигацию по статье. Проверьте, включен ли в вашем браузере JavaScript
Навигация

Как это работает?

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

Renta Javascript SDK — это first-party tracking на базе server-side технологий. Все события о действиях пользователя на сайте поступают на выделенную серверную архитектуру для вашего проекта, что позволяет нам легко трансформировать и отправлять входящие данные в различные точки назначения, такие как Facebook Conversion API.

Facebook Conversion API — это метод передачи событий в Facebook PIxel при помощи API. Чем больше данных вы передаете на сторону Facebook, тем выше вероятность матчинга на стороне Facebook. 

Суть интеграции заключается в том, чтобы синхронизировать поступающие события Javascript SDK с доступными полями Facebook CAPI. 

И в заключение коротко о схеме данных.

Renta Javascript SDK output data 

Каждое событие Javascript SDK поступает со стандартными полями, такими как userAgent, IP, City или Page URL. Полный список и описание полей доступны в документации. 

К тому же каждое событие можно дополнить пользовательскими полями (мы их называем properties). Например, вы можете указать email или name своих пользователей. 

То есть вы можете указывать уникальный набор свойств для каждого отдельного события, которое впоследствии будет доступно для передачи в Facebook CAPI. 

Facebook input data

Facebook CAPI ожидает получить входящие данные согласно своей документации. Все они доступны для интеграции в Renta. К тому же вам не стоит переживать за формат данных — мы их автоматически преобразовываем под требования API. 

Например, кешируем персональные данные пользователей или преобразовываем геоданные под формат ISO. 

В результате все входящие события, которые поступают на сервер, мы транспортируем в режиме реального времени в Facebook Conversion API. Чем больше данных вы передаете, тем выше вероятность  сопоставления данных на стороне Facebook.

Implementation of the Conversion API

Ниже мы подготовили пошаговое руководство по созданию интеграции. 

Step 1. Укажите источник данных.

В каталоге интеграций выберите созданный источник данных Javascript SDK. Все события, которые вы отслеживаете на веб-сайте, будут доступны для интеграции с Facebook CAPI. 

Далее вас перенаправит на страницу, где вы должны указать точку назначения. В нашем примере — это Facebook Conversion API. 

Step 2. Укажите точку назначения.

Авторизируйтесь под учетной записью Facebook, у которой есть доступ к Facebook PIxel, в который вы планируете передавать данные. 

Выберите добавленный аккаунт. 

Step 3. Настройка конфигурации. 

Данный шаг является основным. Его целью является указать соответствие полей (mapping fields) для синхронизации данных между first-party tracking-ом и Facebook Conversion API, что обеспечивает полный контроль над данными, которыми вы делитесь с третьей стороной, что особо важно при соблюдении GDPR.

Давайте перейдем непосредственно к настройке. 

Integration name
Укажите любое название.

Оно выводится в списке созданных интеграций в интерфейсе Renta. 

Ad account 
Выводит список доступных аккаунтов бизнес-менеджеров и рекламных кабинетов, к которым подвязаны Facebook Pixel.

Выберите бизнес-менеджер, который содержит нужный Facebook Pixel. 

Facebook Pixel Name
Укажите те Facebook Pixel, в которые необходимо передавать события. 

Event type
Выберите событие Javascript SDK, данные из которого вы хотите синхронизировать c Facebook Conversion API, например, page.

Это значит, что при каждом просмотре страницы событие page будет являться триггером активации отправки данных в Facebook CAPI. Данные, которые поступают с событием page, доступны для передачи в Facebook Conversion API. 

Filters 
Позволяют добавить дополнительную фильтрацию. Например, вам необходимо отправить события просмотра страницы только для раздела блог. Для этого вы можете добавить фильтр: page содержит blog

Facebook Pixel event name
Выберите стандартный тип события или укажите пользовательское имя события, которое будет отправлено в Facebook CAPI.

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

В нашем примере мы отправляем факт просмотра страницы блога, соответственно, логичней всего использовать стандартное событие View Content

Action Source
Действие происходит на сайте, соответственно, оставляем Website

Data mapping
Это самый ответственный шаг. В нём мы указываем конфигурацию, как данные события page должны быть сопоставлены с полями, которые мы передаем в 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 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.

Выводы: 

  1. На фоне ужесточения политики относительно third-party cookies такими системами, как Intelligent Tracking Prevention от компании Apple, способность Facebook Pixel отслеживать данные уменьшается. Conversion API позволяет заполнить эти пробелы и обеспечить лучшую атрибуцию конверсий.
  2. Использование Facebook CAPI увеличивает размер пользовательской аудитории для возможности ретаргетинга и построения look-a-like аудиторий.
  3. Гибкие настройки конфигурации потока данных позволяют соответствовать требованиям Schrems II и GDPR.

Быстрый старт

Если вы еще не используете first-party tracking, тогда узнайте, как построить современный аналитический стек для задач продуктовой и маркетинг-аналитики на базе Renta Javascript SDK.  

А также не стесняйтесь обращаться к customer success team , если вам понадобится техническая помощь при внедрении Facebook Conversion API.