Aggiungi codici evento

Sembra che tu stia visualizzando l'elemento da un'area geografica in cui il tag di Pinterest non è ancora disponibile. Scopri dove è disponibile il tag di Pinterest per gli account di Pinterest Business.

Ulteriori informazioni

I codici evento ti consentono di misurare l'impatto che i tuoi annunci di Pinterest hanno su determinate azioni sul sito. Inoltre sono necessari per lanciare campagne che ottimizzino automaticamente eventi specifici, come le campagne di conversione o gli annunci di retargeting dinamico. I codici evento servono anche ad accedere a piattaforme come quella dei Dati statistici sulle conversioni.

Dopo aver aggiunto il codice di base puoi aggiungere dei codici evento per monitorare un evento di conversione specifico sul tuo sito web. Il codice di base deve essere posizionato su ogni pagina del tuo sito web e i codici evento devono essere posizionati solo nelle pagine in cui vuoi monitorare conversioni specifiche. Sono richiesti codici eventi diversi per obiettivi della campagna diversi. Ad esempio, per lanciare l'obiettivo Conversione sono richiesti gli eventi checkout, AddToCart o signup.

Tipi di codici evento

La seguente tabella mostra gli eventi che puoi monitorare con il tag di Pinterest. Puoi utilizzarli per creare segmenti di pubblico per il targeting degli annunci e puoi visualizzare il report sulle relative conversioni, organiche o a pagamento, in Gestione annunci. Nota: il report non è disponibile per gli eventi definiti dall'utente.

Evento Obiettivo
Checkout Monitora le persone che hanno completato una transazione.
AddToCart Monitora le persone che hanno aggiunto articoli al carrello.
PageVisit Monitora le persone che hanno visualizzato le pagine primarie, ad esempio pagine dei prodotti o degli articoli.
Signup Monitora le persone che si registrano per un prodotto o un servizio.
WatchVideo Monitora le persone che visualizzano i video.
Lead Monitora le persone che mostrano interesse per il tuo prodotto o servizio.
Search Monitora le persone che sul tuo sito web cercano prodotti specifici o sedi del negozio.
ViewCategory Monitora le persone che visualizzano le pagine delle categorie.
Custom Monitora un evento personalizzato. Usa questo nome evento per monitorare un particolare evento che desideri includere nel report di conversione.
[User-defined event] Aggiunge gli eventi aggiuntivi che hai definito per l'obiettivo della targetizzazione del pubblico. Gli eventi unici non sono disponibili per i report sulle conversioni. Ricorda che tutti gli spazi vuoti presenti nei nomi evento personalizzati elaborati dal tag verranno rimossi.

Aggiungere un codice evento al sito web

Se la finestra è ancora aperta su Gestione annunci da quando hai copiato il codice di base, fai clic su Continua nell'angolo in basso a destra della casella sulla tua schermata per visualizzare tutte le opzioni, quindi fai clic su Copia codice accanto all'evento che desideri monitorare.

Se la finestra non si apre, segui i passaggi di seguito.

  1. Copia il codice per l'evento che desideri aggiungere al tuo sito web dall'elenco di esempi di seguito.
  2. Apri il codice relativo alla pagina del sito web su cui vuoi monitorare un evento.
  3. Incolla il codice evento fra i tag <head> e </head> sulla tua pagina, dopo il codice di base, assicurandoti di sostituire tutti i valori di esempio con il valore appropriato per il tuo sito web. Ciò comporta l'attivazione dell'evento a ogni caricamento della pagina.

Nota: se un evento viene attivato solo dopo che l'utente ha effettuato un'azione specifica sulla pagina, ad esempio se ha cliccato su un pulsante o inviato un modulo, assicurati che il codice evento venga eseguito solo conseguentemente a quell'azione. Ciò richiede la comprensione dei gestori di eventi esistenti nel codice JavaScript della tua pagina.

Aggiungere i dati evento

Puoi fornire ulteriori informazioni su un evento allegando un oggetto che contiene i dati evento. Per la targetizzazione del pubblico sono disponibili tutti i dati evento, ma per il report sulle conversioni organiche e a pagamento sono disponibili soltanto i dati evento value e order_quantity.

