Tapahtumakoodi

Kun olet lisännyt peruskoodin, voit lisätä tapahtumakoodin, jolla voit seurata sivustosi tulostapahtumia.

Alla olevasta taulukosta näet, mitä tapahtumia voit seurata Pinterest-tunnisteella sekä sisältyvätkö ne yleisön luontiin ja tulosraportteihin

Tapahtuma

Käyttötarkoitus

Yleisön luonti

Tulosraportit

Checkout

Seuraa ostoksia suorittavia käyttäjiä

AddToCart

Seuraa ostoskoriin tuotteita lisääviä käyttäjiä

PageVisit

Seuraa tärkeitä sivuja katselevia käyttäjiä (esim. tuote- tai artikkelisivut)

Signup

Seuraa tuotteen tai palvelun käyttäjäksi rekisteröityviä käyttäjiä

WatchVideo

Seuraa videoita katsovia käyttäjiä

Lead

Seuraa yrityksen tuotteesta tai palvelusta kiinnostuneita käyttäjiä

Search

Seuraa tiettyjä tuotteita tai myymälöiden osoitteita yrityksesi sivustosta etsiviä käyttäjiä

ViewCategory

Seuraa luokkasivuja tarkastelevia käyttäjiä

Custom

Seuraa muuta tapahtumaa. Käytä tätä tapahtumaa, kun haluat seurata muuta tapahtumaa, jonka haluat sisällyttää tulosraportteihin.

[User-defined event]

Voit lisätä muita tapahtumia, joita olet määrittänyt yleisökohdistusta varten. Muista, että nämä tapahtumat eivät sisälly tulosraportteihin. Muista myös, että tunnisteen kautta välitettävien tapahtumien nimistä poistetaan välilyönnit.

 

Sijoittelu

Lisää peruskoodi ja tapahtumakoodi niille sivuille, joilla haluat seurata tuloksia. Peruskoodi tulee lisätä sivuston jokaiselle sivulle, mutta tapahtumakoodi vain niille sivuille, joilla haluat seurata tuloksia. Peruskoodi täytyy suorittaa ennen tapahtumakoodia, joten varmista, että se on koodissa ennen tapahtumakoodia.

Esimerkki: Jos haluat seurata suoritettuja ostoksia, lisää ensin peruskoodi ja sen jälkeen Checkout-tapahtumakoodi ostoksen vahvistussivun tunnisteiden <head> ja </head> väliin. Tämä sijoittelu varmistaa, että koodit suoritetaan heti, kun sivu ladataan.

Jos tapahtuma käynnistyy vain, kun käyttäjä tekee tietyn toiminnon (esim. napsauttaa painiketta tai lähettää lomakkeen), muista varmistaa, että tapahtumakoodi on sijoitettu niin, että se suoritetaan vain toiminnon seurauksena. Oikea toteutus edellyttää, että ymmärrät sivun JavaScript-koodin tapahtumakäsittelijöiden toimintaa.

Tapahtumatiedot

Voit toimittaa tapahtumasta lisätietoja tapahtumatietoja sisältävän objektin avulla.

Muista, että Pinterestin tulosraportit sisältävät tällä hetkellä ainoastaan nämä tapahtumatiedot: value ja order_quantity. Voit käyttää muita tapahtumatietoja yleisökohdistukseen, mutta ne eivät sisälly tulosraportteihin.

Toimita value-arvon mukana oikea valuuttakoodi. Pinterest muuntaa tulostunnisteessa ilmoitetun summan tilisi valuutaksi nykyisen valuuttakurssin mukaan ja näyttää tulosten arvot mainosten hallinnan raporteissa tilisi valuutassa.

Tapahtumatieto

Esimerkkiarvo

Tyyppi

Yleisön luonti

Tulosraportit

value

100

numero (kokonaisluku tai liukuluku)

order_quantity

1

numero

currency

USD

