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 偏好設定。遭拒：所需的同意聲明狀態是拒絕；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`	轉換上次修改的時間 (以毫秒為單位，以世界標準時間為準)。
`conversion[].conversionTimestamp`	`unsigned long`	轉換發生時間，以毫秒為單位 (世界標準時間)。
`conversion[].countMillis`	`long`	只有在與 DoubleClick Search 客戶服務聯絡後，廣告客戶才能使用此功能。
`conversion[].criterionId`	`long`	DS 條件 (關鍵字) ID。
`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,000 萬)。	可寫入
`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`。

方法

取得: 從 DoubleClick Search 引擎帳戶擷取轉換清單。
getByCustomerId: 使用新版 Search Ads 360 客戶 ID，從 DoubleClick Search 引擎帳戶擷取轉換清單。
插入: 將一批新的轉換插入 DoubleClick Search。
更新: 更新 DoubleClick Search 中的一批轉換。
updateAvailability: 更新 DoubleClick Search 中一批 Floodlight 活動的可用功能。