Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

建立或更新 CustomerSkAdNetworkConversionValueSchema。

擲回錯誤清單：AuthenticationError AuthorizationError FieldError InternalError MutateError

HTTP 要求

POST https://googleads.googleapis.com/v16/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

共用組合遭到修改的客戶 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean,
  "enableWarnings": boolean
}
欄位
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

要執行的作業。
validateOnly

boolean

如果為 true，表示要求會完成驗證，但尚未執行。系統只會傳回錯誤，不會傳回結果。
enableWarnings

boolean

選用設定。如果為 true，則會啟用傳回警告功能。警告會傳回錯誤訊息和錯誤代碼，但不會封鎖 change 作業的執行。

回應主體

customerSkAdNetworkConversionValueSchemas.mut 的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  },
  "warning": {
    object (Status)
  }
}
欄位
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

所有 的 變更結果。
warning

object (Status)

這些非封鎖錯誤會提供結構定義驗證失敗的詳細資訊。只有在 enableWarnings = true 時，才會傳回這個字串。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/adwords

詳情請參閱 OAuth 2.0 總覽。

CustomerSkAdNetworkConversionValueSchemaOperation

CustomerSkAdNetworkConversionValueSchema 的單一更新作業。

JSON 表示法 
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
欄位
update

object (CustomerSkAdNetworkConversionValueSchema)

更新作業：結構定義應具備有效的資源名稱。

CustomerSkAdNetworkConversionValueSchema

CustomerSkAdNetworkConversionValueSchema。

JSON 表示法 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
欄位
resourceName

string

僅供輸出。結構定義的資源名稱。CustomerSkAdNetworkConversionValueSchema 資源名稱的格式如下：customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}
schema

object (SkAdNetworkConversionValueSchema)

僅供輸出。指定資源的結構定義。

SkAdNetworkConversionValueSchema

CustomerLink 專用的 SkAdNetworkConversionValueSchema。

JSON 表示法 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ],
  "postbackMappings": [
    {
      object (PostbackMapping)
    }
  ]
}
欄位
appId

string

必要欄位。僅供輸出。Apple App Store 應用程式 ID。
measurementWindowHours

integer

僅供輸出。安裝後的時間範圍 (以小時為單位)，應用程式歸因合作夥伴或廣告客戶停止呼叫 updateConversionValue。
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

僅供輸出。精細的轉換價值對應。針對支援多個轉換回溯期的 SkAdNetwork 4.0 以上版本，精細的轉換價值對應只適用於首次回傳。
postbackMappings[]

object (PostbackMapping)

僅供輸出。多個轉換回溯期的回傳的個別回傳轉換價值對應。僅適用於 SkAdNetwork 4.0 以上版本。

FineGrainedConversionValueMappings

精細的轉換價值對應。

JSON 表示法 
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
欄位
fineGrainedConversionValue

integer

僅供輸出。精細的轉換價值。有效值必須在 [0,63] 的範圍內。
conversionValueMapping

object (ConversionValueMapping)

僅供輸出。轉換事件是最精細的轉換價值對應的轉換事件。

ConversionValueMapping

代表某轉換價值與一或多個轉換事件之間的對應。

JSON 表示法 
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
欄位
minTimePostInstallHours

string (int64 format)

僅供輸出。使用者上次在評估期間內處於活躍狀態的最短時間範圍。
maxTimePostInstallHours

string (int64 format)

僅供輸出。使用者上次在評估期間內處於活躍狀態的時間範圍上限。
mappedEvents[]

object (Event)

僅供輸出。轉換價值可對應至具有不同屬性的多個事件。

活動

定義轉換價值對應的 Google 轉換事件。