jokin seuraavista: USD, GBP, CAD, EUR, AUD tai NZD

 

product_name

Parker-saappaat

line_items-matriisi

 

product_id

1414

line_items-matriisi

 

product_category

Kengät

line_items-matriisi

 

product_variant_id

1414-Punainen

line_items-matriisi

 

product_variant

Punainen

line_items-matriisi

 

product_price

99,99

numero (kokonaisluku tai liukuluku), line_items-matriisi

 

product_quantity

1

kokonaisluku, line_items-matriisi

 

product_brand

Parker

line_items-matriisi

 

promo_code

TALVI10

merkkijono

 

property

Athleta

merkkijono

 

search_query

saappaat

merkkijono

 

video_title

Parker – moneen tyyliin sopivat saappaat

merkkijono

 

lead_type

Uutiskirje

merkkijono

 

 

Oheinen esimerkkikoodi seuraa ostostapahtumaa, jonka tapahtumatiedoissa on kahden tuotteen ostamiseen liittyviä tietoja. Muista, että esimerkki on tapahtumakoodin JavaScript-osassa. Esimerkin arvot order_quantity ja value ovat staattisia, mutta saatat haluta toimittaa arvot dynaamisesti.

Esimerkkejä dynaamisesti toimitettavasta tilausarvosta ja -määrästä on kohdassa Tapahtumatiedot value ja order_quantity.
 

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

Tapahtumatiedot value ja order_quantity

Tilausarvo (value) ja -määrä (order_quantity) ovat tällä hetkellä tulosraporteissa käytettävissä olevat tapahtumatiedot. Jos haluat lisätä tilausarvon tai -määrän, voit käyttää joko staattisia arvoja tai toimittaa tiedot dynaamisesti. Suositus on, että toimitusarvo ja -määrä toimitetaan dynaamisesti, jotta ne vastaavat sivustoasi ja käyttämääsi myyntien kirjaustapaa. Useimmissa tapauksissa sivustossa tehdään tilauksia, joiden sisältämien tuotteiden arvot ja määrät vaihtelevat. Jotta voit seurata myyntiä tarkasti, sinun kannattaa seurata tulostunnisteiden order_quantity- ja value-arvoja dynaamisella muuttujalla.

Esimerkki staattisesta arvosta ja määrästä:

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

Raportoitu tilausarvo: 10,00

Raportoitu tilausmäärä: 5

Esimerkki dynaamisesta arvosta ja määrästä:

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

Raportoitu tilausarvo: Dynaamisesti vaihtuva arvo (kunkin Checkout-tapahtuman arvo)

Raportoitu tilausmäärä: Dynaamisesti vaihtuva määrä (kunkin Checkout-tapahtuman määrä)

Huomaa, että dynaamisen tilausmäärän ja -arvon määritys koskee vain omaa sivustoasi.

Vastakutsu

Tapahtumatietojen lisäksi voit lähettää JavaScript-vastakutsun pintrk()-funktion lisäargumenttina. Vastakutsu suoritetaan aina kun tapahtuman seurantakutsu eli pintrk()-funktio käynnistyy.

Vastakutsulla on kaksi argumenttia:

function(didInit, error) {}
  • didInit: Ensimmäinen argumentti saa totuusarvon, joka on tosi (true), jos tapahtuman seurantakutsu muodostetaan, ja epätosi (false), jos tapahtuman seurantakutsun aikana havaitaan virhe.

  • error: Jos didInit-totuusarvo on epätosi (false), toinen argumentti on virhettä kuvaileva merkkijono. Jos didInit-totuusarvo on tosi (true), merkkijonoa ei määritetä.

Esimerkki

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

Mitä seuraavaksi?

Muita esimerkkejä on täällä. Kun olet lisännyt perus- ja tapahtumakoodit, voit tarkistaa ne Pinterest Tag Helper -työkalulla.

Tarvitsetko lisäapua?
Ota yhteyttä