REST API v4: GET statistics (Drag and drop mailing)
Je kunt de statistieken van een Marketing Suite mailing opvragen door een HTTP GET-request te sturen naar de volgende URL:
https://api.copernica.com/v4/draganddrop/emailing/$id/statistics
Hier moet $id
vervangen worden door de ID van de mailing.
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).
Teruggegeven waarde
Velden
Het JSON-object bevat de volgende velden:
- destinations: Aantal ontvangers van deze mailing.
- abuses: Array met het veld 'total' en 'unique' voor het aantal abuses.
- clicks: Array met de velden 'total' en 'unique' voor het aantal kliks en het aantal unieke kliks respectievelijk.
- deliveries: Array met het veld 'total' voor het aantal deliveries.
- errors: Array met de velden 'total' en 'unique' voor het aantal errors.
- impressions: Array met de velden 'total' en 'unique' voor het aantal impressies en het aantal unieke impressies respectievelijk.
- retries: Array met het veld 'total' en 'unique' voor het aantal retries.
- unsubscribes: Array met het veld 'total' en 'unique' voor het aantal unsubscribes.
- dominant_results: Array met het dominante resultaat per onderdeel.
Voorbeeld
Hieronder vind je een voorbeeld van zo'n JSON-object:
{
"destinations": 10,
"deliveries": {
"total": 10
},
"errors": {
"total": 1,
"unique": 1
},
"impressions": {
"total": 4,
"unique": 3
},
"clicks": {
"total": 2,
"unique": 2
},
"unsubscribes": {
"total": 0,
"unique": 0
},
"abuses": {
"total": 0,
"unique": 0
},
"unknown": {
"total": 0
},
"dominant_results": {
"destinations": 10,
"errors": 1,
"abuses": 0,
"unsubscribes": 0,
"clicks": 2,
"impressions": 2,
"deliveries": 0
}
}
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("draganddrop/emailing/{$emailingID}/statistics/", $data));
Dit voorbeeld vereist de REST API-klasse.