新版 Search Ads 360 的 ID 對應

新版 Search Ads 360 Reporting API 現已開放使用。這個新 API 提供更靈活彈性的功能，協助您建立自訂報表，並將這些資料整合至報表應用程式和程序。進一步瞭解如何使用及遷移至新版 Search Ads 360 Reporting API。

新版 Search Ads 360 中的實體 ID 空間與舊版 Search Ads 360 不同。 如要取得舊版與新版 Search Ads 360 之間的 ID 對應關係，請傳送 Reports.getIdMappingFile() 要求。回應包含指定廣告客戶所有實體的 ID 對應。

以下是傳回的檔案範例 (以 UTF-8 編碼的 CSV 格式)：

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

CSV 檔案包含 3 個資料欄：

  • Entity Type：這個資料列的實體類型。

  • Legacy IDs：舊版 Search Ads 360 中完整實體路徑的 JSON 字串

  • New IDs：新版 Search Ads 360 完整實體路徑的 JSON 字串

下表列出支援的實體和 ID 對應範例：

實體類型 說明 舊版 ID 新 ID
客戶 以下項目的 ID 對應： 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
廣告活動 廣告活動的 ID 對應。 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP adGroup 的 ID 對應。 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
條件 以下項目的 ID 對應： 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD ad 的 ID 對應。 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION 以下項目的 ID 對應： 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP 廣告活動群組的 ID 對應。 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET 廣告活動群組成效目標的 ID 對應。 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE 動態饋給表格的 ID 對應。 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM feedItem 的 ID 對應。 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

下載報告

JSON

GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping?alt=media

Python

def download_mapping_file(service, file_name, agency_id, advertiser_id):
  """Generate and save mapping file to a csv.

  Args:
    service: An authorized Doubleclicksearch service.
    file_name: Filename to write the ID mapping file.
    agency_id: DS ID of the agency.
    advertiser_id: DS ID of the advertiser.
  """
  request = service.reports().getIdMappingFile_media(agencyId=agency_id,
      advertiserId=advertiser_id)

  f = open(file_name + '.csv', 'w')
  f.write(request.execute().decode('utf-8'))
  f.close()

物件 ID 唯一性

新版 Search Ads 360 中的每個物件都能透過專屬 ID 識別。這些 ID 在新版 Search Ads 360 中所有帳戶的全域層級都不重複，而其他 ID 則只在限定範圍內。舉例來說，您必須同時使用廣告群組和廣告 ID 識別廣告，因為系統會為每個廣告群組指派專屬廣告 ID，而不會跨廣告群組指定廣告 ID。以下列出新版 Search Ads 360 中各物件 ID 的唯一性。為新的 Search Ads 360 物件設計本機儲存空間時，這些 ID 規則相當實用。

物件 ID 獨特性範圍 是否具有全域獨特性？
預算編號 全域 是
廣告活動 ID 全域 是
AdGroup 編號 全域 是
廣告編號 廣告群組 否 (AdGroupId、AdId) 配對在全域範圍內不重複。
AdGroupCriterion 編號 廣告群組 否 (AdGroupId、CriterionId) 配對在全域範圍內不重複。
CampaignCriterion 編號 廣告活動 否 (CampaignId、CriterionId) 配對在全域範圍內不重複。
廣告額外資訊 廣告活動 否 (CampaignId、AdExtensionId) 配對在全域範圍內不重複。
動態饋給 ID 全域 是
資訊提供項目編號 全域 是
資訊提供屬性編號 資訊提供 否
資訊提供對應編號 全域 是
標籤編號 全域 是
使用者名單 ID 全域 是