Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

建立或更新 CustomerSkAdNetworkConversionValueSchema。

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

HTTP 要求

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

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

路徑參數

參數
customerId

string

要修改共用組合的客戶 ID。

要求主體

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

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

object (CustomerSkAdNetworkConversionValueSchemaOperation)

要執行的作業。
validateOnly

boolean

如果為 true，則驗證要求但尚未執行。系統只會傳回錯誤，而非傳回結果。

回應主體

customerSkAdNetworkConversionValueSchemas.change 的回應訊息。

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

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

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

變更的所有結果。

授權範圍

需要下列 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)
    }
  ]
}
欄位
appId

string

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

integer

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

object (FineGrainedConversionValueMappings)

僅供輸出。精細的轉換價值對應。

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 視為未設定。

MutateCustomerSkAdNetworkConversionValueSchemaResult

CustomerSkAdNetworkConversionValueSchema 變更的結果。

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

string

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

string

已修改 SkanConversionValue 的應用程式 ID。