EN RU
Цены Блог

# Facebook Conversions

advanced expert team enterprise

Интеграция Facebook Conversions отправляет конверсии из Keitaro в Facebook Ads Manager через Conversions API. Переданные события используются в Facebook для оптимизации рекламных кампаний.

Интеграция отправки конверсий отделена от импорта расходов. Для импорта расходов из Facebook в Keitaro смотрите Facebook Costs.

Для передачи конверсий через пиксель без интеграции и API используйте Facebook Pixel.

# Создание интеграции

Откройте Интеграции и выберите Facebook Conversion:

Нажмите Добавить аккаунт. Откроется форма создания интеграции.

# Параметры интеграции

  • Название. Имя интеграции.
  • Выберите кампании. Кампании Keitaro для отправки конверсий в Facebook.
  • Pixel ID. Идентификатор пикселя Facebook для отправки событий через API, смотрите инструкцию.
  • Токен конверсий. Маркер доступа к Conversions API. Смотрите раздел Токен конверсий.
  • Использовать прокси. Отправка запросов к Facebook API через прокси.

# Pixel ID

Pixel ID расположен в настройках пикселя в Facebook Events Manager.

Инструкция Facebook Find your Meta Pixel ID.

# Токен конверсий

Параметры для заполнения полей интеграции описаны в инструкции Facebook.

Токен конверсий расположен в настройках личного кабинета. Нажмите Сгенерировать маркер доступа. Смотрите инструкцию получения токена.

WARNING

Скопируйте и сохраните маркер в надежном месте. Маркер выдается один раз, повторный просмотр недоступен. При утрате маркера перевыпустите его.

# Настройка кампании в Keitaro

  1. Создайте кампанию в трекере.

  2. При создании кампании используйте шаблон источника Facebook и сохраните кампанию:

  1. Подключите интеграцию Facebook Conversion к кампании.

  2. В настройках интеграции нажмите Mapping. Выберите статусы Keitaro и события Facebook для отправки в Facebook Ads Manager:

# Настройка Facebook Ads Manager

Отправка конверсий выполняется при наличии параметра fbclid:

  1. Откройте Facebook Ads Manager и перейдите в бизнес-аккаунт:

  1. Создайте рекламную кампанию:

  1. В разделе Website URL укажите ссылку кампании Keitaro с идентификатором:

  1. В разделе URL parameters добавьте параметры трекера:

WARNING

Удалите fbclid={fbclid} из URL Parameters при добавлении параметров кампании в Facebook. Шаблон кампании Keitaro оставьте без изменений.

fbclid формируется автоматически и не передается макросом от источника. Наличие fbclid={fbclid} в ссылке мешает записи метки в трекер.

  1. Опубликуйте кампанию и проверьте ее статус в Facebook Ads Manager:

  1. После подтверждения кампании дождитесь целевых кликов и проверьте получение событий в разделе Account Overview:

# Проверка отправки конверсий

После появления целевых кликов с параметром fbclid отправьте postback для проверки:

# Передача дополнительных параметров в Facebook

Keitaro по умолчанию передает в Facebook следующие параметры:

'action_source' => 'website', // Передается по умолчанию. Изменить параметр нельзя.
'event_name' =>               // Тип события из Mapping.
'event_time' =>               // Время наступления события.
'event_source_url' =>         // Сайт, с которого пришло событие. Данные берутся из referrer и передаются в хешированном виде.
'user_data' => [
    'fbc' => идентификатор клика,
    'fbp' => идентификатор браузера,
    'client_ip_address' => IP-адрес клика,
    'client_user_agent' => user agent клика,
    'country' => страна, определяется по IP-адресу клика,
    'st' => регион, определяется по IP-адресу клика,
    'ct' => город, определяется по IP-адресу клика
]
1
2
3
4
5
6
7
8
9
10
11
12
13

Доступна отправка дополнительных параметров в user_data:

  • value. Доход конверсии с указанием валюты.
  • em. Почта.
  • ph. Телефон.
  • fn. Имя.
  • ln. Фамилия.

Для передачи данных в Facebook отправьте соответствующие параметры во входящем postback. Пример:

http://your_tracker_domain.com/2a76c2a/postback?subid=3sh8so4er3&status=sale&payout=2.61&em=example@gmail.com&fn=John&ln=Snow&ph=+71234567890
1

# Прокси

Без прокси запросы к Facebook API отправляются с сервера трекера.

Facebook периодически вводит географические или IP-ограничения. Прокси используется для:

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

Для включения прокси откройте созданную интеграцию или создайте новую и установите флажок Использовать прокси:

Укажите данные прокси и нажмите Сохранить.

# Список интеграций

  • Имя. Название интеграции. Нажатие открывает форму редактирования.
  • Статус. Статус интеграции. При отсутствии кампании в настройках интеграции отображается ошибка.
  • Клонировать. Создание копии настроенной интеграции со статусами в Mapping.
  • Остановить/Возобновить. Приостановка или запуск работы интеграции.
  • Mapping. Сопоставление статусов Keitaro с событиями Facebook.
  • Удалить. Удаление интеграции.

Над списком интеграций расположено поле поиска по названию:

# Диагностика ошибок

# Конверсии не отправляются

Проверьте:

  • наличие целевых кликов с параметром fbclid;
  • удаление fbclid={fbclid} из URL Parameters в Facebook Ads Manager;
  • создание кампании Keitaro с шаблоном источника Facebook;
  • привязку интеграции к кампании;
  • настройки Mapping;
  • корректность Pixel ID;
  • актуальность токена конверсий.

# Нет параметра fbclid

fbclid формируется Facebook автоматически. Не добавляйте его как макрос в URL Parameters. При отсутствии fbclid в кликах проверьте ссылку объявления и параметры кампании в Facebook Ads Manager.

# Интеграция не привязана к кампании

Ошибка отображается при отсутствии кампании Keitaro в настройках интеграции. Откройте интеграцию, добавьте кампанию и сохраните настройки.

# FAQ

Доступна ли отправка конверсий без Conversions API?

Для передачи конверсий через пиксель без интеграции и API используйте Facebook Pixel.

Почему событие не отображается в Facebook?

Проверьте наличие параметра fbclid, настройки Mapping, Pixel ID, токен конверсий и статус рекламной кампании в Facebook Ads Manager.

Как передавать параметры Facebook через приложение?

Если трафик идет через приложение, параметры Facebook передаются по цепочке: Facebook → приложение → Keitaro.

Для отправки конверсий используется параметр {fbclid}.

Пример:

  1. Из Facebook передайте значение fbclid в приложение.

  2. Из приложения передайте параметр в Keitaro:

sub1={sub1}
1

В данном случае {sub1} заменяется на реальное значение fbclid.

  1. В параметрах кампании Keitaro укажите:
  • во второй колонке - sub1;
  • в третьей колонке - {fbclid}.

← Facebook Costs →