轉換資源提供方法,可讓使用者大量建立、修改及擷取 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 |
產品的銷售通路。可接受的值為:
|
|
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 |
發生轉換的裝置類型。
可接受的值如下:
|
|
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 )。
可接受的值如下:
|
|
conversion[].state |
string |
轉換狀態,也就是 ACTIVE 或 REMOVED 。注意:DELETED 已淘汰。可接受的值如下:
|
可寫入 |
conversion[].storeId |
string |
廣告中宣傳產品的本地商店 ID。只有在頻道為「local 」時才能使用。 |
|
conversion[].type |
string |
轉換的類型,也就是 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 活動的供應情形。