Singular 是领先的移动归因平台（MMP）之一，能够收集并呈现营销活动数据，帮助企业追踪广告投放效果。

Adapty 提供了一套完整的数据，让您可以在一个地方追踪来自各应用商店的订阅事件。借助 Adapty，您可以轻松了解订阅用户的行为规律，掌握他们的偏好，并据此进行精准、有效的用户触达。因此，通过此集成，您可以在 Singular 中追踪订阅事件，并精确分析各广告系列带来的收益。

Adapty 可以将所有已在集成中配置的订阅事件发送到 Singular。这样，您就能在 Singular 看板中追踪这些事件。此集成有助于评估广告投放活动的效果。

设置集成

将 Adapty 连接至 Singular

要设置与 Singular 的集成，请在 Adapty 看板中前往 Integrations > Singular，开启开关并填写相关字段。

可填写的凭据如下：

• Singular SDK Key：必填。你的 Singular 应用的生产环境 SDK 密钥。
• Singular SDK Key (Sandbox)：选填。你的沙盒 Singular 应用的 SDK 密钥。如果未设置，沙盒事件将不会发送至 Singular。

这两个密钥都可以在 Singular 看板的 Developer tools -> SDK Keys -> SDK Key (不是 SDK Secret) 下找到：

在凭据下方，有三组事件可供您从 Adapty 发送到 Singular。点击此处查看 Adapty 提供的完整事件列表。

我们建议使用 Adapty 提供的默认事件名称，但您也可以根据需要自定义事件名称。

Adapty 将通过服务器对服务器集成向 Singular 发送订阅事件，让您可以在 Singular 看板中查看所有订阅事件，并将其与您的获客活动关联起来。

将您的应用连接到 Singular

Adapty 与 Singular 之间的集成为服务器对服务器方式，因此无需在您的应用程序中添加任何额外代码。

事件结构

Adapty 通过带有查询参数的 GET 请求将事件发送给 Singular。每个事件的结构如下：

{
  "n": "subscription_renewed",
  "a": "singular_sdk_key_123",
  "p": "iOS",
  "i": "com.example.app",
  "ip": "192.168.100.1",
  "idfa": "00000000-0000-0000-0000-000000000000",
  "idfv": "00000000-0000-0000-0000-000000000000",
  "ve": "17.0.1",
  "att_authorization_status": 3,
  "custom_user_id": "user_12345",
  "utime": 1709294400,
  "amt": 9.99,
  "cur": "USD",
  "purchase_product_id": "yearly.premium.6999",
  "purchase_transaction_id": "GPA.3383...",
  "e": "{\"is_revenue_event\":true,\"amt\":9.99,\"cur\":\"USD\",\"purchase_product_id\":\"yearly.premium.6999\",\"purchase_transaction_id\":\"GPA.3383...\"}"
}

Where:

参数	类型	描述
n	String	事件名称（从 Adapty 事件映射而来）。
a	String	你的 Singular SDK Key。
p	String	平台（“iOS” 或 “Android”）。
i	String	应用商店 App ID（Bundle ID）。
ip	String	用户的 IP 地址。
idfa	String	仅 iOS。广告标识符（大写）。
idfv	String	仅 iOS。供应商标识符（大写）。
aifa	String	仅 Android。Google 广告 ID（小写）。
andi	String	仅 Android。Android ID（小写）。
asid	String	仅 Android。App Set ID（小写）。
ve	String	操作系统版本。
att_authorization_status	Integer	仅 iOS。ATT 状态（例如，3 表示已授权）。
custom_user_id	String	用户的 Customer User ID。
utime	Long	事件的 UNIX 时间戳（秒）。
amt	Float	收入金额。
cur	String	货币代码（例如，“USD”）。
purchase_product_id	String	应用商店中的产品 ID。
purchase_transaction_id	String	原始交易 ID。
e	String	包含事件详情的 JSON 字符串（见下文）。

e 参数（自定义事件数据）是一个 JSON 编码的字符串，包含：

参数	类型	描述
is_revenue_event	Boolean	若事件包含收入则为 true。
amt	Float	收入金额。
cur	String	货币代码。
purchase_product_id	String	商店中的产品 ID。
purchase_transaction_id	String	原始交易 ID。