新版 Search Ads 360

新版 Search Ads 360 會將新 ID 指派給使用者帳戶、廣告活動、廣告群組、關鍵字 (條件) 和廣告。這些 ID 有兩項額外的行為變更:

  • 新版 Search Ads 360 會指派全域專屬客戶 ID 給管理員、副管理員和客戶帳戶,正式稱為代理商、廣告客戶和引擎帳戶。

  • 新版 Search Ads 360 不會再將專屬 ID 指派給關鍵字和廣告。

Conversion API 現在可接受新版 Search Ads 360 客戶 ID,只要是接受代理商 ID、廣告客戶 ID 和引擎帳戶 ID 的地方。如果您指定客戶 API,API 會預期廣告活動 ID、廣告群組 ID、關鍵字 ID 和廣告 ID 都是新版 Search Ads 360 ID。使用新版 Search Ads 360 關鍵字或廣告 ID 時,每當您的要求使用關鍵字或廣告 ID,您就必須指定相關的廣告活動和廣告群組 ID。

當您在要求中使用新的 Search Ads 360 ID 時,回應也會使用新版 Search Ads 360 ID。

名單轉換

清單要求提供新的 Search Ads 360 ID 端點。您必須提供客戶帳戶的客戶 ID。此外,您仍然可以指定要在查詢參數中列出的廣告活動 ID 和廣告群組 ID。但 endDaterowCountstartDatestartRow 仍為必要項目。

HTTP 要求

GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion

插入/更新轉換

我們支援使用新版 Search Ads 360 ID 提出的下列要求:

  • 將轉換歸因於關鍵字和廣告
  • 僅將轉換歸因於關鍵字
  • 根據指定轉換的 criterionId (關鍵字 ID) 更新轉換

而端點則一樣請務必在每項轉換資源中提供新的 Search Ads 360 ID:您不必設定 agencyIdadvertiserIdengineAccountId,而是應提供 customerId,並視需要在 campaignIdadGroupIdcriterionIdadId 中使用新版 Search Ads 360 ID。

以下要求範例說明如何使用新版 Search Ads 360 ID 將轉換歸因於關鍵字。

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
{
  "conversion" : [
    {
      "customerId": "123-123-1234"
      "campaignId": "10000001",
      "adGroupId": "20000001",
      "criterionId": "30000001",
      "conversionId": "floodlight conversion ID 1",
      "conversionTimestamp": "1660799917714",
      "type": "ACTION",
      "quantityMillis": "1000",
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test"
    }
  ]
}
    

指定供應情形

您也可以在 Conversion.updateAvailability() 方法中使用新版 Search Ads 360 ID。請務必使用副管理員客戶 ID。範例如下:

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
  "availabilities": [
    {
      "customerId": "123-123-1234"
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test",
      "availabilityTimestamp": "1389348800000"
    }
  ]
}