# Facebook

advanced expert team enterprise

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

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

Откройте Обслуживание → Интеграции, выберите интеграцию с Facebook:

Нажмите Добавить аккаунт

Описание настроек:

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

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

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

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

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

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

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

  1. Выберите "Компания" и нажмите Далее

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

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

  1. Выберите раздел "Инструменты"

  1. Проставьте все галочки и нажмите на кнопку приобретения маркера

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

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

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

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

WARNING

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

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

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

  1. Устаревшая версия API интеграции. Убедитесь, что версия трекера (Admin-Keitaro v), которую используете, как минимум 10.1.8. На данной версии трекера установлена совместимость интеграции с 18 версией Facebook API.

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

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

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

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

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

# Настройка отправки конверсий и событий в 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:

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

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

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

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

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

Доступна возможность отправлять дополнительные параметры в user_data:

  • 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

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

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

В интеграции написано Success, а расходы не обновляются.

Убедитесь, что используете Facebook как источник трафика, выбирается в редактировании кампании и в кампании записаны клики в трекер.

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

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

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

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