Dati degli eventi Valore campione Tipo
value 100,00 Numero (intero o a virgola mobile)
order_quantity 1 Numero intero
order_id 1234OrderID Stringa (si richiede l'order_id per il report dell'analisi delle conversioni) 
product_name Stivali Parker line_items array, stringa
product_id 1414 line_items array, stringa
product_category Scarpe line_items array, stringa
product_variant_id 1414-Rosso line_items array, stringa
product_variant Rosso line_items array, stringa
product_price 99,99 Numero (intero o a virgola mobile), line_items array, stringa
product_quantity 1 Numero intero, line_items array, stringa
product_brand Parker line_items array, stringa
promo_code INVERNO10 Stringa
property Athleta Stringa
search_query stivali Stringa
video_title Come abbinare gli stivali Parker Stringa
lead_type Newsletter Stringa
currency USD

Uno dei seguenti: AED, AMD, ARS, AUD, AZN, BAM, BGN, BHD, BMD, BND, BOB, BRL, BSD, CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, DOP, EGP, EUR, FJD, GBP, GEL, GIP, HKD, HNL, HRK, HUF, IDR, ILS, INR, ISK, JMD, JPY, KGS, KRW, KWD, KZT, MAD, MDL, MOP, MXN, MYR, NOK, NZD, OMR, PAB, PEN, PHP, PKR, PLN, QAR, RON, RSD, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD, UYU, VND o ZAR.

Nota: quando con il tag dell'evento fornisci anche una valuta, noi calcoleremo il tasso di cambio a cui far corrispondere la valuta dell'account dell'inserzionista.

Includere i dati evento nel tag IMG

Il tag IMG è un frammento di codice all'interno del tag di Pinterest che funge da backup nel caso in cui l'utente abbia disattivato JavaScript nel browser. Ti consigliamo di includere i dati evento anche nel tag IMG, per permettere un migliore targeting dell'utente. Puoi decidere di utilizzare soltanto il tag IMG e non il tag di JavaScript, ma per farlo dovrai rimuovere i tag <noscript> dal codice.

Tramettere dinamicamente i dati evento value e order_quantity

Value e order_quantity sono due componenti dei dati evento disponibili nel report sulle conversioni organiche e a pagamento. Se desideri aggiungere value e quantity, puoi trasmetterli in modo dinamico. Un valore dinamico può cambiare a seconda delle azioni intraprese sul tuo sito. Se scegli di trasmettere value e order_quantity, questi saranno unicamente per il suo sito web e relativi al modo in cui registri le vendite. Di solito il valore e la quantità dei prodotti in ciascun ordine confermato sul tuo sito variano.

Trasmettere una funzione callback JavaScript

Oltre ai dati evento, puoi trasmettere una funzione callback JavaScript come argomento opzionale alla funzione pintrk(). Ciò fornisce informazioni aggiuntive nel caso in cui si dovesse verificare un errore a livello del tag, che può essere verificato nello strumento per lo sviluppatore. La funzione callback si attiva ogni volta che si esegue una chiamata di monitoraggio dell'evento, definita funzione pintrk().

La funzione callback è composta dai seguenti due argomenti:

function(didInit, error) {}
  • didInit: questo primo argomento riceve un valore booleano, impostato per essere vero se la chiamata di monitoraggio dell'evento è costruita correttamente, e falso se viene rilevato un errore durante la chiamata di monitoraggio dell'evento.

  • errore: questo secondo argomento riceve una stringa che descrive l'errore quando didInit restituisce "false". Se didInit restituisce "true", la stringa è indefinita.

Esempio di codice evento

Per il monitoraggio e il report delle conversioni, devi specificare uno dei nove tipi di evento nel codice evento. Devi inoltre sostituire YOUR_TAG_ID con l'ID tag di conversione di Pinterest. Ricorda che, oltre a ciò che viene mostrato negli esempi di seguito, puoi includere qualunque combinazione di dati evento per ogni evento.

Esempi di codici di base e codici evento combinati

Ecco alcuni esempi di codici di base combinati con codici evento. Ricorda di verificare che il codice evento sia posizionato dopo il codice di base sul tuo sito web.

Qual è il passaggio successivo?

Scopri di più sui parametri del tag e i cookie o su come abilitare la corrispondenza avanzata facoltativa. Se non vuoi fare nessuna delle due cose, verifica il tuo tag di Pinterest.

Hai ancora bisogno di aiuto?
Contattaci