adjust-icon

Superwall SDK 集成

借助 Superwall 集成,您可以通过服务器端到服务器端 (S2S) 方式,将订阅生命周期事件从 Superwall 转发到 Adjust。Superwall 向 Adjust S2S 事件 API 发送 App Store 订阅事件。

集成包括两个部分:

  • 客户端 :向 Superwall SDK 发送设备标识符和 Adjust 设备 ID (ADID),以便 Superwall 将这些信息包含在 S2S 请求中。
  • 服务器端 :在 Adjust 控制面板中创建事件识别码,然后在 Superwall 控制面板中将识别码映射到 Superwall 订阅事件。

操作前须知

在配置 Superwall 集成之前,请完成以下操作:

  1. 集成 Adjust iOS SDK
  2. 集成 Superwall iOS SDK

发送 Adjust ADID

设备完成首个跟踪到的会话后,就可以读取到 ADID。在 Adjust 会话成功回传中调取该 ID,并使用 setIntegrationAttributes 将其发送至 Superwall SDK。

发送附加归因

Superwall 会针对每个 S2S 请求转发附加归因。Adjust 使用这些标识符进行更可靠的设备匹配,并优化推广活动。收集以下变量,并使用 setUserAttributes 将其发送至 Superwall:

变量描述
idfaiOS 广告标识符。
att_statusApp Tracking Transparency 授权状态(整数 0-3)。
idfviOS 供应商标识符。
ip_address设备的公共 IPv4 地址。从您的应用服务器或合适的 API 调取。

Superwall SDK 会针对每个 S2S 请求自动收集并转发 device_nameos_version

收集推广变量

Adjust SDK 提供获取 IDFA、IDFV 和 ATT 状态的方法。您可以使用这些参数,直接导入AdSupportAppTrackingTransparency。如果您通过 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
adidAdjust 设备 ID。
idfaiOS 广告标识符。
idfviOS 供应商标识符。
att_statusATT 授权状态 (0-3)。
device_name硬件型号标识符。由 Superwall SDK 自动收集。
os_versioniOS 版本。由 Superwall SDK 自动收集。
ip_address设备的公共 IPv4 地址。
created_at_unix事件时间戳 (UNIX 秒)。
environmentsandboxproduction。从交易中自动检测。
revenue收入金额基于已配置的收入报告模式 (RevenueProceeds)。非收入事件的收入金额信息省略。
currencyISO 4217 货币代码。当存在 revenue 时包含在内。
callback_params包含 product_idtransaction_idoffer_code (如有) 的 JSON 对象。可在 Adjust 原始数据导出中使用。