REST API v4: GET document statistics (HTML mailing)

Je kunt de statistieken van een HTML mailing document opvragen door een HTTP GET request te sturen naar de volgende URL:

https://api.copernica.com/v4/html/document/$id/statistics

Hier moet $id vervangen worden door de ID van het emailing document.

Beschikbare parameters

  • begintime: Start datum (en tijd) voor de statistieken (YYYY-MM-DD HH:MM:SS formaat).
  • endtime: Eind datum (en tijd) voor de statistieken (YYYY-MM-DD HH:MM:SS formaat).
  • type: Het type mailings om op te vragen: Massa ('mass') mailings, individuele ('individual') mailings of alle mailings ('both').
  • followups: Geeft aan of we alleen emailings van opvolgacties ('yes') opvragen, alleen emailings die geen gevolg zijn van een opvolgactie ('no') of alle emailings ('both').
  • test: Geeft aan of we alleen test emailings ('yes') opvragen, alleen mailings die geen test waren ('no') of alle mailings ('both').
  • mindestinations: Vraag alleen mailings met dit minimum aantal ontvangers op.
  • maxdestinations: Vraag alleen mailings met dit maximum aantal ontvangers op.

Teruggegeven waarde

Velden

Het JSON object bevat de volgende velden:

  • abuses: Array met de velden 'total' en 'unique' voor het aantal kliks en het aantal unieke abuses respectievelijk.
  • clicks: Array met de velden 'total' en 'unique' voor het aantal kliks en het aantal unieke kliks respectievelijk.
  • errors: Array met de velden 'total' en 'unique' voor het aantal kliks en het aantal unieke errors respectievelijk.
  • impressions: Array met de velden 'total' en 'unique' voor het aantal impressies en het aantal unieke impressies respectievelijk.
  • unsubscribes: Array met de velden 'total' en 'unique' voor het aantal kliks en het aantal unieke unsubscribes respectievelijk.
  • unknown: Array met het velden 'total' voor de statistieken die niet binnen de bovenstaande categorieën vallen.

Voorbeeld

Hieronder vind je een voorbeeld van zo'n JSON object:

{  
   "clicks":{  
      "total":"53",
      "unique":"14"
   },
   "impressions":{  
      "total":"80",
      "unique":"49"
   },
   "errors":{  
      "total":"2412",
      "unique":"2289"
   },
   "unsubscribes":{  
      "total":"0",
      "unique":"0"
   },
   "abuses":{  
      "total":"0",
      "unique":"0"
   },
   "unknown":{  
      "total":"22"
   }
}

PHP voorbeeld

Het volgende script demonstreert hoe je deze 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
$data = array(
    'begintime' => "2019-01-01 00:00:00", 
    'endtime'   => "2019-02-01 00:00:00"
);

// voer het verzoek uit
print_r($api->get("html/document/{$documentID}/statistics/", $data));

Dit voorbeeld vereist de REST API klasse.

Meer informatie