Áttekintés

A konverziós Pinterest API lehetővé teszi a hirdetőknek, hogy közvetlenül a Pinterestnek küldjenek konverziókat szerverek közötti kapcsolattal. A Pinterest API-val rögzített konverziók ezután újracélzásra használhatók a kampányokban, és a konverziós jelentésekben ellenőrizhetők a jobb konverziós láthatóság érdekében.

A konverziós Pinterest API-val a hirdetők a következőket küldhetik:

  • Webes konverziók
  • Alkalmazáson belüli konverziók
  • Offline konverziók
  • Az események valós időben vagy az esemény bekövetkeztét és rögzítését követő egy órán belül fogadhatók. Az ezen az időablakon kívül vagy egy késleltetett csoportos esemény részeként beérkezett események offline konverzióként lesznek számítva. 

    Ha a konverziós Pinterest API-t használod a Pinterest-címkével együtt, azzal maximalizálhatod a rögzített konverziók láthatóságát. Bevált gyakorlatunk, hogy mindkét konverziórögzítési megoldást alkalmazzuk annak érdekében, hogy átfogó képet kapj a konverziós kampányod teljesítményéről.

    A Pinterest API

    A konverziós Pinterest API az egyik olyan termékünk, amely a Pinterest-API-ökoszisztéma területén található. Bárki, akinek üzleti Pinterest-fiókja van, használhatja a konverziós Pinterest API-t, de ez nem ad automatikusan hozzáférést a szélesebb Pinterest API-hoz. 

    A Pinterest fejlesztői platformja a Pinterest összes API-termékéről tartalmaz információt. 

    Első lépések

    Bárki, akinek üzleti Pinterest-fiókja van hozzáférhet a konverziós Pinterest API-hoz.

    Ehhez először is létre kell hoznod egy hozzáférési tokent. A hozzáférési token egy olyan karaktersorozat, amely ellenőrzi a kérelmeket, és visszaküldi őket a megfelelő felhasználói fiókba. 

    Hozzáférési token létrehozása: 

  • Jelentkezz be a Pinterest Business fiókodba
  • Kattints a Hirdetések gombra a felső menüben, és válaszd a Konverziók lehetőséget
  • Válaszd ki a konverziós hozzáférési token oldalát a bal oldali navigációs területen
  • Kattints az Új token generálása gombra
  • Másold ki az új hozzáférési tokent, és térj vissza a telepítési folyamathoz.
  • Ha olyan fiókhoz szeretnél hozzáférni, ami nem a te fiókod, akkor először be kell állítanod az Üzleti hozzáférést. 

    Végrehajtás

    Konverziós események: az összes, Pinterest-címkén rögzíthető eseménytípus a konverziós Pinterest API-hoz is elérhető. A Pinterest API fejlesztői dokumentációjában teljes listát találhatsz az eseményekről és jelentőségükkel kapcsolatos további információkról.

    A szerverek közötti API-integráció beállításához fejlesztői és mérnöki erőforrásokra van szükség a webhely tulajdonosától. A szükséges műszaki fejlesztői erőfeszítések mértéke a következőktől függ:

  • Milyen ismeretekkel rendelkezik a fejlesztőd az API-integrációkkal kapcsolatban? Ha még soha nem készített API-integrációt, akkor további munkára lehet szükség.  Ha már megvalósítottál más konverziós API-kat, a fejlesztődnek csak néhány módosítást kell elvégeznie.
  • Mennyi a nyomon követett események száma, valamint a konverziós folyamat mely szakaszában érkeznek meg hozzánk az adatok?
  • Ha egy hirdető harmadik felet akar vagy kell használnia az integrációhoz (pl. Shopify, GTM, Tealium).
  • Ha már használod a Pinterest-címkét

    Erősen ajánljuk, hogy a konverziós Pinterest API-t a Pinterest-címkével együtt használd, így maximalizálhatod a konverziókat. 

    Ha már korábban beállítottad a Pinterest-címkét, biztosítanod kell, hogy a konverziókat ne számold kétszer: egyszer a Pinterest-címkén, egyszer pedig az API-n keresztül. 

    Ennek eléréséhez ellenőrizd, hogy az event_id paramétert visszaküldjük-e a Pinterest-címke és a konverziós Pinterest API által rögzített konverziók segítségével. 

    Ezután rendszerünk felismeri az event_id paramétereket duplikált példányként, és csak az első rögzített konverziót őrzi meg. Annak érdekében, hogy a duplikálás megszüntetése sikeres legyen, az event_id paramétereknek a következőknek kell megfelelniük:

  • az event_id paramétereknek azonosaknak kell lenniük ugyanazon konverziók között: valaki egy weboldalra navigál, és az oldallátogatás-konverziót a Pinterest-címke és a Pinterest API is aktiválja. A két konverziónak egyező event_id paramétereket kell visszaküldenie, hogy rendszerünk felismerje, hogy azonos konverziókról van szó. 
  • az event_id paramétereknek egyedieknek kell lenniük a különböző konverziók között: valaki egy weboldalra navigál, és az oldallátogatás-konverziót a Pinterest-címke és a Pinterest API is aktiválja. Ezután az illető egy pólót tesz a kosarába, ami az „AddToCart” eseményt aktiválja mind a Pinterest-címkén, mind a Pinterest API-n. Míg az azonos eseményekhez aktivált event_id paramétereknek egyezniük kell, az „Oldallátogatás” és az „AddToCart” eseményhez küldött event_id paramétereknek egyedieknek kell lenniük. Így rendszerünk külön eseményként ismeri fel őket.
  • Az adott eseményazonosító és az event_name alapján a Pinterest minden ismétlődő eseményt eltávolít a nyilvántartásból, feltéve, hogy (a) az esemény nem offline történt (az action_source nem offline), és (b) a Pinterest egymást követően 48 órán belül megkapja az ismétlődő eseményeket.

    Beállításaid ellenőrzése

    Miután befejezted az API beállítását, ellenőrizd, hogy a konverziós események a következők szerint érkeznek-e:

  • Válaszkódok: az API-integrációt beállító fejlesztő áttekintheti a konverzióaktiválások után visszaküldött kérésekre érkezett válaszkódokat. 
  • A Deduplikálás oldal a hirdetéskezelőben: a megszüntetett duplikált konverziók a hirdetéskezelő Deduplikálás oldalán jelennek meg. A Deduplikálás oldal eléréséhez:
    • Jelentkezz be a Pinterest Business fiókodba
    • Kattints a Hirdetések gombra a felső menüben, és válaszd a Konverziók lehetőséget
    • Válaszd ki a Deduplikálás lehetőséget a bal oldali navigációs területen.
  • Minőség és ellenálló képesség

    Az ellenálló képesség a konverziós API-beállítás állapota, amely lehetővé teszi a legmagasabb szintű jelegyeztetést és hozzárendelést. Ezek a további adatok segítenek nekünk pontosabb jelentést szolgáltatni, mivel a hirdetési iparág irányelvei változnak és fejlődnek.

    Az ellenálló képesség állapota

    Az ellenálló képesség állapotának két kategóriája van: a jó és az elégtelen. Ellenálló képességed állapotát a Hirdetéskezelő Konverziós állapot szakaszában találod.

    Jó ellenálló képesség

    1. lehetőség: Specifikus azonosítólefedettség

  • Azonosítólefedettség
    • Az események legalább 90%-ának rendelkezni kell IP/UA-val, 
    • A tölcsér alsó szakaszához tartozó események legalább 10%-a rendelkezik kivonatolt e-maillel vagy MAID-azonosítóval, 
    • Az események legalább 10%-a rendelkezik külső azonosítóval.
  • Átfedés a címkeadatokkal (ahol ez lehetséges)
    • A címkeesemények legalább 90%-át* a CAPI-n keresztül kell fogadni 
  • Vagy:

    2. lehetőség: Érd el az alap egyezési arányt

  • A CAPI-felhasználók egyezési aránya legalább 60%
  • Átfedés a címkeadatokkal (ahol ez lehetséges)
  • A címkeesemények legalább 90%-át* a CAPI-n keresztül kell fogadni 


  • Elégtelen ellenálló képesség

    Az összes nem megfelelő beállítás.

    Az ellenálló képesség azonosítói és jelei

    Küldd el a következő jeleket, hogy rugalmas hirdetői státuszt érhess el.

    API-azonosítók/jelek Súlyok/rang
    client_ip_address + client_user_agent Magas
    em Magas
    external_id Magas
    hashed_maid Magas
    click_id Magas
    fn + ln Alacsony
    ph Alacsony
    ge, bd, ct, st, zp, country Alacsony

    *Súlyok/rangok az egyezési arány növelésének valószínűsége alapján

    Harmadik fél általi végrehajtás

    A Pinterest számos harmadik féltől származó integrációval segíti az API-elfogadási folyamat támogatását. 

    Google Címkekezelő – szerveroldal

    Kapcsold össze Google Címkekezelő‑fiókodat a Konverziós Pinterest API‑val, hogy megtudhasd, milyen hatással van a Pinterest az áruházad forgalmára és a termékeid értékesítésére.

    Ehhez az integrációhoz egy szervertárolót kell megvalósítanod az általad preferált felhőszolgáltató használatával, és ismerned kell a szerveroldali címkézést. Az előfeltételekre vonatkozó további információkért látogass el a fejlesztői webhelyre

    Shopify

    A konverziós API integrációja kiegészíti a Pinterest‑címkét a magas adatfedettség és minőség biztosítására. Mindaddig, amíg a Shopify alkalmazás telepítve van, nincs szükség további teendőre ahhoz, hogy kiaknázhasd ennek a fejlesztésnek az előnyeit. A módosításokat automatikusan alkalmazza a rendszer a kereskedő áruházára.

    Tealium

    A Tealium iránt érdeklődő hirdetők közvetlenül a harmadik féllel állíthatják be a konverziós API-t. A Tealium kiépíti a sablont, és segíti az integrációt a hirdetővel. 

    A végrehajtási folyamatot a Tealium Tanulási Központjában találod. Ha bármilyen kérdésed van a végrehajtás támogatásával kapcsolatban, küldd el a support [at] tealium.com (support[at]tealium[dot]com) címre. 

    Ha kíváncsi vagy a további, harmadik féltől származó integrációkra, további információkért fordulj értékesítési képviselődhöz. 

    A korlátozott adatkezelés értelmezése

    2023. január 1‑jétől a hirdetőknek rendelkezésére áll a korlátozott adatkezelési jelölő, amely abban segít, hogy megfeleljenek a Kalifornia adatvédelemhez való jogról szóló törvényével módosított kaliforniai fogyasztói adatvédelmi törvénynek (közös nevükön „CCPA”). Ha a jelölő használatban van, akkor a Pinterest korlátozza, hogyan használunk fel bizonyos adatokat, így segítve a hirdetőket a felhasználói adatvédelmi beállítások betartásában. Például egy hirdető dönthet úgy, hogy korlátozott adatkezelési jelölőt alkalmaz azon kaliforniai felhasználók esetében, akik megtiltották adataik CCPA szerinti értékesítését vagy megosztását. Ha a korlátozott adatkezelési jelölő használatban van, a Pinterest a CCPA értelmében szolgáltatóként fog eljárni a kaliforniai felhasználóktól származó, jelölővel ellátott adatok tekintetében.

    A korlátozott adatkezelési jelölő használata esetén a hirdetők vállalják, hogy tiszteletben tartják a felhasználók értékesítés és megosztás letiltásával kapcsolatos döntését, valamint beazonosítják a felhasználó lakóhelye szerinti államot.

    End of Other articles Links
    További segítségre van szükséged? Lépj kapcsolatba velünk
    User feedback
    Hasznos volt ez a cikk?

    collection_fields

    Hogyan javíthatnánk a cikken?