Singular

Singular 是领先的移动衡量合作伙伴（MMP）平台之一，负责收集和展示营销活动数据，帮助企业追踪其广告系列效果。

Adapty 提供完整的数据集，让您可以在一处追踪来自各应用商店的订阅事件。借助 Adapty，您可以轻松了解订阅者的行为习惯和偏好，并将这些信息用于精准有效的用户沟通。因此，本集成支持您在 Singular 中追踪订阅事件，精确分析各广告系列带来的收益。

Adapty 可以将您在集成中配置的所有订阅事件发送至 Singular。这样，您便能在 Singular 看板中追踪这些事件，从而评估广告系列的实际效果。

设置集成

将 Adapty 连接到 Singular

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

此集成需要 Singular SDK Key。您可以在 Singular 看板中找到它：Developer tools -> SDK Keys -> SDK Key（非 SDK Secret）：

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

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

Adapty 将通过服务器对服务器集成向 Singular 发送订阅事件，使您能够在 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...\"}"
}

参数说明：

参数	类型	描述
`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。