Trình Kết Nối Amplitude
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ó:
- Tài khoản Amplitude với quyền truy cập API
- Amplitude API Key và Secret Key
- Tài khoản Brevo với quyền truy cập API
- Tài khoản Tajo
Xác Thực
Amplitude sử dụng HTTP Basic Authentication với API Key và Secret Key.
curl -u "API_KEY:SECRET_KEY" \ "https://amplitude.com/api/2/[email protected]"Tìm credentials trong Amplitude Settings > Projects > [Project] > General.
Kết Nối với Tajo
tajo connectors install amplitude \ --api-key $AMPLITUDE_API_KEY \ --secret-key $AMPLITUDE_SECRET_KEYCấu Hình
Thiết Lập Cơ Bản
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
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_EVENTSAPI 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
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
// Đồng bộ cohort Amplitude sang danh sách Brevoawait 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 |