---
title: "Trình Kết Nối Amplitude"
description: "Hướng dẫn tích hợp Amplitude đầy đủ để đồng bộ sự kiện người dùng, cohorts, và dữ liệu thuộc tính với Brevo qua Tajo."
url: https://tajo.io/vi/docs/connectors/custom/amplitude/
markdown: https://tajo.io/vi/docs/connectors/custom/amplitude.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 Amplitude

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 Amplitude với Brevo qua Tajo để kết hợp analytics hành vi sản phẩm với marketing automation, đồng bộ cohorts sang phân đoạn Brevo và kích hoạt chiến dịch dựa trên các sự kiện trong ứng dụng.

## Tổng Quan

| Thuộc Tính | Giá Trị |
| --- | --- |
| **Nền Tảng** | Amplitude |
| **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, Cohorts, Thuộc Tính Người Dùng |
| **Loại API** | REST API |
| **URL API** | `https://amplitude.com/api/2` |

## Tính Năng

- **Đồng bộ cohort** - Xuất cohort Amplitude sang danh sách Brevo cho targeting
- **Forward sự kiện** - Gửi sự kiện hành vi sản phẩm sang Brevo để kích hoạt
- **Đồng bộ thuộc tính người dùng** - Ánh xạ thuộc tính người dùng Amplitude sang thuộc tính liên hệ Brevo
- **Phân tích hành trình** - Kết hợp phân tích hành trình Amplitude với engagement Brevo
- **Xuất dữ liệu** - Lấy dữ liệu sự kiện thô để phân tích 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 Amplitude với quyền truy cập API
2. Amplitude API Key và Secret Key
3. Tài khoản Brevo với quyền truy cập API
4. Tài khoản Tajo

## Xác Thực

Amplitude sử dụng HTTP Basic Authentication với API Key và Secret Key.

```bash
curl -u "API_KEY:SECRET_KEY" \
  "https://amplitude.com/api/2/usersearch?user=user@example.com"
```

Tìm credentials trong Amplitude Settings > Projects > \[Project\] > General.

### Kết Nối với Tajo

```bash
tajo connectors install amplitude \
  --api-key $AMPLITUDE_API_KEY \
  --secret-key $AMPLITUDE_SECRET_KEY
```

## Cấu Hình

### Thiết Lập Cơ Bản

```yaml
connectors:
  amplitude:
    enabled: true
    api_key: "${AMPLITUDE_API_KEY}"
    secret_key: "${AMPLITUDE_SECRET_KEY}"

    sync:
      cohorts: true
      user_properties: true
      events: false  # Dùng streaming cho events

    # Ánh xạ cohort sang danh sách Brevo
    cohort_mapping:
      "Power Users": 20
      "Churned Users": 21
      "Trial Users": 22
```

### Ánh Xạ Trường

```yaml
field_mapping:
  user_id: AMPLITUDE_USER_ID
  email: email
  user_properties.name: FULLNAME
  user_properties.plan: PLAN_TYPE
  user_properties.created_at: SIGNUP_DATE
  user_properties.total_events: TOTAL_EVENTS
```

## API Endpoints

| Phương Thức | Endpoint | Mô Tả |
| --- | --- | --- |
| `GET` | `/api/2/usersearch` | Tìm kiếm người dùng |
| `GET` | `/api/2/useractivity` | Hoạt động người dùng |
| `GET` | `/api/2/cohorts` | Liệt kê cohorts |
| `GET` | `/api/2/cohorts/{cohort_id}/members` | Thành viên cohort |
| `GET` | `/api/2/export` | Xuất sự kiện thô |

## 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('amplitude', {
  apiKey: process.env.AMPLITUDE_API_KEY,
  secretKey: process.env.AMPLITUDE_SECRET_KEY
});
```

### Đồng Bộ Cohort Sang Brevo

```javascript
// Đồng bộ cohort Amplitude sang danh sách Brevo
await tajo.connectors.syncCohort('amplitude', {
  cohortId: 'cohort_123',
  brevoListId: 20,
  type: 'mirror'
});
```

Giới Hạn Kích Thước Sự Kiện

Amplitude API Export giới hạn xuất 365 ngày tối đa mỗi yêu cầu. Đối với dữ liệu lịch sử lớn hơn, hãy chia thành nhiều yêu cầu theo khoảng thời gian nhỏ hơn.

## Giới Hạn Tốc Độ

| Endpoint | Giới Hạn |
| --- | --- |
| User Search | 360 yêu cầu/giờ |
| Cohort API | 120 yêu cầu/giờ |
| Export API | 4 yêu cầu đồng thời |

## Khắc Phục Sự Cố

| Sự Cố | Nguyên Nhân | Giải Pháp |
| --- | --- | --- |
| 401 Unauthorized | Credentials không hợp lệ | Xác minh API Key và Secret Key |
| Cohort trống | Cohort chưa được tính toán | Kích hoạt tính toán cohort thủ công trong Amplitude |
| Xuất hết thời gian | Khoảng thời gian quá lớn | Giảm khoảng thời gian xuất |

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

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