Supermetrics brings all your marketing data into Google Sheets, Google Data Studio, Excel, BigQuery, Snowflake, Redshift, Azure
| Category | Field | Code | Description |
|---|---|---|---|
| TIME | Year | Year | Year, e.g. 2017 |
| Year of week (Mon-Sun) | YearOfWeekIso | Year of week for ISO weeks, e.g. 2017 | |
| Year of week (Sun-Sat) | YearOfWeek | Year of week for US weeks, e.g. 2017 | |
| Year & month | Yearmonth | Year and month, e.g. 2017|06 | |
| Month | Month | Month, e.g. 6 | |
| Year & week (Mon-Sun) | YearWeekIso | Year and week for ISO weeks, e.g. 2017|08 | |
| Year & week (Sun-Sat) | Yearweek | Year and week for US weeks, e.g. 2017|08 | |
| Week (Mon-Sun) | WeekIso | ISO week number, e.g. 51 | |
| Week (Sun-Sat) | Week | US week number, e.g. 51 | |
| Day of week | DayOfWeek | Day of week name for US weeks, e.g. 0 Sunday | |
| Day of week (Mon-Sun) | DayOfWeekNameIso | Day of week name for ISO weeks, e.g. 1 Sunday | |
| Day of week (Sun-Sat) | DayOfWeekName | Day of week name for US weeks, e.g. 0 Sunday | |
| Date | Date | Date, e.g. 2017-01-31 | |
| Hour | Hour | Hour of the day, e.g. 22 | |
| ACCOUNT | Account ID | AccountId | The identifier of an account |
| Account name | AccountName | The account name | |
| Account number | AccountNumber | The assigned number of an account | |
| Account status | AccountStatus | The account status | |
| Account edit link | Account_edit_link | Link to edit the advertising account | |
| Currency code | CurrencyCode | The account currency code | |
| CAMPAIGN | Campaign ID | CampaignId | The assigned identifier of a campaign |
| Campaign name | CampaignName | The campaign name | |
| Campaign type | CampaignType | ||
| Campaign labels | CampaignLabels | The labels applied to a campaign | |
| Status | CampaignStatus | The campaign status | |
| Budget name | BudgetName | The name of a budget. This will be empty for unshared budgets | |
| Budget status | BudgetStatus | The budget status. The possible values are Active and Deleted. This will be empty for unshared budgets | |
| Budget association status | BudgetAssociationStatus | Indicates whether or not the campaign is currently spending from the budget mentioned in the BudgetName column. The possible values are Current and Ended | |
| Tracking template | TrackingTemplate | The current tracking template for a campaign | |
| Custom parameters | CustomParameters | The current set of custom parameters for a campaign. Each custom parameter is a key and value pair. The list of custom parameters is semicolon-delimited and each key is enclosed by braces and a leading underscore, for example {_key1}=value1;{_key2}=value2 | |
| CAMPAIGN CHANGES | Changed by | ChangedBy | The username of the user that made the change to settings within an account. If the system made the change, the value will be Administrator |
| Item changed | ItemChanged | The value that identifies the entity that changed. If the change is an update to an element of the entity or is related to a target associated with a campaign or ad group, the "Attribute changed" field contains the element of the entity that changed or the type of target that was changed | |
| Attribute changed | AttributeChanged | Identifies the attribute or property of the entity from the "Item changed" field that changed | |
| How changed | HowChanged | The value that indicates whether the element was added, updated, or deleted. For adds, the "New value" field contains the added entity. For deletes, the "Old value" field contains the deleted entity. For updates, the "New value" field contains the new value and the "Old value" field contains the old value. If an entity which has a delivery status property was added, for example a campaign, the value of "How change" is Added. To report a deleted entity, the "Item changed" field is Status, the "How changed" field is Changed, and the "New value" field is Deleted. Associating a target with a campaign or ad group will be reported as an add change. The "Attribute changed" field will identify the target types contained in the target object. Updates to a target object will be reported as a delete change and an add change. Removing a campaign's or ad group's association with a target object will be reported as a delete change | |
| Old value | OldValue | The value before the change | |
| New value | NewValue | The value after the change | |
| AD GROUP | Ad group ID | AdGroupId | The assigned identifier of an ad group. This will be empty if "Item changed" is not Ad, Ad group, or Keyword |
| Ad group name | AdGroupName | The ad group name. This will be empty if "Item changed" is not Ad, Ad group, or Keyword | |
| Ad group labels | AdGroupLabels | The labels applied to an ad group. Labels are delimited by a semicolon (;) | |
| Ad group status | AdGroupStatus | The ad group status | |
| Ad group criterion id | AdGroupCriterionId | A list of unique identifiers that identify the criterions to delete | |
| Ad group audience target | AdGroupAudienceTargetingSetting | ||
| Language | Language | The language of the country an ad is served in | |
| Ad group network | Network | The current network setting of an ad group. The possible values include AOL search, Bing and Yahoo! search, Content, and Syndicated search partners | |
| KEYWORD | Biddable ad group criterion 1 | BidParam1 | |
| Biddable ad group criterion 2 | BidParam2 | ||
| Biddable ad group criterion 3 | BidParam3 | ||
| Keyword ID | KeywordId | The keyword identifier | |
| Keyword | Keyword | The keyword text | |
| Keyword labels | KeywordLabels | The labels applied to a keyword. Labels are delimited by a semicolon (;) | |
| Negative keyword id | NegativeKeywordId | The assigned identifier of a negative keyword | |
| Negative keyword | NegativeKeyword | ||
| Negative keyword match type | NegativeKeywordMatchType | The type of match to compare the negative keyword and the user's search term. The possible values for a negative keyword are Exact and Phrase | |
| Keyword conflict level | ConflictLevel | The entity level where the keyword and negative keyword conflict occurs. The possible values are AdGroup and Campaign | |
| Negative keyword list id | NegativeKeywordListId | The assigned identifier of a negative keyword list | |
| Negative keyword list | NegativeKeywordList | The name of a negative keyword list | |
| Keyword status | KeywordStatus | The current keyword status | |
| Bid strategy type | BidStrategyType | The bid strategy type. Possible values include EnhancedCpc, ManualCpc, MaxClicks, MaxConversions, and TargetCpa. If the InheritFromParent strategy type is used, the report will include the inherited bid strategy type e.g. one of the supported values listed above | |
| Bidded match type | BidMatchType | The keyword bid match type. This can be different from the DeliveredMatchType column, for example if you bid on a broad match and the search term was an exact match | |
| Delivered match type | DeliveredMatchType | The match type used to deliver an ad. This can be different from the BidMatchType column, for example if you bid on a broad match and the search term was an exact match | |
| Current max CPC | CurrentMaxCpc | The maximum cost per click bid that was in effect at the time the report was generated. It is not a moving historical bid throughout the report time period | |
| Matched search query | SearchQuery | The search term used by your potential audience | |
| Keyword param 1 | KeywordParam1 | ||
| Keyword param 2 | KeywordParam2 | ||
| Keyword param 3 | KeywordParam3 | ||
| AD | Ad ID | AdId | The assigned identifier of an ad |
| Ad title | AdTitle | The ad title | |
| Ad title part 1 | AdTitlePart1 | The title part 1 attribute of an ad | |
| Ad title part 2 | AdTitlePart2 | The title part 2 attribute of an ad | |
| Ad title part 3 | AdTitlePart3 | The title part 3 attribute of an ad | |
| Ad type | AdType | The ad type | |
| Ad labels | AdLabels | The labels applied to an ad. Labels are delimited by a semicolon (;) | |
| Ad path part 1 | AdPath1 | The path 1 attribute of an ad | |
| Ad path part 2 | AdPath2 | The path 2 attribute of an ad | |
| Ad description | AdDescription | The first ad description that appears below the path in an ad | |
| Ad description 2 | AdDescription2 | The second ad description that appears below the path in an ad. Ad description 2 might not appear in an ad | |
| Ad distribution | AdDistribution | The network where you want your ads to show | |
| Ad status | AdStatus | The ad status | |
| Ad top position | TopVsOther | The report will include a column that indicates whether the ad impression appeared in a top position or elsewhere | |
| Ad extension id | AdExtensionId | The ad extension identifier | |
| AD EXTENSION | Ad extension type name | AdExtensionType | The types of ad extensions that the list of identifiers contains |
| Ad extension type id | AdExtensionTypeId | The system identifier that corresponds to the "Ad extension type name" field. The supported identifiers are 10, 11, and 12 | |
| Ad extension version | AdExtensionVersion | The version attribute of an ad extension | |
| Ad extension click item | AdExtensionClickType | ||
| Ad property value | AdExtensionPropertyValue | The human readable ad extension property value. The following are the possible property values corresponding to each ad extension type id: for type id 10, the property value is the display text of a sitelink ad extension, for type id 11, the property value is the company name of a location ad extension, for type id 12 or 14, the property value is the phone number of a call ad extension | |
| GOAL | Goal | Goal | The name of an event tracking or campaign analytics goal |
| Goal ID | GoalId | The assigned identifier of a goal | |
| SHOPPING CAMPAIGNS | Brand | Brand | |
| Product group | ProductGroup | A forward slash (/) delimited list of product conditions, reported as Operand = Attribute. For example "Product Type = Home / Product Type = Electronics / Product Type = DVD Player". Also note that in a report the single asterisk (*) refers to a product group that matches everything else besides the other filters for the product group | |
| Product partition type | PartitionType | The product partition type | |
| Product group criterion id | ProductGroupCriterionId | ||
| Title | Title | ||
| Seller name | SellerName | The merchant or store name that offers the product | |
| Offer language | OfferLanguage | The language for the product offer, e.g. English | |
| Country of sale | CountryOfSale | The country of sale for the product catalog | |
| Product ID | MerchantProductId | The unique identifier provided by a merchant for each product offer | |
| Condition | Condition | ||
| Product category 1 | ProductCategory1 | The first level value of the Product_category field in your Bing Merchant Center catalog | |
| Product category 2 | ProductCategory2 | The second level value of the Product_category field in your Bing Merchant Center catalog | |
| Product category 3 | ProductCategory3 | The third level value of the Product_category field in your Bing Merchant Center catalog | |
| Product category 4 | ProductCategory4 | The fourth level value of the Product_category field in your Bing Merchant Center catalog | |
| Product category 5 | ProductCategory5 | The fifth level value of the Product_category field in your Bing Merchant Center catalog | |
| Product type 1 | ProductType1 | The first level value of the Product_type field in your Bing Merchant Center catalog | |
| Product type 2 | ProductType2 | The second level value of the Product_type field in your Bing Merchant Center catalog | |
| Product type 3 | ProductType3 | The third level value of the Product_type field in your Bing Merchant Center catalog | |
| Product type 4 | ProductType4 | The fourth level value of the Product_type field in your Bing Merchant Center catalog | |
| Product type 5 | ProductType5 | The fifth level value of the Product_type field in your Bing Merchant Center catalog | |
| Custom label 0 | CustomLabel0 | The value of the Custom_label_0 field in your Bing Merchant Center catalog | |
| Custom label 1 | CustomLabel1 | The value of the Custom_label_1 field in your Bing Merchant Center catalog | |
| Custom label 2 | CustomLabel2 | The value of the Custom_label_2 field in your Bing Merchant Center catalog | |
| Custom label 3 | CustomLabel3 | The value of the Custom_label_3 field in your Bing Merchant Center catalog | |
| Custom label 4 | CustomLabel4 | The value of the Custom_label_4 field in your Bing Merchant Center catalog | |
| DESTINATION | Destination URL | DestinationUrl | The destination URL attribute of an ad, keyword, or ad group criterion. If the destination URL contains dynamic text substitution parameters (for example, {param1}), the report will contain the URL after substitution occurs |
| Display URL | DisplayUrl | The ad display URL | |
| Final URL | FinalURL | The Final URL of an ad, keyword, or criterion. Only the first URL in the list is reported. If the URL contains dynamic text substitution parameters (for example, {param1}), the report will contain the URL before substitution | |
| Final URL suffix | FinalUrlSuffix | The final URL suffix may include tracking parameters that will be appended to the end of the landing page URL | |
| Final mobile URL | FinalMobileURL | The Final Mobile URL of an ad, keyword, or criterion. Only the first URL in the list is reported. If the URL contains dynamic text substitution parameters (for example, {param1}), the report will contain the URL before substitution | |
| Final app URL | FinalAppURL | ||
| Landing page experience | LandingPageExperience | An aggregate quality assessment of all landing pages on your site. The landing page experience score measures whether your landing page is likely to provide a good experience to customers who click your ad and land on your website. A score of 3 is Above Average; a score of 2 is Average; and a score of 1 is considered Below Average. If you specify a time period that spans multiple days, the score will be the same for each day in the time period, and the value is the most recent calculated score. Data for this field is typically updated 14-18 hours after the UTC day ends | |
| Historic landing page experience average | HistoricLandingPageExperience | Historical average of landing page experience scores back as far as 18 months from the current date. This score may vary from the score in the LandingPageExperience column, which is the current score and same value for each day in the time period | |
| AUDIENCE | Audience id | AudienceId | The assigned identifier of the audience, for example the remarketing list ID |
| Audience name | AudienceName | The audience name | |
| Audience association status | AssociationStatus | The status of the association between the ad group and remarketing list, which indicates whether ads are eligible to display. The possible values are Active, Paused, and Deleted | |
| LOCATION | Location type | LocationType | The location type used to deliver ads. For example to distinguish between people in versus searching for or viewing pages about the corresponding location of interest. The possible location type values are: Physical location - Indicates that the user was physically located in the corresponding City, Country, Metro Area, or State locations. Location of interest - Indicates that the physical location of the user was not used to serve the ad, and the user was searching for or viewing pages about the corresponding City, Country, Metro Area, or State locations. Unknown - Legacy value returned if the physical location was not used or confirmed prior to the release of this report field in May 2014. If the user is searching for the location that they are in, then the location type is Physical location. For example if the search user is in Seattle and searching for Seattle, the location type is Physical location |
| Radius | Radius | The radius of a radius target bid. The geographic radius where the user was physically located when they clicked the ad. The "Radius name for landmark" field contains the address or landmark name of the radius | |
| Radius name for landmark | ProximityTargetLocation | The radius target bid name. The name of the geographic radius where the user was physically located when they clicked the ad. The "Radius" field contains the distance of the radius | |
| Most specific location | MostSpecificLocation | The most specific location used to deliver ads. For example if the city and country are both identified, this field will include the same value as the "City" field. If postal code information is available, then it will be included in the report instead of city or country | |
| VISITOR | Age group | AgeGroup | The age group of the audience who viewed the ad. The possible values are 13-17, 18-24, 25-34, 35-49, 50-64, and 65+ |
| Gender | Gender | The gender of the audience who might have viewed the ad, if known. Possible values are Male and Female | |
| Visitor city | City | The city where the user was physically located when they clicked the ad. The "Location type" field identifies whether the user was located in, searching for, or viewing pages about the location | |
| Visitor area code | AreaCode | ||
| Visitor metro area | MetroArea | The metro area (Nielsen DMA® in the United States) where the user was physically located when they clicked the ad. The "Location type" field identifies whether the user was located in, searching for, or viewing pages about the location | |
| Visitor state/region | State | The state where the user was physically located when they clicked the ad. The "Location type" field identifies whether the user was located in, searching for, or viewing pages about the location | |
| Visitor country | Country | The country where the user was physically located when they clicked the ad. The "Location type" field identifies whether the user was located in, searching for, or viewing pages about the location | |
| Visitor country code | CountryCode | The two-letter code of country where the user was physically located when they clicked the ad. The "Location type" field identifies whether the user was located in, searching for, or viewing pages about the location | |
| Device type | DeviceType | The device name attribute of a device OS target bid. The type of device which showed ads. The possible values include Computer, Smartphone, Tablet, and Unknown | |
| Device operating system | DeviceOS | The operating system of the device reported in the DeviceType column. The possible values include Android, Blackberry, iOS, Other, Unknown, and Windows | |
| QUERY INTENT | Query intent country | QueryIntentCountry | The name of a country if the user's geographical intent can be determined. The country is set if the user's intent is related to a country, and not necessarily if they are physically located in the country |
| Query intent state | QueryIntentState | The name of a state if the user's geographical intent can be determined. The state is set if the user's intent is a state or sub geography of the state, and not necessarily if they are physically located in the state | |
| Query intent city | QueryIntentCity | The name of a city if the user's geographical intent can be determined. The city is set if the user's intent is a city, and not necessarily if they are physically located in the city | |
| Query intent metro area | QueryIntentMetroArea | The name of a metro area (Nielsen DMA® in the United States) if the user's geographical intent can be determined. The metro area is set if the user's intent is a metro area or city within the metro area, and not necessarily if they are physically located in the metro area | |
| PUBLISHER | Publisher URL | PublisherUrl | The URL of a website that displayed the ad. If the Network is AOL search, then the publisher URL value is AOL Search Properties Only. If the Network is Bing and Yahoo! search, then the publisher URL value is either Bing and Yahoo! Search Properties Only or msn.com. If the Network is Syndicated search partners, then the publisher URL value is determined by the Syndicated search partners URL |
| CALL TRACKING | Start time of the call | CallStartTime | The start time of a call |
| End time of the call | CallEndTime | The end time of a call | |
| Call area code | CallAreaCode | The area code where a user was physically located when they clicked the ad |