UA RU
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/
UA RU
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. Курс Англійської.
    Подолай мовний бар'єр та розширюй коло друзів на розмовних клубах.
    Дізнатись про курс
  5. На основании событий Conversions API можно снизить цену «клика» и привлечь больше клиентов.
  6. Conversions API важно освоить еще и потому, что ужесточается политика отслеживания данных пользователей (к примеру, Apple меняет мобильный маркетинг).

С чего начать

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

  • Business Manager — это инструмент Facebook, позволяющий управлять рекламными объектами: кабинетами, страницами, каталогами. Если бизнес-менеджера нет, создайте его.
  • Facebook Pixel — это код отслеживания (фрагмент кода JavaScript), с помощью которого можно собирать информацию о посетителях сайта. Ее можно использовать для создания аудиторий ремаркетинга и оптимизации рекламы в Facebook/Instagram. Если пикселя нет, необходимо его создать и установить на сайт.

Настройка 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-запрос:
  • Курс Комерційний директор.
    Зосередження на практичних завданнях та послідовному аналізі проектів замість великої теорії. Реалізуй свої мрії про керівну посаду після завершення курсу.
    Дізнатись програму

Создание 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.

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

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

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

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

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

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

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

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

Если вы нашли ошибку, пожалуйста, выделите фрагмент текста и нажмите Ctrl+Enter.

Курс Микросервисная архитектура.
програма, яка допоможе опанувати головні принципи розробки мікросервісної архітектури, щоби ви могли проєктувати незалежні сервіси, а потім інтегрувати їх в одну систему. Практики буде багато.
Отримати інформацію про курс

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

Топ-5 самых популярных блогеров ноября

Senior Project Manager at Nemesis
Всего просмотровВсего просмотров
1061
#1
Всего просмотровВсего просмотров
1061
Android Team Lead у Balancуй Team
Всего просмотровВсего просмотров
568
#2
Всего просмотровВсего просмотров
568
Software Developer у FullCity Consulting
Всего просмотровВсего просмотров
380
#3
Всего просмотровВсего просмотров
380
Talent scout/HR та Community Manager в Juniverse
Всего просмотровВсего просмотров
301
#4
Всего просмотровВсего просмотров
301
Android Developer | Kotlin
Всего просмотровВсего просмотров
233
#5
Всего просмотровВсего просмотров
233
Рейтинг блогеров
Курс Управління командою в бізнесі.
Онлайн-курс для ефективного управління командою, спрямований на створення проактивних та самостійних команд, де мікроменеджмент не потрібний.
Дізнатись про курс

Самые обсуждаемые статьи

Топ текстов

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

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

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