The Report API now allows grouping and filtering by geozone

If you run websites in multiple countries and are interested in grouping your reports per offer “geozone”, you now can you use &group=geozone. For instance,

http://api.affinitad.com/report/v1?start=2013-04-01&end=2013-04-01&group=geozone&format=xml

will return:

<?xml version="1.0"?>
<twenga>
  <results total="3">
    <result>
      <geozone>FR</geozone>
      <impressions>213326</impressions>
      <clicks>214</clicks>
      <keywords>524991</keywords>
      <revenues>16.49</revenues>
      <ctr>0.00</ctr>
      <ecpm>0.08</ecpm>
    </result>
    <result>
      <geozone>NL</geozone>
      <impressions>178491</impressions>
      <clicks>643</clicks>
      <keywords>332192</keywords>
      <revenues>43.08</revenues>
      <ctr>0.00</ctr>
      <ecpm>0.24</ecpm>
    </result>
    <result>
      <geozone>IT</geozone>
      <impressions>784046</impressions>
      <clicks>2765</clicks>
      <keywords>1068064</keywords>
      <revenues>158.50</revenues>
      <ctr>0.00</ctr>
      <ecpm>0.20</ecpm>
    </result>
  </results>
  <totals>
    <impressions>1175863</impressions>
    <clicks>3622</clicks>
    <keywords>1925247</keywords>
    <revenues>218.07</revenues>
  </totals>
  <averages>
    <impressions>391954.33</impressions>
    <clicks>1207.33</clicks>
    <keywords>641749.00</keywords>
    <revenues>72.69</revenues>
    <ctr>0.00</ctr>
    <ecpm>0.06</ecpm>
  </averages>
</twenga>

To filter by a specific geozone, you can use the &geozone=##2-letter ISO Country Code (ISO 3166-1)## query parameter. For instance, to get detailed statistics for United Kingdom :

http://api.affinitad.com/report/v1?start=2013-04-01&end=2013-04-11&group=day&format=json&geozone=GB

will return:

{
  "results": {
    "result": [
      {
        "date": "2013-04-11",
        "impressions": "3",
        "clicks": "0",
        "keywords": "23",
        "revenues": "0.00",
        "ctr": "0.00",
        "ecpm": "0.00"
      }
    ],
    "@attributes": {
      "total": 1
    }
  },
  "totals": {
    "impressions": "3",
    "clicks": "0",
    "keywords": "23",
    "revenues": "0.00"
  },
  "averages": {
    "impressions": "3.00",
    "clicks": "0.00",
    "keywords": "23.00",
    "revenues": "0.00",
    "ctr": "0.00",
    "ecpm": "0.00"
  }
}