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 & month | Yearmonth | Year and month, e.g. 2017|06 | |
Year & week (Sun-Sat) | yearweek | Year and week for US weeks, e.g. 2017|08 | |
Year & week (Mon-Sun) | yearweekiso | Year and week for ISO weeks, e.g. 2017|08 | |
Month | Month | Month, e.g. 6 | |
Week (Sun-Sat) | week | US week number, e.g. 51 | |
Week (Mon-Sun) | weekiso | ISO week number, e.g. 51 | |
Week (Mon-Sun, dates) | yearweekiso_daterange | ||
Day of month | dayOfMonth | Day of month, e.g. 2 | |
Day of week (numeric) | dayOfWeekNumeric | Day of week for ISO weeks, e.g. "1" for Monday and "7" for Sunday | |
Day of week (name) | dayOfWeekName | Day of week for ISO weeks with names, e.g. "1 - Monday" or "7 - Sunday" | |
Date | Date | Date, e.g. 2017-01-31 | |
ACCOUNT | Account | account | Engine account name |
Account ID | accountId | DS engine account ID | |
Engine ID | accountEngineId | ID of the account in the external engine account | |
Account type | accountType | Engine account type: Google AdWords, Microsoft Advertising, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Native Ads, Baidu, or Comparison Shopping | |
Agency | agency | Agency name | |
Agency ID | agencyId | DS agency ID | |
Advertiser | advertiser | Advertiser name | |
Advertiser ID | advertiserId | DS advertiser ID | |
Currency | accountCurrencyCode | Currency code of the engine account in ISO 4217 format | |
Time zone | accountTimeZone | Time zone of the engine account in IANA Time Zone Database format, such as America/New_York | |
Status | status | The status of the account: Active, Paused, or Removed | |
Site link display text | siteLinkDisplayText | ||
Site link Description 1 | sitelinkDescription1 | ||
Site link Description 2 | sitelinkDescription2 | ||
Site link landing page URL | sitelinkLandingPageUrl | ||
Site link click server URL | sitelinkClickserverUrl | ||
Location business name | locationBusinessName | ||
ID-MAP | Agency ID (Old) | oldAgencyId | Agency ID (Old) |
Manager account ID (New) | newManagerAccountId | Manager account ID (New) | |
Advertiser ID (Old) | oldAdvertiserId | Advertiser ID (Old) | |
Sub Manager Account ID (New) | newSubManagerAccountId | Sub Manager Account ID (New) | |
Engine ID (Old) | oldEngineId | Engine ID (Old) | |
Client Account ID (New) | newClientAccountId | Client Account ID (New) | |
Campaign ID (Old) | oldCampaignId | Campaign ID (Old) | |
SA360 Campaign ID (New) | newCampaignId | SA360 Campaign ID (New) | |
Campaign target ID (Old) | oldCampaignTargetId | Campaign target ID (Old) | |
SA360 Campaign criterion ID (New) | newCampaignCriterionId | SA360 Campaign criterion ID (New) | |
Adgroup ID (Old) | oldAdGroupId | Adgroup ID (Old) | |
SA360 Adgroup ID (New) | newAdGroupId | SA360 Adgroup ID (New) | |
Ad ID (Old) | oldAdId | Ad ID (Old) | |
SA360 Ad ID (New) | newAdId | SA360 Ad ID (New) | |
Entity type | entityType | Entity type | |
CAMPAIGN | Campaign | campaign | Campaign name |
Campaign ID | campaignId | DS campaign ID | |
Campaign Status | campaignStatus | The status of the campaign: Active, Paused, or Removed | |
Campaign type | campaignType | Indicates the type of campaign: Manual, Inventory, Inventory - PLA, Shopping, Comparison shopping, Mobile app install, or Universal app | |
Engine ID | campaignEngineId | ID of the campaign in the external engine account | |
Daily budget | dailyBudget | Daily budget of the campaign | |
Monthly budget | monthlyBudget | Monthly budget of the campaign | |
Delivery method | deliveryMethod | Budget delivery method of the campaign: Standard or Accelerated | |
Ad rotation | adRotation | Ad serving rotation used by the ad group: Optimize or Rotate indefinitely | |
Labels | campaignLabels | Names of labels directly assigned to this campaign; inherited labels are not included | |
Start date | campaignStartDate | Start date of the campaign | |
End date | campaignEndDate | End date of the campaign | |
AD GROUP | Ad group | adGroup | Ad group name |
Ad group ID | adGroupId | DS ad group ID | |
Ad group status | adGroupStatus | The status of the ad group: Active, Paused, or Removed | |
Ad group labels | adGroupLabels | Names of labels directly assigned to this ad group; inherited labels are not included | |
Engine ID | adGroupEngineId | ID of the ad group in the external engine account | |
Start date | adGroupStartDate | Start date of the ad group | |
End date | adGroupEndDate | End date of the ad group | |
Search max CPC | adGroupSearchMaxCpc | Default bid for search keywords in this ad group | |
Broad max CPC | adGroupBroadMaxCpc | Default bid for broad match search keywords in this ad group (Microsoft Advertising only) | |
Exact max CPC | adGroupExactMaxCpc | Default bid for exact match keywords in this ad group (Microsoft Advertising only) | |
Phrase max CPC | adGroupPhraseMaxCpc | Default bid for phrasematch search keywords in this ad group (Microsoft Advertising only) | |
Content max CPC | adGroupContentMaxCpc | Default bid for content keywords in this ad group | |
Mobile bid adjustment | adGroupMobileBidAdjustment | The percentage by which bids are adjusted for mobile. For example, 0.2 means 20% increase, so mobile bids are 1.2 times the default bid. The range of valid values differs based on the external engine | |
AD | Ad | ad | Ad name |
Ad ID | adId | DS ad ID. A value of 0 indicates that the ad is unattributed | |
Ad status | adStatus | The status of the ad: Active, Paused, or Removed. Note that campaigns, ad groups, keywords, and ads each have their own status. See status | |
Ad engine ID | adEngineId | ID of the ad in the external engine account | |
Ad engine status | adEngineStatus | Additional status of the ad in the external engine account. Possible statuses (depending on the type of external account) include active, eligible, creative deleted, creative approved family safe, etc | |
Ad headline | adHeadline | Ad headline | |
Ad headline 2 | adHeadline2 | Ad headline 2; not available for some engines | |
Ad labels | adLabels | Names of labels directly assigned to this ad; inherited labels are not included | |
Ad description 1 | adDescription1 | Ad description line 1 | |
Ad description 2 | adDescription2 | Ad description line 2; not available for some engines | |
Ad path field 1 | adPathField1 | Ad path field 1. Path fields 1 and 2 are combined with ad display URL to form the URL that is shown on an ad | |
Ad path field 2 | adPathField2 | Ad path field 2. Path fields 1 and 2 are combined with ad display URL to form the URL that is shown on an ad | |
Ad display URL | adDisplayUrl | Ad display URL | |
Ad landing page | adLandingPage | Ad landing page. See Landing page and clickserver URLs | |
Ad type | adType | The type of ad: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text, or Expanded dynamic search | |
Ad promotion line | adPromotionLine | Ad promotion line. A short promotional message for a product ad | |
KEYWORD | Keyword | keywordText | Keyword text |
Keyword ID | keywordId | DS keyword ID. A value of 0 indicates that the keyword is unattributed | |
Keyword status | keywordStatus | The status of the keyword: Active, Paused, or Removed. Note that campaigns, ad groups, keywords, and ads each have their own status. See status | |
Keyword engine ID | keywordEngineId | ID of the keyword in the external engine account | |
Keyword engine status | keywordEngineStatus | Additional status of the keyword in the external engine account. Possible statuses (depending on the type of external account) include criterion rarely served, criterion below first page bid, criterion low quality score, review, campaign paused, etc | |
Match type | keywordMatchType | Keyword match type: Broad, Exact, Phrase, or Content | |
Max CPC | keywordMaxCpc | Overrides the ad group's max CPC and sets a maximum amount you are willing to pay if someone clicks an ad for this specific keyword. If this field is empty, the keyword will use the ad group's max CPC | |
Max CPC (effective) | effectiveKeywordMaxCpc | The max CPC (maximum cost-per-click) that is in effect for this keyword. This will be either the same value as the ad group's max CPC or, if the keyword is overriding the ad group's setting, the keyword's own max CPC | |
Max bid | keywordMaxBid | If this keyword is managed by a DS bid strategy, the bid strategy will never raise bids above this limit | |
Min bid | keywordMinBid | If this keyword is managed by a DS bid strategy, the bid strategy will never lower bids below this limit | |
Labels | keywordLabels | Names of labels directly assigned to this keyword; inherited labels are not included | |
Landing page | keywordLandingPage | The final URL that a user would visit after clicking on your ad. See Landing page and clickserver URLs | |
Is display? | isDisplayKeyword | Indicates whether this is a placeholder keyword that is used for display and placement reporting | |
Click server URL | keywordClickserverUrl | The URL that DS uses to track activity. A user who clicks an ad would visit the clickserver URL first, and then be redirected to the final landing page | |
SEARCH | Search query | searchQuery | |
Click type | serpType | The type of search result that Google users clicked | |
FLOODLIGHT | Floodlight activity | floodlightActivity | Floodlight activity name |
Floodlight activity ID | floodlightActivityId | DS Floodlight activity ID | |
Floodlight activity tag | floodlightActivityTag | Floodlight activity tag | |
Floodlight group | floodlightGroup | Floodlight group name | |
Type of conversions generated by Floodlight activities | floodlightGroupConversionType | The type of conversions generated by Floodlight activities in this group: Action or Transaction | |
Floodlight group ID | floodlightGroupId | DS Floodlight group ID | |
Floodlight group tag | floodlightGroupTag | Floodlight group tag | |
TARGETING | Country | countryTargets | Country targets included in the campaign |
Province | provinceTargets | Province targets included in the campaign | |
Metro | metroTargets | Metro targets included in the campaign | |
City | cityTargets | City targets included in the campaign | |
Device | deviceSegment | Segments the report by device; each row and its aggregate metrics are split into multiple rows, up to one for each device segment | |
Device targets | deviceTargetsApi | Device targets at the campaign level; a combination of Desktop, Mobile, Tablet, or Other | |
Effective device targets | effectiveDeviceTargets | Effective device targets at the campaign level; a combination of Desktop, Mobile, Tablet, or Other | |
Language | languageTargets | Language targets at the campaign level | |
Location target | locationTargetName | The name of the location target | |
Location target bid modifier | locationTargetBidModifier | The bid adjustment associated with the location target | |
Campaign target ID | campaignTargetId | The ID DS generated for a campaign target | |
Ad group target ID | adGroupTargetId | The ID DS generated for an ad group target | |
Dynamic ad target conditions | dynamicSearchAdsTargetConditions | The criteria the dynamic ad target uses to select pages under the site domain | |
Dynamic ad target CPC bid | dynamicSearchAdsTargetCpcBid | The dynamic ad target's max CPC (maximum cost per click) setting | |
Dynamic ad target destination URL | dynamicSearchAdsTargetLandingPageUrl | The dynamic ad target's destination URL | |
Dynamic ad target coverage | dynamicSearchAdsTargetCoverage | The percentage of pages on the advertiser's site that the dynamic ad target matches | |
Age target range | ageTargetAgeRange | The age range of age target | |
Age target bid modifier | ageTargetBidModifier | The bid adjustment associated with the age target | |
Gender target type | genderTargetGenderType | The gender type of gender target: Male, Female, Unknown | |
Gender target bid modifier | genderTargetBidModifier | The bid adjustment associated with the gender target | |
REMARKETING | Engine remarketing list | engineRemarketingList | The name of the remarketing list associated with the target |
Engine remarketing list bid modifier | engineRemarketingListBidModifier | The bid adjustment associated with the target | |
CONVERSION | Conversion ID | conversionId | ID that Search Ads 360 generates for each conversion |
Advertiser conversion ID | 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 | |
Conversion status | conversionStatus | The status of the conversion: Active or Removed | |
Conversion type | conversionType | The type of the conversion: Action or Transaction | |
Conversion date | conversionDate | The date, in the Campaign manager network time zone, when the conversion occurred | |
Conversion attribution type | conversionAttributionType | What the conversion is attributed to: Visit or Keyword+Ad | |
Conversion visit ID | conversionVisitId | The DS visit ID that the conversion is attributed to | |
Conversion visit date | conversionVisitTimestamp | The UTC date of the visit that the conversion is attributed to | |
Conversion visit external click ID | 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 | |
Conversion search term | conversionSearchTerm | The search term that led to the conversion | |
Inventory account ID | 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 | |
Product ID | productId | The ID of the product associated with this conversion | |
Product group ID | productGroupId | The product group ID associated with this conversion. Only conversions from shopping campaigns have product group IDs | |
Product target ID | productTargetId | DS product target ID | |
Product country | productCountry | The country (ISO 3166 format) registered for the inventory feed that contains the product associated with this conversion | |
Product language | productLanguage | The language (ISO 639-1) of the product associated this conversion | |
Product store ID | productStoreId | The store in the Local Inventory Ad associated with the conversion | |
Product channel | productChannel | The sales channel of the product associated with the conversion: Online or Local | |
Floodlight order ID | floodlightOrderId | The Floodlight order ID provided by the advertiser for the conversion | |
Floodlight event request string | floodlightEventRequestString | The Floodlight request string of the conversion | |
Floodlight referrer | floodlightReferrer | The Floodlight referrer website of the conversion | |
Feed ID | feedId | The ID of the feed table associated with this conversion | |
Feed item ID | feedItemId | The ID of the feed item row associated with this conversion | |
Feed type | feedType | The type of feed associated with this conversion |