---

type: subproject parent: ad-analytics-hub name: TikTok Ads (ad-analytics-hub підпроект) slug: tiktok-ads status: app-approved-credentials-ready readiness_pct: 35 created: 2026-05-05 last_updated: 2026-05-06

Ad Analytics Hub — TikTok Ads

Підпроект ad-analytics-hub для інтеграції TikTok Marketing API → DVH (зовнішній розробник) + майбутньо BigQuery. App approved 06.05, credentials у Passepartout, чекаємо OAuth + DVH-розробник специфікацій.

Meta

Why this subproject:

• TikTok — один з 4 основних рекламних каналів Deltamedical (Google/Meta/TikTok/Telegram), команда: Катя + Андрій (PPC)
• Зараз TikTok дані в Looker Studio "Humer (копія)" через Supermetrics — але dashboard 2026-05-05 deprecated Сергієм
• Потрібна власна data-pipeline TikTok Marketing API → BigQuery (як Meta Marketing API і Google Ads MCC)

Status (2026-05-06 update):

• ✅ Developer profile APPROVED (зайняло 5 днів — перша заявка rejected через email-domain ≠ website-domain mismatch, виправлено)
• ✅ App "Delta Medical DVH Loader" APPROVED 06.05 — App ID 7636623006235639824 у /srv/passepartout/tiktok/dvh-loader-app.env
• ⏳ OAuth handshake — потрібно авторизувати advertiser-account → access_token + advertiser_ids
• ⏳ DVH-розробник специфікації — куди писати дані, у якому форматі, dimensions+grain (Сергій-PBI-dev контакт TBD)
• 🟡 Python skeleton extractor — після OAuth + специфікацій
• 🟡 ETL код у нашу BQ — паралельно (later phase)

Метрики що тягнемо (per Сергій 05.05): impressions · clicks · views · spend · reach (5 показників)

TikTok Developer App — журнал заявок

1-а заявка — відхилено (до 30.04.2026)

Корінь відмови: TikTok автоматично перевіряє: домен Communication Email = домен Company Website. У 1-й заявці було:

• Communication Email: xxx@deltaswiss.eu
• Company Website: https://Medizine.ua ← mismatch

Поле rejected: Company Name + Account type (Direct Advertiser).

2-а заявка — на review (з 2026-04-30)

Виправлено:

• Company Website: https://deltaswiss.eu (тепер співпадає з email-доменом)
• Account type: Direct Advertiser (правильно для Delta Medical)
• Country: Ukraine
• Vertical: Retail
• Use Cases: Ad Measurement + Reporting
• Опис: заповнено

Submit: 30.04.2026 Очікуваний апрув: 03.05.2026 (3 дні review) Поточна дата: 2026-05-05 ← review-window закрилось 2 дні тому, очікую що в інбоксі Сергія є email-нотіфікація з TikTok (approve / deny)

Що зробити після апруву App (1-2 дні очікування)

1. ✅ Create App — App "Delta Medical DVH Loader" уже створено, чекає approve
2. Отримати App ID + App Secret (після approve)
3. OAuth flow → access_token + advertiser_ids
4. Покласти credentials у passepartout:
   • /srv/passepartout/tiktok/app-credentials.env (chmod 600 + .meta)
5. Заповнити .env пакет для розробника (DVH Loader)
6. Розробник готує DVH-сервер (Data Vault / Data Warehouse) — паралельно, не залежить від TikTok:
   • ODBC driver
   • SQL Login
   • Task Scheduler
   • README від Сергія / Desktop Claude (TODO: знайти і покласти у repo)
7. Code інтеграції в /srv/projects/ad-analytics-hub/tiktok/:
   • ETL tiktok_etl.py — pull campaign/adgroup/ad performance metrics → BQ table ad-analytics-hub.tiktok.{campaigns,adgroups,ads} АБО → DVH SQL (залежно від архітектури яку зараз будує розробник)
   • Cron daily як Google Ads MCC (3:30 UTC?)
   • Інтеграція з daily_delta_monitor для Telegram-recap

