Overview

Pinapayagan ng Pinterest API para sa mga Conversion ang mga advertiser na direktang magpadala ng mga conversion sa Pinterest sa pamamagitan ng pagkonekta ng mga server. Puwedeng gamitin ang mga conversion na na-capture gamit ang Pinterest API para sa muling pag-target sa mga campaign at puwedeng suriin ang mga ito sa reporting ng conversion para sa pinahusay na visibility ng conversion.

Sa pamamagitan ng Pinterest API para sa mga Conversion, puwedeng ipadala ng mga advertiser ang:

  • Mga conversion sa web
  • Mga Conversion sa App
  • Mga Offline na Conversion
  • Puwedeng matanggap ang mga event nang real-time o sa loob ng isang oras mula sa pagsisimula at pag-capture ng event. Ang mga event na natanggap sa labas ng window na ito o bilang bahagi ng naantalang batch event ay bibilangin bilang mga offline conversion. 

    Puwedeng makatulong ang paggamit ng Pinterest API para sa mga Conversion kasama ang Pinterest Tag na masulit ang visibility sa mga na-capture na conversion. Ang aming pinakamahusay na kasanayan ay ang gamitin ang parehong solution sa pag-capture ng conversion para tiyaking makakatanggap ka ng kumpletong view ng performance ng iyong campaign ng conversion.

    Ang Pinterest API

    Ang Pinterest API para sa mga Conversion ay isa sa ilang produkto na kasama sa aming Pinterest API ecosystem. Magagamit ng sinumang may account ng negosyo ng Pinterest ang Pinterest API para sa mga Conversion, pero hindi ito awtomatikong nagbibigay ng access sa mas malawak na Pinterest API. 

    Nasa Developer Platform ng Pinterest ang impormasyon sa lahat ng API product ng Pinterest. 

    Pagsisimula

    May access sa Pinterest API para sa mga Conversion ang sinumang may account ng negosyo ng Pinterest.

    Para magsimula, kakailanganin mo munang gumawa ng access token. Ang access token ay string ng mga character na tinitiyak na ginagawa ang mga kahilingan at ipinapadala pabalik sa account ng tamang user. 

    Para gumawa ng access token: 

  • Mag-log in sa iyong Account ng negosyo ng Pinterest
  • I-click ang Mga Ad sa menu sa itaas at piliin ang Mga Conversion
  • Piliin ang page ng access token ng Conversion mula sa kaliwang bahagi ng pag-navigate
  • I-click ang button na Gumawa ng bagong token
  • Kopyahin ang bagong access token at bumalik sa proseso ng pag-setup.
  • Kung sinusubukan mong mag-access ng account na hindi mo pagmamay-ari, kakailanganin mo munang i-set up ang Business Access. 

    Pagpapatupad

    Mga Conversion Event: available rin sa pamamagitan ng Pinterest API para sa mga Conversion ang lahat ng uri ng event na maka-capture sa Pinterest Tag. Makikita mo ang kumpletong listahan ng mga event at karagdagang impormasyon tungkol sa kahalagahan ng mga ito sa aming Dokumentasyon ng Pinterest API Developer.

    Ang pagse-set up ng server to server API integration ay nangangailangan ng developer at mga engineering resource mula sa may-ari ng website. Ang dami ng teknikal na pagsisikap ng developer ay nag-iiba-iba depende sa:

  • Ang pagiging pamilyar ng iyong developer sa mga API integration. Kung hindi pa sila nakagawa dati ng API integration, maaaring may kailangan pa silang gawin.  Kung naipatupad mo na ang iba pang conversion API, ang iyong developer ay kailangan na lang gumawa ng ilang karagdagang pagbabago.
  • Ang bilang ng mga event na tina-track at kung ano nang yugto ng data ng proseso ang conversion ang ipapadala sa amin.
  • Kung ang isang advertiser ay gusto o kailangang gumamit ng 3rd party para mag-integrate (hal. Shopify, GTM, Tealium).
  • Kung ginagamit mo na ang Pinterest Tag

    Mahigpit naming inirerekomendang gamitin ang Pinterest API para sa mga Conversion kasama ng Pinterest Tag para matiyak na masulit mo ang iyong mga conversion. 

    Kung na-set up mo na ang Pinterest Tag dati, kakailanganin mong tiyakin na hindi binibilang nang dalawang beses ang mga conversion - isang beses sa pamamagitan ng Pinterest Tag, at isang beses sa pamamagitan ng API. 

    Para magawa ito, kakailanganin mong tiyakin na ibinabalik ang parameter na event_id sa mga conversion na na-capture ng Pinterest Tag at Pinterest API para sa mga Conversion. 

    Pagkatapos, tutukuyin ng aming system ang mga event_id bilang mga duplicate at ang unang conversion na na-capture lang ang papanatilihin. Para matiyak na tagumpay ang deduplication na ito, ang mga event_id na ito ay kakailanganing:

  • kailangang magkapareho ang mga event_id sa pagitan ng parehong conversion - Magna-navigate sa isang webpage ang isang tao at magfa-fire ng conversion ng pagbisita sa Page ang Pinterest Tag at Pinterest API. Kakailanganin ng dalawang conversion na magbalik ng mga tumutugmang event_id para matukoy ng aming system na iisang conversion ang mga ito. 
  • kailangang natatangi ang mga event_id para sa iba't ibang conversion - Magna-navigate sa isang webpage ang isang tao at magfa-fire ng conversion ng pagbisita sa Page ang Pinterest Tag at Pinterest API. Pagkatapos ay magdaragdag ang tao ng damit sa kanyang cart na magti-trigger sa AddToCart event na mag-fire sa Pinterest Tag at Pinterest API. Bagaman kailangang magtugma ng mga event_id na na-fire para sa parehong event, kailangang natatangi ang mga event_id na ipinapadala para sa event ng pagbisita sa Page at event na AddToCart. Sa ganitong paraan, makikilala ang mga ito ng aming system bilang hiwalay na mga event.
  • Batay sa event identifier na iyon at sa event_name, aalisin ng Pinterest ang anumang duplicate na event sa talaan, hangga't (a) hindi nangyari ang event offline (hindi offline ang action_source), at (b) matatanggap ng Pinterest ang mga duplicate na event sa loob ng 48 na oras ng isa't isa.

    I-verify ang iyong setup

    Kapag natapos mo nang i-set up ang API, puwede mong i-verify ang mga conversion event na natatanggap sa pamamagitan ng pagsususri sa:

  • Mga Response Code: puwedeng suriin ng developer nag-set sa ng iyong API integration ang mga response code na ibinalik sa bawat kahilingan na ibinalik pagkatapos mag-fire ng conversion. 
  • Page ng Deduplication sa Ads Manager: lalabas ang mga post-deduplicated na conversion sa Page ng Deduplication sa Ads Manager. Para i-access ang page ng deduplication:
    • Mag-log in sa iyong Account ng negosyo ng Pinterest
    • I-click ang Mga Ad sa menu sa itaas at piliin ang Mga Conversion
    • Piliin ang Deduplication mula sa kaliwang bahagi ng pag-navigate.
  • Kalidad at katatagan

    Ang katatagan ay ang status ng API para sa setup ng mga Conversion na nagpapahintulot sa pinakamataas na antas ng pagtugma ng signal at attribution. Tutulungan kami ng karagdagang data na ito na magbigay ng mas tamang pagre-report dahil nagbabago at nag-e-evolve ang mga patakaran sa industriya ng ad.

    Status ng Katatagan

    May dalawang kategorya ng  status ng katatagan: Maganda at Hindi Maganda. Makikita ang status ng iyong katatagan sa seksyon ng Kondisyon ng Conversion ng Ads Manager.

    Magandang katatagan

    Opsyon 1: Partikular na Coverage ng Identifier

  • Coverage ng identifier
    • 90% o higit pa sa mga event ay dapat may IP/UA, 
    • 10% o higit pa sa mas mababang funnel na mga event ang naka-hash ng Email o MAID, 
    • 10% o higit pa sa mga event ang mayroong external id.
  • Mag-overlap sa data ng Tag (kung saan naaangkop)
    • 90%* o higit pa sa mga Tag event ang dapat matanggap sa pamamagitan ng CAPI 
  • O:

    Opsyon 2: Makamit ang Base Match Rate

  • CAPI User Match rate 60% o higit pa
  • Mag-overlap sa data ng Tag (kung saan naaangkop)
  • 90%* o higit pa sa mga Tag event ang dapat matanggap sa pamamagitan ng CAPI 


  • Hindi magandang katatagan

    Anumang setup na Hindi Maganda.

    Mga Resilience ID at Signal

    Ipadala ang mga sumusunod na signal para maabot ang resilient advertiser status.

    Mga API ID/Signal Mga Timbang/Rank
    client_ip_address + client_user_agent Mataas
    em Mataas
    external_id Mataas
    hashed_maid Mataas
    click_id Mataas
    fn + ln Mababa
    ph Mababa
    ge, bd, ct, st, zp, bansa Mababa

    *Weights/rank batay sa probability ng pagdagdag ng match rate

    Pagpapatupad ng Third Party

    Maraming Third Party Integration ang Pinterest para tulungang suportahan ang iyong proseso ng paggamit ng API. 

    Google Tag Manager - Panig ng Server

    Ikonekta ang iyong Google Tag Manager account sa Pinterest API para sa mga Conversion para malaman kung gaano nakakaimpluwensiya ang Pinterest sa traffic sa iyong store at mga benta ng iyong mga produkto.

    Hinihiling ng integration na ito na i-deploy mo ang isang server container gamit ang gusto mong cloud provider at kaalaman sa side tagging ng server.Para sa higit pang impormasyon sa mga kinakailangan, bisitahin ang developer site

    Shopify

    Ang bagong API na ito para sa integration ng mga Conversion ay sumusuporta sa Pinterest Tag para matiyak ang mataas na pagsaklaw at kalidad ng data. Hangga't naka-install ang Shopify app, walang kinakailangang aksyon para samantalahin ang pagpapahusay na ito. Awtomatikong gagamitin ang mga pagbabago sa store ng merchant.

    Tealium

    Puwedeng i-set up ng mga advertiser na interesado sa Tealium ang API para sa mga Conversion sa third party. Binubuo ng Tealium ang template at tutulong itong pangasiwaan ang integration sa advertiser. 

    Nakabalangkas ang proseso ng pagpapatupad sa Learning Center ng Tealium. Puwedeng ipadala ang anumang tanong sa suporta sa pagpapatupad sa support [at] tealium.com (support[at]tealium[dot]com)

    Kung interesado ka sa anumang karagdagang integration ng third party, makipag-ugnayan sa iyong kinatawan ng sales para sa higit pang impormasyon. 

    Pag-unawa sa Pagproseso ng Limitadong Data

    Simula Enero 1, 2023, puwedeng gamitin ng mga advertiser ang flag na Pagproseso ng Limitadong Data para tulungan silang sumunod sa California Consumer Privacy Act na binago batay sa California Privacy Rights Act (magkasama bilang CCPA). Kapag ginamit ang flag na ito, lilimitahan ng Pinterest kung paano namin ginagamit ang ilang data para tulungan ang mga advertiser na sumunod sa mga setting ng privacy ng user. Halimbawa, puwedeng ipatupad ng advertiser ang flag na Pagproseso ng Limitadong Data para sa mga user sa California na nag-opt out sa pagbebenta o pagbabahagi ng kanilang data sa ilalim ng CCPA. Kapag ginamit ang flag na Pagproseso ng Limitadong Data, magsisilbing provider ng serbisyo ang Pinterest sa ilalim ng CCPA kaugnay ng mga naka-flag na data mula sa mga user sa California.

    Pananagutan ng mga advertiser na sumunod sa mga opt-out ng user, pati na rin ang pagtukoy sa estado ng residency ng user kapag ipinapatupad ang Limited Data Processing flag.

    End of Other articles Links
    Kailangan pa rin ng tulong? Kontakin kami
    User feedback
    Nakatulong ba ang article na ito?

    collection_fields

    Paano namin mapapaganda ang article na ito?