Cod de eveniment

După ce adaugi codul de bază, poți adăuga un cod de eveniment, pentru a urmări un anumit eveniment de conversie pe site-ul tău.

Tabelul de mai jos afișează evenimentele pe care le poți urmări cu marcajul Pinterest și indică dacă acestea includ crearea unui segment de public și raportarea conversiilor. 

Eveniment

Scopul

Crearea unui segment de public

Raportarea conversiilor

Checkout

Urmărește persoanele care încheie tranzacții

AddToCart

Urmărește persoanele care adaugă articole în coșuri de cumpărături

PageVisit

Urmărește persoanele care vizualizează pagini principale, cum ar fi pagini de produse și pagini de articole

Signup

Urmărește persoanele care se înscriu la produsul sau serviciul tău

WatchVideo

Urmărește persoanele care vizionează videoclipuri

Lead

Urmărește persoanele care manifestă interes față de produsul sau serviciul tău

Search

Urmărește persoanele care efectuează căutări pe site-ul tău pentru a găsi anumite produse sau locații de magazine

ViewCategory

Urmărește persoanele care vizualizează pagini de categorii

Custom

Urmărește un eveniment personalizat. Folosește acest nume de eveniment pentru a urmări un eveniment special pe care dorești să îl incluzi în raportarea conversiilor tale

[User-defined event]

Adaugă orice eveniment suplimentar pe care l-ai definit în scopul direcționării publicului. Evenimentele unice nu sunt disponibile pentru raportarea conversiilor. Reține: spațiul alb va fi trunchiat din numele brute ale evenimentelor transmise prin marcaj

 

Amplasare

Atât codul de bază, cât și codul de eveniment trebuie adăugate pe toate paginile pentru care dorești să urmărești conversiile. Codul de bază ar trebui plasat pe fiecare pagină de pe site, în timp ce codul de eveniment trebuie plasat doar pe paginile pentru care dorești să urmărești conversiile. Codul de bază trebuie să ruleze înaintea codului de eveniment, deci asigură-te că este plasat primul.

De exemplu, dacă dorești să urmărești finalizările de comenzi reușite, ar trebui să plasezi codul de bază, apoi să adaugi codul de eveniment pentru finalizarea comenzii între marcajele <head> și </head>, în pagina de confirmare a finalizării comenzii. Aceasta amplasare asigură rularea codurilor imediat ce se încarcă pagina.

Pe de altă parte, dacă un eveniment este declanșat doar după ce un utilizator efectuează o anumită acțiune în pagină, de exemplu, face clic pe un buton sau trimite un formular, atunci trebuie să te asiguri că acel cod de eveniment rulează doar ca rezultat al unei acțiuni. Acest lucru necesită o înțelegere a rutinelor de tratare a evenimentelor existente în codul JavaScript al paginii.

Datele despre eveniment

Pentru a oferi informații suplimentare despre un eveniment, atașează un obiect care conține date legate de eveniment.

Reține: momentan oferim raportări doar pentru date de eveniment legate de valoare și de cantitatea comenzilor. Toate celelalte date de eveniment suplimentare sunt disponibile pentru direcționarea publicului, însă nu sunt disponibile și pentru raportarea conversiilor.

Ar trebui returnată valoarea, precum și codul de monedă corespunzător. Vom transforma valoarea de conversie din panoul de control al reclamelor raportat la moneda contului tău, folosind rata de schimb valutar, între codul de monedă returnat în marcajul de conversie și moneda contului.

Date despre eveniment

Valoare eșantion

Tip

Crearea unui segment de public

Raportarea conversiilor

value

100,00

Număr (întreg sau cu zecimale)

order_quantity

1

Număr întreg

currency

USD

Una dintre următoarele: USD, GBP, CAD, EUR, AUD sau NZD

 

product_name

Cizme Parker

matrice line_items

 

product_id

1414

matrice line_items

 

product_category

Încălțăminte

matrice line_items

 

product_variant_id

1414-Red

matrice line_items

 

product_variant

Roșu

matrice line_items

 

product_price

99,99

Număr (întreg sau cu zecimale), matrice line_items

 

product_quantity

1

Număr întreg, matrice line_items

 

product_brand

Parker

matrice line_items

 

promo_code

WINTER10

Șir

 

property

Athleta

Șir

 

search_query

cizme

Șir

 

video_title

Cum îți poți stiliza cizmele Parker

Șir

 

lead_type

Buletin informativ

Șir

 

 

Codul de eveniment dat ca exemplu mai jos urmărește un eveniment de finalizare a comenzii cu date de eveniment care descriu achiziția a două produse. Reține: acest exemplu reprezintă porțiunea JavaScript a codului de eveniment. În acest exemplu, order_quantity și value sunt statice, dar poți să transmiți aceste valori și în mod dinamic.

Consultă secțiunea Date de eveniment legate de valori și cantități de mai jos pentru a vedea exemple de valori și cantități dinamice.
 

<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>

Date de eveniment legate de valori și cantități

Valorile și cantitățile comenzilor sunt cele două tipuri de date de eveniment disponibile momentan în raportarea conversiilor. Dacă dorești să adaugi valoarea și cantitatea, poți folosi valori statice sau le poți transmite în mod dinamic. Dacă dorești să transmiți valoarea și cantitatea în mod dinamic, așa cum este recomandat, acest lucru va fi unic pentru site-ul tău și pentru modul în care îți înregistrezi vânzările. De obicei, valoarea și cantitatea produselor din fiecare comandă plasată pe site variază. Pentru a monitoriza în mod corect valoarea totală a vânzărilor, recomandăm o variabilă dinamică pentru a urmări cantitatea și valoarea în marcajele de conversie.

Exemple de valori și cantități codificate hard:

<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>

Valoarea raportată: 10,00

Cantitatea raportată: 5

Exemple de valori și cantități dinamice:

<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>

Valoarea raportată: volumul dinamic achiziționat odată cu finalizarea comenzii corespunzătoare

Cantitatea raportată: cantitatea dinamică achiziționată odată cu finalizarea comenzii corespunzătoare

Reține: configurarea unei cantități și a unei valori dinamice pentru comenzi este unică pentru site-ul tău.

Callback

În plus față datele de eveniment, poți transmite o funcție callback JavaScript ca argument opțional pentru funcția pintrk(). Această funcție callback rulează de fiecare dată când se declanșează un apel de urmărire a evenimentului, funcția pintrk().

Funcția callback preia următoarele două argumente:

function(didInit, error) {}
  • didInit: primul argument primește o valoare booleană, care este setată ca adevărată în cazul în care apelul de urmărire a evenimentului este construit cu succes, și ca falsă dacă se detectează o eroare în timpul efectuării apelului de urmărire a evenimentului.

  • error: al doilea argument primește un șir care descrie eroarea atunci când didInit returnează fals; dacă didInit este adevărat, acest șir este nedefinit.

Exemplu

<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>

Pașii următori

Poți vedea câteva exemple suplimentare aici. După ce ai adăugat codurile de bază și de eveniment, poți folosi asistentul pentru marcaje Pinterest pentru a confirma că ai implementat corect marcajele.

Încă mai ai nevoie de asistență?
Contactează-ne