GetOfflineReportList (Live)
Returns a list of reports on dynamic text ads that have been created or are being generated.
Input data
The input data structure in JSON is shown below.
{
"method": "GetOfflineReportList"
}
Output data
The method returns an array of OfflineReportInfo objects, each of which contains information about a single report. The array can have a total of up to five objects. The array is sorted by decreasing Id. The output data structure in JSON is shown below.
{
"data": [
{ /* OfflineReportInfo */
"Type": (string),
"Id": (int),
"Status": (string),
"Url": (string)
}
...
]
}
Parameters are described below.
Parameter | Description |
OfflineReportInfo object | |
---|---|
Type | The campaign type that the report was generated for: dynamic_text_ad. |
Id | ID of the report. |
Status | Report status:
|
Url | Link for downloading the report from the server. Returned if the report was created successfully. The report is accessible over the HTTPS protocol. |
Parameter | Description |
OfflineReportInfo object | |
---|---|
Type | The campaign type that the report was generated for: dynamic_text_ad. |
Id | ID of the report. |
Status | Report status:
|
Url | Link for downloading the report from the server. Returned if the report was created successfully. The report is accessible over the HTTPS protocol. |
Sample report
The report is generated in text/tab-separated-values format.
The first row of the report contains the names of fields.
A sample report is shown below.
Date CampaignName CampaignId AdGroupName AdGroupId AdId Title Text Url SearchQuery Impressions Clicks CTR Cost AvgClickCost AvgDepth Conversion AvgGoalCost GoalsNum
31.08.2015 Dynamic ad campaign 12345 Group of dynamic ads 98765 7654321 Iron Rowenta Focus DW6020D1 You'll enjoy buying irons! http://www.example.com/irons/rowenta/dw6020d1 buy iron rowenta 133 24 0.180451127819549 191.778 7.99075 1 1 47.9445 4
31.08.2015 Dynamic ad campaign 12345 Group of dynamic ads 98765 7654321 Steamer Philips GC660/05 You'll enjoy buying irons! http://www.example.com/irons/philips/gc660/05 How to choose a steamer 200 43 0.215 296.38 6.89255813953488 1.4 1 59.276 5
Parameters are described below.
Parameter | Description |
Date | The data statistics are provided for. If the GroupByDate input parameter has the value “week” or “month”, the first date of the week or month is specified. |
CampaignName | The campaign name. |
CampaignId | The campaign ID. |
AdGroupName | Name of the ad group. |
AdGroupId | ID of the ad group. |
AdId | The ad ID. |
Title | Ad title. |
Text | Ad text. |
Url | Ad link. |
SearchQuery | The search query that triggered the ad. |
Impressions | Number of impressions in the search. |
Clicks | Number of clicks in the search. |
CTR | The ratio of clicks on an ad to the number of impressions (click-through rate). |
Cost | The cost per click on search (in the campaign currency). |
AvgClickCost | The average CPC: the ratio of the cost of clicks (in the campaign currency) to the number of clicks. |
AvgDepth | Average session depth on the advertiser's site. |
Conversion | The ratio of conversions to the total number of sessions. |
AvgGoalCost | The average cost of reaching a goal: the ratio of the cost of clicks (in the campaign currency) to the number of conversions. |
GoalsNum | The number of conversions. |
Parameter | Description |
Date | The data statistics are provided for. If the GroupByDate input parameter has the value “week” or “month”, the first date of the week or month is specified. |
CampaignName | The campaign name. |
CampaignId | The campaign ID. |
AdGroupName | Name of the ad group. |
AdGroupId | ID of the ad group. |
AdId | The ad ID. |
Title | Ad title. |
Text | Ad text. |
Url | Ad link. |
SearchQuery | The search query that triggered the ad. |
Impressions | Number of impressions in the search. |
Clicks | Number of clicks in the search. |
CTR | The ratio of clicks on an ad to the number of impressions (click-through rate). |
Cost | The cost per click on search (in the campaign currency). |
AvgClickCost | The average CPC: the ratio of the cost of clicks (in the campaign currency) to the number of clicks. |
AvgDepth | Average session depth on the advertiser's site. |
Conversion | The ratio of conversions to the total number of sessions. |
AvgGoalCost | The average cost of reaching a goal: the ratio of the cost of clicks (in the campaign currency) to the number of conversions. |
GoalsNum | The number of conversions. |
Report data is grouped by the values of the fields Date, CampaignName, CampaignId, AdGroupName, AdGroupId, AdId, Title, Text, Url and SearchQuery.