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 流下最多只能有一个这样的子级。格式：property/{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

启用后，GA 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]（含两个端点）。您必须针对回传时间范围 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。