Анастасия Тимошенко

Привет! Я — Анастасия Тимошенко, Head of PPC and Analytics Department в агентстве комплексного интернет-маркетинга OdesSeo. Сегодня я расскажу про удобный инструмент в Facebook — Conversions API, и поделюсь опытом его настройки и использования. Conversions API или Server-Side API — это функционал Facebook, с помощью которого можно передавать данные напрямую со своего сервера на сервер Facebook. Почему Facebook Conversions API? Это альтернатива более привычному подходу client-side (когда для отправки данных о действиях пользователя на сайте используется код Facebook Pixel). С помощью Conversions API можно настроить отслеживание события за пределами сайта: например, звонок. Можно отправлять в соцсеть данные о переводе заявки из лида в клиента на основании этапов воронки продаж в CRM-системе или факт реальной оплаты, а не транзакции на сайте. На основании событий Conversions API можно снизить цену «клика» и привлечь больше клиентов. Conversions API важно освоить еще и потому, что ужесточается политика отслеживания данных пользователей (к примеру, Apple меняет мобильный маркетинг). С чего начать Перед тем, как приступить к настройке, убедитесь, что у вас есть Business Manager и Facebook Pixel: Business Manager — это инструмент Facebook, позволяющий управлять рекламными объектами: кабинетами, страницами, каталогами. Если бизнес-менеджера нет, создайте его. Facebook Pixel — это код отслеживания (фрагмент кода JavaScript), с помощью которого можно собирать информацию о посетителях сайта. Ее можно использовать для создания аудиторий ремаркетинга и оптимизации рекламы в Facebook/Instagram. Если пикселя нет, необходимо его создать и установить на сайт. Настройка Conversions API: пошаговая инструкция В разделе Events Manager нужно добавить новое событие, выбрав в выпадающем списке «Использование API Conversions»: Выберите раздел Events Manager Кликните на «Использование API Conversions» Далее появится окно с выбором способа настройки Conversions API — вручную или с использованием партнерской интеграции: Окно с выбором способа настройки Проверить, доступна ли интеграция для нужной платформы, можно по этой ссылке. Если такой нет, выбираем «Внедрение API вручную». Далее пошагово нужно указать, какие события и параметры вы хотите отправлять в Facebook: Указываем необходимые события и параметры На последнем шаге можете отправить инструкции разработчику либо выполнить настройку самостоятельно: Последний шаг настройки При выборе самостоятельной настройки откроется руководство: Если вы выбрали самостоятельную настройку — следуйте инструкции на экране Генерация маркера доступа Для реализации API-запросов нужно сгенерировать маркер доступа к Conversions API. Используйте его при каждом вызове API: Генерация маркера доступа Сгенерируйте маркер доступа, а затем скопируйте его и сохраните, так как он не сохранится на Facebook: Обязательно отдельно сохраните маркер доступа Если вдруг вы закрыли руководство или не сохранили маркер — ничего страшного, в меню генерации маркера можно перейти: «Events Manager» — «Настройки» — блок «API Conversions»: Еще один способ сгенерировать маркер доступа Как отправить событие через API Чтобы отправить свое первое тестовое событие, перейдите в Facebook Graph API Explorer. Это инструмент Facebook, с помощью которого можно выполнять API-запросы и проверять ответы на них. Советуем почитать руководство по работе с Graph API Explorer: Для отправки события нужно создать новый POST-запрос: Отправка POST-запроса Укажите актуальную версию API (обычно она уже выбрана по умолчанию): Актуальная версия API выбрана по умолчанию Добавьте идентификатор пикселя и после него — сегмент/events: Добавление идентификатора пикселя Идентификатор пикселя можно посмотреть в разделе настроек: Идентификатор пикселя всегда можно посмотреть в «Настройках» В поле «Маркер доступа» вставьте сгенерированный на прошлом шаге маркер: Вставляем в окошко маркер доступа, который сгенерировали до этого Чтобы сформировать тело запроса, переключитесь на JSON и в поле для ввода текста введите свои данные: Переключение на JSON Чтобы не ошибиться при составлении тела запроса, удобно использовать Payload Helper. В меню слева можно указывать необходимые для события параметры, а в меню справа автоматически будет формироваться нужный код в формате JSON: Справа будет формироваться необходимый код В Payload Helper при клике на «Получить код» открываются сгенерированные варианты на разных языках, это очень удобно: Код генерируется на разных языках программирования Вставьте сформированный JSON в поле Graph API Explorer: Вставьте код в поле Graph API Explorer Чтобы информация об отправленном событии отобразилась в режиме тестирования в Events Manager, после закрывающей квадратной скобки добавьте параметр test_event_code со значением, которое сгенерировано на вкладке тестирования серверных событий в Events Manager: Значение, которое сгенерировано на вкладке тестирования В нашем случае: Добавляем параметр test_event_code Кликните на «Отправить»: Если запрос составлен корректно, то в окошке посредине появится информация о том, что событие получено: «Событие получено» говорит о том, что все прошло успешно Также тестовое событие появится на вкладке «Тестирование событий» в Events Manager: Событие на вкладке «Тестирование событий» После того, как вы создали и протестировали отправку нужного события, вы можете отправить данные в реальном проекте либо составить ТЗ для разработчика. Важно: для событий на сайте, передаваемых через API Conversions, обязательно указывать параметры client_user_agent, action_source и event_source_url. Для остальных типов событий достаточно указания параметра action_source. С примерами отправки события покупки, реализованными на разных серверных языках, можно ознакомиться в разделе для разработчиков. Полезные ссылки со справочной информацией по событиям и параметрам: Перечень всех стандартных событий Перечень параметров событий Параметры данных о клиенте Параметры пользовательских данных О настройке передачи параметров fbp and fbc Дедупликация событий: почему это происходит Если с помощью пикселя Facebook и Conversions API отправить одинаковые события, система выполнит дедупликацию, то есть удаление дубликатов. Копии определяются параметрами «название события» и «ID события», и чтобы удаления не произошло, нужно передавать эти параметры. При отправке идентичного события дубль будет удален, в режиме тестирования вы увидите следующее: Удаление дубля события Полезные материалы по Facebook Conversions API Инструкция по использованию Conversions API и описание обязательных параметров Инструкция по настройке с примером кода отправки события покупки на Python Внедрение Conversions API с помощью серверного Google Tag Manager Этот текст впервые был опубликован в Hihgload

Анастасия Тимошенко

Facebook для разработчика: зачем использовать Conversions API и как его самостоятельно настроить