Интеграция

TikTok Ads в Google Sheets автоматически

Выгружайте TikTok Ads в Google Sheets автоматически: расход, показы, клики, охват, частота и конверсии. API v2 без кода.

LightLead выгружает TikTok Ads в Google Sheets по API v2: расход, показы, клики, CTR, CPC, охват, частота и конверсии на уровне рекламодателя, кампании, группы и объявления. OAuth-токен обновляется автоматически, лимиты отслеживаются по заголовку x-ratelimit-remaining.

Читайте также

Что выгружается

  • Расход, показы, клики, CTR, CPC и CPM
  • Охват (уникальные пользователи) и частота
  • Конверсии (results) и стоимость за результат
  • Данные по рекламодателям, кампаниям, группам и объявлениям
  • Период по умолчанию — последние 30 дней

Измерения и метрики

  • Объекты: advertiser, campaign, adgroup, ad
  • Метрики: spend, impressions, clicks, ctr, cpc, cpm, reach, frequency, conversions, cost_per_result
  • Псевдонимы: adset_* ← adgroup_*
  • Список рекламодателей: id, название, статус, роль, валюта, часовой пояс

Автообновление

Данные обновляются по расписанию — ежечасно, ежедневно или еженедельно. Отчёт учитывает задержку API 1–3 часа относительно интерфейса TikTok Ads Manager; сравнение данных рекомендуется по данным старше 2 дней.

Пример таблицы

КампанияДатаПоказыКликиCTRCPCРасходКонверсииОхват
Spark Ads 12026-07-3076 5002 0402.7%$0.51$1 0405861 200
Catalog Ads 22026-07-3054 3001 2602.3%$0.66$8324147 900
О примере

Значения иллюстрируют структуру отчёта. Реальные данные подставляются из вашего рекламного аккаунта TikTok.

Настройка за 4 шага

  • Начните с LightLead и перейдите в интеграции → рекламные источники → TikTok Ads
  • Авторизуйтесь через TikTok OAuth (роль Analyst — достаточно)
  • Выберите рекламодателя из списка аккаунтов
  • Добавьте отчёт: метрики, период и расписание

Особенности и ограничения

  • Коды ограничений 20001–20003 приходят в теле ответа с HTTP 200 — LightLead распознаёт их через проверку code: 0
  • Лимит отслеживается по заголовку x-ratelimit-remaining без общего числа; сброс — через x-ratelimit-reset
  • Видео- и engagement-метрики (просмотры, лайки, репосты) в коннекторе не запрашиваются
  • Лимитер действует отдельно для каждого рекламодателя
  • Данные API отстают от интерфейса на 1–3 часа

Кому подойдёт

  • Командам TikTok-рекламы: охват, частота и стоимость за результат
  • E-commerce: связь расходов TikTok с продажами через атрибуцию
  • Агентствам: сводные отчёты по нескольким рекламодателям

Цены

LightLead начинается с бесплатного плана (1 аккаунт Meta Ads + Instagram Insights). TikTok Ads и атрибуция Ads → CRM — с плана Solo за $19/мес; несколько CRM — с тарифов Agency от $49/мес.

Частые вопросы

Как подключить TikTok Ads к Google Sheets?

Начните с LightLead, авторизуйтесь через TikTok OAuth и выберите рекламодателя. Роли Analyst достаточно для выгрузки статистики.

Почему данные отличаются от TikTok Ads Manager?

API отстаёт от интерфейса на 1–3 часа, а разные окна атрибуции меняют число конверсий. Сравнивайте данные старше 2 дней.

Можно ли выгружать охват и частоту?

Да — reach и frequency доступны по выбранным периодам.

Что такое коды 20001–20003?

Это ограничения TikTok: превышение лимита запросов, исчерпание дневной квоты и лимит параллельных запросов. LightLead обрабатывает их автоматически.

Как часто обновляются данные?

По расписанию: ежечасно, ежедневно или еженедельно.

Документация

Полная справка по коннектору TikTok Ads: https://docs.lightlead.space/integrations/advertising/tiktok-ads/

Читайте также

Начните с LightLead бесплатно

Создайте первый отчёт — расход, лиды и атрибуция в Google Sheets.

Создать первый отчёт

Документация →