DVH Loader — оригінальний контекст (voice 13:45 UTC)

App «Delta Medical DVH Loader» створювався для PowerBI-розробника (зовнішній партнер Сергія) щоб скриптом ходити у рекламний кабінет Google Ads і забирати дані для Power BI аналітиків. Назва «DVH Loader» походить саме з цього use-case (Data Vault / Data Warehouse → Power BI).

Зараз TikTok-API-доступ через цей самий App — і Сергій залишає вибір:

• Shared — один App, один connection, одночасно живить і VPS pipeline (наш ad-analytics-hub) і Power BI dev. Простіше, менше TikTok-апрувів. Ризик: якщо щось у credentials міняється — обидва треки ламаються.
• Separate — окремий App для VPS / окремий для PBI. Чистіше, ізоляція. Кожен новий App = окремий 1-2 дні app-review.

Сергій (voice): «можливо зможемо по ньому ходити... або зробимо декілька для твоїх задач і окремо для Power BI».

Стек DVH (Power BI side)

• Windows-based
• SQL Server (ODBC + SQL Login)
• Task Scheduler
• Окремий DVH-сервер у партнера-розробника

PBI Partner Data Pipeline (контекст)

DVH Loader — частина ширшого PBI Partner Pipeline (legacy wiki: /srv/wiki/delta-medical/pbi-pipeline.md). Цей pipeline вже стандартизує partner reports (TikTok, Tabletki, Bloggers) у формат Excel для Power BI. Колонки: Date, Source, Compaign (sic — typo у шаблоні), Impressions, Clicks, Reach, Cost, Views.

Реалізовано Cowork skills:

• tabletki-to-pbi (09.04)
• bloggers-to-pbi (09.04)
• TikTok — partners_TikTok_*.xlsx reference template (Cowork session «PBI analitics»)

❓ Open questions:

• Що Power BI dev зараз робить? Готує DVH-сервер за README → готовий до credentials → буде сам пулитати з TikTok через App?
• Архітектура нашого ad-analytics-hub: використовуємо тойже App (shared) чи окремий (separate)?
• Source of truth: DVH SQL → BigQuery sync (для нашого BQ pipeline consistency)? Чи дві паралельні джерела (DVH для Power BI, BQ для VPS-аналітики)?
• Cowork skill tiktok-to-pbi — потрібен як аналог tabletki-to-pbi? (Якщо так — чекаємо TikTok credentials, тоді створюємо разом)

Connect to PBI Partner Pipeline

TikTok вже використано як reference template для PBI Partner Pipeline (Cowork session "PBI analitics", 15 days ago). Колонки partners_*.xlsx: Date, Source, Campaign, Impressions, Clicks, Reach, Cost, Views.

Реалізовані як production skills: tabletki-to-pbi (09.04), bloggers-to-pbi (09.04). TikTok-skill — НЕ створено, бо TikTok-дані ще не в нашому BQ-pipeline. Після інтеграції TikTok Marketing API → BQ → можна зробити tiktok-to-pbi skill.

Open questions

1. TikTok Business Manager — на якому акаунті? (особистий sergey.vereschak@gmail.com / demdizajn / masterdigital / новий?)
2. Login email для developers.tiktok.com — який саме? (Сергій уточнить, додамо у passepartout)
3. Email від TikTok з апрувом/відмовою — очікую є в інбоксі sergey.vereschak@gmail.com за період 2026-05-01..05-03. Сергію — перевір.
4. Якщо знову denied — причина? Ще одна перевірка домена? Інші вимоги?
5. Advertiser_ids — TikTok використовує numeric advertiser IDs. Ми хочемо всі 26 акаунтів як у Meta, чи зосередитись на конкретних брендах?

Cross-references

• Umbrella: ../index.md
• Meta Marketing API підпроект (паралельний): ../meta-ads/index.md — той самий pattern
• Google Ads MCC підпроект (паралельний): ../google-ads/index.md
• Memory: looker_studio_dashboard.md, ad_data_collection.md
• Cowork session "PBI analitics" (15 days ago) — TikTok як reference template