Handleiding voor Implementatie van beslist.nl TAG via de Hard Coded variant

Hard Coded

Disclaimer: Deze handleiding is bedoeld voor gebruikers met technische kennis van HTML en JavaScript. Voer deze stappen alleen uit als je bekend bent met het bewerken van de broncode van je website en het werken met datalayers.

Deze handleiding helpt je stap voor stap bij het implementeren van een Beslist Tag op je website door middel van hard-coded scripts. Deze methode omvat het direct plaatsen van twee scripts op de website: één voor configuratie en één voor conversie.

Voorbereiding

  1. Zorg ervoor dat je toegang hebt tot de code van de website.
  2. Heb je Advertiser_ID (ook wel ShopID genoemd) bij de hand.

Implementatiestappen

Script 1: Configuration tag

De configuration tag is het script wat elke keer inlaadt als een bezoeker een pagina opent.

Voeg de Configuration Tag toe aan de head

  1. Het configuratiescript moet in <head> van de site worden geplaatst op alle pagina’s.
  2. Open de HTML-code van je website.
  3. Zoek de <head>-tag in de HTML-code van je site.
  4. Voeg het volgende script toe binnen de <head>-sectie:<!-- Voor het triggeren van een configuratie-event Beslist --> <script src="https://ct.beslist.nl/ct_refresh?shopid=ADVERTISER_ID"></script>
  5. Vervang ADVERTISER_ID door je werkelijke Advertiser_ID.
  6. Sla de wijzigingen op.

Script 2: Conversie

Het conversiescript moet worden getriggerd zodra er een conversie plaatsvindt.

Voeg de Conversion Tag toe

  1. Bepaal de locatie in de code van je website waar het conversie-event plaatsvindt, meestal op de orderbevestigingspagina of bedankpagina.
  2. Voeg het volgende script in op het punt waar de conversie moet worden gevolgd:<!-- Voor het triggeren van een conversie-event --> <script> if(typeof(window.bslst_event) !== "undefined"){ window.bslst_event("ADVERTISER_ID", "conversion", { "transaction_id": "example.example", "value": "example.example", "including_vat": "example.example" }); } </script>
  3. Het Conversion script moet altijd ingeladen worden na het configuration script
  4. Vervang de placeholders “example.example” en “ADVERTISER_ID” met de daadwerkelijke gegevens van je site:
    • ADVERTISER_ID: Je Advertiser_ID, hetzelfde als in het configuratiescript.
    • transaction_id: Het unieke ordernummer.
    • value: De totale waarde van de transactie in euro’s.
    • including_vat: true als het bedrag inclusief BTW is, false als het exclusief BTW is.
  5. Zorg ervoor dat de waarden van de variabelen tussen aanhalingstekens staan, zodat ze worden omgezet naar een “string”, aangezien waardes van het type “boolean” en “integer/float” niet zijn toegestaan.
  1. Voorbeeld van een ConversiescriptHieronder staat een voorbeeld van hoe het conversiescript eruit kan zien met daadwerkelijke waardes:<script> if(typeof(window.bslst_event) !== "undefined"){ window.bslst_event("12345678", "conversion", { "transaction_id": "ecommerce.OrderID", "value": "ecommerce.Revenue", "including_vat": "true" }); } </script>

Aanvullende Informatie

  • Het Testen van de Tag:
    • Zorg ervoor dat het configuratiescript correct wordt geladen op alle pagina’s door de netwerkverzoeken in de ontwikkelaarstools van je browser te controleren.
    • Verifieer dat het conversiescript correct wordt uitgevoerd bij een conversie-event middels een testbestelling te controleren of de waardes die meegestuurd worden in het netwerkverzoek voor de conversie kloppen.
  • Voorkom Dubbele Tags:
    • Zorg ervoor dat dezelfde tag niet meerdere keren op de website staat om problemen te voorkomen.
    • Verwijder dubbele tags met dezelfde ID uit de template en andere instellingen.