Trình Kết Nối Mixpanel
Kết nối Mixpanel với Brevo qua Tajo để kết hợp product analytics với marketing automation, đồng bộ cohorts sang danh sách Brevo và kích hoạt chiến dịch dựa trên sự kiện sản phẩm.
Tổng Quan
| Thuộc Tính | Giá Trị |
|---|---|
| Nền Tảng | Mixpanel |
| Danh Mục | Tùy Chỉnh |
| Độ Phức Tạp Thiết Lập | Trung Bình |
| Tích Hợp Chính Thức | Không |
| Dữ Liệu Đồng Bộ | Sự Kiện, Người Dùng, Cohorts |
| Loại API | REST API |
| Xác Thực | Service Account |
Tính Năng
- Đồng bộ cohort - Xuất Mixpanel cohorts sang danh sách Brevo
- Thuộc tính người dùng - Đồng bộ user profiles Mixpanel sang liên hệ Brevo
- Xuất sự kiện - Nhập lịch sử sự kiện thô cho phân tích Brevo
- Kích hoạt theo thời gian thực - Forward sự kiện Mixpanel quan trọng sang Brevo
- Lookalike audiences - Sử dụng dữ liệu Mixpanel để tạo phân đoạn tương tự trong Brevo
Yêu Cầu
Trước khi bắt đầu, hãy đảm bảo bạn có:
- Tài khoản Mixpanel (Free, Growth, hoặc Enterprise)
- Service Account credentials
- Project ID Mixpanel của bạn
- Tài khoản Brevo với quyền truy cập API
- Tài khoản Tajo
Xác Thực
Service Account (Khuyến Nghị)
Mixpanel khuyến nghị Service Accounts cho server-to-server authentication.
curl "https://mixpanel.com/api/query/engage" \ -u "SERVICE_ACCOUNT_USERNAME:SERVICE_ACCOUNT_SECRET" \ -d "project_id=YOUR_PROJECT_ID"Tạo service accounts trong Mixpanel Settings > Service Accounts.
Kết Nối với Tajo
tajo connectors install mixpanel \ --username $MIXPANEL_SERVICE_ACCOUNT \ --secret $MIXPANEL_SERVICE_SECRET \ --project-id $MIXPANEL_PROJECT_IDCấu Hình
Thiết Lập Cơ Bản
connectors: mixpanel: enabled: true username: "${MIXPANEL_SA_USERNAME}" secret: "${MIXPANEL_SA_SECRET}" project_id: "${MIXPANEL_PROJECT_ID}" region: "US" # hoặc "EU"
sync: cohorts: true user_profiles: true events: false # Sử dụng raw export thay thế
cohort_mapping: "Power Users": 25 "Churned": 26 "Trial Expiring": 27Ánh Xạ Trường
field_mapping: $email: email $first_name: FIRSTNAME $last_name: LASTNAME $phone: SMS $created: SIGNUP_DATE plan: PLAN_TYPE company: COMPANY_NAME total_events: TOTAL_EVENTS_30DAPI Endpoints
| Phương Thức | Endpoint | Mô Tả |
|---|---|---|
GET | /api/query/engage | Truy vấn user profiles |
GET | /api/query/cohorts/list | Liệt kê cohorts |
GET | /api/query/cohorts/members | Lấy thành viên cohort |
POST | /api/export | Xuất sự kiện thô |
POST | /track | Track sự kiện mới |
POST | /engage | Cập nhật user profiles |
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('mixpanel', { username: process.env.MIXPANEL_SA_USERNAME, secret: process.env.MIXPANEL_SA_SECRET, projectId: process.env.MIXPANEL_PROJECT_ID});Đồng Bộ Cohort Sang Brevo
// Đồng bộ Mixpanel cohort sang danh sách Brevoawait tajo.connectors.syncCohort('mixpanel', { cohortId: 'cohort_abc123', brevoListId: 25, syncMode: 'mirror', includeUserProperties: true});Deduplication Sự Kiện
Mixpanel Export API có thể trả về sự kiện trùng lặp cho các khoảng thời gian chồng lên nhau. Tajo tự động deduplicates theo distinct_id và timestamp nhưng cấu hình event windows cẩn thận.
Giới Hạn Tốc Độ
| Endpoint | Giới Hạn |
|---|---|
| Query API | 60 yêu cầu/giờ |
| Export API | 60 yêu cầu/giờ |
| Track/Engage | 2.000 yêu cầu/giây |
Khắc Phục Sự Cố
| Sự Cố | Nguyên Nhân | Giải Pháp |
|---|---|---|
| 403 Forbidden | Service account không đủ quyền | Kiểm tra quyền trong Mixpanel Settings |
| Cohort trống | ID cohort không đúng | Xác minh ID cohort trong Mixpanel |
| Xuất hết thời gian | Khoảng thời gian quá lớn | Chia thành nhiều yêu cầu nhỏ hơn |
| Trường thiếu | Tên thuộc tính không đúng | Kiểm tra chính xác tên thuộc tính (phân biệt hoa/thường) |