Modelová situace (nejde o skutečná data): zákazník dokončí objednávku, ale jeho prohlížeč zablokuje sledovací skript. Objednávka je v systému e-shopu, reklamní účet o ní ale nic neví. Právě takovou mezeru má zaplnit Konverzní API (Conversions API, zkráceně CAPI), tedy cesta, kterou data o konverzi pošle přímo server firmy.

Microsoft Advertising oznámil 28. 10. 2026, že je CAPI všeobecně dostupné. Příspěvek ale nesděluje, kdo ho může použít. Článek proto odděluje, co Microsoft uvádí, od toho, co je třeba ověřit přímo v účtu.

Vychází z návodu na Microsoft Learn (naposledy aktualizovaného 29. 10. 2026), z říjnového příspěvku Microsoftu a z odpovědi moderátora ve fóru Microsoft Q&A. K dřívějšímu stavu dostupnosti cituje zpravodajský web PPC Land. Nastavení jsme na ostrém účtu nezkoušeli.

Co Konverzní API posílá a jak souvisí se značkou UET?

Je to serverová cesta pro konverze a data o zákaznících, kterou Microsoft doporučuje používat spolu se značkou UET (Universal Event Tracking), ne místo ní. Značka zachytí aktivitu v prohlížeči a kontext stránky, server k tomu přidá události, které nastanou později.

Podle návodu lze jedním napojením poslat události z webu, z CRM, z offline prodeje i z mobilních aplikací. Návod rozlišuje dva typy událostí: načtení stránky (pageLoad) a vlastní událost (custom), například dokončený nákup nebo odeslaný formulář.

Jako důvody uvádí přesnější měření, širší pokrytí atribuce a publika pro dynamický remarketing. Příspěvek z října 2026 slibuje i bohatší signály pro automatické nabídky, čísla ale nepřináší. Jde tedy o tvrzení výrobce bez dokladu.

Komu se Konverzní API vyplatí a komu zatím ne?

Vyplatí se tam, kde se počty konverzí v Microsoft Advertising liší od skutečných objednávek nebo poptávek a kampaně mají dost kliknutí, aby na rozdílu záleželo. Je to úsudek z účelu funkce, prahové hodnoty Microsoft neuvádí.

Přehled podle příkladů z návodu a podle jeho podmínek:

  • E-shop s rozdílem mezi objednávkami a konverzemi: server zná každou objednávku, i když ji prohlížeč neohlásil. Návod uvádí příklad obchodu, který posílá nákupy a kroky pokladny přímo ze systému objednávek.
  • B2B firma s poptávkami v CRM: návod popisuje posílání kvalifikovaných poptávek (leadů), příležitostí a uzavřených zakázek přes datovou platformu nebo partnerský konektor.
  • Firma s prodejem mimo web: návod počítá i s offline transakcemi. Každá událost ale musí nést aspoň jeden identifikátor, například identifikátor kliknutí nebo hašovaný e-mail či telefon.
  • Zatím ne (náš úsudek): účet bez konverzních cílů, které návod počítá mezi podmínky připravenosti, a firma, která neumí předat stav souhlasu a uložit identifikátor kliknutí. U velmi malého počtu kliknutí bude rozdíl v měření těžko znatelný.

Je Konverzní API dostupné pro všechny účty?

Obecnou dostupnost pro všechny účty nelze potvrdit. Microsoft funkci označil 28. 10. 2026 za všeobecně dostupnou, ale příspěvek ani návod neuvádějí podmínky způsobilosti.

Zdroje se přitom rozcházejí. Zpravodajský web PPC Land psal 11. 9. 2026 o pilotu přidělovaném po jednom účtu, který si inzerent nemůže zapnout sám a musí o něj požádat správce účtu u Microsoftu nebo podporu. Opíral se o návod ve stavu z 4. 8. 2026. Jde o sekundární zprávu a v dnešním návodu Microsoftu zmínka o pilotu není.

V červnu 2026 napsal uživatel do fóra Microsoft Q&A, že mu v nastavení značky volba Use Conversions API chybí. Moderátor odpověděl, že by se měla zobrazit, pokud je funkce pro účet zapnutá, a jinak nemusí být zatím zapnutá. Doporučil oslovit správce účtu nebo podporu. V červenci autor dotazu psal, že volbu pořád nemá, a vyřešení fórum neuvádí.

Z otevřených zdrojů tedy nevyplývá, že se volba po říjnovém oznámení objevila všem. Zjistit to jde v účtu: v části UET otevřít značku tužkou, zvolit Save and next, v části Set up tagging vybrat Use Conversions API a použít Copy Token. Token jde podle návodu získat i přes rozhraní API pro správu kampaní. Názvy jsou podle anglického návodu, české rozhraní je může překládat jinak.

Seznam partnerských konektorů se v příspěvku a v návodu liší. Příspěvek uvádí deset partnerů včetně Zeotap, návod deset včetně HubSpotu a u Adobe Real-Time CDP a Switch Growth píše „Coming soon“. Před výběrem konektoru je proto rozumné ověřit v jeho dokumentaci, že je hotový.

Jak funguje deduplikace se značkou UET přes eventId?

Když stejný nákup pošle značka UET i server, musí obě události nést stejné eventId, jinak se konverze může započítat dvakrát. Návod požaduje také shodné ID značky UET a slučitelný název události (eventName).

Ve skriptu UET se hodnota předává parametrem event_id, na serveru polem eventId. Návod ukazuje jako příklad hodnotu 1234567-54422.

Vhodnou hodnotou je podle našeho úsudku číslo objednávky, které se při opakovaném odeslání nemění. Návod výslovně říká jen to, že má být stabilní a že stabilní eventId brání vzniku duplicit při opakovaném odeslání.

Co návod neuvádí: lhůtu, v níž Microsoft obě události spáruje, ani chování při chybějícím eventId na jedné straně. Proto po spuštění porovnat konverze s objednávkami. Zdvojené konverze návod v řešení potíží vysvětluje chybějícím nebo nesourodým eventId.

Co má dodavatel webu poslat a jak naložit se souhlasem?

Návod uvádí tři cesty: vlastní napojení na rozhraní API, partnerský konektor (například datová platforma, kterou firma už používá) a server-side Google Tag Manager. Ten návod označuje za rychlejší cestu pro weby s menším objemem vývoje. Cokoli z toho se zadává dodavateli webu, a ten musí znát tohle:

Každá událost musí mít typ (eventType), čas (eventTime) a v objektu userData aspoň jeden identifikátor. Čas je UNIX čas v sekundách a smí být nejvýš 90 dní starý.

Nejsilnější vazbu na reklamu dává identifikátor kliknutí msclkid. Microsoft ho připojí k adrese vstupní stránky, pokud má účet zapnuté automatické značkování. Podle návodu je jeho zachycení a uložení věcí inzerenta, když události neposílá skript UET; navrhuje uchovávat poslední hodnotu zhruba 90 dní.

E-mail a telefon smějí jít jen jako otisk SHA-256 po normalizaci, telefon ve tvaru E.164, nikdy čitelně. Podle návodu jen tam, kde to dovoluje předpis, zásady firmy a souhlas zákazníka.

Souhlas předává pole adStorageConsent s hodnotou G (udělen) nebo D (zamítnut). Pokud se pole neposílá, Microsoft událost zpracuje jako událost se souhlasem. Události s hodnotou D se nepoužijí pro žádný reklamní účel včetně atribuce a remarketingu.

Pro dynamický remarketing a doporučeně i pro kvalitu měření je potřeba ještě ID Sync, tedy malý pixel v prohlížeči, který spojí anonymní identifikátor návštěvníka s identifikátory Microsoftu. Hodnota VID v pixelu musí odpovídat poli anonymousId na serveru. Zadání pro dodavatele webu:

  • Posílat serverem každou zaplacenou objednávku nebo kvalifikovanou poptávku se stejným eventId, jaké má skript UET.
  • Ukládat a posílat poslední msclkid a anonymní identifikátor shodný s ID Sync.
  • Předávat stav souhlasu v poli adStorageConsent a hašované údaje posílat jen u návštěvníků, kteří to dovolili.
  • Zapisovat odpovědi API do záznamu, aby byla vidět chyba 400 u neplatné události i chyba 401 u špatného tokenu.
  • Zrušené a vrácené objednávky opravovat přes úpravu konverze, kterou popisuje poslední část.

Zavedení Konverzního API bez dvojího započtení

Najít volbu v účtu
V nastavení značky UET hledat Use Conversions API, při chybějící volbě se zeptat podpory.
Zvolit cestu odesílání
Přímé napojení, partnerský konektor nebo server-side správce značek podle zdroje dat.
Sjednotit identifikátory
Stejné ID značky, eventId a eventName ve skriptu UET i v serverových událostech.
Předat souhlas a údaje
Posílat stav souhlasu, msclkid a hašované údaje jen tam, kde je to dovolené.
Porovnat s objednávkami
Po týdnu srovnat konverze v účtu s objednávkami a hledat chybějící i zdvojené.
Pět kroků odvozených z návodu Microsoft Learn; pořadí a formulace jsou naše.

Jak po spuštění ověřit, že konverze nechybí ani se neduplikují?

Nejdřív porovnat počet objednávek nebo poptávek ve vlastním systému s konverzemi v Microsoft Advertising za stejné období, před zapnutím serverových událostí i po týdnu provozu. Skokový nárůst po zapnutí je podezřelý z duplicit.

Odpovědi API je potřeba číst pozorně. Dávka smí mít nejvýš 1 000 událostí a ve výchozím nastavení stačí jedna neplatná, aby API nezpracovalo žádnou. S nastavením continueOnValidationError na true se neplatné události přeskočí a ostatní projdou.

Upozornění u volitelných polí, například u chybně hašovaného e-mailu, vrací kód 200, ale pole se odstraní. Návod to označuje za částečnou ztrátu dat, takže úspěšný kód nestačí a je třeba číst i podrobnosti odpovědi.

Oprava po vrácení zboží: CAPI umí úpravy konverzí, pokud událost nese transactionId. Restate změní jen hodnotu konverze, retract odebere konverzi z počtu úplně; obojí se volá přes objekt OnlineConversionAdjustment v rozhraní API pro správu kampaní.

Článek je informační a nenahrazuje právní poradenství. Souhlasy a zpracování osobních údajů včetně posílání hašovaných údajů je vhodné řešit s právníkem podle konkrétní situace firmy. Nastavení měření v účtu pomůže projít audit analytiky a měření.

Zdroje a stav informací

Stav informací k 20. 11. 2026. Údaje jsou ověřené u těchto zdrojů:

Jak články vznikají a ověřují: redakční zásady blogu.

ZKUSTE TO V PRAXI

Nejdřív zjistit, zda účet nabízí volbu Use Conversions API. Pak po dodavateli webu chtít shodné eventId ve skriptu UET i na serveru, předávání stavu souhlasu a po prvním týdnu porovnání konverzí s objednávkami.

Nejasný pojem?Nahlédněte do slovníku ↗