GetOfflineReportList (Live)

Returns a list of reports on dynamic text ads that have been created or are being generated.

Attention. Disabled method. Use version 5 of the API.

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.

ParameterDescription
OfflineReportInfo object
TypeThe campaign type that the report was generated for: dynamic_text_ad.
IdID of the report.
Status

Report status:

  • Done — Report has been generated.
  • Pending — Report is in progress.
  • Failed — Report was not generated.
UrlLink 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.

Note.

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 Rowenta Focus Iron 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 Philips steamer 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.

ParameterDescription
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.

CampaignNameThe campaign name.
CampaignIdThe campaign ID.
AdGroupNameName of the ad group.
AdGroupIdID of the ad group.
AdIdThe ad ID.
TitleAd title.
TextAd text.
UrlAd link.
SearchQuery

The search query that triggered the ad.

ImpressionsNumber of impressions in the search.
ClicksNumber of clicks in the search.
CTRThe ratio of clicks on an ad to the number of impressions (click-through rate).
CostThe cost per click on search (in the campaign currency).
AvgClickCostThe average CPC: the ratio of the cost of clicks (in the campaign currency) to the number of clicks.
AvgDepthAverage session depth on the advertiser's site.
ConversionThe ratio of conversions to the total number of sessions.
AvgGoalCostThe average cost of reaching a goal: the ratio of the cost of clicks (in the campaign currency) to the number of conversions.
GoalsNumThe number of conversions.

Report data is grouped by the values of the fields Date, CampaignName, CampaignId, AdGroupName, AdGroupId, AdId, Title, Text, Url and SearchQuery.