# Facebook

advanced expert team enterprise

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

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

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

# Добавление аккаунта

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

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

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

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

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

В интеграции возможно искать добавленные интеграции по названиям:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

7. После подтверждения кампании, как начнут появляться целевые клики, проверьте получение событий в разделе 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 адреса клика
                ]

Доступна возможность отправлять дополнительные параметры в 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

# FAQ