L'API di Pinterest per le conversioni consente agli inserzionisti di inviare le conversioni direttamente a Pinterest mediante un collegamento server-to-server. Le conversioni catturate con l'API di Pinterest possono essere utilizzate per il retargeting nelle campagne e possono essere esaminate nei report sulle conversioni per ottenere una maggiore visibilità delle conversioni.
Mediante l'API di Pinterest per le conversioni, gli inserzionisti possono inviare:
Gli eventi possono essere ricevuti in tempo reale o entro un'ora dal loro verificarsi e dall'acquisizione. Gli eventi ricevuti al di fuori di questa finestra, o come parte di un evento batch differito, verranno conteggiati come conversioni offline.
L'utilizzo dell'API di Pinterest per le conversioni, con il tag di Pinterest, può aiutarti a ottimizzare la visibilità delle conversioni acquisite. La nostra best practice consiste nell'utilizzare entrambe le soluzioni di acquisizione delle conversioni per assicurarti di ricevere una visione completa delle prestazioni delle tue campagne di conversione.
L'API di Pinterest per le conversioni è uno dei numerosi prodotti che si trovano nel nostro ecosistema API di Pinterest. Chiunque disponga di un account per aziende Pinterest potrà utilizzare l'API di Pinterest per le conversioni. Questo però non garantisce l'accesso automatico all'API di Pinterest più ampio.
La
Chiunque disponga di un account per aziende Pinterest ha accesso all'API di Pinterest per le conversioni.
Per iniziare, devi prima generare un token di accesso. Un token di accesso è una stringa di caratteri che verifica che le richieste siano effettuate e restituite all'account dell'utente corretto.
Per generare un token di accesso:
Se stai cercando di accedere a un account che non ti appartiene, prima devi configurare Business Access.
Eventi di conversione: tutti i tipi di eventi disponibili per l'acquisizione sul tag di Pinterest sono disponibili anche tramite l'API di Pinterest per le conversioni. Puoi trovare l'elenco completo degli eventi e ulteriori informazioni sulla loro importanza nella nostra
La creazione di un'
Ti consigliamo di utilizzare l'API di Pinterest per le conversioni e il tag di Pinterest per assicurarti di ottimizzare le conversioni.
Se hai già configurato il tag di Pinterest, dovrai assicurarti che le conversioni non siano conteggiate due volte: una volta tramite il tag di Pinterest e una volta tramite l'API.
Devi quindi assicurarti che il parametro event_id venga restituito con le conversioni acquisite sia dal tag di Pinterest che dall'API di Pinterest per le conversioni.
Il nostro sistema riconoscerà quindi i valori event_id come duplicati e manterrà solo la prima conversione catturata. Affinché la deduplicazione venga annullata, i valori event_id dovranno essere:
Sulla base dell'identificatore evento e del valore event_name, Pinterest rimuoverà tutti gli eventi duplicati dal record, se (a) l'evento non è avvenuto offline (il valore action_source non è offline) e (b) Pinterest riceve gli eventi duplicati entro 48 ore l'uno dall'altro.
Dopo aver terminato la configurazione dell'API, puoi verificare la ricezione degli eventi di conversione, controllando:
- Accedi al tuo
account per aziende Pinterest - Fai clic su Annunci nella parte superiore del menu e scegli Conversioni
- Seleziona Deduplicazione dalla barra di navigazione sul lato sinistro dello schermo.
La resilienza è lo stato di una configurazione API per le conversioni che consente il più alto livello di corrispondenza del segnale e di attribuzione. Questi dati aggiuntivi ci aiuteranno a fornire report più accurati man mano che le normative del settore pubblicitario cambiano e si evolvono.
Esistono due categorie di status di resilienza: Buono e Basso. Lo stato di resilienza è visibile nella sezione Stato delle conversioni di Gestione annunci.
Buona resilienza
Opzione 1: copertura dell'identificatore specifica
- Almeno il 90% degli eventi devono avere IP/UA,
- Almeno il 10% degli eventi del funnel di vendita contiene email crittografate o MAID,
- Almeno il 10% degli eventi ha ID esterno.
- Almeno il 90% degli eventi del tag deve essere ricevuto tramite CAPI
Oppure:
Opzione 2: Ottieni il tasso di corrispondenza di base
Bassa resilienza
Tutte le impostazioni non sono Buone.
Invia i seguenti segnali per raggiungere lo status di inserzionista resiliente.
| ID/segnali dell'API | Peso/Classifica |
|---|---|
| client_ip_address + client_user_agent | Alta |
| em | Alta |
| external_id | Alta |
| hashed_maid | Alta |
| click_id | Alta |
| fn + ln | Bassa |
| ph | Bassa |
| ge, bd, ct, st, zp, paese | Bassa |
*Peso/classifica in base alla probabilità di aumentare il tasso di corrispondenza
Pinterest dispone di numerose integrazioni di terze parti per supportare il tuo processo di adozione dell'API.
Google Tag Manager - Lato server
Collega il tuo account Google Tag Manager al tuo API di Pinterest per le conversioni per scoprire quanto Pinterest influenzi il traffico verso il tuo store e le vendite dei tuoi prodotti.
Questa integrazione richiede la distribuzione di un contenitore server utilizzando il provider di cloud preferito e la conoscenza del tag lato server. Per ulteriori informazioni sui prerequisiti, visita il
Shopify
Questa integrazione dell'API per le Conversioni completa il tag di Pinterest per garantire standard più elevati in termini di qualità e di copertura dei dati. Finché l'app di Shopify è installata, non è richiesta alcuna azione per sfruttare questo miglioramento. Le modifiche verranno applicate automaticamente al negozio del commerciante.
Tealium
Gli inserzionisti interessati a Tealium possono configurare l'API per le Conversioni direttamente con la terza parte. Tealium crea il modello e aiuterà a facilitare l'integrazione con l'inserzionista.
Il processo di implementazione è illustrato nel
Se desideri maggiori informazioni sulle altre integrazioni di terze parti, contatta il tuo rappresentante di vendita.
A partire dal 1° gennaio 2023, gli inserzionisti possono utilizzare il contrassegno Trattamento limitato dei dati in conformità al California Consumer Privacy Act, come modificato dal California Privacy Rights Act (insieme, CCPA). Con questo contrassegno, Pinterest limiterà l'utilizzo di alcuni dati per consentire agli inserzionisti di rispettare le impostazioni sulla privacy degli utenti. Ad esempio, un inserzionista potrebbe implementare il contrassegno Trattamento limitato dei dati per gli utenti californiani che hanno scelto di non vendere o condividere i loro dati ai sensi del CCPA. Quando il contrassegno Trattamento limitato dei dati viene utilizzato, Pinterest agirà come fornitore di servizi ai sensi del CCPA per quanto riguarda i dati contrassegnati dagli utenti in California.
Gli inserzionisti sono tenuti a rispettare la scelta degli utenti e a identificarne lo stato di residenza quando implementano il contrassegno Trattamento limitato dei dati.