Co CDP pro Vaprio dělá

Architektura a tok dat

Detaily k jednotlivým vrstvám jsou v kapitolách Zdroje a eventy, Web SDK, Databáze Vaprio a SmartEmailing.

Co běží a co se staví

Popis každého scénáře, jeho podmínky a reporting jsou v kapitole Use-casy.

Kde co najít v Meiru

Instance: vaprio.eu2.pipes.meiro.io. Odkazy níže vedou přímo do aplikace (vyžadují přihlášení).

Zdroje v instanci

Web eventy (Vaprio.cz, Vaprio.sk, sandbox)

Každý webový zdroj má identickou sadu 54 event typů: 52 ze šablony Meira ve stylu GA4 a dva vlastní, cart_updated a user_identified. Reálně se používá zlomek:

Identifikátory na webových eventech: $.user_id (cookie Meira), $.email a $.payload.email, $.device_id (browser), u šablonových typů i email_message_id a phone (telefon se nikdy neplní). Jak eventy vznikají na webu, popisuje kapitola Web SDK.

SmartEmailing eventy

Retence všech SE eventů je neomezená. Význam seznamů a polí je v kapitole SmartEmailing.

Databázové eventy (Vaprio database + backload)

Backload zdroj má stejné 4 event typy s jinými ID. Atributy proto vždy pracují s unionem obou zdrojů. Retence všech DB eventů je neomezená. Detail transformace je v kapitole Databáze Vaprio.

Subscribe endpointy (DOI)

Dva event typy, identifikátor e-mail: newsletter_subscription_requested (žádost, spouští DOI e-mail) a newsletter_subscription_confirmed (potvrzení z prokliku, posílá webhook SmartEmailingu s tokenem). Interní domény (dataclub.cz, vaprio.cz, vaprio.sk) se zahazují. Celý tok je v kapitole Souhlas a DOI.

Dedup a verzování

Retence eventů

Retence je hlavní nástroj na hlídání licenčního objemu uložených eventů, viz Provoz a monitoring.

Dotazy na dokumentaci přes AI

Snippet a first-party doména

<script async src="https://me.vaprio.cz/mpt.js"></script>
<script>
  window.mpt = window.mpt || function(){(window.mpt.q = window.mpt.q || []).push(arguments)};
  mpt("consent", { storage_persistence: window.meiroConsent,
                   user_id: window.meiroConsent, session_id: window.meiroConsent });
  mpt("config", {
    collection_endpoint: "https://me.vaprio.cz/collect/vaprio-cz-1",
    link_tracking:  { enabled: true },
    tracking_rules: { enabled: true },
    web_banners:    { enabled: window.meiroConsent === "granted" }
  });
</script>

Cookie souhlas a SDK

Tracking rules

Kód běží ve Web Workeru v prohlížeči a servíruje se z https://me.vaprio.cz/tracking-rules/<slug>.js. Ten soubor je jediný autoritativní způsob, jak ověřit nasazenou verzi.

Kontrakt dataLayer (co web posílá)

Web bannery a SDK

Jak ověřit, že měření funguje

1. View-source obou webů: správný endpoint per web, jediné volání consent s dynamickou hodnotou, žádné ruční page_view, mpt.js začíná IIFE.
2. Čisté anonymní okno: bez souhlasu eventy s user_id: null a bez mpt_* cookies; po souhlasu cookie mpt_user_id_js existuje a tři refreshe v jednom tabu dají stejné user_id.
3. DevTools Network, typ beacon, filtr collect: u každého batche kontrolovat status odpovědi (400 = zahozený batch), ne jen payload. Konzole: mpt("get","user_id",cb).
4. Projít cesty: detail, varianty, kategorie, vyhledávání bez výsledku, košík (přidat, množství, odebrat, vyprázdnit), checkout, registrace, login. Testovací objednávky jen na sandboxu vaprio.bar.
5. V Meiru: Profiles → Search podle e-mailu testovacího účtu: identifikátory browser + user_id + email, timeline eventů. Surové přijaté requesty (posledních 25 batchů) jsou v detailu zdroje.

Známé vady a otevřené body

CSV exporty

Hodinovka: Cloud App „Vaprio database“

Transformace na eventy

Datový model eventů (výběr polí)

Hygiena identifikátorů

Historie (backload)

Co v CDP není a proč

• Guest objednávka bez e-mailu: event bez identifikátoru se na profil nenaváže a platforma ho po pár dnech smaže.
• Objednávky bez položek (zlomek procenta): order_created se pro ně neemituje, order_updated ano.
• Anonymní účtenky bez věrnostní karty: export je neobsahuje.
• Změna jména či adresy bez bumpu updated_at: do CDP se dostane až s dalším přihlášením.

Kdo co dělá

