新版 Search Ads 360 的 ID 對應

新版 Search Ads 360 Reporting API 現已上線。新版 API 提供 更有彈性，可用來建立自訂報表，以及將資料整合至報表應用程式 和處理程序進一步瞭解如何遷移至及使用新版 Search Ads 360 報表 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 對應： 
adGroupTarget and negativeAdGroupTarget:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "adGroupTargetId": "46700015332504045"
}

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

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

productGroup:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "productGroupId": "92700000508010025"
}
          
{
  "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 識別。其中一些編號 新版 Search Ads 360 中所有帳戶的全球層級不重複，有些則不重複 限制範圍舉例來說，您必須同時使用廣告群組和廣告 ID，才能明確指定 識別廣告，因為系統會為每個廣告群組指派不重複的廣告 ID，而不會跨廣告群組指派。 以下列出新版 Search Ads 360 中每個物件 ID 的獨特性。這些 ID 規則 為新版 Search Ads 360 物件設計本機儲存空間時非常實用。

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