Импорт расходов Keitaro: расход Facebook Ads в отчётах трекера

Смысл импорта расходов Keitaro прост: расход в отчётах трекера превращает его из счётчика конверсий в калькулятор прибыли - каждая строка кампании показывает ROI, а не только выплаты. Keitaro поставляет это как отдельную интеграцию - Facebook Costs, - которая импортирует расход из рекламного кабинета по расписанию, конвертирует его в валюту трекера и раскладывает по отчётам кампаний. Этот гайд проводит настройку от начала до конца: чем интеграция отличается от отправки конверсий, какие поля ей нужны, какой параметр кампании молча решает успех и что делать, когда расход не появляется.

Денежная рамка вокруг этой настройки - почему ROI трекера и ROAS площадки расходятся - в гайде ROI трекера против ROAS; здесь - техническая механика настройки.

Что такое интеграция Facebook Costs

Документация Keitaro проговаривает границу прямо: интеграция «импортирует расходы из рекламного кабинета Facebook Ads в Keitaro», и «интеграция расхода отделена от интеграции отправки конверсий» (документация Facebook Costs). Две интеграции, два набора креденшелов, две работы: Facebook Conversions отправляет ваши конверсии наружу, в Meta; Facebook Costs тянет расход внутрь.

Расход приземляется в отчёты кампаний - где и становится полезным: прибыльность по кампаниям и источникам, честные сравнения офферов, знаменатель ROI из гайда о сверке денег. Параметр cost в постбек-контракте покрывает поконверсионные модели расхода; интеграция покрывает расход кабинета, который никогда не ездит в постбеках.

Настройка: поля, которые имеют значение

Документированная последовательность настройки:

1. Откройте Integrations, выберите Facebook Cost, нажмите Add account.
2. Заполните поля: Name - подпись интеграции; Choose campaigns - кампании Keitaro для обновления; Ad account ID - скопированный из Facebook Ads Manager; Access Token - токен API-подключения; Facebook API version; Update every - интервал автоматического обновления; и Use proxy для маршрутизации запросов.
3. Сохраните - в списке интеграций также доступны Pause, Resume, Clone, Delete и ручная кнопка Update costs для немедленного обновления.

Токен заслуживает отдельной минуты. Документированный путь: в Facebook создайте приложение (Other, затем тип Business), включите Marketing API в настройках приложения, откройте Tools, отметьте чекбоксы, сгенерируйте и скопируйте токен в Keitaro (документация Facebook Costs).

Требование {{adset.id}}

Интеграция маппит расходные данные Facebook на кампании Keitaro через параметры кампании, и несущей является метка набора объявлений: {{adset.id}}. Документация проговаривает режим отказа дословно: «Если параметры кампании пусты или отличаются от шаблона, расходы не записываются».

На практике три места обязаны совпасть:

1. URL-параметры кампании Facebook несут макросы шаблона - как минимум идентификатор набора объявлений.
2. Колонки параметров кампании трекера настроены на их приём.
3. Для удалённых сайтов (KClient PHP, tracking script, плагин WordPress) теги едут дальше в URL сайта, а через приложения параметры проходят по цепочке - документация показывает sub1={{adset.id}} в приложение, затем sub1={sub1} в Keitaro.

Когда расходы молча не появляются, эта цепочка параметров - подозреваемый номер один: раньше токенов, раньше версий API.

Расписание и валюта

Обновления расхода идут по интервалу из Update every, и покрытие документировано: каждое обновление «обновляет расходы за последние 5 дней», а «первое обновление покрывает 30 дней». Валюта обрабатывается автоматически на стороне трекера: Keitaro снимает валюту с аккаунта Facebook и конвертирует её в валюту трекера - в отчётах в любом случае видна базовая валюта трекера.

Одно следствие для отчётности из гайда о сверке применяется напрямую: обновления расхода периодичны, поэтому внутричасовые сравнения ROI способны смешать свежую строку выручки со вчерашней строкой расхода. Сравнивайте на устоявшихся периодах, никогда на живом краю.

Траблшутинг: когда расходы не появляются

Документированный чеклист для отсутствующих расходов:

1. «Integration is not tied to a campaign» - в интеграции не выбрана кампания Keitaro; добавьте и сохраните.
2. Параметры пусты или отличаются от шаблона - расходы не записываются; восстановите цепочку {{adset.id}} из раздела выше.
3. Несовпадение версий - и версия Keitaro, и версия Facebook API в интеграции должны быть актуальными.
4. Проблемы токена - токен Marketing API должен быть жив и скопирован полностью.
5. Доступ к регионам - опция прокси существует для нужных регионов и снижения риска блоков или капчи при частых автоматических запросах.

Со стороны рекламной платформы - что реально насчитала Meta - верификацию закрывают Pixel Activator и Test Events, а конверсионную половину книг - чеклист поиска неисправностей постбеков.

Импорт расходов Keitaro: частые вопросы

Источники