Přehled

Pinterest API pro konverze umožňuje inzerentům odesílat konverze přímo Pinterestu prostřednictvím spojení mezi servery. Konverze zachycené pomocí rozhraní Pinterest API lze pak použít pro opětovné cílení v kampaních a lze je v hlášení konverzí kontrolovat, abyste měli o konverzích lepší přehled.

Prostřednictvím rozhraní Pinterest API pro konverze mohou inzerenti odesílat:

  • Konverze na webu
  • Konverze v aplikaci
  • Offline konverze
  • Události mohou být přijaty v reálném čase nebo do jedné hodiny od proběhlé a zachycené události. Události přijaté mimo toto časové okno nebo v rámci odložené hromadné události budou počítány jako offline konverze. 

    Používáním rozhraní Pinterest API pro konverze spolu s tagem Pinterestu můžete získat maximální přehled o zachycených konverzích. Naším osvědčeným postupem je používat obě řešení pro zachytávání konverzí, aby se zajistilo, že získáte komplexní přehled výkonu kampaně zaměřené na konverze.

    Pinterest API

    Pinterest API pro konverze je jeden z několika produktů, které fungují v rámci našeho rozhraní Pinterest API. Pinterest API pro konverze může používat kdokoli s účtem Pinterest Business, což ale automaticky neposkytuje přístup k širšímu rozhraní Pinterest API. 

    Informace o všech produktech API Pinterestu najdete na Vývojářské platformě Pinterestu. 

    Začínáme

    K rozhraní Pinterest API pro konverze má přístup kdokoli s účtem Pinterest Business.

    Pokud chcete začít, musíte nejdřív vygenerovat přístupový token. Přístupový token je řetězec znaků, který ověří, že se žádosti provádějí a odesílají zpět na účet správného uživatele. 

    Přístupový token vygenerujete takto: 

  • Přihlaste se ke svému firemnímu účtu Pinterest.
  • V horní nabídce klikněte na Reklamy a vyberte Konverze.
  • V navigaci nalevo vyberte stránku Přístupový token pro konverze.
  • Klikněte na tlačítko Vygenerovat nový token.
  • Zkopírujte nový přístupový token a vraťte se k procesu instalace.
  • Pokud se snažíte přistupovat k účtu, který nevlastníte, musíte si nejdřív nastavit Přístup pro firmy. 

    Implementace

    Události konverzí: Všechny typy událostí dostupné k zachycení u tagu Pinterestu jsou k dispozici také prostřednictvím rozhraní Pinterest API pro konverze. Úplný seznam událostí a další informace ohledně jejich významu najdete v naší dokumentaci rozhraní Pinterest API pro vývojáře.

    Nastavení integrace API mezi servery vyžaduje vývojářské a technické zdroje vlastníka webové stránky. Množství práce, které musí vývojář vynaložit, se bude lišit v závislosti na těchto faktorech:

  • Obeznámenost vašeho vývojáře s integracemi API. Pokud ještě integraci API nikdy neprováděl, možná mu to dá větší práci.  Pokud jste už implementovali jiná API pro konverze, mělo by stačit, aby vývojář provedl jenom několik změn.
  • Počet sledovaných událostí a to, v jaké fázi procesu konverze nám budou data zasílána.
  • Zda inzerent chce nebo potřebuje k integraci využít třetí stranu (např. Shopify, GTM, Tealium).
  • Pokud už používáte tag Pinterestu

    Důrazně doporučujeme používat rozhraní Pinterest API pro konverze spolu s tagem Pinterestu, abyste dosahovali maximálního počtu konverzí. 

    Pokud jste už tag Pinterestu dříve nastavili, budete muset zajistit, aby se konverze nezapočítávaly dvakrát – jednou prostřednictvím tagu Pinterestu a jednou prostřednictvím rozhraní API. 

    Pokud toho chcete dosáhnout, musíte zajistit, aby se parametr event_id předával zpět s konverzemi zachycenými tagem Pinterestu i rozhraním Pinterest API pro konverze. 

    Náš systém pak rozpozná event_ids jako duplikáty a zachová jenom první zachycenou konverzi. Aby se zajistilo, že tato deduplikace bude úspěšná, musí event_ids splňovat tyto požadavky:

  • event_ids musí být mezi stejnými konverzemi identické – Uživatel přejde na webovou stránku a konverzi při návštěvě stránky spustí tag Pinterestu i rozhraní Pinterest API. Obě odeslané konverze budou muset mít odpovídající event_ids, aby náš systém rozpoznal, že se jedná o stejnou konverzi. 
  • event_ids musí být pro různé konverze jedinečné – Uživatel přejde na webovou stránku a konverzi při návštěvě stránky spustí tag Pinterestu i rozhraní Pinterest API. Uživatel si pak do košíku přidá tričko, což spustí událost AddToCart u tagu Pinterestu i rozhraní Pinterest API. Zatímco event_ids spuštěné pro stejné události se musí shodovat, event_ids odeslané pro událost návštěvy stránky a událost AddToCart musí být jedinečné. Náš systém je tak rozpozná jako samostatné události.
  • Na základě tohoto identifikátoru události a parametru event_name Pinterest ze záznamu odstraní všechny duplicitní události za předpokladu, že (a) událost neproběhla offline (action_source není offline) a (b) Pinterest obdrží duplicitní události do 48 hodin od sebe.

    Ověření nastavení

    Jakmile dokončíte nastavení rozhraní API, můžete ověřit přijímání událostí konverzí tak, že zkontrolujete:

  • Kódy odpovědí: Vývojář, který vaši integraci rozhraní API nastavuje, může kontrolovat kódy odpovědí, které se vracejí s každou žádostí odeslanou zpět po spuštění konverze. 
  • Stránka deduplikování ve Správě inzerce: Konverze po deduplikování se zobrazí na stránce deduplikování ve Správě inzerce. Na stránku deduplikování se dostanete takto:
    • Přihlaste se ke svému firemnímu účtu Pinterest.
    • V horní nabídce klikněte na Reklamy a vyberte Konverze.
    • V navigaci nalevo vyberte možnost Deduplikování.
  • Kvalita a odolnost

    Odolnost je stav nastavení API pro konverze, který umožňuje nejvyšší úroveň párování signálů a atribuce. Tato další data nám pomohou poskytovat přesnější vykazování s tím, jak se mění a vyvíjí zásady reklamního odvětví.

    Stav odolnosti

    Existují dvě kategorie stavu odolnosti: dobrý a špatný. Stav odolnosti je viditelný v části Stav konverze ve Správě inzerce.

    Dobrá odolnost

    Možnost 1: Rozsah konkrétních identifikátorů

  • Rozsah identifikátorů
    • minimálně 90 % událostí by mělo mít IP/UA, 
    • minimálně 10 % událostí z dolní části konverzního trychtýře má E-mail nebo MAID s hodnotou hash, 
    • minimálně 10 % událostí má externí ID.
  • Překrývání s daty tagu (v příslušných případech)
    • Minimálně 90 %* událostí tagu by mělo být přijato přes CAPI 
  • Nebo:

    Možnost 2: Dosažení základní míry shody

  • Míra shody uživatelů CAPI minimálně 60 %
  • Překrývání s daty tagu (v příslušných případech)
  • Minimálně 90 %* událostí tagu by mělo být přijato přes CAPI 


  • Špatná odolnost

    Jakékoli nastavení, které nemá dobrou odolnost.

    ID a signály odolnosti

    Odešlete následující signály, abyste dosáhli stavu odolného inzerenta.

    ID API / signály Hmotnosti / pořadí
    client_ip_address + client_user_agent Vysoké
    em Vysoké
    external_id Vysoké
    hashed_maid Vysoké
    click_id Vysoké
    fn + ln Nízké
    ph Nízké
    ge, bd, ct, st, zp, země Nízké

    *Váhy/pořadí založené na pravděpodobnosti zvýšení míry shody

    Implementace třetích stran

    Pinterest má několik integrací třetích stran, které pomáhají podporovat proces přijetí rozhraní API. 

    Správce značek Google – na straně serveru

    Můžete propojit účet Správce značek Google s rozhraním API Pinterestu pro konverze, abyste zjistili, nakolik Pinterest ovlivňuje návštěvnost vašeho obchodu a prodej vašich produktů.

    Tato integrace vyžaduje nasazení kontejneru serveru pomocí preferovaného poskytovatele cloudových služeb a znalosti o označování na straně serveru. Další informace o požadavcích najdete na webu pro vývojáře

    Shopify

    Tato integrace rozhraní API pro konverze doplňuje tag Pinterestu, aby se zajistil vysoký rozsah a kvalita dat. Pokud je nainstalována aplikace Shopify, není k využívání tohoto vylepšení potřeba nic dělat. Změny se v obchodě obchodníka projeví automaticky.

    Tealium

    Inzerenti, kteří mají zájem o Tealium, mohou nastavit API pro konverze přímo s třetí stranou. Tealium vytvoří šablonu a pomůže usnadnit integraci s inzerentem. 

    Proces implementace je popsán ve výukovém centru Tealium. Případné otázky týkající se podpory implementace můžete posílat na adresu support [at] tealium.com (support[at]tealium[dot]com)

    Pokud máte zájem o jakékoli další integrace třetích stran, obraťte se na svého prodejního zástupce s žádostí o další informace. 

    Vysvětlení omezeného zpracování údajů

    Od 1. ledna 2023 mohou inzerenti používat označení omezeného zpracování údajů, který jim pomůže dodržovat zákon Kalifornie o ochraně osobních údajů spotřebitelů ve znění podle zákona Kalifornie o ochraně osobních údajů (společně označováno jako CCPA). Při použití tohoto označení Pinterest omezí způsob, jakým používáme určitá údaje, abychom inzerentům pomohli dodržovat nastavení soukromí uživatelů. Inzerent může například implementovat označení omezeného zpracování údajů pro uživatele z Kalifornie, kteří se odhlásili z prodeje nebo sdílení jejich dat v rámci zákona CCPA. Pokud je použito označení omezeného zpracování údajů, Pinterest bude jednat jako poskytovatel služeb v rámci zákona CCPA, pokud jde o označené údaje od uživatelů v Kalifornii.

    Inzerenti jsou při implementaci označení omezeného zpracování údajů povinni odhlášení uživatelů dodržovat a také identifikovat stav pobytu uživatele.

    End of Other articles Links
    Ještě potřebujete pomoc? Kontaktujte nás
    User feedback
    Byl tento článek užitečný?

    collection_fields

    Jak můžeme tento článek vylepšit?