Pinterest Conversions API Shopifylle: käyttöönoto-opas

Pinterest Conversions API on Pinterestin palvelin–palvelin-tapa lähettää konversiotapahtumia. Kauppasi tai työkalu, kuten ROASaurus, lähettää tapahtumia, kuten ostoja, suoraan Pinterest-mainostilillesi sen sijaan, että luottaisi pelkästään ostajan selaimessa olevaan Pinterest Tagiin. Pinterest käyttää dataa konversioraportointiin, kampanjoiden optimointiin ja kohdentamiseen.

Tämä opas käsittelee v5 API:a ja sen hyväksymiä tapahtumia, epik-klikkaus-ID:tä, asiakasdatan hashausta, deduplikoinnin toimintaa Pinterest Tagin kanssa, testaamista sekä sitä, miten kaikki otetaan käyttöön Shopifyssa.

Mikä on Pinterest Conversions API?

Pinterest Tag on skripti ostajan selaimessa. Conversions API tekee saman työn palvelimelta. API-versiossa 5 lähetät tapahtumat mainostilisi events-päätepisteeseen, valtuutettuna konversioiden käyttöoikeustunnuksella (access token), jonka luot Pinterest Ads Managerissa. Jokainen tapahtuma kertoo, missä se tapahtui: verkkokaupalle action source on web.

Pinterest pyytää mainostajia, jotka käyttävät myös Tagia, välttämään konversion laskemista kahdesti välittämällä event_id:n jokaisen tapahtuman mukana. Se pyytää myös tapahtumia reaaliajassa tai viimeistään tunnin kuluttua niiden tapahtumisesta.

Shopifyssa palvelinyhteydellä on yksi selvä etu: ostot tulevat itse tilauksesta. Shopify ilmoittaa jokaisesta maksetusta tilauksesta ROASaurukselle webhookilla, ja ROASaurus lähettää sen Pinterestille pian maksun jälkeen riippumatta siitä, laukesiko Tag selaimessa. Shopifyn palvelinpuolen seurannan opas selittää ajatuksen tarkemmin.

Mitä tapahtumia Pinterest Conversions API hyväksyy?

Pinterestillä on kiinteä lista vakiotapahtumien nimistä, jotka kirjoitetaan pienillä kirjaimilla ja alaviivoilla, kuten page_visit, add_to_cart ja checkout. Voit määritellä myös enintään 15 mukautettua tapahtumatyyppiä mainostajaa kohden. ROASaurus yhdistää Shopifyn viisi ostoprosessin tapahtumaa näin:

Nimi voi hämmentää. Pinterestin checkout on valmis osto, ei kassan aloitus. Kassan aloitus on erillinen tapahtuma, initiate_checkout.

Kassatapahtumaa varten Pinterest suosittelee lähettämään arvon, valuutan, tilaus-ID:n, content ID:t ja tuotteiden määrän. ROASaurus lähettää kaikki viisi sekä kunkin tuotteen määrän ja hinnan. Pinterest pyytää arvon ennen veroa ja toimitusta. Shopifyssa ROASaurus lähettää täsmälleen sen: tilauksen loppusumman miinus vero ja toimitus, sekä palvelimelta että selaintagista. Kun verkkokauppa-alusta ei ilmoita veroa ja toimitusta erikseen, ROASaurus lähettää tilauksen loppusumman.

Miten Pinterest yhdistää tapahtuman henkilöön?

Jokaisessa tapahtumassa on käyttäjädataa. Pinterest vaatii vähintään yhden kolmesta: hashatun sähköpostiosoitteen, hashatun mobiilimainostunnuksen tai IP-osoitteen yhdessä user agentin kanssa. Verkkokaupalla ei ole mainostunnusta, joten se tarvitsee sähköpostin tai IP-osoitteen ja user agentin. ROASaurus ohittaa tapahtuman, jolla ei ole kumpaakaan, sen sijaan että lähettäisi tapahtuman, jota Pinterest ei voi käyttää.

epik-klikkaus-ID

Pinterestin klikkaus-ID voi tulla kahdesta paikasta: laskeutumissivun URL-osoitteen epik-parametrista tai verkkotunnuksesi _epik-evästeestä. Pinterestin API-opas suosittelee välittämään _epik-evästeen arvon, koska se toimii edelleen, kun URL-parametri puuttuu tai se on poistettu, mikä antaa paremman kattavuuden.

