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.