ru:https://highload.today/blogs/facebook-dlya-razrabotchika-zachem-ispolzovat-conversions-api-i-kak-ego-samostoyatelno-nastroit/ ua:https://highload.today/uk/blogs/facebook-dlya-razrabotchika-zachem-ispolzovat-conversions-api-i-kak-ego-samostoyatelno-nastroit/
logo
Инструменты      15/07/2021

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

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

Head of PPC and Analytics Department в рекламном агентстве OdesSeo

Привет! Я — Анастасия Тимошенко, Head of PPC and Analytics Department в агентстве комплексного интернет-маркетинга OdesSeo. Сегодня я расскажу про удобный инструмент в Facebook — Conversions API, и поделюсь опытом его настройки и использования.

Conversions API или Server-Side API — это функционал Facebook, с помощью которого можно передавать данные напрямую со своего сервера на сервер Facebook.

Почему Facebook Conversions API?

  1. Это альтернатива более привычному подходу client-side (когда для отправки данных о действиях пользователя на сайте используется код Facebook Pixel).
  2. С помощью Conversions API можно настроить отслеживание события за пределами сайта: например, звонок.
  3. Можно отправлять в соцсеть данные о переводе заявки из лида в клиента на основании этапов воронки продаж в CRM-системе или факт реальной оплаты, а не транзакции на сайте.
  4. На основании событий Conversions API можно снизить цену «клика» и привлечь больше клиентов.
  5. Conversions API важно освоить еще и потому, что ужесточается политика отслеживания данных пользователей (к примеру, Apple меняет мобильный маркетинг).

С чего начать

Перед тем, как приступить к настройке, убедитесь, что у вас есть Business Manager и Facebook Pixel:

  • Business Manager — это инструмент Facebook, позволяющий управлять рекламными объектами: кабинетами, страницами, каталогами. Если бизнес-менеджера нет, создайте его.
  • Facebook Pixel — это код отслеживания (фрагмент кода JavaScript), с помощью которого можно собирать информацию о посетителях сайта. Ее можно использовать для создания аудиторий ремаркетинга и оптимизации рекламы в Facebook/Instagram. Если пикселя нет, необходимо его создать и установить на сайт.
  • Онлайн-курс "Adobe Premiere з нуля" від Skvot.
    Навчіться монтувати відео.Впевнено.Швидко.Без конфлікту «очікування/реальність».Під менторством засновників Cofounder Studio.Які змонтували понад 3000 роликів на двох.
    Детальніше про курс

Настройка Conversions API: пошаговая инструкция

  • В разделе Events Manager нужно добавить новое событие, выбрав в выпадающем списке «Использование API Conversions»:

Раздел Events Manager

Выберите раздел Events Manager

 

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

Кликните на «Использование API Conversions»

  • Далее появится окно с выбором способа настройки Conversions API — вручную или с использованием партнерской интеграции:

Способы настройки Conversions API

Окно с выбором способа настройки

  • Проверить, доступна ли интеграция для нужной платформы, можно по этой ссылке. Если такой нет, выбираем «Внедрение API вручную». Далее пошагово нужно указать, какие события и параметры вы хотите отправлять в Facebook:

Пошаговая настройка

Указываем необходимые события и параметры

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

Выбор способа настройки

Последний шаг настройки

При выборе самостоятельной настройки откроется руководство:

Руководство по реализации

Если вы выбрали самостоятельную настройку — следуйте инструкции на экране

Генерация маркера доступа

  • Для реализации API-запросов нужно сгенерировать маркер доступа к Conversions API. Используйте его при каждом вызове API:

Генерация маркера доступа

Генерация маркера доступа

  • Сгенерируйте маркер доступа, а затем скопируйте его и сохраните, так как он не сохранится на Facebook:

Маркер доступа

Обязательно отдельно сохраните маркер доступа

Если вдруг вы закрыли руководство или не сохранили маркер — ничего страшного, в меню генерации маркера можно перейти: «Events Manager» — «Настройки» — блок «API Conversions»:

