Yleiskatsaus

Pinterestin tulos-API:n avulla mainostajat voivat lähettää tuloksia suoraan Pinterestiin palvelimelta palvelimelle. Pinterest-API:n avulla mitattuja tuloksia voidaan käyttää kampanjoiden uudelleenkohdistamiseen, ja niitä voidaan tarkastella tulosraporteissa tulosnäkyvyyden parantamiseksi.

Mainostajat voivat lähettää Pinterestin tulos-API:n kautta seuraavia tuloksia:

  • Web-tulokset
  • Sovellustulokset
  • Offline-tulokset
  • Tapahtumat voidaan vastaanottaa reaaliaikaisesti tai tunnin kuluessa tapahtumasta ja sen mittaamisesta. Tämän aikaikkunan ulkopuolella vastaanotetut tapahtumat sekä viivästyneet erätapahtumat luokitellaan offline-tuloksiksi. 

    Pinterestin tulos-API:n ja Pinterest-tunnisteen käyttäminen voi auttaa seuraamaan mitattuja tuloksia entistä tarkemmin. Pinterest suosittelee käyttämään molempia tulosten mittausratkaisuja saadaksesi kattavia tietoja tuloskampanjasi tehokkuudesta.

    Pinterest-API

    Pinterestin tulos-API on yksi Pinterestin API-tuotteista, joka on käytettävissä yritystilillä. Muut Pinterest-API:t eivät kuitenkaan ole automaattisesti käytettävissä yritystilillä. 

    Pinterest Developers Platform sisältää tietoa kaikista Pinterestin API-tuotteista. 

    Aloittaminen

    Pinterestin tulos-API:a voi käyttää Pinterestin yritystilillä.

    Luo aluksi käyttöoikeustietue, joka tarkistaa, että pyynnöt tehdään ja lähetetään takaisin oikean käyttäjän tilille. 

    Käyttöoikeustietueen luominen: 

  • Kirjaudu sisään Pinterest-yritystiliin.
  • Valitse ylävalikosta Mainokset ja sitten Tulokset.
  • Valitse vasemmalta Tulosten käyttöoikeustietue -sivu.
  • Napsauta Luo uusi tietue.
  • Kopioi uusi käyttöoikeustietue ja palaa määritykseen.
  • Jos yrität käyttää jonkun muun omistamaa tiliä, määritä ensin Business-käyttö. 

    Käyttöönotto

    Tulostapahtumat: Kaikki Pinterest-tunnisteella mitattavissa olevat tapahtumatyypit ovat mitattavissa myös Pinterestin tulos-API:n kautta. Lisätietoja tapahtumista ja niiden merkityksestä on Pinterestin kehittäjien API-dokumentaatiossa.

    Palvelinten välisen API-integraation asettaminen vaatii verkkosivuston omistajalta kehittäjä- ja suunnitteluresursseja. Teknisen kehittäjän työmäärä vaihtelee riippuu seuraavista seikoista:

  • Kehittäjän API-integraatiokokemus. Jos hän ei ole koskaan aiemmin tehnyt API-integraatiota, se voi vaatia lisätyötä.  Jos käytössä on muitakin tulos-API:ta, kehittäjän tarvitsee tehdä vain muutamia lisämuutoksia.
  • Seurattavien tapahtumien määrä ja se, missä tulosprosessin vaiheessa tiedot lähetetään Pinterestille.
  • Haluaako mainostaja käyttää tai tarvitseeko hänen käyttää kolmatta osapuolta integraatioon (esim. Shopify, GTM, Tealium).
  • Jos käytät jo Pinterest-tunnistetta

    Pinterest suosittelee vahvasti käyttämään sekä Pinterestin tulos-API:a että Pinterest-tunnistetta, mikä auttaa maksimoimaan tuloksia. 

    Jos olet jo määrittänyt Pinterest-tunnisteen aiemmin, varmista, että tuloksia ei lasketa kahteen kertaan Pinterest-tunnisteen ja API:n kautta. 

    Varmista, että event_id lähetetään Pinterest-tunnisteen ja Pinterestin tulos-API:n avulla mitattujen tulosten mukana. 

    Järjestelmä tunnistaa event_id-parametrien kaksoiskappaleet ja säilyttää vain ensimmäisen mitatun tuloksen. Jotta kaksoiskappaleiden poisto onnistuu:

  • Samoilla tuloksilla tulee olla identtinen event_id: Pinterest-tunniste ja Pinterest-API käynnistävät sivukäyntituloksen, kun käyttäjä siirtyy sivustolle. Tulosten täytyy lähettää Pinterestille vastaavat event_id-parametrit, jotta järjestelmä tunnistaa, että kyseessä on sama tulos. 
  • Jokaisella tuloksella tulee olla eri event_id: Pinterest-tunniste ja Pinterest-API käynnistävät sivukäyntituloksen, kun käyttäjä siirtyy sivustolle. Pinterest-tunniste ja Pinterest-API käynnistävät AddToCart-tapahtuman, kun käyttäjä lisää ostoskoriin T-paidan. Vaikka samoilla tapahtumilla tulee olla identtinen event_id, sivukäyntitapahtumalla ja AddToCart-tapahtumalla tulee olla eri event_id, jotta Pinterest tunnistaa ne erillisiksi tapahtumiksi.
  • Pinterest poistaa tapahtumatunnisteen ja event_name-parametrin perusteella päällekkäiset tapahtumat edellyttäen, että (a) tapahtuma ei tapahtunut offline-tilassa (action_source ei ole offline-tilassa), ja (b) Pinterest vastaanottaa päällekkäiset tapahtumat 48 tunnin kuluessa toisistaan.

    Määrityksen vahvistaminen

    API:n määrittämisen jälkeen voit varmistaa tulostapahtumien vastaanottamisen tarkistamalla seuraavat:

  • Vastauskoodit: API-integraation määrittävä kehittäjä voi tarkistaa jokaisen pyynnön mukana lähetetyt vastauskoodit tulostapahtumien käynnistymisen jälkeen. 
  • Mainosten hallinnan kaksoiskappaleiden poistosivu: tulokset näkyvät kaksoiskappaleiden poiston jälkeen mainosten hallinnan kaksoiskappaleiden poistosivulla. Voit siirtyä kaksoiskappaleiden poistosivulle seuraavasti:
    • Kirjaudu sisään Pinterest-yritystiliin.
    • Valitse ylävalikosta Mainokset ja sitten Tulokset.
    • Valitse vasemmalta Kaksoiskappaleiden poisto.
  • Laatu ja kestävyys

    Kestävyys on tulos-API:n määrityksen tila, jonka avulla voidaan varmistaa, että signaalit yhdistetään ja määritetään oikein. Näiden lisätietojen avulla Pinterest voi antaa tarkempia raportteja mainosalan käytäntöjen muuttuessa ja kehittyessä.

    Kestävyysluokitus

    Kestävyystasoja on kaksi: Hyvä sekä Heikko. Kestävyysluokitus näkyy mainosten hallinnan Tulosongelmat-osiossa.

    Hyvä kestävyys

    Vaihtoehto 1: Tunnusten kattavuus

  • Tunnusten kattavuus
    • Vähintään 90 prosentilla tapahtumista tulee olla IP/UA. 
    • Vähintään 10 % suppilon alaosan tapahtumista on salattuja sähköposteja tai MAID-tiedostoja. 
    • Vähintään 10 prosentilla tapahtumista on ulkoinen tunnus.
  • Päällekkäisyys tunnistetietojen kanssa (soveltuvin osin)
    • Vähintään 90 prosenttia* tunnistetapahtumista tulee vastaanottaa tulos-API:n kautta. 
  • Tai:

    Vaihtoehto 2: Saavuta perusvastaavuusaste

  • Tulos-API:n käyttäjien vastaavuusaste vähintään 60 %
  • Päällekkäisyys tunnistetietojen kanssa (soveltuvin osin)
  • Vähintään 90 prosenttia* tunnistetapahtumista tulee vastaanottaa tulos-API:n kautta. 


  • Heikko kestävyys

    Muut määritykset, joiden luokitus ei ole Hyvä.

    Kestävyystunnukset ja signaalit

    Lähetä seuraavat signaalit, niin voit saavuttaa kestävyysluokituksen.

    API-tunnukset/signaalit Painotus/sijoitus
    client_ip_address + client_user_agent Korkea
    em Korkea
    external_id Korkea
    hashed_maid Korkea
    click_id Korkea
    fn + ln Alhainen
    ph Alhainen
    ge, bd, ct, st, zp, country Alhainen

    *Painotus/sijoitus vastaavuusasteen parantumisen todennäköisyyden perusteella

    Ulkoiset integraatiot

    Pinterestillä on useita API:n käyttöönottoa helpottavia ulkoisia integraatioita. 

    Google Tag Manager – palvelinpuoli

    Kun käytät Google Tag Manager -tiliä ja Pinterestin tulos-API:a, saat tietoja siitä, miten paljon Pinterest vaikuttaa liikenteeseen ja myyntiin.

    Integrointi edellyttää, että otat palvelinsäilön käyttöön haluamallasi pilvipalvelulla ja palvelinpuolen tunnisteiden tuntemusta. Lisätietoja edellytyksistä on kehittäjäsivustolla

    Shopify

    Tämä tulos-API täydentää Pinterest-tunnistetta korkean kattavuuden ja laadun varmistamiseksi. Jos olet asentanut Shopify-sovelluksen, voit hyödyntää parannusta ilman erillisiä toimenpiteitä. Muutokset otetaan automaattisesti käyttöön myyjän kaupassa.

    Tealium

    Tealiumista kiinnostuneet mainostajat voivat ottaa tulos-API:n käyttöön suoraan kolmannen osapuolen kanssa. Tealium kehittää mallia ja helpottaa integrointia mainostajan kanssa. 

    Lisätietoja toteutuksesta on Tealiumin ohjekeskuksessa. Toteutustukea koskevat kysymykset voi lähettää osoitteeseen support [at] tealium.com (support[at]tealium[dot]com)

    Jos olet kiinnostunut muista ulkoisista integraatioista, pyydä lisätietoja myyntiedustajaltasi. 

    Lisätietoja rajoitetusta tietojenkäsittelystä

    Mainostajat voivat 1.1.2023 alkaen käyttää rajoitetun tietojenkäsittelyn merkintää, joka auttaa heitä noudattamaan Kalifornian kuluttajan yksityisyyttä koskevaa lakia (California Consumer Privacy Act), sellaisena kuin se on muutettuna Kalifornian tietosuojalailla (California Privacy Rights Act) (yhdessä CCPA). Kun tämä merkintä on käytössä, Pinterest rajoittaa tiettyjen tietojen käyttöä, mikä auttaa mainostajia noudattamaan käyttäjien tietosuoja-asetuksia. Mainostaja voi esimerkiksi ottaa käyttöön rajoitetun tietojenkäsittelyn merkinnän kalifornialaisille käyttäjille, jotka ovat kieltäneet tietojensa myynnin tai jakamisen CCPA-lain mukaan. Kun rajoitetun tietojenkäsittelyn merkintää käytetään, Pinterest toimii CCPA-lain mukaisena palveluntarjoajana kalifornialaisilta käyttäjiltä saatujen merkittyjen osalta.

    Mainostajat ovat vastuussa käyttäjien estoasetusten noudattamisesta sekä asuinpaikan tunnistamisesta rajoitetun tietojenkäsittelyn merkinnän käyttämisen yhteydessä.

    End of Other articles Links
    Tarvitsetko lisäapua? Ota yhteyttä
    User feedback
    Oliko ohje hyödyllinen?

    collection_fields

    Miten voisimme parantaa sitä?