# Facebook Costs

advanced expert team enterprise

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

Интеграция расходов отделена от интеграции отправки конверсий. Для передачи событий в Facebook через Conversions API смотрите Facebook Conversions.

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

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

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

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

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

# Ad account ID

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

# Маркер доступа

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

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

  1. Нажмите Далее:

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

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

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

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

  1. Откройте раздел Инструменты. Установите все флажки и нажмите кнопку генерации маркера:

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

# Маркер доступа в новых кабинетах Facebook

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

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

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

  1. Установите все флажки и скопируйте маркер доступа.

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

Для записи расходов в Keitaro укажите в кампании параметры из шаблона источника Facebook:

Для импорта расходов требуется идентификатор группы объявлений — параметр {{adset.id}}.

WARNING

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

При отправке трафика на удаленный сайт с подключением через KClient PHP, Tracking script или WordPress plugin добавьте метки из шаблона источника к URL сайта. Пример:

domain.com?adset_id={{adset.id}}&...
1

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

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

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

# Прокси

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

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

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

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

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

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

# Расходы не обновляются

Проверьте:

  • актуальную стабильную версию Keitaro;
  • совместимость версии Facebook API с текущей версией трекера;
  • корректность Ad account ID;
  • корректность маркера доступа к Marketing API;
  • наличие параметров из шаблона источника Facebook в кампании Keitaro;
  • наличие параметров трекера в рекламной кампании Facebook.

# Неверный маркер доступа

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

# Синхронизация не привязана к кампании

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

# FAQ

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

Keitaro берет валюту из кабинета Facebook и конвертирует расходы в валюту трекера.

За какой период обновляются расходы?

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

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

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

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

Для импорта расходов используется параметр {{adset.id}}.

Пример:

  1. В Facebook передайте значение adset.id в параметр приложения:
sub1={{adset.id}}
1
  1. Из приложения передайте параметр в Keitaro:
sub1={sub1}
1

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

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