ROASaurus lukee molemmat verkkokaupassasi ja käyttää URL-parametria, kun uusi klikkaus tuo sellaisen, ja muuten evästettä. Se tallentaa klikkaus-ID:n kävijän mukana ja lähettää sen jokaisen palvelintapahtuman click_id-kentässä, myös ostossa. Käynnit, joilla on epik, lasketaan Pinterest-käynneiksi ROASaurusin attribuutioraporteissa.

POST https://api.pinterest.com/v5/ad_accounts/549755885175/events

{
  "data": [{
    "event_name": "checkout",
    "action_source": "web",
    "event_time": 1793016000,
    "event_id": "order-5512345678901",
    "event_source_url": "https://example-store.com/checkouts/…/thank-you",
    "user_data": {
      "em": ["a3f1…9c2e"],
      "ph": ["7b40…11d8"],
      "external_id": ["e05c…4a7f"],
      "client_ip_address": "203.0.113.24",
      "client_user_agent": "Mozilla/5.0 (iPhone; …)",
      "click_id": "dj0yJnU9…"
    },
    "custom_data": {
      "currency": "USD",
      "value": "84",
      "order_id": "5512345678901",
      "content_ids": ["44123456789"],
      "contents": [{ "id": "44123456789", "quantity": 2, "item_price": "42" }],
      "num_items": 2
    }
  }]
}

Miten deduplikointi Pinterest Tagin kanssa toimii?

Jos Tag ja API raportoivat molemmat oston, Pinterest saa kaksi tapahtumaa yhdestä tilauksesta. Jotta ne käsitellään yhtenä, tarvitaan sama tunnus molemmin puolin: Tagin tapahtuma-ID:n täytyy vastata palvelintapahtuman event_id-arvoa. Pinterest säilyttää ensimmäisen vastaanottamansa tapahtuman ja poistaa 48 tunnin sisällä saapuvat päällekkäiset tapahtumat.

ROASaurus rakentaa oston tunnuksen Shopifyn tilaus-ID:stä. Tilauksen 5512345678901 ostolla on tapahtuma-ID order-5512345678901 sekä kassalla laukeavassa Tagissa että palvelintapahtumassa.

Kaikki viisi tapahtumaa deduplikoidaan

Jokaisella ROASaurusin ostoprosessin tapahtumalla on yksi tapahtuma-ID, jota käyttävät sekä Tag selaimessa että palvelintapahtuma. Tag käyttää samoista tapahtumista Pinterestin omia nimiä: pagevisit, viewcontent, addtocart, initiatecheckout ja checkout, jotka vastaavat API:n nimiä page_visit, view_content, add_to_cart, initiate_checkout ja checkout. Kun molemmat ovat käytössä, Pinterest säilyttää yhden kopion jokaisesta sivukäynnistä, tuotteen katselusta, ostoskoriin lisäyksestä, kassan aloituksesta ja ostosta.

Voit ajaa sen kahdella tavalla:

• Tag ja Conversions API yhdessä. Tag lisää selainsignaalit, palvelin täyttää sen, minkä Tag jättää väliin, ja Pinterest yhdistää kopiot.
• Aja API:a ilman Tagia. Jätä Tag ID tyhjäksi tai kytke pois Also load the browser tag. Jokainen tapahtuma lähetetään silloin kerran, vain palvelimelta.

Kaksoislaskentaa käsittelevä ohjeartikkeli käy läpi samat tarkistukset muille mainosalustoille.

Miten Pinterest Conversions API:a testataan?

API:ssa on testilippu. Pyynnöt, jotka lähetetään arvolla test=true, menevät hiekkalaatikkoon: Pinterest käsittelee ne testidatana eikä käytä niitä raportointiin tai optimointiin.

1. Kytke testitila päälle

   Muokkaa ROASaurusissa Pinterest-pikseliä kohdassa Tracking & platforms ja rastita Test mode (events show under Test events, max 20). Jokainen palvelintapahtuma lähetetään silloin arvolla test=true. Pinterest käsittelee enintään 20 testitapahtumaa erää kohden.

