Đă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ên trang này

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.

Minh họa · dữ liệu mẫu

Ví dụ đồng bộ

Kiểm tra một bản ghi

Nguồn

Amplitude

Trạng thái trình kết nối: Dự kiến

Đích

Công cụ khác của bạn

Trạng thái trình kết nối: Công cụ tùy chỉnh

Ánh xạ trường

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`

Soạn thảo
Kiểm tra một bản ghi
Phê duyệt phiên bản này

Trạng thái áp dụng cho từng trình kết nối, không bảo đảm lần đồng bộ này đã sẵn sàng. Các trường chỉ để minh họa. Hãy kiểm tra lược đồ và quyền thực tế trước khi chạy đồng bộ.

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_KEY

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

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