Benieuwd naar de impact van jouw keuzehulpen op b.v. omzet en conversie? Activeer dan je Impact Dashboard in Aiden:
Het Impact Dashboard in Aiden
Het Impact Dashboard werkt door de aankopen van klanten door te sturen naar Aiden. Om dit te doen plaats je het Impact Script - een klein stukje JavaScript - op de order confirmation page.
Zo activeer je het Impact Dashboard:
Log in op je Aiden account
Ga naar een van je apps
Ga naar Analytics
Klik op de tab Impact op Set up en volg de stappen!
Tenzij je zelf technisch handig bent heb je hier waarschijnlijk een developer voor nodig. Alle instructies vind je hieronder. Zorg ervoor dat alle stappen zorgvuldig worden doorlopen, en gebruik de checklist onderaan dit artikel om te checken of alles correct is ingesteld.
💡 Goed om te weten: Het Impact Script stuurt alle orders van de website door, waarop Aiden vervolgens checkt of de order aan een keuzehulpgebruiker kan worden gekoppeld. In de Aiden backend kunnen we namelijk zien of een product is geadviseerd in een bepaalde sessie.
Check voor de zekerheid even of je deze order data mag delen volgens je algemene voorwaarden.
💡 Product varianten: Door product varianten in te stellen in je catalogus kan Aiden betere inzichten tonen in het Impact Dashboard. Lees in deze tutorial hoe je product varianten instelt.
1. Plaats het Aiden basis script
Hoogstwaarschijnlijk staat dit script al in jullie webshop (anders zouden jullie keuzehulpen niet goed werken), maar voor de zekerheid: volg hier stap 1 en check vooral of het Aiden script aanwezig is op jullie order confirmation page.
2. Integreer met het Impact script
Kies eerst hoe je het Impact script wil integreren, dat kan direct op je website of via Google Tag Manager (GTM).
❗️Let op: Plaats de scripts bij voorkeur niet via Google Tag Manager! Het versturen van de aankoopinformatie wordt dan geblokkeerd door adblockers. Dit resulteert in een significante onderrapportering van de metrics in Aiden.
Dat gezegd hebbende: we weten dat integratie via GTM vaak de snelste optie is, dus ook die uitleg vind je verderop in deze tutorial.
2.1. Directe integratie
Om de aankoopinformatie door te sturen kun je dit voorbeeldscript als startpunt gebruiken en op de order confirmation page plaatsen. Zorg ervoor dat de waardes in orderId, currency, en products per order dynamisch worden gevuld met de gevraagde aankoopinformatie.
Ga na het plaatsen van het script door met stap 3.
Bekijk voorbeeldscript
Bekijk voorbeeldscript
<script type="text/javascript">
window._aiden = window._aiden || []
window._aiden.push({
event: "Purchase",
// debug: Optioneel.
// Zet op true om te activeren.
// Kan gebruikt worden om te kijken of events correct verstuurd worden.
// Als een event incorrect is wordt dit in de console gelogt.
// Weghalen voor productie gebruik, anders worden er geen events verwerkt!
debug: false,
// apiKey: begint met 'AID-' en vind je onder "Analyze" bij een keuzehulp in Aiden.
apiKey: "YOUR API KEY", // Vervangen door eigen api-key
// orderID: bestelnummer
orderId: "Order Identifier", // Vervangen door het unieke ID van de order
// currency:
// ISO-4217 valuta code waarin betaald is.
// https://nl.wikipedia.org/wiki/ISO_4217
currency: "EUR",
// Inhoud van de bestelling, een array met per product een aidenProductId, quantity en price
products: [
{
// aidenProductId:
// Unieke identifier die in Aiden ingesteld staat.
// Als producten via een product feed zijn gekoppeld is het
// aidenProductId hetzelfde als de waarde in het <id> element
// in de XML feed.
aidenProductId: "12345678", // vervangen door juiste product-id
quantity: 4, // vervangen door aantal gekochte items
price: 99.99, // vervangen door prijs per stuk
}
],
})
</script>
❗️Let op: De IDs die Aiden ontvangt via een CSV of Google Shopping Feed worden gebruikt om aangekochte producten te herkennen en te koppelen aan keuzehulp sessies. Zorg er dus voor dat de juiste IDs meegestuurd worden. Mocht een developer dit voor je doen, geef ze dan door welk soort ID ze mee moeten sturen.
2.1. Integratie via Google Tag Manager
Met Google Tag Manager integreren kan, echter vergroot dit wel de kans op onderrapportage doordat adblockers het GTM blokkeren. Ook voegt het extra complexiteit toe aan de integratie. De onderstaande stappen geven in grote lijnen aan wat je moet doen om Impact analytics op te zetten met Google Tag Manager. De exacte stappen zijn afhankelijk van hoe Google Tag Manager is opgezet op je webshop en welke andere Triggers en Variables al zijn ingesteld.
2.1.1. Maak een Tag aan
Maak een Tag aan van het type Custom HTML. Plak hier het onderstaande voorbeeldscript in. Stel als trigger een "Page view" in die alleen triggert op de order confirmation page.
Bekijk het voorbeeldscript
Bekijk het voorbeeldscript
<script type="text/javascript">
window._aiden = window._aiden || []
window._aiden.push({
event: "Purchase",
// apiKey: begint met 'AID-' en vind je onder "Analyze" bij een keuzehulp in Aiden.
apiKey: "YOUR API KEY", // Vervangen door eigen api-key
orderId: "{{Purchase - order ID}}", // Vervangen door GTM-variabele waarin het transaction/order ID zit
// currency:
// ISO-4217 valuta code waarin betaald is.
// https://nl.wikipedia.org/wiki/ISO_4217
currency: "EUR",
// Inhoud van de bestelling
// Belangrijk:
// 1. Zorg ervoor dat het ID in aidenProductId gelijk is aan het product ID in de catalogus in Aiden!
// 2. Zorg ervoor dat de price die in de product variabele zit de prijs per stuk is
products: ({{Purchase - order products}} || []).map(function (e) {
if(!e.hasOwnProperty('aidenProductId')) {
//
e['aidenProductId'] = e["id"] || e["item_id"];
}
return e;
})
})
</script>
2.1.2. Vervang de standaard waarden
Er staan een aantal voorbeeld waardes in het script die nog vervangen moeten worden.
❗️Let op: De waarde in aidenProductId moet overeenkomen met de product ID's in de catalogus in Aiden. Check dus welke ID's er in Aiden gebruikt worden voordat je het script implementeert.
💡 GTM Triggers en variables: Waarschijnlijk staan er al tags ingesteld die de aankopen doorsturen naar bijvoorbeeld een CRM, Ad- en of analyticsplatform. De triggers en variables uit die tags kan je vaak hergebruiken in de Aiden impact tag.
API-key
Ten eerste moet je de API-key invullen waar nu "YOUR API KEY" staat. De API key kan je in Aiden vinden door op je naam te klikken > settings > API keys. Zorg ervoor dat de API key in het script tussen aanhalingstekens staat, zoals "YOUR API KEY" ook staat.
{{Purchase - order ID}}
Vervang deze variabele door de variabele die het order/transactie ID bevat. Je kan de juiste variabele vinden door in de lijst met variabelen te zoeken naar "order id", "orderid", "transactionid" en "transaction id", of door bij een andere purchase-tag te kijken welke variabelen gebruikt worden.
{{Purchase - order products}}
Vervang deze variabele door de variabele waarin de aangekochte producten staan. Ieder product moet minimaal bestaan uit een id of item_id, de quantity (hoeveelheid) en price.
De product-id moet gelijk zijn aan het product ID in de Aiden catalogus. Anders kunnen we het aangekochte producten niet koppelen aan een geadviseerd product.
Vaak bevat de naam van de juiste variabele de woorden purchase en products, dus daarop zoeken kan helpen bij het vinden van de juiste variabele. Je kan ook kijken welke variabelen gebruikt worden in andere purchase-tags.
❗️Let op: Controleer of de prijs die met een product meegestuurd wordt de prijs per product is en niet de prijs per product maal het aantal bestelde producten.
Variabelen niet gevonden?
Indien de variablelen nog niet bestaan moeten ze nog aangemaakt worden. Hier vind je hoe je variabelen aanmaakt en ervoor zorgt dat ze gevuld zijn.
3. Checklist
Bekijk de volgende vragen en zorg ervoor dat je alle vragen met zekerheid met “JA” kan beantwoorden.
Komen de id's in het aidenProductId-veld overeen met die in de catalogus in Aiden?
Wordt de prijs per stuk meegestuurd in het price-veld? In Aiden wordt het bedrag maal de quantity gedaan, als dit dus niet de prijs per stuk is zal de impact niet kloppen.
Bevat het orderId-veld een unieke waarde voor iedere bestelling?
Wordt het embed-script ook ingeladen op de pagina waar het event verstuurd wordt?
Wordt het event vanaf hetzelfde domein verstuurd als waarop de keuzehulp staat, dus niet vanaf bijvoorbeeld een subdomein?
Staat het impact script niet meer op een test/staging omgeving?
4. Wacht tot de eerste aankoop is verstuurd
Als een gebruiker een aankoop doet zal er data naar Aiden worden verstuurd. Vervolgens kun je onder "Analytics" in Aiden de integratie verifiëren. Als alles goed binnen komt, dan is de integratie succesvol en zijn de Impact analytics nu beschikbaar voor alle keuzehulpen!