---

type: project parent: ad-analytics-hub name: Tabletki.ua integration slug: tabletki-ua status: active readiness_pct: 90 last_updated: 2026-05-05

Tabletki.ua integration (sub-project of Ad Analytics Hub)

Tabletki.ua Producer API (sales by category + UTM by campaign) → BigQuery ad-analytics-hub.tabletki. Weekly cron Mon-Sun.

Meta

Why: Tabletki.ua — найбільший аптечний агрегатор UA, дає offline sell-out даних для Deltamedical SKU. Поєднання з ad-spend (Google Ads + Meta) дозволяє рахувати справжній CR/CPA на покупку (не тільки click).

Status (2026-05-05):

• 🟢 Backfill виконано (8 тижнів, 02.03 → 26.04)
• 🟢 Weekly cron systemd-timer створено сьогодні (раніше згадувалось у memory як активний — насправді не було)
• 🟢 Loader stable (2 API-запити + 4 BQ-запити, ~30 сек на тиждень)
• 🟢 Manual run для 27.04→03.05 виконано: 404 sales rows + 26 UTM rows у BQ

Implementation

Cron

• Service/Timer файли: /etc/systemd/system/tabletki-weekly.{service,timer}
• Розклад/власник: дивіться загальний реєстр у MEMORY.md розділ «⏰ Крони»
• Логи: journalctl -u tabletki-weekly

Manual run (ручний refill)

GOOGLE_APPLICATION_CREDENTIALS=/srv/passepartout/google/ad-pipeline-worker-sa.json \
  /srv/tools/tabletki/tabletki_loader.py --mode both --from 2026-04-13 --to 2026-04-19

BQ schema

ad-analytics-hub.tabletki.tabletki_sales (20 полів):

• date_from, date_to, period_type (Mon-Sun + 'week')
• sku_id, product_code, product_name, manufacturer
• category_code, category_name
• units_sold, revenue_uah, avg_price_uah
• category_revenue_uah, pct_category_revenue, pct_category_units
• category_top1/2/3_units (для market-share)
• ingested_at, source_file

ad-analytics-hub.tabletki.tabletki_utm (10 полів):

• date_from, date_to, utm_campaign, utm_source, utm_medium
• clicks, conversions, conversion_value
• ingested_at, source_file

Auth

• API token: /srv/passepartout/tabletki/api.token (Bearer JWT, exp 2027-04-16, login APIadsanalyzer, clientId 270)
• BQ writes: /srv/passepartout/google/ad-pipeline-worker-sa.json (має bigquery.dataEditor + bigquery.jobUser на dataset tabletki)

Code

• /srv/tools/tabletki/tabletki_loader.py — Python loader (~250 рядків)
• Modes: sales | utm | both | auto-week
• Args: --from --to --dry-run --mode

Idempotency

DELETE rows for (date_from, date_to) → INSERT нових. Repeat-safe.

Cross-references

• Memory (canonical): project_tabletki_integration.md
• BigQuery integration: /integrations/bigquery.md

Backlog

• [ ] Drift detector rule: «memory каже cron активний → перевір systemctl list-timers» (виявлено 2026-05-05)
• [ ] Looker Studio views (v_delta_sales_daily, v_delta_sales_weekly, v_delta_sales_trend, v_market_share) — Сергій: dashboard треба deprecate за rule «забути Looker». Перевірити чи views не використовуються звідкись активно.
• [ ] Alert на crash cron — зараз тихо лежить у journalctl
• [ ] Daily refresh — зараз тільки weekly (Tabletki API дає daily, але грязнуваті дані)

Open questions

1. Чи переносимо UTM-звіт у спільний ad-analytics-hub.utm_unified view (Tabletki + GA4 + Google Ads)?
2. Які Deltamedical SKU моніторимо як «свої» (для CR розрахунку) — є чіткий список?
3. Daily-cron побудувати чи лишаємо weekly (CR за тиждень — ок для marketing meeting)?