Met gebeurteniscodes kun je de impact van je Pinterest-advertenties meten op bepaalde acties op je website. Ze zijn ook nodig om campagnes te starten die automatisch worden geoptimaliseerd voor bepaalde gebeurtenissen, zoals conversiecampagnes en dynamische retargeting van advertenties. Je hebt ook gebeurteniscodes nodig om
Nadat je
De tabel hieronder laat zien welke gebeurtenissen je kunt bijhouden met de Pinterest-tag. Je kunt ze gebruiken om
Gebeurtenis | Doel |
---|---|
Checkout | Volg mensen die transacties afronden. |
AddToCart | Volg mensen die artikelen aan hun winkelwagen toevoegen. |
PageVisit | Volg mensen die belangrijke pagina's bekijken, zoals productpagina's en artikelpagina's. |
Signup | 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 op je website 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 aanvullende gebeurtenissen toe die je hebt gedefinieerd voor doelgroeptargeting. Voor unieke gebeurtenissen zijn geen conversierapportages beschikbaar. Houd er rekening mee dat spaties in de aangepaste namen van gebeurtenissen die via de tag worden doorgegeven, worden verwijderd. |
Er zijn verplichte en aanbevolen gebeurtenissen, afhankelijk van de advertentiecampagnes die je wilt uitvoeren.
Campagnetype | Vereiste gebeurtenissen | Aanbevolen gebeurtenissen | Vereiste gebeurtenisgegevens | Aanbevolen gebeurtenisgegevens |
---|---|---|---|---|
Merkbekendheid | Geen |
|
Geen | Conversietoeschrijving |
Catalogusverkopen |
|
|
|
|
Overweging | Geen |
|
Geen | Conversietoeschrijving |
Conversies |
Ten minste een van de volgende:
|
|
Geen |
|
Videoweergaven | Geen | Geen | Geen | Conversietoeschrijving |
Er zijn verplichte en aanbevolen gebeurtenissen, afhankelijk van de functies die je wilt gebruiken.
Uitgelicht | Vereiste gebeurtenissen | Aanbevolen gebeurtenissen | Vereiste gebeurtenisgegevens | Aanbevolen gebeurtenisgegevens |
---|---|---|---|---|
Conversiestatistieken |
|
Geen | currency | Geen |
Programma voor geverifieerde verkopers |
|
Geen | currency | Geen |
Dynamische retargeting |
|
Geen |
|
Geen |
Als je besluit om een handmatige installatie uit te voeren, moet je de gebeurteniscodes zelf aan je website toevoegen. De onderstaande stappen zijn voor mensen die de optie Handmatig instellen gebruiken.
- Log in op je zakelijke Pinterest-account op je computer.
- Klik op
het hamburgerpictogram linksboven op de pagina - Klik onder Zakelijk op Conversies.
- Klik op Aan de slag.
- Selecteer alleen Pinterest-tag en klik op Doorgaan.
- Klik rechtsonder in het scherm op Overslaan.
- Klik op Naar handmatige installatie.
- Kopieer de basiscode en klik op Doorgaan.
- Kies of je automatische conversietoeschrijving wilt inschakelen en klik vervolgens op Doorgaan.
- Klik op Code kopiëren onder het grijze vak, naast de gebeurteniscode die je wilt toevoegen.
- Open de code voor de pagina van je website waarop je een gebeurtenis wilt volgen.
- Plak de gebeurteniscode op de pagina waar de gebeurtenis zou moeten plaatsvinden en vervang eventuele voorbeeldwaarden door de juiste waarde voor je website. Op die manier wordt de gebeurtenis geactiveerd, telkens de pagina wordt geladen.
- Klik op Gereed.
Opmerking: als een gebeurtenis volgt op een specifieke handeling op de pagina (bijvoorbeeld als er op een knop wordt geklikt of een formulier wordt verzonden), moet je ervoor zorgen dat de gebeurteniscode alleen wordt uitgevoerd als gevolg van die handeling. Hiervoor moet je kennis hebben van de bestaande event handlers in de JavaScript-code van je pagina.
Je kunt aanvullende informatie over een gebeurtenis meegeven door een object toe te voegen dat gebeurtenisgegevens bevat. Alle gebeurtenisgegevens zijn beschikbaar voor doelgroeptargeting, maar alleen de gebeurtenisgegevens value (waarde) en order_quantity (bestelhoeveelheid) zijn beschikbaar voor betaalde en organische conversierapportage.
Gebeurtenisgegevens | Voorbeeldwaarde | Type |
---|---|---|
value | 100,00 | Getal (integer of floating point) |
event_id | eventId0001 |
Tekenreeks (een id-tekenreeks die de gebeurtenis uniek identificeert) Opmerking: deze id kan worden verzonden onder een van de volgende veldnamen, die allemaal hoofdlettergevoelig zijn: |
order_quantity | 1 | Integer |
order_id | 1234OrderID | String (order_id is vereist voor rapportage van conversieanalyse) |
product_name | Parker-laarzen | line_items array, string |
product_id | 1414 | line_items array, string |
product_category | Schoenen | line_items array, string |
product_variant_id | 1414-Rood | line_items array, string |
product_variant | Rood | line_items array, string |
product_price | 99,99 | Getal (integer of floating point), line_items array, string |
product_quantity | 1 | Integer, line_items array, string |
product_brand | Parker | line_items array, string |
promo_code | WINTER10 | String |
property | Athleta | String |
search_query | laarzen | String |
video_title | Het stylen van je Parker-laarzen | String |
lead_type | Nieuwsbrief | String |
currency | USD |
Een van de volgende: AED, AMD, ARS, AUD, AZN, BAM, BGN, BHD, BMD, BND, BOB, BRL, BSD, CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, DOP, EGP, EUR, FJD, GBP, GEL, GIP, HKD, HNL, HRK, HUF, IDR, ILS, INR, ISK, JMD, JPY, KGS, KRW, KWD, KZT, MAD, MDL, MOP, MXN, MYR, NOK, NZD, OMR, PAB, PEN, PHP, PKR, PLN, QAR, RON, RSD, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD, UYU, VND of ZAR. Opmerking: Wanneer je een valuta meestuurt met je taggebeurtenis, berekenen wij de wisselkoers om het bedrag om te rekenen naar de valuta van je advertentieaccount. |
De IMG-tag is een stukje code binnen de Pinterest-tag die fungeert als back-up wanneer mensen JavaScript hebben uitgeschakeld in hun browser. We raden je aan ook gebeurtenisgegevens op te nemen in de IMG-tag, omdat er op die manier betere gebruikerstargeting mogelijk is. Je kunt ervoor kiezen om alleen de IMG-tag te gebruiken en niet de JavaScript-tag, maar dan moet je wel de
Hieronder vind je voorbeelden van elk gebeurtenistype, die je kunt kopiëren en op je website kunt plaatsen. Merk op dat je de voorbeeldwaarden moet vervangen door een dynamische variabele voor je website.
Checkout
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=checkout&ed[event_id]=YOUR_EVENT_ID&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
Gebeurtenisgegevens: event_id, value, order_quantity en currency
Zorg ervoor dat je de juiste valutacode invoert voor je website.
AddToCart
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=AddToCart&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
Gebeurtenisgegevens: value, order_quantity en currency.
Zorg ervoor dat je de juiste valutacode invoert voor je website.
PageVisit
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=pagevisit&noscript=1" />
Gebeurtenisgegevens: geen
Signup
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=signup&noscript=1" />
Gebeurtenisgegevens: geen
WatchVideo
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=watchvideo&ed[video_title]=My+Product+Video+01&noscript=1" />
Gebeurtenisgegeven: video_title
Lead
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=lead&ed[lead_type]=Newsletter&noscript=1" />
Gebeurtenisgegeven: lead_type
Zoeken
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=search&ed[search_query]=horse&noscript=1" />
Gebeurtenisgegeven: search_query
ViewCategory
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=viewcategory&noscript=1" />
Gebeurtenisgegevens: geen
Custom
Het gebeurtenistype moet 'custom' zijn, anders worden de conversies die door de tag worden bijgehouden niet gerapporteerd in advertentiebeheer.
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=custom&noscript=1" />
Gebeurtenisgegevens: geen
Value en order_quantity zijn de twee gebeurtenisgegevens die beschikbaar zijn voor betaalde en organische conversierapportage. Als je deze gegevens wilt toevoegen, kun je de waarden dynamisch invullen. Een dynamische waarde kan wijzigen, afhankelijk van de handeling die op je site wordt verricht. Als je ervoor kiest value en order_quantity door te geven, is dit uniek voor je website en voor de manier waarop je verkopen registreert. Meestal verschillen de waarde en het aantal producten voor elke bestelling die op je website wordt geplaatst.
<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
Opmerking: het instellen van dynamische bestelhoeveelheid en waarde is uniek voor je website.
Naast gebeurtenisgegevens kun je ook een JavaScript-callback-functie meegeven als optionele parameter aan de functie pintrk(). Hiermee wordt aanvullende informatie verstrekt indien er iets is misgegaan met je tag, wat je kunt nagaan in de tool voor ontwikkelaars. Deze callback-functie wordt elke keer uitgevoerd wanneer een gebeurtenisregistratie, de functie pintrk(), wordt geactiveerd.
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' wanneer er een fout is opgetreden bij het aanmaken van 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.
<script>
pintrk('track', 'checkout', {
value: 10.00,
order_quantity: 2,
currency: 'USD',
event_id: 'eventId0001',
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>
Voor conversietracking en conversierapportage moet je een van de negen gebeurtenistypes in de gebeurteniscode specifiëren. Je moet ook je YOUR_TAG_ID vervangen door je Pinterest conversietag-ID. Onthoud dat je elke combinatie van gebeurtenisgegevens per gebeurtenis kunt gebruiken, naast de voorbeelden die hieronder worden getoond.
Deze sectie bevat een voorbeeld van elk gebeurtenistype in een complete indeling die je kunt kopiëren en direct op je website kunt plaatsen. Elk voorbeeld heeft de gebeurtenisgegevens die nodig zijn voor het bijhouden van activiteit op je website. Houd er rekening mee dat je de voorbeeldwaarden moet vervangen door de juiste statische waarde of de juiste dynamische variabele voor je website. Bijvoorbeeld: waarschijnlijk wil je het bestelbedrag dynamisch bijhouden, omdat de waarde van elke bestelling die wordt geplaatst op je website verschilt naargelang van wat een gebruiker koopt. Maar je wilt misschien een statische waarde toekennen aan het gebeurtenisgegeven lead_type, als dit alleen op één specifieke pagina wordt geplaatst.
Checkout
<script>
pintrk('track', 'checkout', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: "WINTER10",
property: 'Athleta',
search_query: "laarzen",
video_title: 'Zo style je Parker-laarzen',
lead_type: 'Nieuwsbrief',
line_items: [
{
product_name: 'Parker-laarzen',
product_id: '1414',
product_category: 'Schoenen',
product_variant_id: '1414-rood',
product_variant: 'Rood',
product_price: 99,99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Gebeurtenisgegevens: value, order_quantity, currency en event_id.
Zorg ervoor dat je de juiste valutacode invoert voor je website.
AddToCart
<script>
pintrk('track', 'addtocart', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: "WINTER10",
property: 'Athleta',
search_query: "laarzen",
video_title: 'Zo style je Parker-laarzen',
lead_type: 'Nieuwsbrief',
line_items: [
{
product_name: 'Parker-laarzen',
product_id: '1414',
product_category: 'Schoenen',
product_variant_id: '1414-rood',
product_variant: 'Rood',
product_price: 99,99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Gebeurtenisgegevens: value, order_quantity en currency.
Zorg ervoor dat je de juiste valutacode invoert voor je website.
PageVisit
<script>
pintrk('track', 'pagevisit', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: "WINTER10",
property: 'Athleta',
search_query: "laarzen",
video_title: 'Zo style je Parker-laarzen',
lead_type: 'Nieuwsbrief',
line_items: [
{
product_name: 'Parker-laarzen',
product_id: '1414',
product_category: 'Schoenen',
product_variant_id: '1414-rood',
product_variant: 'Rood',
product_price: 99,99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Signup
<script>
pintrk('track', 'signup', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: "WINTER10",
property: 'Athleta',
search_query: "laarzen",
video_title: 'Zo style je Parker-laarzen',
lead_type: 'Nieuwsbrief',
line_items: [
{
product_name: 'Parker-laarzen',
product_id: '1414',
product_category: 'Schoenen',
product_variant_id: '1414-rood',
product_variant: 'Rood',
product_price: 99,99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
WatchVideo
<script>
pintrk('track', 'watchvideo', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: "WINTER10",
property: 'Athleta',
search_query: "laarzen",
video_title: 'Zo style je Parker-laarzen',
lead_type: 'Nieuwsbrief',
line_items: [
{
product_name: 'Parker-laarzen',
product_id: '1414',
product_category: 'Schoenen',
product_variant_id: '1414-rood',
product_variant: 'Rood',
product_price: 99,99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Gebeurtenisgegevens: Video_title
Lead
<script>
pintrk('track', 'lead', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: "WINTER10",
property: 'Athleta',
search_query: "laarzen",
video_title: 'Zo style je Parker-laarzen',
lead_type: 'Nieuwsbrief',
line_items: [
{
product_name: 'Parker-laarzen',
product_id: '1414',
product_category: 'Schoenen',
product_variant_id: '1414-rood',
product_variant: 'Rood',
product_price: 99,99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Gebeurtenisgegeven: lead_type
Zoeken
<script>
pintrk('track', 'search', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: "WINTER10",
property: 'Athleta',
search_query: "laarzen",
video_title: 'Zo style je Parker-laarzen',
lead_type: 'Nieuwsbrief',
line_items: [
{
product_name: 'Parker-laarzen',
product_id: '1414',
product_category: 'Schoenen',
product_variant_id: '1414-rood',
product_variant: 'Rood',
product_price: 99,99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Gebeurtenisgegeven: search_query
ViewCategory
<script>
pintrk('track', 'viewcategory', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'Zo style je Parker-laarzen',
lead_type: 'Nieuwsbrief',
line_items: [
{
product_name: 'Parker-laarzen',
product_id: '1414',
product_category: 'Schoenen',
product_variant_id: '1414-rood',
product_variant: 'Rood',
product_price: 99,99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Door de gebruiker gedefinieerde gebeurtenissen
<script>
pintrk('track', 'user_defined_event_name', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: "WINTER10",
property: 'Athleta',
search_query: "laarzen",
video_title: 'Zo style je Parker-laarzen',
lead_type: 'Nieuwsbrief',
line_items: [
{
product_name: 'Parker-laarzen',
product_id: '1414',
product_category: 'Schoenen',
product_variant_id: '1414-rood',
product_variant: 'Rood',
product_price: 99,99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Custom
Het gebeurtenistype moet 'custom' zijn. Anders worden de conversies die door de tag worden bijgehouden, niet gerapporteerd in Advertentiebeheer.
<script>
pintrk('track', 'custom', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: "WINTER10",
property: 'Athleta',
search_query: "laarzen",
video_title: 'Zo style je Parker-laarzen',
lead_type: 'Nieuwsbrief',
line_items: [
{
product_name: 'Parker-laarzen',
product_id: '1414',
product_category: 'Schoenen',
product_variant_id: '1414-rood',
product_variant: 'Rood',
product_price: 99,99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Hier zijn wat voorbeelden van basiscodes gecombineerd met gebeurteniscodes. Vergeet niet te controleren of de gebeurteniscode op je website na de basiscode is geplaatst.
Voorbeeld conversietag-ID: 123456789 (vervang dit door je Pinterest conversietag-ID)
Voorbeeld gebeurteniscode: PageVisit
<head>
<script type="text/javascript">
!function(e){if(!window.pintrk){window.pintrk=function(){window.pintrk.queue.push(
Array.prototype.slice.call(arguments))};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}
("https://s.pinimg.com/ct/core.js"); pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1" />
</noscript>
</head>
Voorbeeld conversietag-ID: 123456789 (vervang dit door je Pinterest conversietag-ID)
Voorbeeld gebeurteniscodes: PageVisit en AddToCart
<head>
<script type="text/javascript">
!function(e){if(!window.pintrk){window.pintrk=function(){window.pintrk.queue.push(
Array.prototype.slice.call(arguments))};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}
("https://s.pinimg.com/ct/core.js"); pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
pintrk('track', 'addtocart');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1" />
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=addtocart&noscript=1" />
</noscript>
</head>