Raw event data about conversions.
This report can only be returned by an asynchronous request (that is, via the Reports.request() method).
Because events occur on specific dates, a request for this report must specify a timeRange . You can specify either of the following:
- startDate and endDate .
- changedMetricsSinceTimestamp ( changedAttributesSinceTimestamp is not valid for events).
Request excerpt
Send a regular Reports.request()
request body, but specify "reportType": "conversion"
.
{ ... "reportType": "conversion", "columns": [ { "columnName": string , "headerText": string , "startDate": string , "endDate": string } ], "filters": [ { "column": { "columnName": string , }, ... }, ... ], ... }
For each column that you want returned or filtered in the report,
specify the columnName
listed in the table below.
You can also optionally specify headerText
, startDate
,
and endDate
.
Note that some columns cannot be filtered; refer to "Filterable" in the table below.
columnName
|
Description | Behavior | Type | Filterable |
|---|---|---|---|---|
status
|
The status of the conversion: Active
or Removed
. |
attribute | Status
|
Yes |
deviceSegment
|
The device segment that the conversion is attributed to: Desktop
, Mobile
, Tablet
, or Other
. |
attribute | Device segment
|
Yes |
floodlightGroup
|
Floodlight group name. | attribute | String
|
Yes |
floodlightGroupConversionType
|
The type of conversions generated by Floodlight activities in this group: Action
or Transaction
. |
attribute | Conversion type
|
Yes |
floodlightGroupId
|
DS Floodlight group ID. | attribute | ID
|
Yes |
floodlightGroupTag
|
Floodlight group tag. | attribute | String
|
Yes |
floodlightActivity
|
Floodlight activity name. | attribute | String
|
Yes |
floodlightActivityId
|
DS Floodlight activity ID. | attribute | ID
|
Yes |
floodlightActivityTag
|
Floodlight activity tag. | attribute | String
|
Yes |
agency
|
Agency name. | attribute | String
|
Yes |
agencyId
|
DS agency ID. | attribute | ID
|
Yes |
advertiser
|
Advertiser name. | attribute | String
|
Yes |
advertiserId
|
DS advertiser ID. | attribute | ID
|
Yes |
account
|
Engine account name. | attribute | String
|
Yes |
accountId
|
DS engine account ID. | attribute | ID
|
Yes |
accountEngineId
|
ID of the account in the external engine account. | attribute | String
|
Yes |
accountType
|
Engine account type: Google AdWords
, Bing Ads
, Yahoo Japan Listing Ads
, Yahoo Search Marketing
, Yahoo Gemini
, Baidu
, or Comparison Shopping
. |
attribute | Engine type
|
Yes |
campaign
|
Campaign name. | attribute | String
|
Yes |
campaignId
|
DS campaign ID. | attribute | ID
|
Yes |
campaignStatus
|
The status of the campaign that contains this item. | attribute | Status
|
Yes |
adGroup
|
Ad group name. | attribute | String
|
Yes |
adGroupId
|
DS ad group ID. | attribute | ID
|
Yes |
adGroupStatus
|
The status of the ad group that contains this item. | attribute | Status
|
Yes |
keywordId
|
DS keyword ID. A value of 0 indicates that the keyword is unattributed. | attribute | ID
|
Yes |
keywordMatchType
|
Keyword match type: Broad
, Exact
, Phrase
, or Content
. |
attribute | Match type
|
Yes |
keywordText
|
Keyword text. | attribute | String
|
Yes |
productTargetId
|
DS product target ID. | attribute | ID
|
Yes |
productGroupId
|
The product group ID associated with this conversion. Only conversions from shopping campaigns have product group IDs. Product group IDs should not be used for joining. | attribute | ID
|
Yes |
ad
|
Ad name. | attribute | String
|
Yes |
adId
|
DS ad ID. A value of 0 indicates that the ad is unattributed. | attribute | ID
|
Yes |
isUnattributedAd
|
Indicates whether metrics in this row are unattributable to a specific ad. For example, an ad with an unsupported format or an erroneous clickserver URL can prevent DS from attributing metrics to an ad. | attribute | Boolean
|
Yes |
inventoryAccountId
|
The DS inventory account ID containing the product associated with the conversion. DS generates this ID when you link an inventory account in DS. | attribute | ID
|
Yes |
productId
|
The ID of the product associated with this conversion. | attribute | String
|
Yes |
productCountry
|
The country (ISO 3166 format) registered for the inventory feed that contains the product associated with this conversion. | attribute | String
|
Yes |
productLanguage
|
The language (ISO 639-1) of the product associated this conversion. | attribute | String
|
Yes |
productStoreId
|
The store in the Local Inventory Ad associated with the conversion. This should match the store IDs used in your local products feed. | attribute | String
|
Yes |
productChannel
|
The sales channel of the product associated with the conversion: Online
or Local
. |
attribute | Product channel
|
Yes |
conversionId
|
ID that Search Ads 360 generates for each conversion. | attribute | ID
|
Yes |
advertiserConversionId
|
For offline conversions, this is an ID provided by advertisers. If an advertiser doesn't specify such an ID, Search Ads 360 generates one. For online conversions, this is equal to the conversionId column or the floodlightOrderId column depending on the advertiser's Floodlight instructions. | attribute | String
|
Yes |
conversionType
|
The type of the conversion: Action
or Transaction
. |
attribute | Conversion type
|
Yes |
conversionRevenue
|
The total dollar amount from the conversion. | attribute | Money
|
Yes |
conversionQuantity
|
The quantity of items recorded by the conversion, as determined by the qty parameter. The advertiser is responsible for dynamically populating the parameter (such as number of items sold in the conversion), otherwise it defaults to 1. | attribute | Number
|
Yes |
conversionDate
|
The date, in the Campaign manager network time zone, when the conversion occurred. This date is used for conversion metric aggregation. For example, when DS aggregates actions for May 1, it counts all action conversions whose conversionDate
is May 1. |
attribute | Date
|
Yes |
conversionTimestamp
|
The UTC timestamp when the conversion occurred. | attribute | Timestamp
|
Yes |
conversionLastModifiedTimestamp
|
The UTC timestamp of the conversion's most recent modification. | attribute | Timestamp
|
Yes |
conversionAttributionType
|
What the conversion is attributed to: Visit
or Keyword+Ad
. |
attribute | Conversion attribution type
|
Yes |
conversionVisitId
|
The DS visit ID that the conversion is attributed to. | attribute | ID
|
Yes |
conversionVisitTimestamp
|
The UTC timestamp of the visit that the conversion is attributed to. | attribute | Timestamp
|
Yes |
conversionVisitExternalClickId
|
A unique string, for the visit that the conversion is attributed to, that is passed to the landing page as the gclid URL parameter. Only enabled for advertisers with conversion API integration or Google Analytics integration. | attribute | String
|
Yes |
conversionSearchTerm
|
The search term that led to the conversion. | attribute | String
|
Yes |
floodlightOriginalRevenue
|
The original, unchanged revenue associated with the Floodlight event (in the currency of the current report), before Floodlight currency instruction modifications. | attribute | Money
|
Yes |
floodlightEventRequestString
|
The Floodlight request string of the conversion. | attribute | String
|
Yes |
floodlightReferrer
|
The Floodlight referrer website of the conversion. | attribute | String
|
Yes |
floodlightOrderId
|
The Floodlight order ID provided by the advertiser for the conversion. | attribute | String
|
Yes |
feedItemId
|
The ID of the feed item row associated with this conversion. | attribute | ID
|
Yes |
feedId
|
The ID of the feed table associated with this conversion. | attribute | ID
|
Yes |
feedType
|
The type of feed associated with this conversion. | attribute | Feed type
|
Yes |
