资源:SKAdNetworkConversionValueSchema
iOS 数据流的 SKAdNetwork 转化价值架构。
JSON 表示法 |
---|
{ "name": string, "postbackWindowOne": { object ( |
字段 | |
---|---|
name |
仅限输出。架构的资源名称。这将仅是 iOS 数据流的子级,且 iOS 数据流下最多只能有一个此类子级。格式:properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema |
postbackWindowOne |
必需。第一个回传时间范围的转化价值设置。它们与回传时间范围 2 和 3 的值不同,因为它们包含“精细”的转化价值(数值)。 必须设置此回传时间范围的转化价值。其他窗口为可选项,如果未设置或停用,可能会沿用此窗口的设置。 |
postbackWindowTwo |
第二个回传时间范围的转化价值设置。 仅当需要为此回传时间范围定义不同的转化价值时,才应配置此字段。 如果将此回传时间范围的 enable_postback_window_settings 设置为 false,将使用 postbackWindowOne 的值。 |
postbackWindowThree |
第三个回传时间范围的转化价值设置。 仅当用户选择为此回传时间范围定义不同的转化价值时,才应设置此字段。可以在不设置窗口 2 的情况下配置窗口 3。如果已设置窗口 1 和窗口 2,并且此回传窗口的 enable_postback_window_settings 设置为 false,架构将继承 postbackWindowTwo 的设置。 |
applyConversionValues |
启用后,Google Analytics(分析)SDK 将使用此架构定义设置转化价值,并且架构将导出到与此媒体资源关联的所有 Google Ads 帐号。如果停用,GA SDK 不会自动设置转化价值,架构也不会导出到 Google Ads。 |
PostbackWindow
SKAdNetwork 转化回传时间范围的设置。
JSON 表示法 |
---|
{
"conversionValues": [
{
object ( |
字段 | |
---|---|
conversionValues[] |
重复字段的顺序将用于确定转化价值设置的优先级。编入索引的条目越低,优先级越高。系统会选择第一个评估结果为 true 的转化价值设置。如果将 enable_postback_window_settings 设置为 true,则必须至少包含一个条目。最多可以包含 128 个条目。 |
postbackWindowSettingsEnabled |
如果 enable_postback_window_settings 为 true,则必须填充 conversionValues,并且将用于确定何时以及如何在客户端设备上设置转化价值,以及将架构导出到关联的 Google Ads 账号。如果设为 false,系统不会使用这些设置,但系统会保留这些设置,以备日后使用。对于 postbackWindowOne,必须始终为 true。 |
ConversionValues
SKAdNetwork 转化价值架构的回传时间范围的转化价值设置。
JSON 表示法 |
---|
{ "displayName": string, "coarseValue": enum ( |
字段 | |
---|---|
displayName |
SKAdNetwork 转化价值的显示名称。显示名称的长度上限为 50 个 UTF-16 代码单元。 |
coarseValue |
必需。粗略的转化价值。 此值不一定是唯一的。 |
eventMappings[] |
为实现此转化价值而必须满足的事件条件。此列表中的条件以 AND 相连。如果启用了回传时间范围,其中必须至少包含 1 个条目,最多包含 3 个条目。 |
lockEnabled |
如果为 true,SDK 应锁定为当前回传时间范围的此转化价值。 |
fineValue |
细化的转化价值。此设置仅适用于第一个回传时间范围。其有效值为 [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 |
必需。GA4 事件的名称。必须始终设置此字段。显示名称的长度上限为 40 个 UTF-16 代码单元。 |
minEventCount |
必须至少设置以下四个最小值/最大值中的一个。所设置的值将以 AND 关系结合在一起,以确定事件。事件发生的最小次数。如果未设置,则不会检查事件数下限。 |
maxEventCount |
事件发生的次数上限。如果未设置,则不会检查事件数上限。 |
minEventValue |
由该事件产生的最低收入。收入币种将在媒体资源一级指定。如果未设置,则不会检查最小事件价值。 |
maxEventValue |
由该事件产生的最高收入。收入币种将在媒体资源一级指定。如果未设置,则不会检查事件价值上限。 |
方法 |
|
---|---|
|
创建 SKAdNetworkConversionValueSchema。 |
|
删除目标 SKAdNetworkConversionValueSchema。 |
|
查找单个 SKAdNetworkConversionValueSchema。 |
|
列出数据流上的 SKAdNetworkConversionValueSchema。 |
|
更新 SKAdNetworkConversionValueSchema。 |