Seznamy, custom fields, odesílatelé

SE API v3 – používané flows

Automatizace ve SmartEmailingu

Destinace z Meira do SmartEmailingu

Konvence: jedna destinace na scénář a trh, trh je v kódu destinace zapečený. Exportované atributy se do funkce předávají jen vyjmenované (mód Custom).

Payload a šablony

{% set p = metadata.event.attributes %}
{{ p.hero_product.name }} – {{ p.hero_product.price }} {{ p.currency }}
{% for it in p.items %}
  {{ it.name }} {% if it.discount > 0 %}(-{{ it.discount_pct }} %){% endif %}
{% endfor %}

Otevřené body

• Význam seznamů 9/15: přegenerovat na kupující, nebo oficiálně předefinovat na „všechny kontakty“.
• Souhlas per trh (souhlas CZ + objednávka SK): dnes je blacklist globální, seznamy oddělené.
• Změna e-mailu v účtu vytvoří v SE nový kontakt, starý zůstává.
• Finální DOI e-maily a welcome šablona od Vapria; zápis ID banneru do cf 25 zatím neověřen reálným kontaktem.
• Výhled: souhlas jako eventový stream přímo v Meiru (subscribe endpointy + odhlášení), pak SE přestane být zdrojem pravdy o souhlasu.

Identifier typy a kde vznikají

Jak se profil skládá

• Webový purchase e-mail nepotřebuje, váže se přes user_id; e-mail dodá souběžný user_identified z děkovací stránky.
• Guest objednávka = jen e-mail. Newsletter kontakt bez účtu = jen e-mail. GDPR anonymizovaný účet = jen customer_id.
• Dva účty Vapria se stejným e-mailem účtu se legitimně spojí do jednoho profilu (limit 2 customer_id).

Pravidla a rozhodnutí

Limity a přetečení

Kde to vidět v Meiru

V detailu profilu: záložka Identity ukazuje identifikátory a historii spojení (merge, přidání identifikátoru).

Restitch (oprava chybně spojených profilů)

Definice souhlasu

Atribut Email marketing consent

Použití v segmentech a scénářích

• Podmínka: Email marketing consent → consent_status has any of sub.
• Destinace do SmartEmailingu posílají e-mail právě jedné adrese profilu se stavem sub; profil s nulou nebo více adresami sub scénář přeskočí (obsah košíku je citlivý).
• anonymized_account = 1 (GDPR výmaz) v atributu Personal information není souhlas; takové profily se nikdy neoslovují.
• Cookie souhlas na webu a e-mailový souhlas jsou dvě různé věci. Bannery filtruje cookie souhlas přes SDK, e-maily filtruje consent_status.

DOI flow (welcome flow)

1. Banner na webu (welcome flow, 4 kroky) po validaci pošle POST https://me.vaprio.cz/collect/subscribe-endpoint-cz (SK -sk) s {event: "subscription_request", email, source, custom_params}. Bez tokenu, protože HTML banneru je veřejné. Teprve po úspěšném uložení SDK odešle web_banner_submit.
2. Subscribe endpoint uloží newsletter_subscription_requested (identifikátor e-mail → cookie profil se spojí s profilem účtu nebo SE kontaktu).
3. Pipe per trh pošle každý takový event do event destination SmartEmailing DOI: SE POST /import s double_opt_in_settings (DOI e-mail 134 / 137, seznam 32 / 35, ověřený odesílatel, silence period 1 den, ID banneru do cf 25). SE pošle jen DOI e-mail.
4. Proklik DOI: SE zapíše kontakt do seznamu 32 / 35 a přesměruje na děkovací stránku Vapria (/email-potvrzeni.html, SK /email-potvrdenie.html).
5. SE automatizace „MEIRO – DOI flow to CDP“: webhook subscription_confirmed do Meira (s tokenem) → newsletter_subscription_confirmed; webhook do DB Vapria → souhlas v databázi a seznamy 6 / 12; cf 22 = CZ / SK; po 7 dnech odebrání ze seznamu 32 / 35.
6. Do CDP se souhlas propíše z databáze (customer_updated přes hodinovku, do ~1 h) a ze SmartEmailingu (contact_updated). Event newsletter_subscription_confirmed je spouštěč pro welcome e-mail.

Objekty DOI v instanci

Ověřený průběh (17. 9.): odeslání banneru → DOI proklik za sekundy → kontakt v SE seznamu 6 z databáze do 5 minut → customer_updated se souhlasem v Meiru do 45 minut.

Otevřené body

• Finální DOI e-maily (134 / 137 jsou testovací) a text děkovací stránky dodá Vaprio.
• Welcome e-mail po potvrzení: journey v Meiru a SE automatizace se šablonou (viz Use-casy).
• Cílový stav: souhlas jako eventový stream v Meiru včetně odhlášení, SmartEmailing pak přestane být zdrojem pravdy o souhlasu.

