REST API v4: GET clicks (HTML mailing destination)
Net zoals je van een mailing statistieken op kunt vragen kun je ook de statistieken per emailing destination opvragen. Je kan deze opvragen met een HTTP GET call naar de volgende URL:
https://api.copernica.com/v4/html/destination/$id/clicks
Hier moet $id
vervangen worden door de ID van de mailing destination. Deze methode
ondersteunt ook het gebruik van de fields parameter
voor het timestamp veld.
Teruggegeven velden
Deze methode geeft een JSON object terug met clicks onder het 'data' veld. Voor elke click is de volgende informatie beschikbaar:
- ID: ID van de click.
- link_id: ID van de geklikte link.
- link: De geklikte link.
- link_title: Titel van de geklikte link.
- timestamp: Tijdstempel van de click.
- ip: De IP waar de click vandaan kwam.
- user-agent: De user agent string van de clicker.
- referer: De referer van de clicker.
- emailing: De ID van de emailing waar de click vandaan kwam.
- destination: De destination waar de click vandaan kwam.
- profile: De ID van het profiel waar de click vandaan kwam.
- subprofile: De ID van het subprofiel waar de click vandaan kwam (als deze beschikbaar is).
JSON voorbeeld
De JSON van een enkele click ziet er bijvoorbeeld zo uit:
{
"ID":"19431",
"link_id":"3145",
"link":"{webversion}",
"link_title":"",
"timestamp":"2010-11-03 15:07:33",
"ip":"0.0.0.0",
"useragent":"Firefox 3.6, WinXP",
"referer":null,
"emailing":"1914",
"destination":"823456",
"profile":"2290961",
"subprofile":null
}
PHP voorbeeld
Dit script demonstreert hoe je de API methode kunt gebruiken:
// vereiste scripts
require_once('CopernicaRestAPI.php');
// verander dit naar je access token
$api = new CopernicaRestAPI("your-access-token", 4);
// stel de periode in
$parameters = array(
'fields' => array('timestamp>2019-01-01', 'timestamp<2019-02-01')
);
// voer het verzoek uit
print_r($api->get("html/destination/{$destinationID}/clicks/", $parameters));
Dit voorbeeld vereist de REST API klasse.
Meer informatie
- Overzicht van alle REST API calls
- Opvragen van een HTML mailing destination
- Opvragen van abuses voor een HTML mailing destination
- Opvragen van deliveries voor een HTML mailing destination
- Opvragen van errors voor een HTML mailing destination
- Opvragen van impressions voor een HTML mailing destination
- Opvragen van unsubscribes voor een HTML mailing destination