2024-05 Search Ads 360 API Upgrade

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.
  

Table of Comparisons

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

Supported Entities and Example ID Mappings

Customer

ID mapping for:

• advertiser
• account.

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:

• adGroupTarget
• keyword
• negativeAdGroupKeyword
• negativeAdGroupTarget
• productGroup.

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:

• campaignTarget
• negativeCampaignKeyword
• negativeCampaignTarget.

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.