Kód udalosti

Po pridaní základného kódu môžete pridať kód udalosti na sledovanie konkrétnej udalosti konverzie na vašej webovej lokalite.

Tabuľka nižšie obsahuje udalosti, ktoré môžete sledovať pomocou značky Pinterestu, a tiež, či zahŕňajú vytvorenie publika a vykazovanie konverzií. 

Udalosť

Účel

Vytvorenie publika

Vykazovanie konverzií

Checkout

Sledovanie používateľov, ktorí dokončia transakcie

AddToCart

Sledovanie používateľov, ktorí pridali položky do nákupných košíkov

PageVisit

Sledovanie používateľov, ktorí zobrazujú primárne stránky, napríklad stránky produktov alebo článkov

Signup

Sledovanie používateľov, ktorí sa prihlásili na odber vášho produktu alebo služby

WatchVideo

Sledovanie používateľov, ktorí sledujú videá

Lead

Sledovanie používateľov, ktorí prejavujú záujem o váš produkt alebo službu

Search

Sledovanie používateľov, ktorí na vašej webovej lokalite vyhľadávajú konkrétne produkty alebo obchody

ViewCategory

Sledovanie používateľov, ktorí zobrazujú stránky kategórií

Custom

Sledovanie vlastnej udalosti. Túto udalosť môžete použiť na sledovanie špeciálnej udalosti, ktorú chcete zahrnúť do vykazovania konverzií.

[User-defined event]

Pridajte akúkoľvek udalosť, ktorú ste definovali na účely zacielenia na publikum. Jedinečné udalosti nie sú k dispozícii na vykazovanie konverzií. Nezabúdajte, že medzery budú z názvov nespracovaných udalostí odovzdaných prostredníctvom značky odstránené.

 

Umiestnenie

Základný kód aj kód udalosti je potrebné pridať na každú stránku, na ktorej chcete sledovať konverzie. Základný kód by ste mali pridať na každú stránku svojej webovej lokality, zatiaľ čo kód udalosti stačí vložiť iba na stránky, na ktorých chcete sledovať konverzie. Základný kód sa musí spustiť pred kódom udalosti, takže ho vložte na prvé miesto.

Ak chcete sledovať napríklad úspešné nákupy, mali by ste vložiť základný kód a potom kód udalosti nákupu medzi značky <head> a </head> na stránke potvrdenia nákupu. Vďaka takémuto umiestneniu sa kódy spustia hneď pri načítaní stránky.

Na druhej strane, ak sa udalosť aktivuje až po tom, ako používateľ vykoná na stránke určitú akciu, ako je napríklad kliknutie na tlačidlo alebo odoslanie formulára, je potrebné zabezpečiť, aby sa kód udalosti spustil len v dôsledku vykonania akcie. To si vyžaduje pochopenie existujúcich obslužných rutín udalostí v kóde JavaScript stránky.

Údaje udalosti

Ďalšie informácie o udalosti môžete pridať pripojením objektu, ktorý obsahuje údaje udalosti.

Nezabúdajte, že v súčasnosti ponúkame iba vykazovanie na základe údajov udalosti value a order_quantity. Akákoľvek ďalšie údaje udalosti sú k dispozícii na zacielenie publika, ale nie sú k dispozícii na vykazovanie konverzií.

Hodnota by sa mala odoslať späť spolu s príslušným kódom meny. Hodnotu konverzie konvertujeme v prehľade správcu reklám na menu vášho účtu s použitím výmenného kurzu medzi kódom meny odoslanom späť v značke konverzie a menou vášho účtu.

Údaje udalosti

Vzorová hodnota

Typ

Vytvorenie publika

Vykazovanie konverzií

value

100,00

Číslo (celé číslo alebo číslo s plávajúcou desatinnou čiarkou)

order_quantity

1

Celé číslo

currency

USD

Jedna z nasledujúcich mien: USD, GBP, CAD, EUR, AUD alebo NZD

 

product_name

Topánky Parker

line_items array

 

product_id

1414

line_items array

 

product_category

Topánky

line_items array

 

product_variant_id

1414-Červené

line_items array

 

product_variant

Červené

line_items array

 

product_price

99,99

Číslo (celé číslo alebo číslo s plávajúcou desatinnou čiarkou), pole line_items

 

product_quantity

1

Celé číslo, pole line_items

 

product_brand

Parker

line_items array

 

promo_code

WINTER10

Reťazec

 

property

Athleta

Reťazec

 

search_query

topánky

Reťazec

 

video_title

Ako nosiť topánky Parker

Reťazec

 

lead_type

Bulletin

Reťazec

 

 

Nižšie uvedený vzorový kód udalosti sleduje udalosť platby pomocou údajov udalosti, ktoré popisujú nákup dvoch produktov. Majte na pamäti, že tento príklad je časť kódu udalosti napísaná v JavaScripte. V tomto príklade sú hodnoty order_quantity a value statické, ale môžete ich odovzdať späť dynamicky.

V nižšie uvedenej sekcii údajov udalosti hodnoty a množstva nájdete príklady dynamickej hodnoty a množstva.
 

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

Údaje udalosti hodnoty a množstva

Hodnota a množstvo objednávky sú dve časti údajov udalosti, ktoré sú v súčasnosti k dispozícii vo vykazovaní konverzií. Ak chcete pridať hodnotu a množstvo, môžete použiť buď statické hodnoty, alebo ich odovzdať späť dynamicky. Ak chcete odovzdať hodnotu a množstvo späť dynamicky tak, ako sa to odporúča, budú jedinečné pre vašu webovú lokalitu a spôsob zaznamenávania predaja. Hodnota a množstvo produktov sa v jednotlivých objednávkach zadaných na vašej webovej lokalite zvyčajne líšia. Ak chcete presne sledovať celkovú hodnotu predaja, odporúčame použiť dynamickú premennú na sledovanie množstva a hodnoty v značkách konverzie.

Príklad pevne kódovanej hodnoty a množstva:

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

Vykázaná hodnota: 10,00

Vykázané množstvo: 5

Príklad dynamickej hodnoty a množstva:

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

Vykázaná hodnota: Dynamická čiastka zakúpená v rámci príslušnej platby

Vykázané množstvo: Dynamické množstvo zakúpené v rámci príslušnej platby

Nezabúdajte, že nastavenie dynamického množstva a hodnoty objednávky je jedinečné pre vašu webovú lokalitu.

Spätné volanie

Okrem údajov udalosti môžete použiť funkciu spätného volania JavaScriptu ako voliteľný argument funkcie pintrk(). Táto funkcia spätného volania sa spustí pri každom volaní sledovania udalosti – funkcie pintrk().

Funkcia spätného volania má dva nasledujúce argumenty:

function(didInit, error) {}
  • didInit: Tento prvý argument akceptuje booleovskú hodnotu, ktorá sa nastaví na možnosť „true“, ak sa volanie sledovania udalosti úspešne vykonalo, alebo na možnosť „false“, ak sa pri volaní sledovania udalosti zistila chyba.

  • error: Tento druhý argument akceptuje reťazec, ktorý popisuje chybu, keď je hodnota argumentu didInit „false“. Ak je hodnota argumentu didInit „true“, tento reťazec nie je definovaný.

Príklad

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

Ďalšie kroky

Ďalšie príklady nájdete tu. Po pridaní základného kódu a kódu udalosti môžete pomocou pomocného nástroja značky Pinterestu overiť, či ste značky implementovali správne.

Ešte stále potrebujete pomôcť?
Kontaktujte nás