PostHog

PostHog 是一个分析平台，提供用户行为追踪、产品使用可视化和留存分析等工具。凭借事件追踪、用户流程分析和功能标志等功能，它能帮助你更好地了解和改进产品。将 PostHog 与 Adapty 集成后，即可无缝追踪订阅相关事件，例如试用开始、续订和取消等。通过将这些事件发送至 PostHog，你可以分析订阅变化对用户行为的影响、评估付费墙效果，并在现有分析工作流中深入了解你的变现策略。

集成特性

集成特性	描述
时间安排	实时；事件可能不会立即出现在 PostHog 看板上。
数据方向	Adapty 事件从 Adapty 服务器发送到 PostHog 服务器。
Adapty 集成点	移动应用代码中的 PostHog 和 Adapty SDK Adapty 服务器

PostHog 事件结构

Adapty 会根据 PostHog 集成页面上 Events names 部分的配置，将所选事件发送到 PostHog。每个事件的结构如下：

{
  "distinct_id": "[email protected]",
  "timestamp": "2025-01-08T11:06:12+00:00",
  "event": "subscription_started",
  "properties": {
    "$set": {
      "email": "[email protected]",
      "first_name": "John",
      "last_name": "Doe",
      "birthday": "1990-01-01",
      "gender": "male",
      "os": "iOS"
    },
    "timezone": "America/New_York",
    "ip_address": "10.168.1.1",
    "*": "{{other_event_properties}}"
  }
}

其中

参数	类型	描述
distinct_id	String	用户的唯一标识符（例如 `profile.posthog_distinct_user_id`、`customer_user_id` 或 `profile_id`）。
timestamp	ISO 8601 日期和时间	事件发生的日期和时间。
event	String	事件名称，即你在 PostHog 配置的 Events names 部分中定义的名称。
properties	Object	包含 properties.$set 以及所有事件专属属性。每个属性均为可选项，若缺失则不会发送至 PostHog。

properties.$set 参数

properties.$set 对象中的每个参数都是可选的，如果缺失则不会发送到 PostHog。

参数	类型	描述
email	String	用户的电子邮件地址。
first_name	String	用户的名字。
last_name	String	用户的姓氏。
birthday	String (Date)	用户的出生日期。
gender	String	用户的性别。
os	String	用户设备的操作系统。

设置 PostHog 集成

打开 Adapty 看板中的 Integrations -> PostHog 页面，并启用开关。
登录 PostHog 看板。
导航至 Settings -> Project。
在 Project 窗口中，向下滚动至 Project ID 部分，复制 Project API key。
将 API key 粘贴到 Adapty 看板中的 Project API key 字段。PostHog 的服务端集成不支持专用的沙盒模式。
选择您的 PostHog Deployment： | 选项 | 描述 | | ------ | ------------------------------------------------------------ | | us/eu | 默认的 PostHog 托管部署。 | | Custom | 适用于自托管实例。请在 PostHog Instance URL 字段中输入您的实例 URL。 |
（可选）如果您使用的是自托管的 PostHog 部署，请在 PostHog Instance URL 字段中输入您的部署地址。
（可选）调整 Reporting Proceeds、Exclude Historical Events、Report User’s Currency 和 Send Trial Price 等设置。详情请参阅集成设置。
（可选）你还可以在 Events names 部分自定义发送至 PostHog 的事件。禁用不需要的事件或根据需要重命名它们。
点击 Save 完成配置。

SDK 配置

要启用从 PostHog 接收归因数据，请按如下方式将 distinctId 值传递给 Adapty：

如果您使用第三方用户 ID 作为 Customer User ID，请不要在 activate() 时传入——第三方 SDK 可能尚未生成该 ID。请先不带 CUID 调用 activate()，然后调用 setIntegrationIdentifier()，最后再使用 CUID 调用 identify()。

do {
    let distinctId = PostHogSDK.shared.getDistinctId()

    try await Adapty.setIntegrationIdentifier(
        key: "posthog_distinct_user_id",
        value: distinctId
    )
} catch {
    // handle the error
}

Adapty.setIntegrationIdentifier("posthog_distinct_user_id", PostHog.distinctId()) { error ->
    if (error != null) {
        // handle the error
    }

Adapty.setIntegrationIdentifier("posthog_distinct_user_id", PostHog.distinctId(), error -> {
    if (error != null) {
        // handle the error
    }
});

try {
    final distinctId = await Posthog().getDistinctId();

    await Adapty().setIntegrationIdentifier(
        key: "posthog_distinct_user_id",
        value: distinctId,
    );
} catch (e) {
    // handle the error
}


// ...
const posthog = usePostHog();

// ...
try {
  await adapty.setIntegrationIdentifier("posthog_distinct_user_id", posthog.getDistinctId());
} catch (error) {
  // handle `AdaptyError`
}

Adapty 现在将向 PostHog 发送事件并从中接收归因数据。