---
title: "Trình Kết Nối Mixpanel"
description: "Hướng dẫn tích hợp Mixpanel đầy đủ để đồng bộ sự kiện người dùng, cohorts và dữ liệu hành vi với Brevo qua Tajo."
url: https://tajo.io/vi/docs/connectors/custom/mixpanel/
markdown: https://tajo.io/vi/docs/connectors/custom/mixpanel.md
lang: vi-VN
robots: noindex
---

Đăng ký quyền truy cập sớm

Nhập tên và địa chỉ email công việc của bạn. Chúng tôi sẽ gửi liên kết để xác nhận yêu cầu truy cập Tajo.

# Trình Kết Nối Mixpanel

Trạng thái trình kết nối: Dự kiến Chưa được xây dựng. Hiện Tajo chưa chạy trình kết nối này.

| Trường nguồn | Trường đích | Giá trị mẫu |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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ó:

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.

```bash
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

```bash
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

```yaml
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

```yaml
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ứ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

```javascript
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

```javascript
// Đồ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 Độ

| 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) |

## Tài Nguyên Liên Quan

- [Tài Liệu Query API Mixpanel](https://developer.mixpanel.com/reference/query-api)
- [Trình Kết Nối Amplitude](https://tajo.io/vi/docs/connectors/custom/amplitude)
- [Trình Kết Nối PostHog](https://tajo.io/vi/docs/connectors/custom/posthog)