PostHog

PostHog là một nền tảng phân tích cung cấp các công cụ để theo dõi hành vi người dùng, trực quan hóa mức độ sử dụng sản phẩm và phân tích khả năng giữ chân người dùng. Với các tính năng như theo dõi sự kiện, user flows và feature flags, nền tảng này được thiết kế để giúp bạn hiểu rõ hơn và cải thiện sản phẩm của mình.

Tích hợp PostHog với Adapty giúp theo dõi liền mạch các sự kiện liên quan đến gói đăng ký, chẳng hạn như bắt đầu dùng thử, gia hạn và hủy đăng ký. Bằng cách gửi các sự kiện này tới PostHog, bạn có thể phân tích cách các thay đổi gói đăng ký ảnh hưởng đến hành vi người dùng, đánh giá hiệu suất paywall và có được cái nhìn sâu hơn về các chiến lược kiếm tiền — tất cả trong quy trình phân tích hiện có của bạn.

Đặc điểm tích hợp

Cấu trúc sự kiện PostHog

Adapty gửi các sự kiện đã chọn tới PostHog như được cấu hình trong phần Events names trên trang tích hợp PostHog. Mỗi sự kiện có cấu trúc như sau:

{
  "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}}"
  }
}

Trong đó

Các tham số properties.$set

Mỗi tham số trong object properties.$set là tùy chọn và sẽ không được gửi tới PostHog nếu bị thiếu.

Thiết lập tích hợp PostHog

1. Mở trang Integrations -> PostHog trong Adapty Dashboard và bật toggle.

   

2. Đăng nhập vào PostHog Dashboard.

3. Điều hướng đến Settings -> Project.

   

4. Trong cửa sổ Project, cuộn xuống phần Project ID và sao chép Project API key.

5. Dán API key vào trường Project API key trong Adapty Dashboard. PostHog không có chế độ Sandbox riêng cho tích hợp server-to-server.

6. Chọn PostHog Deployment của bạn:

   Tùy chọn	Mô tả
   us/eu	Các deployment mặc định được PostHog lưu trữ.
   Custom	Dành cho các instance tự lưu trữ. Nhập URL instance của bạn vào trường PostHog Instance URL.

7. (Tùy chọn) Nếu bạn đang dùng deployment PostHog tự lưu trữ, nhập địa chỉ deployment của bạn vào trường PostHog Instance URL.

8. (Tùy chọn) Điều chỉnh các cài đặt như Reporting Proceeds, Exclude Historical Events, Report User’s Currency và Send Trial Price. Xem Cài đặt tích hợp để biết thêm chi tiết về các tùy chọn này.

9. (Tùy chọn) Bạn cũng có thể tùy chỉnh các sự kiện nào được gửi tới PostHog trong phần Events names. Tắt các sự kiện không cần thiết hoặc đổi tên chúng theo nhu cầu.

10. Nhấn Save để hoàn tất thiết lập.

Cấu hình SDK

Để bật tính năng nhận dữ liệu attribution từ PostHog, truyền giá trị distinctId vào Adapty như sau:

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 sẽ gửi các sự kiện tới PostHog và nhận attribution từ đó.