Codice evento

Dopo aver aggiunto il codice di base, puoi aggiungere un codice evento per monitorare un evento di conversione sul tuo sito web.

La tabella seguente mostra gli eventi che puoi monitorare con il tag di Pinterest e se questi includono la creazione del pubblico e i report sulle conversioni

Evento

Obiettivo

Creazione del pubblico

Report sulle conversioni

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 nel tuo prodotto o servizio

Search

Monitora le persone che effettuano ricerche sul tuo sito web per trovare prodotti specifici o sedi del negozio

ViewCategory

Monitora le persone che visualizzano le pagine delle categorie

Custom

Monitora un evento personalizzato. Usa questo nome dell'evento per monitorare un particolare evento che desideri includere nel report di conversione

[User-defined event]

Aggiungi un evento aggiuntivo che hai definito per l'obiettivo della targetizzazione del pubblico. Gli eventi unici non sono disponibili per i report sulle conversioni. Tieni presente che gli spazi vuoti verranno eliminati dai nomi degli eventi originari elaborati dal tag.

 

Posizionamento

Sia il codice di base che il codice evento devono essere aggiunti a ogni pagina di cui vuoi monitorare le conversioni. Il codice di base deve essere posizionato su ogni pagina del tuo sito web, mentre il codice evento deve essere posizionato solo nelle pagine in cui vuoi monitorare le conversioni. Il codice di base deve attivarsi prima del codice evento, pertanto assicurati di posizionarlo per primo.

Ad esempio, se desideri monitorare i pagamenti conclusi correttamente, devi posizionare il codice di base e quindi il codice evento CheckOut tra i tag <head> e </head> nella pagina di conferma di avvenuto pagamento. In questo modo, i codici verranno attivati non appena la pagina verrà caricata.

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, dovrai assicurarti che il codice evento venga eseguito solo conseguentemente all'azione. Ciò richiede la comprensione dei gestori di eventi esistenti nel codice JavaScript della tua pagina.

Dati degli eventi

Puoi fornire ulteriori informazioni su un evento allegando un oggetto che contiene i dati evento.

Tieni presente che al momento offriamo i report solo per i dati evento value e order_quantity. Eventuali dati evento aggiuntivi sono disponibili per la targetizzazione del pubblico, ma non per i report di conversione.

Il valore deve essere rinviato insieme al codice valuta appropriato. Convertiamo il valore di conversione nel report di gestione annunci per la valuta del tuo account usando il tasso di cambio tra il codice valuta restituito nel tag di conversione e la valuta del tuo account.

Dati degli eventi

Valore campione

Tipo

Creazione del pubblico

Report sulle conversioni

value

100,00

Numero (intero o a virgola mobile)

order_quantity

1

Numero intero

currency

USD

Una delle seguenti: USD, GBP, CAD, EUR, AUD o NZD

 

product_name

Stivali Parker

line_items array

 

product_id

1414

line_items array

 

product_category

Scarpe

line_items array

 

product_variant_id

1414-Rosso

line_items array

 

product_variant

Rosso

line_items array

 

product_price

99,99

Numero (intero o a virgola mobile), line_items array

 

product_quantity

1

Numero intero, line_items array

 

product_brand

Parker

line_items array

 

promo_code

INVERNO10

Stringa

 

property

Athleta

Stringa

 

search_query

stivali

Stringa

 

video_title

Come abbinare gli stivali Parker

Stringa

 

lead_type

Newsletter

Stringa

 

 

Il codice evento esemplificativo riportato qui sotto monitora un evento di checkout con dati evento che descrivono l'acquisto di due prodotti. Ricorda che questo esempio rappresenta la parte di JavaScript del codice evento. In questo esempio, order_quantity e value sono statici, ma potresti voler trasmettere questi valori in modo dinamico.

Consulta la sezione dati evento valore e quantità qui sotto per esempi di valore e quantità dinamici.
 

<script>
 pintrk('track', 'checkout', {
   value: 10.00,
   order_quantity: 2,
   currency: 'USD',
   line_items: [
     {
       product_name: 'Parker Boots',
       product_id: '1414',
       product_price: 5.00,
       product_quantity: 1
     },
     {
       product_name: 'Parker Sandals',
       product_id: 'ABC',
       product_price: 5.00,
       product_quantity: 1
     }
   ]
 });
</script>

Dati evento valore e quantità

Valore e quantità dell'ordine sono due componenti dei dati evento disponibili al momento nei report sulle conversioni. Se desideri aggiungere valore e quantità, puoi usare i valori in modo statico o farli ritornare in modo dinamico. Se desideri trasmettere valore e quantità in modo dinamico, come consigliato, questi saranno unici per il tuo sito web e del modo in cui registri le vendite. Generalmente, il valore e la quantità dei prodotti in ciascun ordine confermato sul tuo sito variano. Per monitorare in maniera accurata il valore totale delle tue vendite, consigliamo una variabile dinamica che monitori la quantità e il valore nei tag di conversione.

Esempio di valore e quantità fissi:

<script>
 pintrk('track', 'checkout', {
   value: 10.00, // Read this value (must be a number)
   order_quantity: 5 // Read this quantity (must be an integer)
 });
</script>
<noscript>
 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=checkout&ed[value]=10.00&ed[order_quantity]=5&noscript=1"/>
</noscript>

Valore indicato: 10,00

Quantità indicata: 5

Esempio di valore dinamico e quantità:

<script>
 pintrk('track', 'checkout', {
   value: {{Enhanced Transaction Revenue}},
   order_quantity: {{item.quantity}}
 });
</script>
<noscript>
 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=checkout&ed[value]={{Enhanced Transaction Revenue}}&ed[order_quantity]={{item.quantity}}&noscript=1" />
</noscript>

Valore indicato: importo dinamico acquistato con il pagamento corrispondente

Quantità indicata: quantità dinamica acquistata con il pagamento corrispondente

Nota: la configurazione di quantità e valore dinamici dell'ordine è peculiare per il tuo sito web.

Callback

Oltre ai dati evento, puoi trasmettere una funzione callback JavaScript come argomento opzionale alla funzione pintrk(). 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: il 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

<script>
 pintrk('track', 'checkout', {
   value: 10.00,
   order_quantity: 2,
   currency: 'USD',
   line_items: [
     {
       product_name: 'Parker Boots',
       product_id: '1414',
       product_price: 5.00,
       product_quantity: 1
     },
     {
       product_name: 'Parker Sandals'
       product_id: 'ABC',
       product_price: 5.00,
       product_quantity: 1
     }
   ]
 }, function(didInit, error) { if (!didInit) { console.log(error); }
 });
</script>

Passaggi successivi

Puoi vedere altri esempi qui. Dopo aver aggiunto il codice di base e il codice evento, puoi usare l'Assistente tag Pinterest per confermare di aver implementato correttamente i tag.

Hai ancora bisogno di aiuto?
Contattaci