REST API: GET impressions (Marketing Suite)

Er worden statistieken bijgehouden over elke mailing die verstuurd wordt met Copernica om je meer inzicht te geven in de prestatie hiervan. Impressions zijn een van de statistieken die worden bijgehouden. Je kan alle impressies voor een account opvragen met een HTTP GET call naar de volgende URL:

https://api.copernica.com/v2/ms/impressions?access_token=xxxx

Deze methode ondersteunt ook het gebruik van de fields parameter voor het timestamp veld.

Parameters

De parameters voor deze methode kunnen ingesteld worden om alleen de statistieken voor een bepaalde periode op te halen. De volgende optionele parameters zijn beschikbaar:

  • begintime: De tijdstempel waarna de impression gemaakt moet zijn (YYYY-MM-DD HH:MM:SS format).
  • endtime: De tijdstempel waarvoor de impression gemaakt moet zijn (YYYY-MM-DD HH:MM:SS format).

Teruggegeven velden

Deze methode geeft een JSON object terug met impressions onder het 'data' veld. Voor elke impression is de volgende informatie beschikbaar:

  • ID: De ID van de impression.
  • mailing: De ID van de mailing.
  • timestamp: Tijdstempel van de impression.
  • ip: De IP waar de impression vandaan kwam.
  • useragent: User agent string van de machine waar de impression vandaan kwam.
  • device: Type apparaat waar de klik vandaan kwam ('desktop','tablet','mobile','unknown').
  • destination: De ID van de destination die de impression veroorzaakte.
  • profile: De ID van het profiel die de impression veroorzaakte.
  • subprofile: De ID van het subprofiel die de impression veroorzaakte.

JSON voorbeeld

Een enkele impression ziet er bijvoorbeeld zo uit.

{  
   "ID":"1",
   "mailing":"412",
   "timestamp":"2014-10-09 13:41:46",
   "ip":"2a03:e280:0:1::1",
   "useragent":"Mozilla\/5.0 (Ubuntu; X11; Linux x86_64; rv:8.0) Gecko\/20100101 Firefox\/8.0",
   "device":"desktop",
   "destination":"112",
   "profile":13453,
   "subprofile":null
}

PHP voorbeeld

Dit script demonstreert hoe je de API methode kunt gebruiken:

// vereiste scripts
require_once('copernica_rest_api.php');

// verander dit naar je access token 
$api = new CopernicaRestAPI("your-access-token", 2);

// voer het verzoek uit
print_r($api->get("ms/impressions"));

Dit voorbeeld vereist de REST API klasse.

Meer informatie