Overview
New vs old Search Ads 360 connector
Since early 2024, SA360 has had two APIs for Search Ads 360 (SA360) and currently there are two connectors for these to separate APIs in Funnel. "Search Ads 360" connector using the old SA360 API while "New Search Ads 360" use the new API.
The old API will be shut down on June 30th 2024. Funnel will continue to support the old API as long as it is available. When SA360 removes it, Funnel will no longer be able to fetch data from the API but data that is already downloaded to Funnel will still be available.
To learn more about how to migrate to the new connector, please take a look at this migration guide.
Aggregatable vs non-aggregatable metrics
When connecting SA360, you can select Regular or Non-aggregatable metrics. Non-aggregatable are metrics that can not be summed over days and/or dimensions thus they will be imported as metrics that represent non-summable rows, read more here:
What are non aggregatable metrics?
Note: The non-aggregatable report doesn't support saved columns.
Reports
Campaign (also available as a non-aggregatable report)
Ad Group (also available as a non-aggregatable report)
Keyword
Ad
Keyword Ad
Conversion
Shopping Performance View
The Report field dictates the granularity of your report. Metric totals can sometimes differ between different levels, the same can be true if you segment by Device or not (this works exactly like it does in the Search Ads 360 UI). If you select the keyword level you would have to compare it to the keyword tab in the Search Ads 360 UI.
Additional Segments
Device
Conversion Action
Conversion Action Name
Historical Quality Score
The following dimensions are included when selecting the Conversion Action segment:
Conversion Action Name
Conversion Action Type
Conversion Action Category
Conversion Action ID
Conversion Action Category Primary for Goal
Conversion Action Category Attribution Model
Conversion Action Data Driven Model Status
Floodlight Activity Group Tag
Floodlight activity Tag
Floodlight Activity ID
Please note that not all segments are available for all reports.
Custom Columns
Funnel only import Custom metrics, Custom dimensions are not supported.
Custom columns are owned by a Manager account, Sub-manager account or Client account, and a column can only be downloaded if the connecting user has access to the account owning the column. This means that the available set of custom columns for a Client account can vary depending on the access level of the SA360 user connecting the Client account in Funnel.
Our goal is to provide the same set of custom columns that a user can see and use at the Client account level in the SA360 UI.
Currently funnel will not import custom columns that are classified as *date-parameterized or percent due to API limitations.
* Funnel imports date-parameterized columns when it is unknown to us that they are, in fact, date-parameterized. This could be because the columns they depend on are unknown, or when other columns they depend on themselves are dependent on date-parameterized columns. These columns frequently has data mismatches.
Historical Data
Two years of historical data will be downloaded when you connect a new source, which is the maximum allowed by the SA360 API.
Dimensions and Metrics
Each report contains a unique setup with dimensions and metrics listed below. Please note that if you add an additional segment when you connect the report, that segment will show up as a dimension in Funnel.
Campaign Report
Dimensions
Account Type
Bidding Strategy
Bidding Strategy ID
Campaign
Campaign ID
Campaign Labels
Campaign Sub-type
Client Account ID
Client Account
Client Engine ID
Geo Targets
Direct Manager ID
Direct Manager name
Metrics
All Conversions
All Conversions by Conversion Date
All Conversions Value
All Conversions Value by Conversion Date
Clicks
Client Account Conversion Value
Client Account Conversions
Client Account View-through Conversions
Conversions Value
Cost
Cross-Device Conversions
Cross-Device Conversions by Conversion Date
Cross-Device Conversions Value
Cross-Device Conversions Value by Conversion Date
Impressions
Visits
Search Impr. Share – Estimated
Search Top Impr. Share – Estimated
Search Abs. Top Impr. Share – Estimated
Search Lost Impr. Share (rank) – Estimated
Search Lost Impr. Share (budget) – Estimated
Total Eligible Impressions – Estimated
Total Eligible Top Impressions – Estimated
Total Eligible Absolute Top Impressions – Estimated
Search Impr. Share Impressions
Total Top Impressions
Total Rank Lost Impressions – Estimated
Total Budget Lost Impressions – Estimated
Total Absolute Top Impressions - Estimated
Non-aggregatable Campaign Report
Dimensions
Account Type
Campaign
Campaign ID
Client account ID
Client account
Client Engine ID
Historical Quality Score
Metrics
Search Absolute Top Impression Share
Search Budget Lost Impression Share
Search Budget Lost Top Impression Share
Search Exact Match Impression Share
Search Impression Share
Search Rank Lost Absolute Impression Share
Search Rank Lost Impression Share
Search Rank Lost Top Impression Share
Ad group Report
Dimensions
Account Type
Ad Group
Ad Group Engine ID
Ad Group ID
Ad Group Labels
Ad Group Type
Ad Group Status
Bidding Strategy ID
Bidding Strategy Name
Campaign
Campaign engine ID
Campaign ID
Campaign Status
Client account ID
Client account
Client Engine ID
Geo Targets
Direct manager ID
Direct manager name
Metrics
All Conversions
All Conversions by Conversion Date
All Conversions Value
All Conversions Value by Conversion Date
Clicks
Client Account Conversion Value
Client Account Conversions
Client Account View-through Conversions
Conversions Value
Cost
Cross-Device Conversions
Cross-Device Conversions by Conversion Date
Cross-Device Conversions Value
Cross-Device Conversions Value by Conversion Date
Impressions
Visits
Search Impr. Share – Estimated
Search Top Impr. Share – Estimated
Search Abs. Top Impr. Share – Estimated
Search Lost Impr. Share (rank) – Estimated
Search Lost Impr. Share (budget) – Estimated
Total Eligible Impressions – Estimated
Total Eligible Top Impressions – Estimated
Total Eligible Absolute Top Impressions – Estimated
Search Impr. Share Impressions
Total Top Impressions
Total Rank Lost Impressions – Estimated
Total Budget Lost Impressions – Estimated
Total Absolute Top Impressions - Estimated
Non-aggregatable Ad group Report
Dimensions
Account Type
Ad group
Ad group ID
Ad group Type
Campaign
Campaign ID
Client account ID
Client account
Client Engine ID
Historical Quality Score
Metrics
Search Absolute Top Impression Share
Search Budget Lost Impression Share
Search Budget Lost Top Impression Share
Search Exact Match Impression Share
Search Impression Share
Search Rank Lost Absolute Impression Share
Search Rank Lost Impression Share
Search Rank Lost Top Impression Share
Keyword Report
Dimensions
Account Type
Ad Group
Ad Group ID
Ad Group Type
Ad Group Status
Bidding Strategy Name
Bidding Strategy ID
Campaign
Campaign ID
Campaign Type
Campaign Status
Client Account ID
Client Account
Client Engine ID
Effective Keyword Max CPC
Keyword ID
Keyword Final URL
Keyword Labels
Keyword Match Type
Keyword Text
Keyword Status
Direct Manager ID
Direct Manager Name
Metrics
All Conversion
All Conversions Value
Average CPC
Clicks
Client Account Conversion Value
Client Account Conversions
Client Account View-through Conversions
Cost
Cross-Device Conversions
Cross-Device Conversions by Conversion Date
Cross-Device Conversions Value
Cross-Device Conversions Value by Conversion Date
Impressions
Visits
Ad Report
Dimensions
Account Type
Ad Group
Ad Group ID
Ad Group type
Ad ID
Ad Final URL
Ad Type
Campaign
Campaign ID
Campaign Type
Client account ID
Client Account
Client Engine ID
Expanded Text Ad Description1
Expanded Text Ad Description2
Expanded Text Ad Headline
Expanded Text Ad Headline2
Final URLs
Geo Targets
Direct Manager ID
Direct Manager Name
Metrics
All Conversions
All Conversions Value
Average CPC
Clicks
Client Account Conversion Value
Client Account Conversions
Client Account View-through Conversions
Cost
Cross-Device Conversions
Cross-Device Conversions by Conversion Date
Cross-Device Conversions Value
Cross-Device Conversions Value by Conversion Date
Impressions
Visits
Keyword Ad
Dimensions
Account Type
Ad Group
Ad Group ID
Ad Group type
Ad ID
Ad Final URL
Ad Labels
Ad Type
Campaign
Campaign ID
Campaign Type
Client account ID
Client Account
Client Engine ID
Direct Manager ID
Direct Manager Name
Expanded Text Ad Description1
Expanded Text Ad Description2
Expanded Text Ad Headline
Expanded Text Ad Headline2
Final URLs
Geo Targets
Historical Quality Score
Keyword ID
Keyword Final URL
Keyword Labels
Keyword Match Type
Keyword Text
Keyword Status
Metrics
All Conversions
All Conversions by Conversion Date
All Conversions Value
All Conversions Value by Conversion Date
Average CPC
Clicks
Client Account Conversion Value
Client Account Conversions
Client Account View-through Conversions
Conversions Value
Cost
Cross-Device Conversions
Cross-Device Conversions by Conversion Date
Cross-Device Conversions Value
Cross-Device Conversions Value by Conversion Date
Impressions
Visits
Conversion Report
Dimensions
Account Type
Advertiser conversion ID
Campaign
Campaign ID
Conversion attribution type
Conversion ID
Conversion last modified timestamp
Conversion timestamp
Conversion visit external click ID
Client account ID
Client account
Device
Floodlight order ID
Keyword text
Direct manager ID
Direct manager name
Merchant ID
Product Country Code
Metric
Conversion quantity
Shopping Performance View Report
Dimensions
Account Type
Ad group
Ad group engine ID
Ad group ID
Ad group type
Campaign
Campaign engine ID
Campaign ID
Client account ID
Client account
Direct manager ID
Direct manager name
Product Bidding Category Level 1
Product Bidding Category Level 2
Product Bidding Category Level 3
Product Brand
Product Channel
Product Condition
Product Country
Product Country Code
Product Custom Attribute 0
Product Custom Attribute 1
Product Custom Attribute 2
Product Item ID
Product Title
Product Type Level 1
Product Type Level 2
Product Type Level 3
Product Type Level 4
Metrics
Average CPC
Clicks
Cost
Impressions