Копирование маркера доступа

Еще один способ сгенерировать маркер доступа

Как отправить событие через API

Чтобы отправить свое первое тестовое событие, перейдите в Facebook Graph API Explorer. Это инструмент Facebook, с помощью которого можно выполнять API-запросы и проверять ответы на них. Советуем почитать руководство по работе с Graph API Explorer:

  • Для отправки события нужно создать новый POST-запрос:
  • Онлайн-курс "Кібербезпека вебзастосунків" від robot_dreams.
    Пройдіть всі етапи тестування застосунків та відточіть навички на воркшопах з реальними прикладами проведення атак.Лектор — експерт з 10-річним досвідом у інформаційній безпеці.
    Про курс

Создание POST запроса

Отправка POST-запроса

  • Укажите актуальную версию API (обычно она уже выбрана по умолчанию):

Выбор версии API

Актуальная версия API выбрана по умолчанию

  • Добавьте идентификатор пикселя и после него — сегмент/events:

Идентификатор пикселя и сегмент /events

Добавление идентификатора пикселя

  • Идентификатор пикселя можно посмотреть в разделе настроек:

 ID пикселя

Идентификатор пикселя всегда можно посмотреть в «Настройках»

  • В поле «Маркер доступа» вставьте сгенерированный на прошлом шаге маркер:

Добавление маркера доступа

Вставляем в окошко маркер доступа, который сгенерировали до этого

  • Чтобы сформировать тело запроса, переключитесь на JSON и в поле для ввода текста введите свои данные:

Переключение на JSON

Переключение на JSON

  • Чтобы не ошибиться при составлении тела запроса, удобно использовать Payload Helper. В меню слева можно указывать необходимые для события параметры, а в меню справа автоматически будет формироваться нужный код в формате JSON:

Payload Helper

Справа будет формироваться необходимый код

  • В Payload Helper при клике на «Получить код» открываются сгенерированные варианты на разных языках, это очень удобно:

Варианты кода на разных языках

Код генерируется на разных языках программирования

  • Вставьте сформированный JSON в поле Graph API Explorer:

Добавление 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.

Психологічний профорієнтаційний тест для IT-фахівців від Hillel IT School.
Пройдіть психологічний профорієнтаційний тест для IT-фахівців щоб дізнатися ваші сильні сторони, вподобання і інтереси і з'ясувати, яка IT-спеціальність вам підходить.
Пройти тест

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

Полезные ссылки со справочной информацией по событиям и параметрам:

Дедупликация событий: почему это происходит

Если с помощью пикселя Facebook и Conversions API отправить одинаковые события, система выполнит дедупликацию, то есть удаление дубликатов. Копии определяются параметрами «название события» и «ID события», и чтобы удаления не произошло, нужно передавать эти параметры.

При отправке идентичного события дубль будет удален, в режиме тестирования вы увидите следующее:

Курс Frontend розробки від Mate academy.
Front-end розробник одна з найзатребуваніших професій на IT ринку. У Mate academy ми навчимо вас розробляти візуально привабливі та зручні інтерфейси. Після курсу ви зможете створювати вебсайти і застосунки, що вразять і користувачів, і роботодавців.
Дізнатися більше про курс

Удаление дубля события

Удаление дубля события

Полезные материалы по Facebook Conversions API

If you have found a spelling error, please, notify us by selecting that text and pressing Ctrl+Enter.

Онлайн-курс "SMM-спеціаліст" від Laba.
Від аналізу аудиторії та створення живого контенту — до побудови комʼюніті навколо бренду в соцмережах.Під менторством Senior SMM Specialist в Uklon.
Дізнатись більше

Этот материал – не редакционный, это – личное мнение его автора. Редакция может не разделять это мнение.

Ваша жалоба отправлена модератору

Сообщить об опечатке

Текст, который будет отправлен нашим редакторам: