Co Conversion API dělá
Conversion API (CAPI) odesílá konverzní události přímo ze serveru Storeep na reklamní platformu, obchází tak prohlížeč kupujícího. Protože běží server-to-server, není ovlivněna blokátory reklam, nastavením soukromí v prohlížeči ani omezeními sledování v iOS. Přenáší také hashované údaje o zákazníkovi pro lepší párování u chytrého nabízení a podobných publik. Pro klientské pixely si přečtěte doprovodný článek Browser pixels.
Můžete současně používat pro stejnou platformu jak pixel v prohlížeči, tak CAPI. Storeep označí oba stejným ID události vytvořeným z typu události a čísla objednávky, takže platforma je sloučí do jedné konverze místo dvojího započítání.
Které platformy nabízejí CAPI
- Facebook / Meta Conversion API.
- TikTok Events API.
- Snapchat Conversions API.
X a Google Ads nemají v Storeep serverovou Conversion API, fungují pouze přes prohlížeč.
Co se odesílá
U každé kvalifikované objednávky Storeep odešle hodnotu objednávky a měnu, položky produktů a signály kupujícího: hashovaný e-mail, hashovaný telefon, hashované zákaznické ID (external_id), IP adresu, user agent a u Facebooku a Snapchatu také hashovanou zemi trhu. Dále předává všechny ID kliknutí na reklamu nalezené v cookies kupujícího (Facebook _fbc a _fbp, TikTok ttclid, Snapchat ScCid), aby platforma mohla přiřadit konverzi k původnímu kliknutí.
Typy konverzních událostí
- Facebook: pouze Lead nebo Purchase. Facebook CAPI neposílá události přidání do košíku ani zahájení objednávky.
- TikTok: Lead, Purchase, Place an order nebo Complete payment.
- Snapchat: Purchase nebo Reserve.
Měna a objednávky s nulovou hodnotou
Každá událost používá měnu objednávky, pokud ji platforma podporuje, jinak je hodnota převedena na USD. Facebook CAPI přeskočí objednávky s celkovou hodnotou 0, protože Meta odmítá konverze bez hodnoty, což je v souladu s Facebook pixel v prohlížeči.
Omezení pro opuštěné objednávky
Toto je klíčové chování. Nová objednávka vždy spustí odeslání přes CAPI. Opuštěná objednávka je jiná: odešle se pouze tehdy, když zapnete přepínač Opuštěné objednávky u daného záznamu CAPI a pouze v okamžiku, kdy se stav objednávky změní z opuštěné na jakýkoli jiný stav.
- Při vypnuté volbě Opuštěné objednávky se obnovené opuštěné objednávky nikdy neodesílají na platformu.
- Při zapnutí se událost odešle, když objednávka přejde z opuštěného stavu, ať už stav změníte ručně, nebo jej automaticky změní aplikace Automator.
- Pokud není Automator nainstalován, musíte stav objednávky změnit sami, aby se událost odeslala.
- Přepínač je pro každý záznam zvlášť, takže můžete sledování opuštěných objednávek zapnout jen pro jedno Pixel ID a pro jiné jej nechat vypnuté.
Instalace CAPI a jeho polí
- Otevřete Apps v levém menu.
- Najděte požadovanou aplikaci Conversion API a klikněte na Install, poté potvrďte.
- Otevřete aplikaci znovu a klikněte na Add new pixel pro vytvoření záznamu.
Každý záznam obsahuje tato pole:
- Activate: pokud je zapnuto, konverzní události se odesílají server-to-server. Ve výchozím nastavení zapnuto.
- Opuštěné objednávky: přepínač popsaný výše. Ve výchozím nastavení vypnuto.
- Ad account name: označení pouze pro vaši orientaci.
- Pixel ID: vaše Meta, TikTok nebo Snapchat Pixel ID.
- Markets: trhy obchodu, na které se tento záznam vztahuje. Vyberte jeden nebo více.
- Conversion event type: platformní možnosti uvedené výše.
- Access token: přístupový token pro Conversions API, který vygenerujete ve správci událostí platformy. Povinné.
- Activate test mode: pokud je zapnuto, události se odesílají jako testovací.
- Test code: testovací kód události z platformy, například TEST_1234. Povinné při zapnutém testovacím režimu.
Testovací režim
Při zapnutém testovacím režimu se události zobrazují v přehledu testovacích událostí platformy, takže si můžete ověřit integraci bez ovlivnění reálných dat. Testovací události neovlivňují nabízení reklam ani optimalizaci, proto před spuštěním ostrých kampaní testovací režim vypněte.
Jak trhy určují rozsah CAPI
Záznam CAPI se spustí pouze pro objednávky vytvořené na trzích, které jste u něj vybrali. Objednávka z trhu, který jste nevybrali, tento záznam nespustí, takže můžete mít pro každou zemi jiné Pixel ID a access token ze stejného obchodu.
Na co si dát pozor
- Používejte stejné Pixel ID pro pixel v prohlížeči i CAPI, aby platforma sloučila obě doručení do jedné konverze.
- Pokud se události přestanou zobrazovat ve správci událostí platformy, váš access token mohl vypršet. Vygenerujte nový a aktualizujte záznam.
- Každý záznam je nezávislý. Můžete přidat více záznamů na každou platformu, každý s vlastním Pixel ID, access tokenem, trhy, typem události a nastavením pro opuštěné objednávky.
- Před spuštěním ostrého provozu nezapomeňte vypnout testovací režim, jinak se vaše skutečné konverze nebudou počítat.