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ínhGiá Trị
Nền TảngAmplitude
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, Cohorts, Thuộc Tính Người Dùng
Loại APIREST API
URL APIhttps://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.

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

Terminal window
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ứcEndpointMô Tả
GET/api/2/usersearchTìm kiếm người dùng
GET/api/2/useractivityHoạt động người dùng
GET/api/2/cohortsLiệt kê cohorts
GET/api/2/cohorts/{cohort_id}/membersThành viên cohort
GET/api/2/exportXuấ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 Độ

EndpointGiới Hạn
User Search360 yêu cầu/giờ
Cohort API120 yêu cầu/giờ
Export API4 yêu cầu đồng thời

Khắc Phục Sự Cố

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

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.