2. Tee testitilaus

   Käy kaupassasi, katso tuotetta, lisää se ostoskoriin ja tee tilaus loppuun.

3. Lue tulos

   Avaa Event log. Pinterest voi vastata HTTP 200:lla, vaikka yksi pyynnön tapahtuma epäonnistui, joten ROASaurus tarkistaa jokaisen tapahtuman tilan ja näyttää virheet siellä.

4. Kytke testitila pois

   Poista testitilan valinta, jotta tapahtumat lasketaan raportointiin ja optimointiin.

5. Tarkista Events Overview

   Avaa Pinterest Ads Managerissa Events Overview -sivu. Se näyttää saapuvat tapahtumat ja deduplikoidut konversiot. Pinterest suosittelee tavoittelemaan hyvää Event Quality Scorea.

Miten Pinterest Conversions API otetaan käyttöön Shopifyssa ROASaurusin avulla

Tarvitset Shopify-kaupan, jossa on ROASaurus-sovellus, sekä pääsyn Pinterest Ads Manageriin. Pinterest-integraatiosivu listaa kaikki kentät, jotka ROASaurus lähettää.

1. Yhdistä Shopify-kauppasi

   Siirry kohtaan Add a store › Shopify, klikkaa Install app ja kytke ROASaurus app embed päälle teemaeditorissa. Se tallentaa epikin ja _epik-evästeen jokaisella sivulla. Shopify-käyttöönotto-opas näyttää jokaisen vaiheen.

2. Luo konversioiden käyttöoikeustunnus

   Siirry Pinterest Ads Managerissa kohtaan Conversions ja luo konversioiden käyttöoikeustunnus. Merkitse muistiin mainostilisi ID.

3. Lisää Pinterest-pikseli ROASaurusiin

   Siirry kohtaan Tracking & platforms, klikkaa Pinterest-kortissa Add pixel ja täytä Ad account ID ja Conversion access token.

4. Lisää Tag ID

   Deduplikointia Tagin kanssa varten täytä Pinterest Tag ID ja pidä Also load the browser tag valittuna. Ilman Tag ID:tä ROASaurus lähettää vain palvelintapahtumia eikä lataa Tagia.

5. Lisää kassapikseli

   Siirry Shopify adminissa kohtaan Settings › Customer events, lisää mukautettu pikseli nimeltä ROASaurus ja liitä sivultasi Tracking & platforms löytyvä koodinpätkä. Se laukaisee Tagin checkout-tapahtuman Shopifyn kassalla ja käyttää tilaus-ID:tä arvona event_id.

6. Valitse palvelintapahtumat ja testaa

   Valitse haluamasi palvelintapahtumat ja testaa testitilassa ennen kuin otat käyttöön.

Kun Respect visitor consent on päällä, mikä on oletus, ROASaurus noudattaa ostajan valintaa Shopifyn evästebannerissa. Kun ostaja kieltäytyy markkinointievästeistä, ROASaurus ei lataa hänelle Pinterest Tagia, ei aseta kävijätunnusta, joten hänen klikkauksiaan ei yhdistetä häneen, eikä lähetä hänen selaustapahtumiaan Pinterestille. Hänen maksettu tilauksensa lähetetään silti Conversions API:lle palvelimelta hashatun tilausdatan sekä tilauksen IP-osoitteen ja user agentin kanssa, mutta ilman klikkaus-ID:tä. Suostumus- ja tietosuojaopas selittää, mitä tallennetaan ja lähetetään.

Yhdistä Pinterest-mainostilisi kohdassa Setup › Ad spend, niin ROASaurus hakee kampanjakulut tunnin välein ja näet Pinterestin ROAS:in ja voiton mainosten jälkeen voittoanalytiikassa. TikTok Events API -opas käsittelee saman käyttöönoton TikTokille, jossa jokainen molempia reittejä kulkeva tapahtuma deduplikoidaan.

Lähteet

1. Pinterest Developers: Track conversion events in the API
2. Pinterest Business help: The Pinterest Conversions API
3. Pinterest Developers: Track conversions with Pinterest Tag

ROASaurusissa

• Pinterest-integraatio
• Palvelinpuolen seuranta ROASaurus-palvelussa
• Ohje: estä kaksoislaskenta

Lue lisää