Prezentare generală

API-ul Pinterest pentru conversii le permite publicitarilor să trimită conversii direct către Pinterest, prin intermediul unei conexiuni server-la-server. Conversiile capturate cu ajutorul API-ului Pinterest pot fi folosite apoi pentru redirecționarea în campanii și pot fi examinate în secțiunea de raportare a conversiilor, pentru o vizibilitate îmbunătățită a conversiilor.

Cu ajutorul API-ului Pinterest pentru conversii, publicitarii pot trimite:

  • Conversii web
  • Conversii în aplicație
  • Conversii offline
  • Evenimentele pot fi primite în timp real sau în termen de o oră de la producerea și capturarea evenimentului. Evenimentele primite în afara acestui interval de timp sau ca parte a unui eveniment de lot întârziat vor fi contorizate drept conversii offline. 

    Folosirea API-ului Pinterest pentru conversii împreună cu marcajul Pinterest te poate ajuta să maximizezi vizibilitatea conversiilor capturate. Practică pe care o recomandăm presupune folosirea ambelor soluții de capturare a conversiilor, pentru a ne asigura că beneficiezi de o imagine completă asupra performanței campaniei tale de conversie.

    API-ul Pinterest

    API-ul Pinterest pentru conversii este unul dintre numeroasele produse din ecosistemul nostru de API-uri Pinterest. Orice persoană care are un cont Pinterest Business va putea folosi API-ul Pinterest pentru conversii, însă acest lucru nu permite în mod automat acces la API-ul Pinterest extins. 

    Platforma Pinterest pentru dezvoltatori conține informații despre toate produsele asociate API-ului Pinterest. 

    Începutul

    Orice persoană care are un cont Pinterest Business are acces la API-ul Pinterest pentru conversii.

    Pentru a începe, va trebui mai întâi să generezi un token de acces. Un token de acces este un șir de caractere care verifică dacă solicitările sunt făcute și returnate către contul de utilizator corect. 

    Pentru a genera un token de acces: 

  • Conectează-te la contul Pinterest Business
  • Fă clic pe Reclame în meniul de sus și alege Conversii
  • Selectează pagina Token de acces pentru conversie din panoul de navigare din partea stângă
  • Fă clic pe butonul Generează un token nou
  • Copiază noul token de acces și revino la procesul de configurare.
  • Dacă încerci să accesezi un cont pe care nu îl deții, va trebui mai întâi să configurezi Accesul business. 

    Implementarea

    Evenimente de conversie: toate tipurile de evenimente care pot fi capturate cu ajutorul marcajului Pinterest sunt disponibile și prin intermediul API-ului Pinterest pentru conversii. Poți găsi o listă completă a evenimentelor și informații suplimentare despre importanța lor în Documentația pentru dezvoltatori privind API-ul Pinterest.

    Configurarea unei integrări API server-la-server necesită resurse de dezvoltatori și inginerie de la proprietarul site-ului. Nivelul de efort pentru dezvoltatorul tehnic va varia în funcție de:

  • Familiaritatea dezvoltatorului tău cu integrările API-ului. Dacă nu a făcut niciodată o integrare API înainte, este posibil să necesite un efort suplimentar.  Dacă ai implementat alte modificări ale API-urilor pentru conversii, dezvoltatorul ar trebui să facă doar câteva modificări incrementale.
  • Numărul de evenimente urmărire și în ce etapă a procesului de conversie ni se vor trimite datele.
  • Dacă un publicitar dorește sau trebuie să folosească o terță parte pentru integrare (adică Shopify, GTM, Tealium).
  • Dacă folosești deja marcajul Pinterest

    Îți recomandăm să folosești API-ul Pinterest pentru conversii alături de marcajul Pinterest, pentru a te asigura că maximizezi conversiile. 

    Dacă ai configurat deja marcajul Pinterest, va trebui să te asiguri că nu contorizezi conversiile de două ori – o dată prin marcajul Pinterest și o dată prin API. 

    Pentru aceasta, va trebui să te asiguri că parametrul event_id este returnat împreună cu conversiile capturate atât de marcajul Pinterest, cât și de API-ul Pinterest pentru conversii. 

    Sistemul nostru va recunoaște apoi parametrii event_id ca dubluri și va păstra doar prima conversie capturată. Pentru ca eliminarea dublurilor să se realizeze succes:

  • Parametrii event_id trebuie să fie identici pentru aceleași conversii – o persoană navighează la o pagină web și o conversie bazată pe vizita pe pagină este declanșată atât de marcajul Pinterest, cât și de API-ul Pinterest. Pentru cele două conversii, parametri event_id returnați trebuie să corespundă, astfel încât sistemul nostru să recunoască faptul că este vorba de aceeași conversie. 
  • Parametrii event_id trebuie să fie unici pentru diferite conversii : o persoană navighează la o pagină web și o conversie bazată pe vizita pe pagină este declanșată atât de marcajul Pinterest, cât și de API-ul Pinterest. Persoana adaugă apoi un tricou în coș, ceea ce declanșează evenimentul AddToCart atât în marcajul Pinterest, cât și în API-ul Pinterest. Parametrii event_id declanșați pentru aceleași evenimente trebuie să corespundă, însă parametrii event_id trimiși pentru evenimentul de vizitare a paginii și, respectiv, pentru evenimentul de adăugare în coș trebuie să fie unici. În acest fel, sistemul nostru va recunoaște evenimentele ca fiind separate.
  • Pe baza identificatorului de eveniment și a parametrului event_name, Pinterest va elimina evenimentele duplicate din înregistrare, cu următoarele condiții: (a) evenimentul să nu aibă loc offline (action_source nu este offline) și (b) Pinterest primește evenimentele duplicate la un interval de cel mult 48 de ore.

    Verificarea configurației

    După ce termini configurarea API-ului, te poți asigura că primești evenimente de conversie verificând următoarele:

  • Coduri de răspuns: dezvoltatorul care a configurat integrarea API-ului poate examina codurile de răspuns returnate împreună cu fiecare solicitare returnată după declanșarea unei conversii. 
  • Pagina de eliminare a dublurilor din panoul de control al reclamelor: conversiile după eliminarea dublurilor se vor afișa în pagina de eliminare a dublurilor din panoul de control al reclamelor. Pentru a accesa pagina de eliminare a dublurilor:
    • Conectează-te la contul Pinterest Business
    • fă clic pe Reclame în meniul de sus și alege Conversii;
    • selectează Eliminare dubluri din panoul de navigare din partea stângă.
  • Calitate și rezistență

    Rezistența este starea configurării unui API pentru conversii care permite cel mai înalt nivel de potrivire și atribuire a semnalului. Aceste date suplimentare ne vor ajuta să oferim o raportare mai precisă, pe măsură ce politicile din domeniul publicității se modifică și evoluează.

    Starea de rezistență

    Există două categorii de stare de rezistență: Bună și Slabă. Starea de rezistență este vizibilă în secțiunea Integritatea conversiilor din panoul de control al reclamelor.

    Rezistență bună

    Opțiunea 1: Acoperirea cu identificatori specifici

  • Acoperire cu identificatori
    • 90% sau mai mult dintre evenimente ar trebui să aibă IP/UA, 
    • 10% sau mai mult dintre evenimentele din partea inferioară a canalului au e-mail sau MAID criptate cu algoritmi hash, 
    • 10% sau mai mult dintre evenimente au ID extern.
  • Suprapunere cu datele Marcajului (dacă este cazul)
    • 90%* sau mai mult dintre evenimentele cu marcaje trebuie primite prin CAPI 
  • Sau:

    Opțiunea 2: Atinge rata de potrivire de bază

  • Rată de potrivire a utilizatorilor prin CAPI de minimum 60%
  • Suprapunere cu datele Marcajului (dacă este cazul)
  • 90%* sau mai mult dintre evenimentele cu marcaje trebuie primite prin CAPI 


  • Rezistență slabă

    Orice configurație care nu este bună.

    ID-uri și semnale de rezistență

    Trimite următoarele semnalele pentru a obține starea de publicitar rezilient.

    ID-urile/Semnalele API-ului Pondere/Clasificare
    client_ip_address + client_user_agent Ridicată
    em Ridicată
    external_id Ridicată
    hashed_maid Ridicată
    click_id Ridicată
    fn + ln Scăzută
    ph Scăzută
    ge, bd, ct, st, zp, țară Scăzută

    *Ponderi/clasificări bazate pe probabilitatea de îmbunătățire a ratei de potrivire

    Implementări ale unor soluții terțe

    Pinterest are mai multe integrări de soluții terțe pentru a susține procesul de adoptare a API-urilor. 

    Google Tag Manager – pe partea de server

    Conectează-ți contul Google Tag Manager la API Pinterest pentru conversii pentru a afla în ce măsură Pinterest influențează traficul către magazinul tău și vânzările produselor tale.

    Această integrare necesită implementarea unui container de server folosind furnizorul de cloud preferat și cunoștințele de marcaje de pe partea de server. Pentru mai multe informații despre cerințele prealabile, vizitează site-ul dezvoltatorului

    Shopify

    Acest API pentru integrarea conversiilor vine în completarea marcajului Pinterest pentru a asigura o acoperire și o calitate înaltă a datelor. Atât timp cât aplicația Shopify este instalată, nu este necesară nicio acțiune pentru a profita de această îmbunătățire. Modificările vor fi aplicate automat magazinului comerciantului.

    Tealium

    Publicitarii interesați de Tealium, pot configura API-ul pentru conversii direct cu partea terță. Tealium construiește șablonul și va ajuta la facilitarea integrării cu publicitarul. 

    Procesul de implementare este prezentat in Centrul de învățare Tealium. Poți trimite întrebările legate de asistența pentru implementare la support [at] tealium.com (support[at]tealium[dot]com)

    Dacă te interesează integrări suplimentare de servicii terțe, contactează reprezentantul de vânzări pentru a obține mai multe informații. 

    Înțelegerea procesării limitate a datelor

    Începând cu 1 ianuarie 2023, publicitarii pot folosi un marcaj de procesare limitată a datelor pentru a respecta Legea privind confidențialitatea consumatorilor din California, modificată de Legea privind confidențialitatea din California (împreună, CCPA). Dacă este implementat acest marcaj, Pinterest va limita modul în care utilizăm anumite date pentru a-i ajuta pe publicitari să respecte setările de confidențialitate ale utilizatorilor. De exemplu, un publicitar ar putea implementa marcajul de procesare limitată a datelor pentru utilizatorii din California care au ales să renunțe la vânzarea sau distribuirea datelor lor în temeiul CCPA. Când se utilizează marcajul de procesare limitată a datelor, Pinterest va acționa ca furnizor de servicii în temeiul CCPA cu privire la datele semnalizate de utilizatorii din California.

    Când implementează marcajul de procesare limitată a datelor, publicitarii își asumă responsabilitatea de a respecta renunțările utilizatorilor și de a identifica statul de reședință al utilizatorilor.

    End of Other articles Links
    Încă mai ai nevoie de asistență? Contactează-ne
    User feedback
    Acest articol a fost util?

    collection_fields

    Cum am putea îmbunătăți acest articol?