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

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

Привет! Я — Анастасия Тимошенко, 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. Если пикселя нет, необходимо его создать и установить на сайт.

Настройка 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.

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

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

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

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

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

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

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

 

Этот текст впервые был опубликован в Hihgload

Поделиться
Поделиться сюжетом
Источник материала
Джастін Бібер випустив новий альбом SWAG за участю Sexyy Red, Lil B та Gunna
Ukraine Art News
2025-07-11T13:01:22Z
У Києві відбувається церемонія прощання з композитором Ігорем Покладом
Ukraine Art News
2025-07-11T11:13:17Z
Мільйони доларів за культовий аксесуар: сумку Джейн Біркін продали на аукціоні за рекордну суму
Elle
2025-07-11T06:58:24Z
Бекхеми зворушливо привітали доньку Гарпер з Днем народження й поділилися рідкісними сімейними фото
Elle
2025-07-10T19:13:13Z
Dorofeeva і Positiff випустили першу за 5 років спільну пісню "Смак-Печаль"
Ukraine Art News
2025-07-10T11:33:12Z
Британський музикант Бенджамін Клементайн виступить в Україні вперше з 2018 року
Ukraine Art News
2025-07-09T14:45:47Z
Помер український композитор Ігор Поклад
Ukraine Art News
2025-07-09T14:00:53Z
Розлученню не бути: Джастін і Гейлі Бібери спростували чутки про негаразди в шлюбі
Elle
2025-07-09T10:42:46Z
Помер відомий український композитор Ігор Поклад
Ukraine Art News
2025-07-09T08:24:49Z
Тіна Кароль представила нову пісню і кліп "Людині потрібна людина"
Ukraine Art News
2025-07-11T13:46:37Z
«УКRАЇNKИ»: У Києві відкрили виставку до 100-річчя Союзу Українок Америки
Ukraine Art News
2025-07-11T13:22:28Z
Джастін Бібер несподівано випустив новий альбом — уперше за чотири роки
Elle
2025-07-11T12:28:25Z
Італія виділить 45 млн євро на відновлення шести культурних памʼяток Одеси
Ukraine Art News
2025-07-11T09:55:17Z
“Білоус забрав із Молодого театру 23 вистави”. Станіслав Мойсеєв вперше поділився думками після повернення
Ukraine Art News
2025-07-11T09:43:15Z
У Львові реставрують панно «Збір винограду» та перенесуть у арт-центр
Хмарочос
2025-07-11T08:28:38Z
У Римі ZAG галерея відкрила виставку «Маленький Принц»
Photo Lviv
2025-07-11T05:01:05Z
У столиці Ботсвани проведуть Вечір української кухні
Ukraine Art News
2025-07-10T20:19:15Z
ТНМК і Krechet випустили пісню і кліп "Аплодуй"
Ukraine Art News
2025-07-10T18:28:22Z
Перед виходом останнього фільму "Абатства Даунтон" Bonhams виставить на аукціон костюми та реквізит
Ukraine Art News
2025-07-11T14:31:18Z
Супермен б'ється з іншопланетним монстром у новому фрагменті фільму Джеймса Ґанна
KinoFilms
2025-07-11T12:58:15Z
Студія Peacock оголосила дату виходу спін-оффу серіалу "Офіс"
Ukraine Art News
2025-07-11T11:16:24Z
«Кривавий лідер»: український трейлер бойовика за участю Джуда Лоу та Ніколаса Голта
KinoFilms
2025-07-11T10:43:09Z
Топ-5 фільмів за участі Бреда Пітта
Ukraine Art News
2025-07-11T07:31:18Z
Топ-5 фільмів за участі Лілі Коллінз
Ukraine Art News
2025-07-11T07:01:28Z
Лікарі назвали причину смерті зірки "Убити Білла" та "Мерзенної вісімки" Майкла Медсена
Ukraine Art News
2025-07-10T18:13:15Z
Український проєкт фільму "Вакуум" отримав премію Eurimages за розвиток копродукції у Карлових Варах
Ukraine Art News
2025-07-10T15:07:20Z
Що відомо про третю частину «Дюни» із Зендеєю та Тімоті Шаламе в головних ролях
Elle
2025-07-10T14:43:14Z
Романтичний район Львова – Богданівка, частина друга
Photo Lviv
2025-07-11T05:13:02Z
Історичні проходи по Львові. Рецензія 1932 року
Photo Lviv
2025-07-10T05:13:05Z
Білий Камінь: Де замок, гідний королів, перетворився на міф
Photo Lviv
2025-07-09T05:12:30Z
«Будьте зрівноважені»: вибрані статті про мистецтво Григорія Крука. Частина друга
Photo Lviv
2025-07-08T05:12:24Z
За два тижні жіночі купе з’являться у ще трьох поїздах
Хмарочос
2025-07-07T12:01:04Z
На березі Сени відкрили облаштовані пляжі для купання. Вони пропрацювали рівно один день
Хмарочос
2025-07-07T10:51:55Z
15 найгарніших архітектурних споруд світу — рейтинг Time Out
Elle
2025-07-07T08:06:33Z
Пам’ятник Александрові Фредру: мандри трьома містами
Photo Lviv
2025-07-06T05:06:25Z
Єдиний маршрут пам’яті: які локації на Львівщині увійшли до переліку
Photo Lviv
2025-07-06T05:00:40Z
Тактичні візки для евакуації поранених, інноваційні технології із захисту рослин та ремонт військових авто — премія для підприємиць «Створено Жінками» оголосила проєкти переможниць
Elle
2025-07-11T14:07:18Z
ЄС посилює підтримку української культури та спадщини
Ukraine Art News
2025-07-11T13:55:20Z
Шопінг-гід: де купувати тренди і базу з найкращими літніми знижками
Elle
2025-07-11T13:43:26Z
Cоціальні виплати збільшатися завдяки новому способу обрахунку
Хмарочос
2025-07-11T13:28:32Z
Користь шоколаду для жіночого здоров'я: великий гід
Elle
2025-07-11T12:58:29Z
Звинувачений у домаганнях Білоус після звільнення заборонив грати 23 свої вистави в Молодому театрі
Ukraine Art News
2025-07-11T12:25:16Z
Небо Києва закриють системою перехоплення ворожих дронів
Хмарочос
2025-07-11T11:25:26Z
В столицю повертаються Fuckup Nights – Kooperativ збере підприємців, щоб поговорити про їх провали
Хмарочос
2025-07-11T10:37:36Z
Маштабні пожежі та знищення заповідної природи – що зараз відбувається із заповідником «Асканія-Нова»
Хмарочос
2025-07-11T10:34:56Z
Україна першою в Європі надаватиме послуги мобільного зв’язку через Starlink, — гендиректор Київстар
Хмарочос
2025-07-10T12:31:47Z
В Україні заблокували інтернет-магазин Leader-Books, у якому продавали книжки з РФ та Білорусі
Ukraine Art News
2025-07-09T17:42:47Z
Штучний інтелект Grok від Ілона Маска тепер викриває російську пропаганду: росіяни лютують
Gloss
2025-07-09T13:07:03Z
Оплата домашнього інтернету Sword: найкращі способи для мешканців Києва і передмістя
Хмарочос
2025-07-02T07:03:48Z
Стрімінг на космічному рівні: Netflix у колаборації з NASA показуватиме запуск ракет
Ukraine Art News
2025-07-01T01:00:55Z
Під Меджибізьким замком на Хмельниччині археологи виявили скелет дитини й артефакти XVII-XVIII ст
Ukraine Art News
2025-06-30T17:21:59Z
За два місяці до релізу: у мережу злили фото майбутніх iPhone 17 Pro та iPhone 17 Air
Gloss
2025-06-26T17:30:41Z
Суд у США відхилив позов 13 письменників про порушення авторських прав для навчання ШІ на їхніх книжках
Ukraine Art News
2025-06-26T14:24:42Z
У Франції знайшли залишки давньоримського поселення з унікальною мозаїкою
Ukraine Art News
2025-06-26T14:21:48Z
Готуємо гаспачо за рецептом знаменитого іспанського шеф-кухаря Хосе Андреса
Elle
2025-07-09T12:21:43Z
5 рецептів літніх смузі: прості та дуже корисні
Elle
2025-07-08T15:36:36Z
ТОП-5 легких літніх закусок
Elle
2025-06-17T14:30:38Z
«ТопШефи х WINETIME. Готуємо разом»: Влад Кіндер ділиться рецептом тунця татакі
Elle
2025-06-06T12:49:01Z
8 найкращих лимонадів у літню спеку
Krasinfo
2025-06-03T07:09:43Z
Весняне меню: детокс-салат із цибулі-порею з креветками
Elle
2025-05-20T19:09:34Z
«ТопШефи х WINETIME. Готуємо разом»: Анастасія Степанова ділиться рецептом лимонного тарту
Elle
2025-05-14T19:03:31Z
Сирники з лекваром: готуємо українську страву за 20 хвилин
Elle
2025-05-12T11:00:56Z
Сезонний рецепт: найсмачніший кіш зі спаржею
Elle
2025-05-09T18:34:08Z