Report Type: conversion

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:

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.

columnNameDescriptionBehaviorTypeFilterable
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