Conversion

轉換資源提供方法，可讓使用者大量建立、修改及擷取 Floodlight 轉換。

如需本資源的方法清單，請見本頁結尾。

資源表示法

列出轉換。

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string
    }
  ]
}

資源名稱	值	說明	附註
conversion[]	list	所要求的轉換。
conversion[].adGroupId	long	DS 廣告群組 ID。
conversion[].adId	long	DS 廣告 ID。
conversion[].adUserDataConsent	string	代表在設定中授予核心平台服務 (CPS) 偏好設定的同意聲明。沒有預設值。可接受的值為：GRANTED：您想授予的同意聲明狀態是授予的。讀取 GTE 設定中的 CPS 偏好設定。DENIED：想要的同意聲明狀態為「拒絕」，但 CPS 清單空白。
conversion[].advertiserId	long	DS 廣告主 ID。
conversion[].agencyId	long	DS 代理商 ID。
conversion[].attributionModel	string	與 DoubleClick Search 客戶服務團隊聯絡後，廣告客戶才能使用這項功能。
conversion[].campaignId	long	DS 廣告活動 ID。
conversion[].channel	string	產品的銷售通路。可接受的值為： 「local」：實體商店 「online」：網路商店
conversion[].clickId	string	轉換的 DS 點擊 ID。
conversion[].conversionId	string	廣告主需提供這個 ID，才能處理離線轉換。廣告客戶可以指定任何有意義的 ID。請求中的每次轉換都必須指定專屬 ID，且在廣告客戶的所有轉換中，ID 和時間戳記的組合不得重複。 如果是線上轉換，DS 會根據廣告客戶的 Floodlight 指示，將 dsConversionId 或 floodlightOrderId 複製到這項資源。
conversion[].conversionModifiedTimestamp	unsigned long	上次修改轉換的時間 (以 Epoch 紀元時間 (UTC) 為單位。
conversion[].conversionTimestamp	unsigned long	轉換發生的時間，以 Epoch 紀元時間 (UTC) 為單位。
conversion[].countMillis	long	與 DoubleClick Search 客戶服務團隊聯絡後，廣告客戶才能使用這項功能。
conversion[].criterionId	long	DS 條件 (關鍵字) 編號。
conversion[].currencyCode	string	轉換收益的貨幣代碼。格式須為 ISO 4217 字母 (3 個字元)	可寫入
conversion[].customDimension[]	list	轉換的自訂維度，可用來篩選報表中的資料。
conversion[].customDimension[].name	string	自訂維度名稱。
conversion[].customDimension[].value	string	自訂維度值。
conversion[].customMetric[]	list	轉換的自訂指標。
conversion[].customMetric[].name	string	自訂指標名稱。
conversion[].customMetric[].value	double	自訂指標數值。
conversion[].customerId	string	新版 Search Ads 360 客戶 ID。必須是客戶帳戶。設定這個欄位後，所有其他 ID 欄位都應設為新版 Search Ads 360 ID。
conversion[].deviceType	string	發生轉換的裝置類型。 可接受的值如下： "DESKTOP" "HIGH_END_MOBILE" "OTHER_DEVICE" "TABLET"
conversion[].dsConversionId	long	DoubleClick Search 為每次轉換產生的 ID。
conversion[].engineAccountId	long	DS 引擎帳戶 ID。
conversion[].floodlightOrderId	string	廣告客戶提供的轉換 Floodlight 訂單 ID。
conversion[].inventoryAccountId	long	DS 產生的 ID 可用於識別產品所屬商品目錄帳戶。
conversion[].productCountry	string	替內含該產品的 Merchant Center 動態饋給註冊的國家/地區。請使用 ISO 3166 代碼指定國家/地區。
conversion[].productGroupId	long	DS 產品群組 ID。
conversion[].productId	string	產品 ID (SKU)。
conversion[].productLanguage	string	替內含產品的 Merchant Center 動態饋給註冊的語言。請使用 ISO 639 代碼指定語言。
conversion[].quantityMillis	long	這項轉換的數量 (以千分之一為單位)，	可寫入
conversion[].revenueMicros	long	此 TRANSACTION 轉換的收益金額，以微量為單位 (值乘以 1000000，無小數)。舉例來說，如要指定收益值「10」，請在請求中輸入「10000000」(1 千萬)。	可寫入
conversion[].segmentationId	long	數字區隔 ID (例如 DoubleClick Search Floodlight 活動 ID)。
conversion[].segmentationName	string	友善區隔 ID (例如 DoubleClick Search Floodlight 活動名稱)。
conversion[].segmentationType	string	這項轉換的區隔類型 (例如 FLOODLIGHT)。 可接受的值如下： "FLOODLIGHT"
conversion[].state	string	轉換狀態，也就是 ACTIVE 或 REMOVED。注意：DELETED 已淘汰。 可接受的值如下： "ACTIVE" "DELETED":  (已淘汰) "REMOVED"	可寫入
conversion[].storeId	string	廣告中宣傳產品的本地商店 ID。只有在頻道為「local」時才能使用。
conversion[].type	string	轉換的類型，也就是 ACTION 或 TRANSACTION。ACTION 轉換是指沒有可量化價值的使用者動作，TRANSACTION 轉換則是指具有可量化價值的動作。例如註冊電子郵件名單 (ACTION) 與電子商務購買 (TRANSACTION)。 可接受的值如下： "ACTION" "TRANSACTION"
kind	string	將此視為 ConversionList 資源。值：固定字串 doubleclicksearch#conversionList。

方法

get

從 DoubleClick Search 引擎帳戶擷取轉換清單。

getByCustomerId

使用新版 Search Ads 360 客戶 ID 從 DoubleClick Search 引擎帳戶擷取轉換清單。

插入

在 DoubleClick Search 中插入大量新轉換。

更新

更新 DoubleClick Search 中的一批轉換。

updateAvailability

更新 DoubleClick Search 中大量 Floodlight 活動的供應情形。