gebeurteniscode

Nadat je de basiscode hebt toegevoegd, kun je een gebeurteniscode toevoegen om een specifieke conversiegebeurtenis op je website bij te houden.

De tabel hieronder laat zien welke gebeurtenissen je kunt bijhouden met de Pinterest-tag, en of ze het  maken van doelgroepen en  conversierapportages ondersteunen. 

Evenement

Doel

Maken van doelgroepen

Conversierapportages

Kassa

Volg mensen die transacties afronden

AddToCart

Volg mensen die items aan winkelwagens toevoegen

PageVisit

Volg mensen die belangrijke pagina's bekijken, zoals productpagina's en artikelpagina's

Registratie

Volg mensen die zich aanmelden voor je product of dienst

WatchVideo

Volg mensen die video's bekijken

Lead

Volg mensen die interesse tonen in je product of dienst

Zoeken

Volg mensen die zoekopdrachten op je website uitvoeren om te zoeken naar specifieke producten of winkellocaties

ViewCategory

Volg mensen die categoriepagina's bekijken

Custom

Volg een aangepaste gebeurtenis. Gebruik deze gebeurtenisnaam om een speciale gebeurtenis te volgen die je in je conversierapportage wilt vermelden

[User-defined event]

Voeg een aanvullende gebeurtenis toe die je hebt gedefinieerd voor doelgroeptargeting. Voor unieke gebeurtenissen zijn geen conversierapportages beschikbaar. Houd er rekening mee dat witruimte vóór en na de onbewerkte gebeurtenisnamen die via de tag worden doorgegeven, wordt verwijderd

 

Plaatsing

Zowel de basiscode als de gebeurteniscode moeten worden toegevoegd aan elke pagina waar je conversies wilt bijhouden. De basiscode moet worden geplaatst op elke pagina van je website, maar de gebeurteniscode hoeft alleen geplaatst te worden op pagina's waar je conversies bij wilt houden. De basiscode moet vóór de gebeurteniscode worden uitgevoerd, dus plaats die als eerste.

Als je bijvoorbeeld succesvolle betalingen wilt bijhouden, moet je de basiscode en vervolgens de kassa-gebeurteniscode toevoegen tussen de <head>-tag en de </head>-tag op je afrekenpagina. Door de code hier te plaatsen, zorg je ervoor dat deze wordt uitgevoerd zodra de pagina is geladen.

Als een gebeurtenis echter alleen moet worden geregistreerd na een specifieke actie op de pagina, bijvoorbeeld het aanklikken van een knop of het indienen van een formulier, dan moet je ervoor zorgen dat de gebeurteniscode alleen wordt uitgevoerd nadat de actie heeft plaatsgevonden. Hiervoor moet je kennis hebben van de bestaande event handlers in de JavaScript-code van je pagina.

Gebeurtenisgegevens

Je kunt aanvullende informatie over een gebeurtenis meegeven door een object toe te voegen dat gebeurtenisgegevens bevat.

Onthoud dat we op dit moment alleen rapportage bieden voor de value- en order_quantity-gebeurtenisgegevens. Alle andere gebeurtenisgegevens zijn beschikbaar voor doelgroeptargeting, maar niet voor conversierapportage.

De waarde moet samen met de juiste valutacode worden teruggestuurd. De conversiewaarde in rapportages in Advertentiebeheer wordt omgerekend naar de valuta van je account aan de hand van de wisselkoers tussen de teruggestuurde valuta en de valuta van je account.

Gebeurtenisgegevens

Voorbeeldwaarde

Type

Maken van doelgroepen

Conversierapportages

value

100,00

Getal (integer of floating point)

order_quantity

1

Integer

currency

USD

Een van de volgende: USD, GBP, CAD, EUR, AUD of NZD

 

product_name

Parker-laarzen

Array van line_items

 

product_id

1414

Array van line_items

 

product_category

Schoenen

Array van line_items

 

product_variant_id

1414-Rood

Array van line_items

 

product_variant

Rood

Array van line_items

 

product_price

99,99

Getal (integer of floating point), array van line_items

 

product_quantity

1

Integer, array van line_items

 

product_brand

Parker

Array van line_items

 

promo_code

WINTER10

String

 

property

Athleta

String

 

search_query

laarzen

String

 

video_title

Het stylen van je Parker-laarzen

String

 

lead_type

Nieuwsbrief

String

 

 

De voorbeeld-gebeurteniscode hieronder houdt een checkout-gebeurtenis bij met gebeurtenisgegevens die de aankoop van twee producten beschrijven. Onthoud dat dit voorbeeld het JavaScript-gedeelte van de gebeurteniscode is. In dit voorbeeld zijn order_quantity en value statisch, maar je kunt deze waarden ook dynamisch doorgeven.

Bekijk het gedeelte 'Gebeurtenisgegevens waarde en bestelaantal' hieronder voor voorbeelden van dynamische waarde en hoeveelheid.
 

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

Gebeurtenisgegevens waarde en bestelaantal

Waarde en bestelaantal zijn twee gebeurtenisgegevens die momenteel beschikbaar zijn voor conversierapportage. Als je deze gegevens wilt toevoegen, kun je statische waarden gebruiken of de waarden dynamisch invullen. Als je de gegevens, zoals aanbevolen, dynamisch wilt doorgeven, is dit uniek voor je website en voor hoe je verkopen registreert. Meestal verschillen de waarde en het aantal producten voor elke bestelling die op je website wordt geplaatst. Om de totale waarde van je verkoop nauwkeurig bij te houden, raden we je aan een dynamische variabele te gebruiken om het aantal en de waarde in je conversietags bij te houden.

Voorbeeld van statische waarde en aantal:

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

Gerapporteerde waarde: 10,00

Gerapporteerd aantal: 5

Voorbeeld van dynamische waarde en aantal:

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

Gerapporteerde waarde: dynamische waarde van de bijbehorende aankoop

Gerapporteerd aantal: dynamisch aantal dat bij de bijbehorende aankoop is gekocht

Het instellen van dynamische bestelwaarde en -aantal is uniek voor je website.

Callback

Naast gebeurtenisgegevens kun je ook een JavaScript-callback-functie meegeven als optionele parameter aan de functie pintrk(). Deze callback-functie wordt elke keer uitgevoerd wanneer een gebeurtenisregistratie, de functie pintrk(), wordt aangeroepen.

De callback-functie neemt de volgende twee parameters aan:

function(didInit, error) {}
  • didInit: De eerste parameter ontvangt een booleanwaarde die 'true' is wanneer de gebeurtenisregistratie succesvol geconstrueerd is, en 'false' is wanneer er een fout is opgetreden bij de gebeurtenisregistratie.

  • error: De tweede parameter ontvangt een string die de fout beschrijft wanneer didInit 'false' teruggeeft; als didInit 'true' is, is de string undefined.

Voorbeeld

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

Volgende stappen

Hier kun je nog wat voorbeelden bekijken. Nadat je je basis- en gebeurteniscodes hebt toegevoegd, kun je de Pinterest-taghelper gebruiken om te controleren of je de tags juist geïmplementeerd hebt.

Nog steeds hulp nodig?
Neem contact met ons op