name: TikTok Ads — інтеграція ad-analytics-hub description: TikTok Marketing API → BigQuery / DVH pipeline. Developer profile approved 2026-05-05; App "Delta Medical DVH Loader" pending app-review (1-2 дні). type: project originSessionId: 0d72a3ff-fe25-4987-9dc3-09cd33ac2eba

TikTok Ads — Ad Analytics Hub підпроект

Що це

Інтеграція TikTok Marketing API як 6-й підпроект ad-analytics-hub (паралельно з google-ads, meta-ads, tabletki-ua, ga4, gtm). Архітектура — DVH (Data Vault / Data Warehouse) Loader: SQL Server + ODBC + Task Scheduler. Окремий розробник готує DVH-сервер за README паралельно з нашою TikTok-інтеграцією.

Status (2026-05-05 13:31 UTC)

✅ Developer profile APPROVED — зайняло 5 днів через 1-й reject (email-domain ≠ website-domain mismatch) ⏳ App "Delta Medical DVH Loader" pending app-approval — 1-2 дні 🟡 App ID + Secret з'являться після app-апруву 🟡 OAuth + access_token + advertiser_ids — після credentials

Журнал заявок Developer Profile

1-а заявка — REJECTED (до 30.04.2026):

• Communication Email: xxx@deltaswiss.eu
• Company Website: https://Medizine.ua ← mismatch
• Rejected field: Company Name + Account type (Direct Advertiser)
• Корінь: TikTok автоматично перевіряє «email-domain == website-domain»

2-а заявка — APPROVED 2026-05-05:

• Виправлено Company Website: https://Medizine.ua → https://deltaswiss.eu
• Account type: Direct Advertiser
• Country: Ukraine | Vertical: Retail | Use Cases: Ad Measurement + Reporting
• Submit: 30.04.2026 → Approved: 05.05.2026 (5 днів)

App Application

App "Delta Medical DVH Loader" — pending approval (з 2026-05-05):

• Submit: 05.05.2026
• Banner на dashboard: «Your app is currently pending approval»
• TikTok верифікує: name + description + scope
• Очікуваний апрув: 06-07.05.2026 (1-2 дні)
• Що видасть: App ID + App Secret

Цикл імплементації після App-апруву

1. Отримати App ID + App Secret на dashboard
2. OAuth flow → access_token + advertiser_ids
3. Save credentials → /srv/passepartout/tiktok/app-credentials.env (chmod 600 + .meta)
4. Заповнити .env пакет для розробника
5. DVH-сервер (паралельно, не залежить від TikTok):
   • ODBC driver
   • SQL Login
   • Task Scheduler (Windows-based)
   • README від Сергія / Desktop Claude
6. ETL в /srv/projects/ad-analytics-hub/tiktok/:
   • Pull campaign/adgroup/ad performance metrics → BQ або DVH
   • Cron daily як MCC (3:30 UTC?)
   • Інтеграція з daily_delta_monitor → Telegram-recap

DVH-нюанс

App називається «Delta Medical DVH Loader» — отже архітектура не просто ETL у BQ, а Data Vault / Data Warehouse loader. Скоріше за все Windows-based:

• SQL Server (ODBC + SQL Login)
• Task Scheduler
• Окремий DVH-сервер у Сергія / партнера-розробника (не VPS)

❓ Open questions:

• Де живе DVH-сервер? (on-prem / Azure / іnshe)
• Як він конектиться з нашим BQ pipeline?
• Чи дублюємо у BQ для consistency з Meta/Google Ads, чи DVH стане окремим Source-of-Truth?

Cross-context

• TikTok як reference template для PBI Partner Pipeline (Cowork «PBI analitics», 15 days ago). Колонки partners_*.xlsx: Date, Source, Campaign, Impressions, Clicks, Reach, Cost, Views.
• tabletki-to-pbi (09.04) + bloggers-to-pbi (09.04) — production skills
• tiktok-to-pbi skill — після TikTok pipeline в BQ/DVH

Open questions для Сергія

1. TikTok Business Manager — на якому акаунті? (sergey.vereschak@gmail.com / demdizajn / masterdigital / інший?)
2. Login email для developers.tiktok.com
3. DVH-сервер — де живе? Windows on-prem? Azure VM?
4. Розробник — хто це? Чи треба нам зв'язатись напряму?
5. README для DVH — де лежить? Може Desktop Claude передасть копію
6. Advertiser_ids — всі 26 акаунтів як у Meta, чи фокус на конкретних?

Wiki

• /srv/wiki/projects/deltamedical/ad-analytics-hub/tiktok-ads/index.md

Source of truth

• 2026-05-05 13:11 UTC — перший контекст (через Telegram-форвард сесії Claude in Chrome)
• 2026-05-05 13:31 UTC — Developer profile APPROVED + App "DVH Loader" submitted (через Telegram-форвард)