REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

资源：SKAdNetworkConversionValueSchema

iOS 数据流的 SKAdNetwork 转化价值架构。

JSON 表示法 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
字段
name

string

仅限输出。架构的资源名称。这将仅是 iOS 数据流的子级，且 iOS 数据流下最多只能有一个此类子级。格式：properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

必需。第一个回传时间范围的转化价值设置。它们与回传时间范围 2 和 3 的值不同，因为它们包含“精细”的转化价值（数值）。

必须设置此回传时间范围的转化价值。其他窗口为可选项，如果未设置或停用，可能会沿用此窗口的设置。
postbackWindowTwo

object (PostbackWindow)

第二个回传时间范围的转化价值设置。

仅当需要为此回传时间范围定义不同的转化价值时，才应配置此字段。

如果将此回传时间范围的 enable_postback_window_settings 设置为 false，将使用 postbackWindowOne 的值。
postbackWindowThree

object (PostbackWindow)

第三个回传时间范围的转化价值设置。

仅当用户选择为此回传时间范围定义不同的转化价值时，才应设置此字段。可以在不设置窗口 2 的情况下配置窗口 3。如果已设置窗口 1 和窗口 2，并且此回传窗口的 enable_postback_window_settings 设置为 false，架构将继承 postbackWindowTwo 的设置。
applyConversionValues

boolean

启用后，Google Analytics（分析）SDK 将使用此架构定义设置转化价值，并且架构将导出到与此媒体资源关联的所有 Google Ads 帐号。如果停用，GA SDK 不会自动设置转化价值，架构也不会导出到 Google Ads。

PostbackWindow

SKAdNetwork 转化回传时间范围的设置。

JSON 表示法 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
字段
conversionValues[]

object (ConversionValues)

重复字段的顺序将用于确定转化价值设置的优先级。编入索引的条目越低，优先级越高。系统会选择第一个评估结果为 true 的转化价值设置。如果将 enable_postback_window_settings 设置为 true，则必须至少包含一个条目。最多可以包含 128 个条目。
postbackWindowSettingsEnabled

boolean

如果 enable_postback_window_settings 为 true，则必须填充 conversionValues，并且将用于确定何时以及如何在客户端设备上设置转化价值，以及将架构导出到关联的 Google Ads 账号。如果设为 false，系统不会使用这些设置，但系统会保留这些设置，以备日后使用。对于 postbackWindowOne，必须始终为 true。

ConversionValues

SKAdNetwork 转化价值架构的回传时间范围的转化价值设置。

JSON 表示法 
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
字段
displayName

string

SKAdNetwork 转化价值的显示名称。显示名称的长度上限为 50 个 UTF-16 代码单元。
coarseValue

enum (CoarseValue)

必需。粗略的转化价值。

此值不一定是唯一的。
eventMappings[]

object (EventMapping)

为实现此转化价值而必须满足的事件条件。此列表中的条件以 AND 相连。如果启用了回传时间范围，其中必须至少包含 1 个条目，最多包含 3 个条目。
lockEnabled

boolean

如果为 true，SDK 应锁定为当前回传时间范围的此转化价值。
fineValue

integer

细化的转化价值。此设置仅适用于第一个回传时间范围。其有效值为 [0,63]（含 [0,63]）。必须为回传时间范围 1 设置此值，不得为回传时间范围 2 和 3 设置此值。此值不一定是唯一的。

如果第一个回传时间范围的配置会重复用于第二个或第三个回传时间范围，则此字段不会产生任何影响。

CoarseValue

当满足 ConversionValues.event_mappings 条件时，通过 updatePostbackConversionValue SDK 调用设置的粗略转化价值。如需了解详情，请参阅 SKAdNetwork.CoarseConversionValue。

枚举
COARSE_VALUE_UNSPECIFIED 未指定粗略值。
COARSE_VALUE_LOW 粗略值低。
COARSE_VALUE_MEDIUM 媒介的粗略值。
COARSE_VALUE_HIGH 表示粗略的高值。

EventMapping

与事件匹配的事件设置条件。

JSON 表示法 
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
字段
eventName

string

必需。GA4 事件的名称。必须始终设置此字段。显示名称的长度上限为 40 个 UTF-16 代码单元。
minEventCount

string (int64 format)

必须至少设置以下四个最小值/最大值中的一个。所设置的值将以 AND 关系结合在一起，以确定事件。事件发生的最小次数。如果未设置，则不会检查事件数下限。
maxEventCount

string (int64 format)

事件发生的次数上限。如果未设置，则不会检查事件数上限。
minEventValue

number

由该事件产生的最低收入。收入币种将在媒体资源一级指定。如果未设置，则不会检查最小事件价值。
maxEventValue

number

由该事件产生的最高收入。收入币种将在媒体资源一级指定。如果未设置，则不会检查事件价值上限。

方法

create

 创建 SKAdNetworkConversionValueSchema。

delete

 删除目标 SKAdNetworkConversionValueSchema。

get

 查找单个 SKAdNetworkConversionValueSchema。

list

 列出数据流上的 SKAdNetworkConversionValueSchema。

patch

 更新 SKAdNetworkConversionValueSchema。