Website tracker SDK | copernica.pageview()

Deze functie kan gebruikt worden om een paginaweergave-event te triggeren. Dit wordt in principe impliciet gedaan bij elke paginaweergave, en hoef je dus niet zelfstandig te doen. Mocht je echter vanwege privacy-richtlijnen tracking hebben uitschakeld, een 'single-page application' hebben, of om andere redenen kunstmatig paginaweergaven willen doorsturen, dan kun je dit doen door deze functie aan te roepen.

Je kunt wat parameters aan de functie meegeven om meer gegevens over de pageview door te sturen. Deze parameters moeten op zijn minst een URL bevatten, maar als je dat niet specificeert wordt standaard de huidig URL gebruikt. Verder ben je vrij in wat voor informatie je meegeeft:

// parameters die je mee zou kunnen geven
coperica.pageview({
    url:    'https://mijndomein.nl/voorbeeldpagina',
    info:   'meer informatie om in een opvolgactie te gebruiken',
    extra:  'nog wat extra info',
});

Single-page-applicaties

Als tracking is ingeschakeld, dan wordt bij elke nieuw bezochte pagina automatisch een call naar Copernica gestuurd. Dit werkt goed bij traditionele websites waar elke klik automatisch een nieuwe pagina inlaadt. Vandaag de dag worden websites echter steeds vaker geïmplementeerd als "single page applications". Als een bezoeker dan op een link of een button klikt, dan wordt niet meer de hele pagina ververst, maar slechts een onderdeel van de pagina.

Dit zorgt vaak voor een gebruiksvriendelijkere, snellere en meer interactieve website. Maar tracking werkt daardoor niet zo goed meer. In een dergelijk geval kun je zelf de copernica.pageview()-functie aanroepen. Er wordt dan alsnog een pageview gelogd, zelfs al blijft de bezoeker formeel gezien op dezelfde pagina.

Returnwaarde

De functie returneert een javascript promise waarmee je toegang hebt tot een result object met een status code. Errors hebben soms ook een 'message' waarin je kan zien wat er fout is gegaan:

copernica.pageview({}).then(succes => {

    // laat de code van de succes zien
    console.log('succes', succes.code);
}, error => {

    // een error heeft ook een message zodat je weet wat er fout is gegaan 
    console.log('error', error.code, error.message);
});

Voorbeelden

In dit voorbeeld laten we zien hoe je een paginaweergave-event kan triggeren met een zelf ingestelde pad als een gebruiker op een knop klikt dat een voorbeeldpagina zou moeten laten zien op jouw 'single-page application':

// knop om opvolgacties te zien
<button onclick="verwerkKlik('voorbeeldpagina')">Laat voorbeeldpagina zien</button>

// de javascript code op jouw pagina
<script>

    // een functie die je aan kan roepen als een link of knop 
    // wordt geklikt met 'onclick="verwerkKlik(pad)"'
    function verwerkKlik(pad) {

        // zorg ervoor dat het standaardgedrag van 
        // een klik niet wordt uitgevoerd
        event.preventDefault();

        // maak de url met jouw pad
        const url = 'https://mijndomein.nl/' + pad

        // trigger een paginaweergave-event, je kan hier ook nog extra informatie
        // aan toevoegen als je dat wilt gebruiken in jouw opvolgactie
        copernica.pageview({ 
            url:    url,
            info:   'meer informatie dat je in je opvolgactie wilt gebruiken',
        });

        // doe andere dingen hier als er op een link of knop wordt geklikt
    }
</script>