Telegram бот подтягивания расходов из Facebook в трекеры

Бот для подтяжки ваших расходов FB с агентов/нлм
Ссылка на бота: https://t.me/ppcostbot

1. Работа медиабаера

1.1 Предварительные условия

Баер при создании рекламных кампаний в Facebook должен передавать в трекер id кампании. Для этого используется макрос {{campaign.id}}. Его необходимо вставлять в объявления в поле Параметры URL или в саму ссылку. Для передачи id кампании необходимо использовать параметр с именем, равным выбранному токену в трекере.

Например: если в трекере для хранения id кампании выбрано поле t8, то в ссылку объявления нужно добавить: https://example.com?t8={{campaign.id}} либо в Параметрах URL добавить метку t8 со значением {{campaign.id}}.

1.2 Работа с токенами аккаунтов

При добавлении в систему используются ТОЛЬКО Developer токены. Подробная инструкция по их получению находится тут. После того, как токен получен и добавлен система спросит:

• название токена: короткое имя (обычно название агентства, с которым происходит работа через данный аккаунт), которое потом будет отображаться в общем списке всех токенов баера.
• размер комиссии в процентах: система умеет загружать расходы С УЧЁТОМ комиссии агентов, что удобно, поскольку комиссии в любом случае ложится на плечи баера. Комиссия вводится просто как число, без знака процента. Если требуется, можно вводить десятичную часть через точку. Например, если комиссия составляет шесть целых и восемь десятых процента, то вводим: 6.8
  Данный шаг можно пропустить и тогда комиссия не будет учитываться.

После добавления токена можно перейти в меня Facebook Data и посмотреть информацию по всем доступным аккаунтам View Ad Accounts:

Здесь можно удобно смотреть местное время, также отображается кол-во активных кампаний и объявлений.

2. Механика подтягивания расходов

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

Система получает из Facebook расходы по всем доступным токену аккаунтам и по всем кампаниям каждого аккаунта. Делается это одним запросом, чтобы не нагружать Facebook и предотвратить слёт токенов.

Данные из Facebook получаются за сегодня и за вчера, чтобы учесть небольшие долёты и докруты спенда, которые в Facebook не редкость.

После получения данных из Facebook система берёт из трекера все доступные ей кампании и объединяет их по группам. Каждая группа - это один баер. Поэтому название группы в трекере и имя баера в системе обязательно ДОЛЖНЫ СОВПАДАТЬ.

Далее для каждой кампании из текущей группы запускается процедура обновления расходов.

Система УЧИТЫВАЕТ часовые пояса из Facebook. То есть: если ваши аккаунты находятся в GMT-7 а ваш трекер находится в GMT+3 не удивляйтесь тому, что когда вы смотрите стату в Facebook за сегодня и стату в трекере за сегодня - это РАЗНЫЕ сегодня и там будут разные данные по спенду. Если прям сильно хочется сверить корректность загруженного спенда - поменяйте временно часовой пояс вашего трекера и сравнивайте данные.

Также не забывайте, что при загрузке спенда учитывается КОМИССИЯ агентов, если вы её указали. Так что даже за одинаковый интервал времени в трекере спенд может быть БОЛЬШЕ именно из-за комиссии.