# Fbtool.pro

expert team enterprise

Передача расходов Facebook из сервиса Fbtool.pro

# Как подключить

Для подключения на стороне Fbtool.pro необходимо:

  • URL админки трекера в формате tracker_domain.com, на котором доступен Admin API.
  • API ключ. Для сервиса понадобится ключ, полученный в аккаунте администратора.
  1. В интерфейсе Fbtool.pro перейдите в меню Расходы → Keitaro

  2. Введите адрес админки и API ключ в соответственные поля.

  1. Нажмите Сохранить, чтобы добавить привязку.

Расходы передаются с помощью параметра ad.id, который установлен в Sub ID 4 по умолчанию в настройке шаблона Facebook в Keitaro.

# Как прочитать лог запроса

Запросите лог API запроса в поддержке fbtool.pro. Это понадобится для сверки расходов или проверки причины, по которой расход не приходит в трекер. Рассмотрим пример переданного лога

Отправляемые данные - {"start_date":"2024-10-16 00:00:00","end_date":"2024-10-16 23:59:59","cost":"60.83","currency":"USD",
"timezone":"Europe\/Berlin","filters":{"sub_id_5":"120212558973560058"}}
Url отправки: - http://your_domain/admin_api/v1/campaigns/28/update_costs
Ответ Keitaro - {"success":true}
Отправляемые данные - {"start_date":"2024-10-16 00:00:00","end_date":"2024-10-16 23:59:59","cost":"79.18","currency":"USD",
"timezone":"Europe\/Berlin","filters":{"sub_id_5":"120212559138500058"}}
Url отправки: - http://your_domain/admin_api/v1/campaigns/28/update_costs
Ответ Keitaro - {"success":true}

1
2
3
4
5
6
7
8
9

В логе два запроса, каждый состоит из:

  • start_date, end_date - временной промежуток, за который обновляется расход.
  • cost - сумма расходов.
  • currency - валюта, в которой передается расход.
  • timezone - часовой пояс, в котором указаны даты запроса. Должен совпадать с часовым поясом трекера. Если временные зоны разные, статистика Keitaro и Fbtool.pro не совпадет.
  • filters":{"sub_id_1-30":"X"} - параметр, по которому обновляется расход. В дефолтной настройке это sub_id_4, в X указан ad.id, по которому шла передача расхода.

Чтобы проверить, как записан расход в трекер, в отчете по кликам кампании отфильтруйте клики по параметру sub_id_1-30 из запроса. Делится cost на количество кликов с записанным X.

  • {"success":true} - окончание запроса. Статус, отданный трекером. true приходит при успешном запросе, расход записан. false приходит при неуспешном запросе, чтобы расход записался, необходимо устранить ошибку.

# FAQ по Fbtool.pro

Расходы не приходят

Запросите в поддержке Fbtool.pro лог отправленных запросов на трекер, чтобы проверить, произошел ли обмен информацией и какие статусы отдавал трекер.

Дополнительно проверьте правильность указания ad.id в sub_id_4

Интеграция не работала, расходы частично не передались

Fbtool.pro передает расходы за Сегодня и вчера. При необходимости восстановить данные, воспользуйтесь указанным временным отрезком. За дополнительной помощью обратитесь в поддержку Fbtool.pro.

Какой интервал отправки расходов из Fbtool.pro в Keitaro

Отправка данных происходит раз в 15 минут.