# 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:

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

- Нажмите Далее:

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


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

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

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

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

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

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

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

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

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

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

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

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

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

# Прокси
Без прокси запросы к 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}}.
Пример:
- В Facebook передайте значение
adset.idв параметр приложения:
sub1={{adset.id}}
- Из приложения передайте параметр в Keitaro:
sub1={sub1}
В данном случае {sub1} заменяется на реальное значение adset.id.
- В параметрах кампании Keitaro укажите:
- во второй колонке -
sub1; - в третьей колонке -
{{adset.id}}.