Cost Import

Cost Import (/cost-import) подтягивает рекламные расходы в трекер, чтобы cost, profit и ROI на Dashboard и в Reports отражали реальный spend. Без этого раздела ROI часто считается только по ручной cost-модели кампании или выглядит слишком красиво.

Cost Import
Интеграции провайдеров и Daily Costs.

Назначение

Источники трафика редко отдают spend в трекер автоматически. Cost Import связывает кабинеты Facebook, Google Ads, TikTok, Yandex.Direct, VK Ads, myTarget с кампаниями ATracker (или принимает CSV) и пишет daily cost.

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

  • Кампании в ATracker уже созданы — импорт cost привязывается к ним.
  • Доступ к токенам/credentials рекламного кабинета (это не универсальный «один клик OAuth» для всех провайдеров).
  • Понимание external campaign id в кабинете рекламы.

Как открыть

  1. Боковое меню → Cost Import.
  2. Путь: /cost-import.

Провайдеры и credentials

  • Facebook — access token (Graph API Explorer или System User) + ad account id.
  • Google Ads — developer token, OAuth client, refresh token, customer id (и опционально login customer id).
  • TikTok — Business access token + advertiser id.
  • Yandex.Direct, VK Ads, myTarget — токены/ключи соответствующих кабинетов.

В UI у каждого провайдера есть пошаговая справка «как получить ключи». Обычно вы вставляете токены вручную и сохраняете интеграцию.

Пошаговый рабочий цикл (авто)

  1. Создайте интеграцию: выберите провайдера, заполните обязательные credentials по подсказкам в UI.
  2. Сохраните интеграцию. Ошибка сохранения чаще неверный/просроченный токен или неверный ad account / customer / advertiser id — исправьте до маппинга кампаний.
  3. Привяжите external campaign id кабинета к кампании ATracker. Id берите из URL/колонки кабинета рекламы, не путайте с именем кампании.
  4. Запустите синхронизацию за нужные даты (сначала один день для проверки).
  5. Откройте Daily Costs — строки spend по дням с привязкой к campaign и provider.
  6. При ошибке сверки отредактируйте или удалите daily-записи, исправьте маппинг id, повторите sync.
  7. Проверьте cost / profit / ROI на Dashboard и в Reports за те же даты и ту же кампанию.

CSV-путь

  1. Выберите кампанию ATracker.
  2. Подготовьте файл с date, cost, currency (и связанными полями по шаблону загрузки).
  3. Загрузите файл и настройте маппинг колонок на экране импорта.
  4. Проверьте Daily Costs: день, сумма, валюта, кампания.
  5. Откройте Reports за те же даты — cost должен появиться в агрегатах.

CSV удобен для тестовых кампаний и кабинетов без API. Не загружайте один и тот же день дважды без необходимости — получите задвоение spend и ложный ROI.

Сверка после импорта

Сумма cost по кампании в Daily Costs должна быть близка к spend в UI кабинета с учётом timezone и валюты. Чеклист: (1) даты совпадают с периодом отчёта; (2) кампания та же; (3) currency согласована с Settings → General; (4) нет дублей строк за день. Если cost есть в Daily Costs, а ROI в отчёте «пустой» или выглядит как без spend — пересмотрите период/фильтр Reports и timezone аккаунта. После утреннего sync сначала Daily Costs, потом Dashboard/Reports — не наоборот.

Несколько провайдеров и кабинетов

Если трафик идёт из двух кабинетов на одну кампанию ATracker, заведите две интеграции и два маппинга external id (или разнесите по разным кампаниям трекера). Иначе daily cost смешается и ROI станет неинтерпретируемым. Несколько ad accounts одного провайдера — отдельные интеграции. Для агентских MCC в Google укажите login customer id, когда customer id — клиентский аккаунт под менеджером.

Типичные сценарии

  • Ежедневный sync Facebook/Google утром перед ROI-созвоном; затем preset Reports «Daily ROI».
  • Разовый CSV для тестовой кампании без API-доступа.
  • Смена токена Facebook System User — обновить credentials интеграции, затем sync за вчера для контроля.
  • Расхождение с кабинетом на 1 день — чаще timezone: сверьте границы суток аккаунта трекера и кабинета.

Устранение неполадок

  • Sync «успешен», cost пустой — неверный external campaign id или выбран другой ad account.
  • Cost на «чужой» кампании — перепутали маппинг; удалите daily-строки, поправьте id, sync снова.
  • Ошибка credentials — обновите токен/developer token/refresh token; у Google часто протухает refresh.
  • ROI «слишком хороший» — cost ещё не синхронизирован за период или смотрите только ручную cost-модель.

Поля Daily Costs в контексте

Строка Daily Costs — это spend за календарный день с привязкой к кампании ATracker и провайдеру. Редактирование/удаление нужно, когда маппинг id был неверным или CSV задвоил день. После правки пересчитайте ROI в Reports за тот же день: Dashboard подхватит актуальный cost при следующем обновлении агрегатов. Не смешивайте ручную cost-модель кампании и импорт без понимания, что именно попадает в колонку cost отчёта — иначе «двойной» или «нулевой» spend выглядит как баг UI.

Частые ошибки

  • Ожидать Login with Facebook для всех сетей — большинству нужны вручную вставленные токены.
  • Неверный external campaign id — sync «успешен», но cost не на той кампании.
  • Другая currency без указания в CSV — искажение ROI.
  • Смотреть ROI за период, куда cost ещё не синхронизирован.