EN RU
Цены Блог

# Facebook

advanced expert team enterprise

Keitaro умеет забирать с Facebook информацию о расходах по рекламным кампаниям и отправлять конверсии для оптимизации рекламных кампаний на стороне источника. Интеграция по расходам отделена от интеграции по конверсиям. Для передачи конверсий с помощью пикселя без использования интеграции и API используйте инструкцию Facebook Pixel.

# Импорт расходов из Facebook beta

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

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

# Описание настроек интеграции расходов

  • Название. Имя новой интеграции.
  • Выберите кампании. Каждая интеграция Facebook привязывается к одной или нескольким кампаниям. Выберите из списка для каких кампаний обновлять расходы.
  • Ad account ID. ID кабинета.
  • Маркер доступа. Токен для подключения к рекламному аккаунту по API, смотрите получение АПИ токена.
  • Версия Facebook API. Версионность Facebook API.
  • Обновлять расходы каждые. Обновление расходов интеграции в заданном промежутке времени.
  • Использовать прокси. Совершать все запросы к Facebook API с прокси.

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

beta

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

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

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

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

# Работа со списком интеграций

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

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

# Получение ID кабинета

Откройте Facebook Ads Manager и скопируйте Ad account ID:

# Получение API токена

  1. Авторизуйтесь в Facebook.

Откройте страницу Apps и нажмите Создать приложение:

  1. В следующем окне нажмите Далее:

  1. Выберите Другое и нажмите Далее:

  1. Выберите Business и нажмите Далее:

  1. Добавьте название приложения, контактный электронный адрес и нажмите Создание приложения:

  1. Откройте настройки приложения. Выберите API Marketing, нажмите Настроить:

  1. Выберите раздел Инструменты. Проставьте все галочки и нажмите на кнопку получения маркера:

  1. Скопируйте API токен приложения:

# Получение API токена в новых кабинетах Facebook

Пошаговая инструкция для новых кабинетов
  1. Создайте новое приложение со сценарием использования Создание и настройка рекламы с помощью Marketing API:

  1. Завершите создание приложения и перейдите в панель настроек.

  1. Выберите Настроить сценарий использования, перейдите во вкладку Инструменты:

  1. Проставьте галочки во всех чекбоксах и заберите маркер доступа.

# Получение токена конверсий

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

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

WARNING

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

# Использовать прокси

Без прокси в настройках интеграции запросы отправляются с сервера трекера.

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

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

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

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

# Исправление ошибок подключения интеграции

Основные причины, по которым пользователи не получают расходы в трекере и конверсии на стороне источника:

  1. Устаревшая версия API интеграции. Убедитесь, что используете последнюю актуальную стабильную версию трекера (Обслуживание → Обновление Keitaro → Стабильный → Текущая версия актуальна). На данной версии трекера установлена совместимость интеграции с 18 версией Facebook API.

  2. Неправильный токен для подключения к рекламному аккаунту по API. Страница, с которой берётся корректный токен, выглядит следующим образом:

  1. Отсутствие параметров Facebook, например {{adset.id}} для расходов и {fbclid} для конверсий, в настройках Кампании в разделе Параметры.

В ссылке кампании, которую размещаете в источнике, необходимо добавить параметры кампании, в том числе {{adset.id}}, но {fbclid} необходимо удалить из ссылки при добавлении в источник.

WARNING

Значение fbclid не передается макросом от источника, а формируется автоматически, поэтому содержание макроса в ссылке помешает записи метки в трекер.

Подключайте параметры прямо из шаблона, в настройках кампании:

При отсутствии заполненных параметров или использовании макросов, отличных от шаблонных, расходы не запишутся и отправка конверсий не произойдет:

Если трафик в первую очередь идет на удаленный сайт, к которому трекер подключен по любому скрипту интеграции (KClient PHP; Tracking script; WordPress plugin), метки из шаблона источника необходимо дописать к URL сайта как domain.com?adset_id={{adset.id}}&...

  1. В настройках объявления Facebook вставлена ссылка кампании или сайта интеграции без дополнительных параметров. При создании объявления метки, которые получаете при использовании источника, следует добавить в отдельное окно для параметров.

# Настройка Keitaro для отправки конверсий и событий в Facebook Ads Manager

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

  1. Подключите интеграцию в кампании к рекламному кабинету Facebook Ads Manager. Смотрите Настройку
  2. В настройках интеграции нажмите Mapping. Выберите нужные статусы и события, которые хотите отправлять в Facebook Ads Manager:

  1. Добавьте Pixel ID и токен конверсий согласно инструкции выше.
  2. Готово! Интеграция настроена. Как начнут появляться целевые клики в кампании при наличии параметра fbclid (смотрите раздел Отчеты — Клики), отправьте postback для проверки:

# Как настроить Facebook Ads Manager для получения конверсий

  1. Отправка конверсии происходит при наличии параметра fbclid:

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

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

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

  1. Дополнительно впишите URL с параметрами трекера в раздел URL parameters:

WARNING

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

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

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

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

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

                'action_source' => 'website', // Данный параметр передается по дефолту. Изменить его возможности нет.
                'event_name' =>               // Тип события, указывается в окне маппинга при настройке интеграции.
                '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 — имя,
  • ls — фамилия.

Для отправки в 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

# FAQ

Ошибка «Синхронизация не привязана к кампании».

Не добавлена кампания в настройках интеграции.

Интеграция показывает ошибку.

Убедитесь, что введён верный Cabinet ID и API токен.

Как происходит конвертация валюты.

Трекер берёт валюту из кабинета Facebook и конвертирует в валюту трекера.

Период обновления расхода.

Интеграция обновляет расходы за последние 5 дней.

При первом обновлении период равен 30 дням.

← Google Ads →