新版 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"
}
CRITERION 廣告群組層級條件 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 廣告的 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"
}

實體遺漏的常見原因

雖然廣告主的對應檔案會包含大部分的實體，但仍有少數情況會缺少實體。以下是幾個最常見的原因：

  • 每個對應檔案都會每 3 天更新一次。如果在新實體建立後立即下載對應檔案，該實體可能不會出現在對應檔案中。最多可能需要等待 3 天。
  • 實體所屬帳戶會遭到移除。在這種情況下，我們不支援 ID 對應。

下載報告

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 是為個別廣告群組指派，而非跨廣告群組指派。以下列出新版 Search Ads 360 中每個物件 ID 的唯一性。當您為新 Search Ads 360 物件設計本機儲存空間時，這些 ID 規則可能會很實用。

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