Upsight logo Back to top

Campaign Reports for Advertisers

Aggregate Campaign Report

Description


Returns aggregate data for one campaign.

Aggregate Campaign Report

HTTP:GET


/report/game/<game_id:int>/campaign/<campaign_id:int>/report

Aggregate Campaign Report

Parameters


ParameterTypeDescription
game_id int The Game ID that this content unit is associated with.
campaign_id int The Campaign Id the report is associated with.
auth Authentication token (authentication header may be used instead). Required

Aggregate Campaign Report

Example Request


GET /report/game/2012/campaign/2225/report?startts=1320883200&endts=1323993600

Aggregate Campaign Report

Example Response


{
    "errobj": null,
    "response": {
        "conversions": 14044,
        "spend": 11149.72,
        "value": 19403.33,
        "startts": 1320883200,
        "actions": 96599,
        "conversionrate": 14.54,
        "actionrate": 5.87,
        "endts": 1323993600,
        "impressions": 1646949,
        "ecpm": 6.77
    },
    "error": null
}

Detailed Campaign Report

Description


Returns meta data and a list of data points for the specified report type. Each data point is returned as a (timestamp, value) pair. Data points are spaced out according to the granularity parameter (set to 'day' by default). The API will not perform interpolation to fill gaps in reporting with intermediate data points.

Detailed Campaign Report

HTTP:GET


/report/game/<game_id:int>/campaign/<campaign_id:int>/report/<report_type:str>

Detailed Campaign Report

Parameters


ParameterTypeDescription
game_id int The Game ID that this campaign unit is associated with.
campaign_id int The Campaign ID the report is associated with.
report_type string See the Detailed Campaign Report Types table
auth Authentication token (authentication header may be used instead). Required

Detailed Campaign Report

Example Request


GET /report/game/1793/campaign/2559/report/impressions?startts=1320883200&endts=1323993600

Detailed Campaign Report

Example Response


{
    "errobj": null,
    "response": {
        "report": "impressions",
        "game_ids": [
            1793
         ],
         "startts": 1320883200,
         "campaign_ids": [
             2559
          ],
         "endts": 1323993600,
         "datapoints": [
             [
                 1322092800,
                 31132
             ],
             [
                 1322179200,
                 26934
             ],
             [
                 1322265600,
                 29146
             ],
             ...
         ],
     },
     "error": null
}