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ínhGiá Trị
Nền TảngMixpanel
Danh MụcTùy Chỉnh
Độ Phức Tạp Thiết LậpTrung Bình
Tích Hợp Chính ThứcKhông
Dữ Liệu Đồng BộSự Kiện, Người Dùng, Cohorts
Loại APIREST API
Xác ThựcService 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ó:

  1. Tài khoản Mixpanel (Free, Growth, hoặc Enterprise)
  2. Service Account credentials
  3. Project ID Mixpanel của bạn
  4. Tài khoản Brevo với quyền truy cập API
  5. 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.

Terminal window
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

Terminal window
tajo connectors install mixpanel \
--username $MIXPANEL_SERVICE_ACCOUNT \
--secret $MIXPANEL_SERVICE_SECRET \
--project-id $MIXPANEL_PROJECT_ID

Cấ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_30D

API Endpoints

Phương ThứcEndpointMô Tả
GET/api/query/engageTruy vấn user profiles
GET/api/query/cohorts/listLiệt kê cohorts
GET/api/query/cohorts/membersLấy thành viên cohort
POST/api/exportXuất sự kiện thô
POST/trackTrack sự kiện mới
POST/engageCậ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 Brevo
await 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 Độ

EndpointGiới Hạn
Query API60 yêu cầu/giờ
Export API60 yêu cầu/giờ
Track/Engage2.000 yêu cầu/giây

Khắc Phục Sự Cố

Sự CốNguyên NhânGiải Pháp
403 ForbiddenService account không đủ quyềnKiểm tra quyền trong Mixpanel Settings
Cohort trốngID cohort không đúngXác minh ID cohort trong Mixpanel
Xuất hết thời gianKhoảng thời gian quá lớnChia thành nhiều yêu cầu nhỏ hơn
Trường thiếuTên thuộc tính không đúngKiểm tra chính xác tên thuộc tính (phân biệt hoa/thường)

Tài Nguyên Liên Quan

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

auto-detect
Trợ lý AI

Xin chào! Hãy hỏi tôi về tài liệu.