Prehľad

Rozhranie API Pinterestu pre konverzie umožňuje inzerentom posielať konverzie priamo na Pinterest prostredníctvom pripojenia serveru k serveru. Konverzie zaznamenané pomocou rozhrania API Pinterestu potom možno použiť na opätovné zacielenie v kampaniach a možno ich kontrolovať v prehľadoch konverzií, aby sa zlepšila viditeľnosť konverzií.

Inzerenti môžu prostredníctvom rozhrania API Pinterestu pre konverzie odosielať:

  • Konverzie na webe
  • Konverzie v aplikácii
  • Offline konverzie
  • Udalosti možno prijímať v reálnom čase alebo do hodiny od výskytu a zaznamenania udalosti. Udalosti prijaté mimo tohto obdobia alebo ako súčasť oneskorenej dávkovej udalosti sa budú počítať ako offline konverzie. 

    Používanie rozhrania API Pinterestu pre konverzie spolu so značkou Pinterestu vám môže pomôcť maximalizovať viditeľnosť pri zaznamenávaných konverziách. Naším osvedčeným postupom je použiť obe riešenia na zaznamenávanie konverzií, aby ste mali komplexný prehľad o výkonnosti kampaní zameraných na konverzie.

    API Pinterestu

    Rozhranie API Pinterestu pre konverzie je jedným z viacerých produktov, ktoré žijú v našom ekosystéme rozhrania API Pinterestu. Ktokoľvek s firemným účtom na Pintereste bude môcť používať rozhranie API Pinterestu pre konverzie. Toto rozhranie však nebude automaticky udeľovať prístup k širšiemu rozhraniu API Pinterestu. 

    Platforma vývojárov Pinterestu obsahuje informácie o všetkých produktoch API Pinterestu. 

    Začíname

    Ku rozhraniam API Pinterestu pre konverzie má prístup ktokoľvek s firemným účtom na Pintereste.

    Ak chcete začať, najskôr budete musieť vygenerovať prístupový token. Prístupový token je reťazec znakov, ktorý overuje žiadosti a odosiela sa späť do správneho účtu používateľa. 

    Ako vygenerovať prístupový token: 

  • Prihláste sa do svojho firemného účtu na Pintereste.
  • V hornej ponuke kliknite na položku Reklamy a vyberte možnosť Konverzie.
  • Na ľavom navigačnom paneli vyberte stránku prístupového tokenu konverzií.
  • Kliknite na tlačidlo Vygenerovať nový token.
  • Skopírujte nový prístupový token a vráťte sa do procesu nastavenia.
  • Ak sa pokúšate získať prístup k účtu, ktorý nevlastníte, musíte najskôr nastaviť firemný prístup. 

    Implementácia

    Konverzné udalosti: všetky typy udalostí, ktoré sú k dispozícii na zaznamenávanie v značke Pinterestu, sú k dispozícii aj prostredníctvom rozhrania API Pinterestu pre konverzie. Úplný zoznam udalostí a ďalšie informácie o ich význame nájdete v našej dokumentácii pre vývojárov rozhrania API Pinterestu.

    Nastavenie integrácie rozhraním API typu server-server vyžaduje od vlastníka webovej lokality vývojárske a technické zdroje. Miera úsilia technického vývojára sa bude líšiť v závislosti od:

  • skúseností vášho vývojára s integráciami rozhraní API – ak vývojár ešte nikdy predtým neintegroval rozhranie API, môže si to vyžadovať ďalšie úsile, ale ak už implementoval iné rozhrania API konverzií, stačí mu vykonať len niekoľko čiastkových zmien,
  • počtu sledovaných udalostí a od toho, z akého štádia spracovania konverzií sú údaje, ktoré sa nám odošlú,
  • toho, či inzerent chce alebo potrebuje použiť služby tretích strán na integráciu (t. j. Shopify, GTM, Tealium).
  • Ak už značku Pinterestu používate

    Dôrazne odporúčame používať rozhranie API Pinterestu pre konverzie spolu so značkou Pinterestu, aby ste maximalizovali svoje konverzie. 

    Ak ste značku Pinterestu už v minulosti nastavili, musíte zabezpečiť, aby sa konverzie nezarátali dvakrát – raz prostredníctvom značky Pinterestu a raz cez rozhranie API. 

    Na dosiahnutie tohto cieľa sa musíte uistiť, že parameter event_id sa odovzdáva späť s konverziami, ktoré zaznamenávajú značka Pinterestu aj rozhranie API Pinterestu pre konverzie. 

    Náš systém potom parametre event_ids uzná za duplikáty a zachová si iba prvú zaznamenanú konverziu. Ak chcete zabezpečiť, aby bolo odstránenie duplikátov úspešné, parameter event_ids musí byť:

  • Parameter event_ids musí byť totožný medzi rovnakými konverziami – Osoba prejde na webovú stránku a konverziu pri návšteve stránky spustila značka Pinterestu aj rozhranie API Pinterestu. Tieto dve konverzie budú musieť odoslať zodpovedajúce parametre event_ids späť, aby náš systém uznal, že ide o rovnakú konverziu. 
  • Parameter event_ids musí byť jedinečný pre rôzne konverzie – Osoba prejde na webovú stránku a konverziu pri návšteve stránky spustila značka Pinterestu aj rozhranie API Pinterestu. Táto osoba si potom do košíka pridá tričko, ktoré spustí udalosť AddToCart na značke Pinterestu aj na rozhraní API Pinterestu. Aj keď sa parametre event_ids musia zhodovať pre rovnaké udalosti, odošlú sa na udalosť návštevy stránky a udalosť AddToCart musí byť jedinečná. Náš systém ich tak rozpoznáva ako samostatné udalosti.
  • Na základe tohto identifikátora udalosti a parametra event_name Pinterest zo záznamu odstráni všetky duplicitné udalosti za predpokladu, že (a) udalosť sa neudiala offline (action_source nemá hodnotu offline) a (b) Pinterest dostane duplicitné udalosti do 24 hodín od seba.

    Overenie nastavenia

    Po dokončení nastavovania rozhrania API môžete overiť, či sa udalosti konverzie prijímajú. Skontrolujte:

  • Kódy odpovedí: Vývojár, ktorý nastavuje integráciu rozhrania API, môže skontrolovať kódy odpovedí, ktoré sa vrátili s každou žiadosťou odoslanou späť po spustení konverzie. 
  • Stránka odstránenia duplikátov v správcovi reklám: konverzie po odstránení duplikátov sa budú zobrazovať na stránke odstránenia duplikátov v správcovi reklám. Ak chcete získať prístup k stránke odstránenia duplikátov:
    • Prihláste sa do svojho firemného účtu na Pintereste.
    • V hornej ponuke kliknite na položku Reklamy a vyberte možnosť Konverzie.
    • Na ľavom navigačnom paneli vyberte možnosť Odstránenie duplikátov.
  • Kvalita a odolnosť

    Odolnosť je stav nastavenia rozhrania API pre konverzie, ktorý umožňuje najvyššiu úroveň párovania signálov a pripisovania. Tieto ďalšie údaje nám pomôžu poskytovať presnejšie prehľady, pretože pravidlá reklamného priemyslu sa menia a vyvíjajú.

    Stav odolnosti

    Existujú dve kategórie stavu odolnosti: dobrý a zlý. Váš stav odolnosti je viditeľný v časti Stav konverzií v správcovi reklám.

    Dobrá odolnosť

    1. možnosť: Pokrytie konkrétnych identifikátorov

  • Pokrytie identifikátorov
    • minimálne 90 % udalostí by malo mať IP/UA, 
    • minimálne 10 % udalostí z dolnej časti lievika má e‑mail alebo MAID s hašovanou hodnotou, 
    • minimálne 10 % udalostí má externé ID.
  • Prekrytie s údajmi značky (v príslušných prípadoch)
    • Minimálne 90 % udalostí značky by malo byť prijatých cez CAPI 
  • Alebo:

    2. možnosť: Dosiahnutie základnej miery zhody

  • Miera zhody používateľov CAPI minimálne 60 %
  • Prekrytie s údajmi značky (v príslušných prípadoch)
  • Minimálne 90 % udalostí značky by malo byť prijatých cez CAPI 


  • Zlá odolnosť

    Akékoľvek nastavenie, ktoré nemá dobrú odolnosť.

    Identifikátory a signály odolnosti

    Odošlite nasledujúce signály, aby ste dosiahli stav odolného inzerenta.

    Identifikátory/signály rozhrania API Hmotnosť/rebríček
    client_ip_address + client_user_agent Vysoká
    em Vysoká
    external_id Vysoká
    hashed_maid Vysoká
    click_id Vysoká
    fn + ln Nízka
    ph Nízka
    ge, bd, ct, st, zp, krajina Nízka

    *Váhy/poradie založené na pravdepodobnosti zvýšenia miery zhody

    Implementácia tretích strán

    Pinterest má niekoľko integrácií tretích strán, ktoré pomáhajú podporovať proces prijímania rozhrania API. 

    Správca značiek Google – strana servera

    Prepojte svoj účet v Správcovi značiek Google s rozhraním API Pinterestu pre konverzie, aby ste zistili, ako Pinterest ovplyvňuje návštevnosť vášho obchodu a predaj vašich produktov.

    Táto integrácia vyžaduje nasadenie kontajnera servera pomocou preferovaného poskytovateľa cloudu a znalosti značkovania na strane servera. Ďalšie informácie o predpokladoch nájdete na lokalite pre vývojárov

    Shopify

    Toto rozhranie API na integráciu konverzií dopĺňa značku Pinterestu, aby bolo zabezpečené vysoké pokrytie a vysoká kvalita údajov. Pokiaľ je nainštalovaná aplikácia Shopify, na využitie tohto vylepšenia nie je potrebná žiadna akcia. Zmeny sa automaticky použijú v obchode obchodníka.

    Tealium

    Inzerenti, ktorí majú záujem o Tealium, môžu nastaviť rozhranie API pre konverzie priamo s treťou stranou. Tealium vytvára šablónu a pomôže uľahčiť integráciu s inzerentom. 

    Implementačný proces je opísaný v Centre vzdelávania pre Tealium. Akékoľvek otázky týkajúce sa podpory v súvislosti s implementáciou možno odoslať na adresu support [at] tealium.com (support[at]tealium[dot]com)

    Ak máte záujem o akékoľvek ďalšie integrácie tretích strán, obráťte sa na obchodného zástupcu a získajte viac informácií. 

    Pochopenie obmedzeného spracovania údajov

    Od 1. januára 2023 môžu inzerenti používať označenie obmedzeného spracovania údajov, aby boli v súlade s kalifornským zákonom o ochrane súkromia spotrebiteľov v znení kalifornského zákona o ochrane súkromia (ďalej spolu len „zákon CCPA“). Po zavedení tohto označenia Pinterest obmedzí používanie určitých údajov, čo pomôže inzerentom dodržiavať nastavenia ochrany súkromia používateľov. Inzerent môže napríklad implementovať označenie obmedzeného spracovania údajov používateľom z Kalifornie, ktorí podľa zákona CCPA odmietli predaj alebo zdieľanie svojich údajov. Keď sa použije označenie obmedzeného spracovania údajov, Pinterest bude podľa zákona CCPA v súvislosti s údajmi označenými používateľmi v Kalifornii pôsobiť ako poskytovateľ služieb.

    Pri implementácii označenia obmedzeného spracovania údajov sú inzerenti zodpovední za dodržiavanie odmietnutia používateľom, ako aj za identifikáciu štátu bydliska používateľa.

    End of Other articles Links
    Stále potrebujete pomoc? Kontaktujte nás
    User feedback
    Bol tento článok užitočný?

    collection_fields

    Ako môžeme tento článok zlepšiť?