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 密钥粘贴到 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 完成设置。

选项	描述
us/eu	默认的 PostHog 托管部署。
Custom	用于自托管实例。在 PostHog Instance URL 字段中输入您的实例 URL。

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
}

import { adapty } from 'react-native-adapty';
import { usePostHog } from 'posthog-react-native'

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

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

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