REST API v4: POST /events/website/pageview
Deze methode stelt je in staat om een website pageview event te registreren. Dit event treedt op wanneer een gebruiker een specifieke pagina bekijkt op een website.
Dit is een HTTP POST methode naar het volgende adres:
https://api.copernica.com/v4/events/website/pageview
Deze POST call triggert een website pageview event. De verdere verwerking van dit event is afhankelijk van de configuratie van je account. Als gevolg van deze POST call:
- Het event wordt gelogd.
- Bijbehorende opvolgacties worden uitgevoerd.
Parameters
De volgende parameter moet verplicht worden meegegeven aan dit endpoint:
- url: De URL van de bekeken pagina. (verplicht)
Naast deze verplichte parameter kunnen aan dit evenement extra attributen worden toegevoegd die gebruikt kunnen worden voor verdere analyse of opvolgacties.
Geaccepteerde formaten
De API-call accepteert zowel JSON-data als traditionele POST-data
(application/x-www-form-urlencoded
). Hieronder staan voorbeelden van beide
formaten.
Voorbeeld met JSON
POST /v4/events/website/pageview HTTP/1.1
Host: api.copernica.com
Authorization: Bearer your-access-token
Content-Length: 30
Content-Type: application/json
{
"url": "https://example.com/page1"
}
Voorbeeld met URL-gecodeerde data
POST /v4/events/website/pageview HTTP/1.1
Host: api.copernica.com
Authorization: Bearer your-access-token
Content-Length: 27
Content-Type: application/x-www-form-urlencoded
url=https%3A%2F%2Fexample.com%2Fpage1
Voorbeeld met PHP
// Vereiste scripts
require_once('copernica-rest-api.php');
// Vervang met jouw access token
$api = new CopernicaRestAPI("your-access-token", 4);
// Voer het verzoek uit
$api->post("/events/website/pageview", array(
'url' => 'https://example.com/page1'
));
Dit voorbeeld vereist de REST API klasse.