借助 Superwall 集成,您可以通过服务器端到服务器端 (S2S) 方式,将订阅生命周期事件从 Superwall 转发到 Adjust。Superwall 向 Adjust S2S 事件 API 发送 App Store 订阅事件。
集成包括两个部分:
- 客户端 :向 Superwall SDK 发送设备标识符和 Adjust 设备 ID (ADID),以便 Superwall 将这些信息包含在 S2S 请求中。
- 服务器端 :在 Adjust 控制面板中创建事件识别码,然后在 Superwall 控制面板中将识别码映射到 Superwall 订阅事件。
操作前须知
在配置 Superwall 集成之前,请完成以下操作:
发送 Adjust ADID
设备完成首个跟踪到的会话后,就可以读取到 ADID。在 Adjust 会话成功回传中调取该 ID,并使用 setIntegrationAttributes 将其发送至 Superwall SDK。
发送附加归因
Superwall 会针对每个 S2S 请求转发附加归因。Adjust 使用这些标识符进行更可靠的设备匹配,并优化推广活动。收集以下变量,并使用 setUserAttributes 将其发送至 Superwall:
| 变量 | 描述 |
|---|---|
idfa | iOS 广告标识符。 |
att_status | App Tracking Transparency 授权状态(整数 0-3)。 |
idfv | iOS 供应商标识符。 |
ip_address | 设备的公共 IPv4 地址。从您的应用服务器或合适的 API 调取。 |
Superwall SDK 会针对每个 S2S 请求自动收集并转发 device_name 和 os_version。
收集推广变量
Adjust SDK 提供获取 IDFA、IDFV 和 ATT 状态的方法。您可以使用这些参数,直接导入AdSupport和AppTrackingTransparency。如果您通过 Adjust SDK 处理 ATT 则也可以在 ATT 授权回传 中调取这些值。
配置 Superwall 控制面板
在 Superwall 控制面板中进行下列设置以启用事件转发。
事件映射
在 Adjust 控制面板中创建事件识别码,然后将其添加到 Superwall 控制面板,将每个识别码映射到对应的 Superwall 订阅事件。您需要为每个要转发的事件创建一个单独的事件识别码。只有配置了相应的事件识别码,事件才会被转发。
有关受支持事件及其映射逻辑的完整列表,请参阅 Superwall Adjust 事件映射文档。
S2S 安全识别码
如果您在 Adjust 中启用了 S2S 安全识别码,请创建一个 S2S 安全识别码并将其添加至 Superwall 控制面板。Superwall 会将该识别码作为 Authorization: Bearer 标头包含在每个 S2S 请求中。
环境
Superwall 会自动检测每个事件是来自 sandbox 还是生产环境。针对通过 TestFlight 或使用 sandbox Apple ID 进行的 sandbox 环境购买,转发时 environment会被设置为 sandbox。针对生产环境中的购买,environment设置为production。Adjust 使用此字段来区分测试数据和实时数据。
收入
对于包含收入的事件,Superwall 会将购买金额和币种转发给 Adjust。您可以在 Superwall 控制面板中将收入报告模式配置为“Revenue” (收入) 或“利润” (Proceeds)。
- Revenue :毛收入,即完整购买价格。
- Proceeds :扣除支付处理费用 (如 App Store 费用) 后的净收入。
无收入事件在发送时不带收入参数。当计算所得的金额低于 0.001 时,收入将被忽略。
S2S 请求参数
每个转发至 Adjust S2S 事件 API 的事件都包含以下参数。
| 参数 | 描述 |
|---|---|
s2s | 始终为 1表示服务器端到服务器端的请求。 |
app_token | 在 Superwall 控制面板中配置的 Adjust 应用识别码。 |
event_token | 映射到 Superwall 事件的 Adjust 事件识别码。 |
os_name | 平台名称。针对 App Store 事件设置为 ios。 |
adid | Adjust 设备 ID。 |
idfa | iOS 广告标识符。 |
idfv | iOS 供应商标识符。 |
att_status | ATT 授权状态 (0-3)。 |
device_name | 硬件型号标识符。由 Superwall SDK 自动收集。 |
os_version | iOS 版本。由 Superwall SDK 自动收集。 |
ip_address | 设备的公共 IPv4 地址。 |
created_at_unix | 事件时间戳 (UNIX 秒)。 |
environment | sandbox 或 production。从交易中自动检测。 |
revenue | 收入金额基于已配置的收入报告模式 (Revenue或Proceeds)。非收入事件的收入金额信息省略。 |
currency | ISO 4217 货币代码。当存在 revenue 时包含在内。 |
callback_params | 包含 product_id、transaction_id 和 offer_code (如有) 的 JSON 对象。可在 Adjust 原始数据导出中使用。 |