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
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
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. At the time of writing this we are facing challenges in how to achieve this via the API, and we are working together with Google to find a long term solution.
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
Campaign
Campaign ID
Campaign Labels
Client account ID
Client account
Geo Targets
Direct manager ID
Direct manager name
Metrics
All Conversion
All Conversions Value
Client Account Conversion Value
Client Account Conversions
Client Account View-through Conversions
Cross-device Conversions
Cross-device Conversions Value
Non-aggregatable Campaign Report
Dimensions
Account Type
Campaign
Campaign ID
Client account ID
Client account
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
Bidding Strategy ID
Bidding Strategy Name
Campaign
Campaign engine ID
Campaign ID
Client account ID
Client account
Geo Targets
Direct manager ID
Direct manager name
Metrics
All Conversion
All Conversions Value
Client Account Conversion Value
Client Account Conversions
Client Account View-through Conversions
Cross-device Conversions
Cross-device Conversions Value
Non-aggregatable Ad group Report
Dimensions
Account Type
Ad group
Ad group ID
Ad group Type
Campaign
Campaign ID
Client account ID
Client account
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
Campaign
Campaign ID
Client account ID
Client account
Effective keyword max CPC
Keyword ID
Keyword labels
Keyword match type
Keyword text
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 Value
Impressions
Visits
Ad Report
Dimensions
Account Type
Ad group
Ad group ID
Ad group type
Ad ID
Ad labels
Ad Type
Campaign
Campaign ID
Client account ID
Client account
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 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 Value
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