Transakce (databáze)

Košík a prohlížení (web)

E-mail a souhlas

Web bannery

Experimenty a provoz

Šablonové atributy Meira

Web: Number of visits CZ / SK, All viewed web pages (timeline), All user_ids, All Google / Facebook IDs. SmartEmailing: All emails opened / clicked / received (email_sent_history), Last campaign received / opened / clicked, Number of emails received / opened / clicked, Date of last …, All email interactions, All email unsubscribes, SmartEmailing subscription status, SmartEmailing Email engagement, First / Last name, All emails, Number of events from SmartEmailing. Vlastník je Meiro nebo Vaprio, na scénářích Data Clubu nestojí (kromě Last 10 viewed products ve welcome selection).

Pravidla platformy (ověřená)

Postup pro nový atribut

1. Účel a dimenze zapsat; zkontrolovat, zda to neumí existující atribut nebo report.
2. SQL podle vzorů, preview / test na 5–10 profilech různých typů (účet s objednávkami, walk-in, guest, GDPR, profil bez účtu) a ruční porovnání s eventy.
3. Schválení: předložit název, SQL, dimenze, single / multi-row. Před založením otázka „Chcete se poradit s implementátorem?“.
4. Založit a uložit definici do repozitáře projektu, zapsat kdo, co, kdy.

Plán

Jak fungují kontrolní skupiny

Mapa pásem

UI testy (varianty bannerů, timing) se řežou kolmo: sudé vs. liché buckety, nebo stratifikovaný výčet bucketů tak, aby každá varianta měla polovinu Main i polovinu cizích kontrolek. Experimenty se pak nealiasují.

Dashboard Experiments

Goals

Ostatní dashboardy

Reporty reagují na výběr období dashboardu přes časovou dimenzi atributu (event_time, clicked_at). Čísla jsou úplná až po naplnění atributu na všech profilech; testovací profily zkreslují CTR, odečítají se dočasným filtrem na audienci nebo se testuje na sandboxu.

Hlídky (watchdog audience)

Jak číst čísla

• Otevření e-mailů po ~2 týdnech, kliky průběžně, rozdíl v nákupech Control vs Main až za 6–8 týdnů.
• Éry: každý start scénáře nebo změna kontraktu (např. desktop banner měří zavření a skutečné URL až od 22. 9.) je zapsaná v metodice; období před érou se do srovnání nebere.
• Výpadek přepočtu profilů (19. 9. 2026, 11 hodin) zamrazil audience a atributy; eventy se neztratily, ale den je pro vyhodnocení bannerů zkreslený.
• Purchase rate košíkové kvalifikace je vysoký, protože kvalifikace zahrnuje i checkout. Proto velké karty ukazují podíl bez nákupu, kde je rozdíl citlivější.

Co běží samo

Heartbeat a alerty

Co je normální

Když něco nejde

Limity platformy (naučené)

• Cloud App: výstup do 10 000 eventů a ~10 MiB na běh (přebytek se tiše zahodí), limit běhu 5 minut, kolem 8–10 odchozích requestů na běh.
• /collect: 1 MB na request, 10 000 eventů na request, 429 při plné frontě.
• Refresh profilu bere max 10 000 nejnovějších eventů; detail profilu v API vrací max 100 eventů (zbytek přes cursor).
• Atribut max 20 dimenzí, dimenze neměnné, žádný přepočet po změně SQL. Dashboard max 20 reportů. Jeden restitch najednou.
• Profile API vrací pro neznámý identifikátor 404 s JSON tělem; při health-checku kontrolovat tělo, ne jen status.
• Aktivní journey nejde uložit; postup pauza → uložit → spustit. Hrany grafu musí mít ID.

Objem eventů a retence

Incidenty

• 19. 9. 2026Worker přepočtu profilů stál 11 hodin (platforma Meiro). Atributy, audience a journeys zamrzlé; eventy se neztratily, po restartu se dopočítaly. Heartbeat upraven na v12 (stojící worker se hlásí do hodiny), Meiro přidalo interní monitoring front.
• 17.–21. 9. 2026Ojedinělé HTTP 500 a TLS chyby SmartEmailingu při volání trigger-event, 20.–21. 9. degradace SE. Destinace bez retry doručení propadaly; 22. 9. nasazen retry do všech pěti destinací.
• 15. 9. 2026Planý poplach heartbeatu (počty ze vzorku) a padající běhy; Meiro opravilo runtime 15./16. 9., prompt přepsán na absolutní prahy.
• 2. 9. 2026Cloud App vrátil přes 10 000 eventů, platforma zdroj vypnula. Řešení: okno 6 h a strop 8 000 eventů na běh.