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.mutate 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  }
}
字段
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

此 mutate 的所有结果。

授权范围

需要以下 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 mutate 的结果。

JSON 表示法 
{
  "resourceName": string,
  "appId": string
}
字段
resourceName

string

被修改的客户的资源名称。
appId

string

已修改的 SkanConversionValue 的应用 ID。