Інтеграція

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.

Створити перший звіт

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