Trình Kết Nối PostHog

Kết nối PostHog với Brevo qua Tajo để hợp nhất product analytics với marketing automation, đồng bộ user cohorts sang danh sách Brevo và kích hoạt chiến dịch dựa trên hành vi sản phẩm.

Tổng Quan

Tính Năng

• Đồng bộ persons - Nhập PostHog user profiles sang liên hệ Brevo
• Đồng bộ cohort - Xuất cohorts sang danh sách Brevo cho targeting
• Theo dõi sự kiện - Forward PostHog events sang Brevo triggers
• Feature flag sync - Đồng bộ trạng thái feature flag sang thuộc tính liên hệ
• HogQL queries - Truy vấn dữ liệu PostHog với SQL để tạo phân đoạn tùy chỉnh

Yêu Cầu

Trước khi bắt đầu, hãy đảm bảo bạn có:

1. Tài khoản PostHog (Cloud hoặc Self-hosted)
2. Personal API Key
3. Project ID PostHog
4. Tài khoản Brevo với quyền truy cập API
5. Tài khoản Tajo

Xác Thực

curl "https://app.posthog.com/api/projects/" \
  -H "Authorization: Bearer YOUR_PERSONAL_API_KEY"

Tạo Personal API Keys trong PostHog Settings > Personal API keys.

Kết Nối với Tajo

tajo connectors install posthog \
  --api-key $POSTHOG_API_KEY \
  --project-id $POSTHOG_PROJECT_ID \
  --host https://app.posthog.com  # hoặc URL self-hosted

Cấu Hình

Thiết Lập Cơ Bản

connectors:
  posthog:
    enabled: true
    api_key: "${POSTHOG_API_KEY}"
    project_id: "${POSTHOG_PROJECT_ID}"
    host: "https://app.posthog.com"

    sync:
      persons: true
      cohorts: true
      feature_flags: false
      events: false

    cohort_mapping:
      "Active Users": 35
      "Churned": 36
      "Power Users": 37

Ánh Xạ Trường

field_mapping:
  email: email
  properties.$name: FULLNAME
  properties.$phone: SMS
  properties.company: COMPANY_NAME
  properties.plan: PLAN_TYPE
  properties.signup_date: SIGNUP_DATE
  properties.$initial_referring_domain: ACQUISITION_SOURCE

API Endpoints

Ví Dụ Code

Khởi Tạo Trình Kết Nối

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

await tajo.connectors.connect('posthog', {
  apiKey: process.env.POSTHOG_API_KEY,
  projectId: process.env.POSTHOG_PROJECT_ID
});

Đồng Bộ Cohort Sang Brevo

// Đồng bộ PostHog cohort sang danh sách Brevo
await tajo.connectors.syncCohort('posthog', {
  cohortId: 123,
  brevoListId: 35,
  syncMode: 'mirror',
  includeProperties: ['email', 'plan', 'company']
});

Giới Hạn Tốc Độ

Khắc Phục Sự Cố

Tài Nguyên Liên Quan

• Tài Liệu API PostHog
• PostHog HogQL Documentation
• Trình Kết Nối Amplitude
• Trình Kết Nối Mixpanel