JSON 表示法 
{
  "mappedEventName": string,
  "currencyCode": string,

  // Union field revenue_rate can be only one of the following:
  "eventRevenueRange": {
    object (RevenueRange)
  },
  "eventRevenueValue": number
  // End of list of possible types for union field revenue_rate.

  // Union field event_rate can be only one of the following:
  "eventOccurrenceRange": {
    object (EventOccurrenceRange)
  },
  "eventCounter": string
  // End of list of possible types for union field event_rate.
}
欄位
mappedEventName

string

僅供輸出。這個轉換價值代表的 Google 事件名稱。
currencyCode

string

僅供輸出。event_revenue 的回報幣別。ISO 4217 三字母貨幣代碼，例如「USD」
聯集欄位 revenue_rate。事件收益的範圍或特定值。revenue_rate 只能是下列其中一項：
eventRevenueRange

object (RevenueRange)

僅供輸出。事件收益範圍。
eventRevenueValue

number

僅供輸出。特定事件的收益值。
聯集欄位 event_rate。事件計數器的範圍或特定值。event_rate 只能是下列其中一項：
eventOccurrenceRange

object (EventOccurrenceRange)

僅供輸出。事件計數器範圍。
eventCounter

string (int64 format)

僅供輸出。適用於特定事件計數器值。

RevenueRange

定義收益值的範圍。

JSON 表示法 
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
欄位
minEventRevenue

number

僅供輸出。如果是收益範圍，這是指系統要更新這個轉換價值的currencyCode最小值。系統會將值 0 視為未設定。
maxEventRevenue

number

僅供輸出。如果是收益範圍，系統會更新這個轉換價值 (currencyCode) 中的最大值。系統會將值 0 視為未設定。

EventOccurrenceRange

定義事件計數器值的範圍。

JSON 表示法 
{
  "minEventCount": string,
  "maxEventCount": string
}
欄位
minEventCount

string (int64 format)

僅供輸出。針對事件計數器範圍，這是指定義範圍的最小值。系統會將值 0 視為未設定。
maxEventCount

string (int64 format)

僅供輸出。事件計數器範圍的定義範圍上限。系統會將值 0 視為未設定。

PostbackMapping

多個轉換回溯期中每個回傳的對應。

JSON 表示法 
{
  "postbackSequenceIndex": integer,
  "coarseGrainedConversionValueMappings": {
    object (CoarseGrainedConversionValueMappings)
  },

  // Union field lock_window_trigger can be only one of the following:
  "lockWindowCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "lockWindowFineConversionValue": integer,
  "lockWindowEvent": string
  // End of list of possible types for union field lock_window_trigger.
}
欄位
postbackSequenceIndex

integer

僅供輸出。以 0 為基礎的索引，表示回傳順序。有效值必須在 [0,2] 的範圍內。
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

僅供輸出。所有不精確轉換價值的轉換價值對應。
聯集欄位 lock_window_trigger。用於鎖定轉換回溯期的事件或轉換價值。lock_window_trigger 只能是下列其中一項：
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

僅供輸出。涵蓋會觸發轉換回溯期鎖定的完整轉換價值。
lockWindowFineConversionValue

integer

僅供輸出。精細的轉換價值會觸發轉換回溯期鎖定。
lockWindowEvent

string

僅供輸出。觸發轉換回溯期鎖定的事件名稱。

CoarseGrainedConversionValueMappings

粗略的轉換價值對應。

JSON 表示法 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
欄位
lowConversionValueMapping

object (ConversionValueMapping)

僅供輸出。對應「低」粗略轉換價值。
mediumConversionValueMapping

object (ConversionValueMapping)

僅供輸出。「中」粗略的轉換價值對應。
highConversionValueMapping

object (ConversionValueMapping)

僅供輸出。對應「高」粗略轉換價值。

MutateCustomerSkAdNetworkConversionValueSchemaResult

CustomerSkAdNetworkConversionValueSchema 的變更結果。

JSON 表示法 
{
  "resourceName": string,
  "appId": string
}
欄位
resourceName

string

已修改客戶的資源名稱。
appId

string

已修改 SkanConversionValue 的應用程式 ID。