2024-05 Search Ads 360 API Upgrade
  • 4 Minutes to read
  • Dark
    Light
  • PDF

2024-05 Search Ads 360 API Upgrade

  • Dark
    Light
  • PDF

Article Summary

Introduction

Beginning June 30th, 2024, Google will discontinue support for the older version of the Search Ads 360 Reporting API and transition to the updated Search Ads 360 Reporting API.
This document details the deprecated columns from the previous Search Ads 360 and provides guidance on accessing them in the new Search Ads 360.

Details of Changes

Support Discontinuation

Google will cease support for the older version of the Search Ads 360 Reporting API and shift to the updated Search Ads 360 Reporting API on June 30th, 2024.
Users are advised to migrate to updated Search Ads 360 Reporting API for continued functionality.

New Data Source

  • The new Search Ads 360 data source is set to be accessible by mid-May.
  • All reports have filter support, with the filters operating on an AND logic basis.
  • The "Currency" field and "Include Removed Entities" checkbox have been phased out.
    image.png

Table of Comparisons

Here is how you can pull data from the older version reports in the new Search Ads 360 version:

Old Report NameNew Report NameColumnsBehavior Changes
AccountCustomerField Mappings TableBehavior Changes Table
AdAd Group AdField Mappings TableBehavior Changes Table
Ad GroupAd GroupField Mappings TableBehavior Changes Table
Ad Group TargetAd Group Criterion and the following metrics: Ad Group Audience View, Age Range View, Gender View and Webpage View.Field Mappings TableBehavior Changes Table
AdvertiserCustomerField Mappings TableBehavior Changes Table
Bid StrategyBidding StrategyField Mappings TableBehavior Changes Table
CampaignCampaignField Mappings TableBehavior Changes Table
Campaign TargetCampaign CriterionField Mappings TableBehavior Changes Table
Conversion (event-level)ConversionField Mappings TableBehavior Changes Table
FeedItemAssetField Mappings TableBehavior Changes Table
Floodlight ActivityConversion ActionField Mappings TableBehavior Changes Table
KeywordAd Group CriterionField Mappings TableBehavior Changes Table
Negative Ad Group KeywordAd Group CriterionField Mappings TableBehavior Changes Table
Negative Ad Group TargetAd Group CriterionField Mappings TableBehavior Changes Table
Negative Campaign KeywordCampaign Criterion and the following metrics: Location View and Campaign Audience View.Field Mappings TableBehavior Changes Table
Negative Campaign TargetCampaign Criterion and the following metrics: Location View and Campaign Audience View.Field Mappings TableBehavior Changes Table
Paid And OrganicDeprecatedField Mappings TableBehavior Changes Table
Product AdvertisedShopping Performance ViewField Mappings TableBehavior Changes Table
Product GroupProduct Group ViewField Mappings TableBehavior Changes Table
Product Lead And Cross SellCart Data Sales ViewField Mappings TableBehavior Changes Table
Product TargetCampaign CriterionField Mappings TableNo Behavior Changes
Visit (event-level)VisitField Mappings TableBehavior Changes Table

Supported Entities and Example ID Mappings

Customer

ID mapping for:

Legacy IDs:

advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}

New IDs:

{
"customerId": "200001235"
}

Campaign

ID mapping for campaign.

Legacy IDs:

{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}   

New IDs:

{
  "customerId": "200001235",
  "campaignId": "14660344555"
}

Ad Group

ID mapping for adGroup.

Legacy IDs:

{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}

New IDs:

{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}

Criterion

ID mapping for:

Legacy IDs:

{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}

New IDs:

{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}

Ad

ID mapping for ad.

Legacy IDs:

{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}

New IDs:

{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}

Campaign Criterion

ID mapping for:

Legacy IDs:

{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}

New IDs:

{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}

Campaign Group

ID mapping for campaign group.

Legacy IDs:

{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}

New IDs:

{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}

Campaign Group Performance Target

ID mapping for campaign group performance target.

Legacy IDs:

{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}

New IDs:

{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}

Feed Table

ID mapping for Feed Table.

Legacy IDs:

{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}

New IDs:

{
  "customerId": "200001235",
  "feedId": "207040045"
}

Feed Item

ID mapping for feedItem.

Legacy IDs:

{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}

New IDs:

{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

What Actions Should You Take?

  • Users must set up the new Search Ads 360 data source Rivers following the guidelines outlined in the Search Ads 360 Walkthrough documentation.
  • it is necessary to establish a new connection for the new Search Ads 360 data source.
  • It is recommended to complete this migration as soon as possible to avoid disruption of services after June 30th, 2024.

Was this article helpful?