REST API v3: GET testgroup statistics (Publisher)

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

https://api.copernica.com/v3/publisher/testgroup/$id/statistics?access_token=xxxx

Hier moet $id vervangen worden door de ID van de testgroep.

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 velden

De teruggegeven waarde is een JSON object met de volgende velden:

  • abuses: Array met het aantal totale ('total') en unieke ('unique') abuses.
  • clicks: Array met het aantal totale ('total') en unieke ('unique') clicks.
  • errors: Array met het aantal totale ('total') en unieke ('unique') errors.
  • impressions: Array met het aantal totale ('total') en unieke ('unique') impressions.
  • unknown: Array met het totale ('total') aantal onbekende statistieken.
  • unsubscribes: Array met het aantal totale ('total') en unieke ('unique') unsubscribes.

JSON voorbeeld

De JSON voor de statistieken ziet er bijvoorbeeld zo uit:

{  
   "clicks":{  
      "total":"3",
      "unique":"2"
   },
   "impressions":{  
      "total":"5",
      "unique":"5"
   },
   "errors":{  
      "total":"0",
      "unique":"0"
   },
   "unsubscribes":{  
      "total":"1",
      "unique":"1"
   },
   "abuses":{  
      "total":"0",
      "unique":"0"
   },
   "unknown":{  
      "total":"1"
   }
}

PHP voorbeeld

Het volgende script demonstreert hoe je deze API methode kunt gebruiken:

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

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

// 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("publisher/testgroup/{$testgroupID}/statistics", $data));

Dit voorbeeld vereist de REST API klasse.

Meer informatie