- HTTP 要求
- 路徑參數
- 要求主體
- 回應主體
- 授權範圍
- ConversionAdjustment
- GclidDateTimePair
- ConversionAdjustmentType
- RestatementValue
- ConversionAdjustmentResult
- 試試看!
處理指定的轉換調整項。
擲回錯誤清單:AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
HTTP 要求
POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadConversionAdjustments
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
必要欄位。執行上傳作業的客戶 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"conversionAdjustments": [
{
object ( |
欄位 | |
---|---|
conversionAdjustments[] |
必要欄位。上傳的轉換資料調整項。 |
partialFailure |
必要欄位。如果為 true,系統就會執行成功的作業,且無效的作業會傳回錯誤。如果為 false,只有在所有作業皆有效的情況下,系統才會在單筆交易中執行所有作業。這個欄位必須一律設為 true。如要進一步瞭解部分失敗,請參閱 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures。 |
validateOnly |
如果為 true,則驗證要求但尚未執行。系統只會傳回錯誤,而非傳回結果。 |
回應主體
ConversionAdjustmentUploadService.UploadConversionAdjustments
的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{ "partialFailureError": { object ( |
欄位 | |
---|---|
partialFailureError |
在部分失敗模式中,發生轉換調整失敗的錯誤。調整期間發生所有錯誤時,系統會傳回這個編號。如果在調整範圍以外發生任何錯誤 (例如驗證錯誤),我們會傳回遠端程序呼叫 (RPC) 層級錯誤。如要進一步瞭解部分失敗,請參閱 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures。 |
results[] |
傳回成功處理的轉換調整項。若發生錯誤的資料列,Proto 將為空白。validationOnly 為 true 時,不會傳回結果。 |
jobId |
上傳批次的工作 ID。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。
ConversionAdjustment
轉換調整項。
JSON 表示法 |
---|
{ "gclidDateTimePair": { object ( |
欄位 | |
---|---|
gclidDateTimePair |
針對調整項,可明確識別報表中沒有指定訂單 ID 的轉換。如果調整類型為 ENHANCEMENT,則此值是選填項目,但除了 orderId 之外,也可以設定。 |
adjustmentType |
調整項類型。 |
restatementValue |
修正轉換價值所需的資訊。必須填寫才能重編。不應提供撤銷要求。如果提供撤銷要求,系統會傳回錯誤。注意:如果您要上傳第二次以其他調整過的值來重編,則該資料必須具有較新的且較新的發生時間。否則,系統會將其視為與先前的重編項目重複,並予以忽略。 |
userIdentifiers[] |
用來提升原始轉換的使用者 ID。ConversionAdjustUploadService 僅接受強化作業中的使用者 ID。每項強化功能最多只能有 5 個使用者 ID。 |
orderId |
要調整的轉換訂單 ID。如果記錄到轉換時指定了訂單 ID,就必須使用該訂單 ID 做為 ID。您必須提供訂單 ID 才能執行強化作業。 |
conversionAction |
與此轉換調整項相關聯的轉換動作資源名稱。注意:雖然這個資源名稱是由客戶 ID 和轉換動作 ID 組成,但驗證作業會忽略客戶 ID,並使用轉換動作 ID 做為轉換動作的唯一 ID。 |
adjustmentDateTime |
調整項發生的日期。必須晚於 conversionDateTime。必須指定時區。格式為「yyyy-mm-dd hh:mm:ss+|-hh:mm」,例如「2019-01-01 12:32:45-08:00」。 |
userAgent |
用來強化原始轉換的使用者代理程式。當使用者在網頁上完成轉換時,這項資訊會顯示在使用者的 HTTP 要求標頭中。例如「Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)」。只有在含有使用者 ID 的強化項目中時,才能指定使用者代理程式。這個步驟必須與傳送原始轉換的要求使用者代理程式相符,因此轉換和強化項目都會歸因於同台裝置,或同時歸因於跨裝置。 |
GclidDateTimePair
用於識別系統回報的轉換,未指定訂單 ID。
JSON 表示法 |
---|
{ "gclid": string, "conversionDateTime": string } |
欄位 | |
---|---|
gclid |
與這個調整項的原始轉換相關聯的 Google 點擊 ID (gclid)。 |
conversionDateTime |
套用這項調整幅度的原始轉換發生日期。必須指定時區。格式為「yyyy-mm-dd hh:mm:ss+|-hh:mm」,例如「2019-01-01 12:32:45-08:00」。 |
ConversionAdjustmentType
廣告客戶可採取的不同動作來調整已記錄的轉換。撤銷動作會歸入轉換。重編會改變轉換價值。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
代表此版本中未知的值。 |
RETRACTION |
否定轉換,讓總價值和計數都歸零。 |
RESTATEMENT |
變更轉換的價值。 |
ENHANCEMENT |
利用提供的使用者 ID 和使用者代理程式來補充現有轉換的資料,Google 可以運用這些資料提高轉換次數。 |
RestatementValue
包含修正轉換價值所需的資訊。
JSON 表示法 |
---|
{ "adjustedValue": number, "currencyCode": string } |
欄位 | |
---|---|
adjustedValue |
重組的轉換價值。這是重編後產生的轉換價值。舉例來說,如要將轉換的價值從 100 變更為 70,則應記錄調整後的值 70。注意:如果您要上傳第二次以其他調整過的值來重編,則該資料必須具有較新的且較新的發生時間。否則,系統會將其視為與先前的重編項目重複,並予以忽略。 |
currencyCode |
剩餘價值的貨幣。如未提供,系統會採用轉換動作的預設幣別;如未設定,則會使用帳戶幣別。此為 ISO 4217 3 字元的貨幣代碼,例如 USD 或 EUR。 |
ConversionAdjustmentResult
識別成功處理的轉換調整項的資訊。
JSON 表示法 |
---|
{ "gclidDateTimePair": { object ( |
欄位 | |
---|---|
gclidDateTimePair |
轉換的 Google 點擊 ID 和轉換日期時間。 |
orderId |
要調整的轉換訂單 ID。 |
adjustmentType |
調整項類型。 |
conversionAction |
與此轉換調整項相關聯的轉換動作資源名稱。 |
adjustmentDateTime |
調整項發生的日期。格式為「yyyy-mm-dd hh:mm:ss+|-hh:mm」,例如「2019-01-01 12:32:45-08:00」。 |