Konektor Mixpanel

Hubungkan Mixpanel ke Brevo melalui Tajo untuk menjembatani analitik produk dengan otomatisasi pemasaran. Sinkronkan profil pengguna, event perilaku, dan cohort untuk membuat kampanye berbasis data dari penggunaan produk yang sebenarnya.

Ikhtisar

Fitur

• Ingesti event - Impor event track melalui Ingestion API Mixpanel ke dalam workflow Brevo
• Sinkronisasi profil pengguna - Petakan properti profil pengguna Mixpanel ke atribut kontak Brevo
• Ekspor cohort - Sinkronkan cohort Mixpanel ke list kontak Brevo untuk kampanye tertarget
• Analitik grup - Sinkronkan data tingkat grup untuk pemasaran berbasis akun B2B
• Manajemen identitas - Manfaatkan identity merge Mixpanel untuk profil pelanggan yang terpadu
• Kueri JQL - Jalankan kueri JQL kustom untuk mengekstrak kumpulan data tertentu bagi Brevo
• Lookup table - Sinkronkan data pengayaan dari lookup table Mixpanel

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Akun Mixpanel dengan sebuah proyek yang sudah dibuat
2. Project Token Mixpanel Anda untuk pelacakan sisi klien
3. Service Account dengan izin yang sesuai untuk akses API sisi server
4. Akun Brevo dengan akses API
5. Akun Tajo dengan kredensial API

Autentikasi

Service Account (direkomendasikan)

Mixpanel menyarankan penggunaan Service Account untuk autentikasi API. Service account memakai HTTP Basic Auth dengan username (username service account) dan password (secret service account).

# Service Account authentication
curl https://mixpanel.com/api/app/me \
  -u "SERVICE_ACCOUNT_USERNAME:SERVICE_ACCOUNT_SECRET"

Project Token

Project Token dipakai untuk pelacakan event sisi klien dan aman untuk disertakan dalam kode klien:

// Client-side initialization
mixpanel.init("YOUR_PROJECT_TOKEN");

OAuth (untuk integrasi partner)

Untuk integrasi aplikasi yang mengakses banyak proyek:

curl https://mixpanel.com/api/2.0/engage \
  -H "Authorization: Bearer YOUR_OAUTH_TOKEN"

Konfigurasi

Setup dasar

connectors:
  mixpanel:
    enabled: true
    project_token: "your-project-token"
    service_account:
      username: "your-service-account-username"
      secret: "your-service-account-secret"
    project_id: "12345"
    data_residency: "US"  # or "EU"

    # Data sync options
    sync:
      events: true
      profiles: true
      cohorts: true
      groups: false

    # Brevo list assignment
    lists:
      all_users: 15
      engaged_users: 16
      at_risk: 17

Pemetaan event

Petakan event Mixpanel ke tipe event Brevo:

event_mapping:
  # Mixpanel event -> Brevo event
  "Purchase": "order_completed"
  "Sign Up": "customer_created"
  "Add to Cart": "cart_updated"
  "Page View": "page_viewed"
  "$experiment_started": "experiment_started"

  # Custom events
  "Feature Activated": "feature_used"
  "Subscription Renewed": "subscription_renewed"

Pemetaan properti profil

Petakan properti pengguna Mixpanel ke atribut kontak Brevo:

property_mapping:
  $email: email
  $first_name: FIRSTNAME
  $last_name: LASTNAME
  $phone: SMS
  $city: CITY
  $region: REGION
  $country_code: COUNTRY
  plan: PLAN_TYPE
  company: COMPANY
  signup_date: SIGNUP_DATE
  total_revenue: LTV

Endpoint API

Contoh kode

Inisialisasi konektor Mixpanel

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Mixpanel project
await tajo.connectors.connect('mixpanel', {
  projectToken: process.env.MIXPANEL_TOKEN,
  serviceAccountUser: process.env.MIXPANEL_SA_USER,
  serviceAccountSecret: process.env.MIXPANEL_SA_SECRET,
  projectId: process.env.MIXPANEL_PROJECT_ID
});

Mengimpor event melalui Ingestion API

// Import events to Mixpanel (automatically forwarded to Brevo)
const response = await fetch('https://api.mixpanel.com/import', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Basic ' + btoa(
      `${process.env.MIXPANEL_SA_USER}:${process.env.MIXPANEL_SA_SECRET}`
    )
  },
  body: JSON.stringify([
    {
      event: "Purchase",
      properties: {
        distinct_id: "user_123",
        $insert_id: "evt_abc123",
        time: Math.floor(Date.now() / 1000),
        revenue: 89.99,
        product_id: "SKU-001",
        product_name: "Widget Pro"
      }
    }
  ])
});

// Expected response: { "code": 200, "status": "OK", "num_records_imported": 1 }

Menyinkronkan cohort ke Brevo

// Export a Mixpanel cohort and sync to a Brevo list
const cohort = await tajo.connectors.syncCohort('mixpanel', {
  cohortId: 12345,
  targetList: 16,
  syncMode: 'mirror'
});

console.log(cohort);
// {
//   cohortName: "Engaged Users (Last 7 Days)",
//   membersCount: 3200,
//   syncedToBrevo: 3200,
//   listId: 16
// }

Menetapkan properti profil pengguna

// Set user properties via the Engage API
const response = await fetch('https://api.mixpanel.com/engage#$set', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify([{
    $token: process.env.MIXPANEL_TOKEN,
    $distinct_id: "user_123",
    $set: {
      $email: "[email protected]",
      $first_name: "Jane",
      $last_name: "Kim",
      plan: "premium",
      total_orders: 12,
      lifetime_value: 1250.00
    }
  }])
});

Batas rate

Pemecahan masalah

Praktik terbaik

1. Gunakan Service Account - Utamakan Service Account dibanding Project Secret untuk autentikasi sisi server
2. Sertakan $insert_id - Selalu tetapkan insert ID unik untuk deduplikasi event
3. Kelompokkan pembaruan profil - Kirim hingga 2.000 pembaruan profil per permintaan agar efisien
4. Gunakan endpoint EU - Untuk data residency EU, pakai api-eu.mixpanel.com pada seluruh panggilan API
5. Sinkronkan cohort terjadwal - Siapkan sinkronisasi cohort harian atau mingguan alih-alih polling terus-menerus
6. Petakan properti bawaan - Gunakan properti bawaan Mixpanel ($email, $first_name) untuk data profil
7. Pantau ingesti - Gunakan halaman Events Mixpanel untuk memastikan event diterima dengan benar

Keamanan

• Hanya HTTPS - Seluruh komunikasi API mensyaratkan enkripsi TLS
• Isolasi Service Account - Akses dibatasi per proyek dengan izin berbasis peran
• Deduplikasi event - Dedup bawaan via $insert_id mencegah masalah integritas data
• SOC 2 Type II - Mixpanel bersertifikat SOC 2 Type II
• GDPR/CCPA - Mendukung penghapusan data pengguna melalui GDPR API
• Data residency EU - Pusat data EU tersedia untuk kepatuhan Eropa

Sumber daya terkait

• Konektor Segment
• Konektor Amplitude
• Skill Customer Sync
• Brevo Events API