Mixpanel Bağlayıcısı

Ürün analitiğini pazarlama otomasyonuyla birleştirmek için Mixpanel’i Tajo üzerinden Brevo’ya bağlayın. Gerçek ürün kullanımına dayalı veri odaklı kampanyalar oluşturmak için kullanıcı profillerini, davranış olaylarını ve kohortları senkronize edin.

Genel Bakış

Özellikler

• Olay alımı - Mixpanel’in Alım API’si aracılığıyla izleme olaylarını Brevo iş akışlarına aktarın
• Kullanıcı profili senkronizasyonu - Mixpanel kullanıcı profil özelliklerini Brevo kişi özniteliklerine eşleyin
• Kohort dışa aktarma - Hedefli kampanyalar için Mixpanel kohortlarını Brevo kişi listelerine senkronize edin
• Grup analitiği - B2B hesap tabanlı pazarlama için grup düzeyinde verileri senkronize edin
• Kimlik yönetimi - Birleşik müşteri profilleri için Mixpanel’in kimlik birleştirme özelliğinden yararlanın
• JQL sorguları - Brevo için belirli veri kümelerini çıkarmak üzere özel JQL sorguları çalıştırın
• Arama tabloları - Mixpanel arama tablolarından zenginleştirme verilerini senkronize edin

Ön Koşullar

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

1. Proje oluşturulmuş bir Mixpanel hesabı
2. İstemci tarafı izleme için Mixpanel Proje Belirteciniz
3. Sunucu tarafı API erişimi için uygun izinlere sahip bir Hizmet Hesabı
4. API erişimi olan bir Brevo hesabı
5. API kimlik bilgileri olan bir Tajo hesabı

Kimlik Doğrulama

Hizmet Hesapları (Önerilen)

Mixpanel, API kimlik doğrulaması için Hizmet Hesapları kullanmayı önerir. Hizmet hesapları, kullanıcı adı (hizmet hesabı kullanıcı adı) ve parola (hizmet hesabı gizli anahtarı) ile HTTP Basic Auth kullanır.

# Hizmet Hesabı kimlik doğrulaması
curl https://mixpanel.com/api/app/me \
  -u "SERVICE_ACCOUNT_USERNAME:SERVICE_ACCOUNT_SECRET"

Proje Belirteci

Proje Belirteci, istemci tarafı olay izleme için kullanılır ve istemci koduna dahil edilmesi güvenlidir:

// İstemci tarafı başlatma
mixpanel.init("YOUR_PROJECT_TOKEN");

OAuth (İş Ortağı Entegrasyonları için)

Birden fazla projeye erişen uygulama entegrasyonları için:

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

Yapılandırma

Temel Kurulum

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"  # veya "EU"

    # Veri senkronizasyon seçenekleri
    sync:
      events: true
      profiles: true
      cohorts: true
      groups: false

    # Brevo liste ataması
    lists:
      all_users: 15
      engaged_users: 16
      at_risk: 17

Olay Eşleştirme

Mixpanel olaylarını Brevo olay türlerine eşleyin:

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

  # Özel olaylar
  "Feature Activated": "feature_used"
  "Subscription Renewed": "subscription_renewed"

Profil Özelliği Eşleştirme

Mixpanel kullanıcı özelliklerini Brevo kişi özniteliklerine eşleyin:

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

API Uç Noktaları

Kod Örnekleri

Mixpanel Bağlayıcısını Başlatma

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

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

// Mixpanel projesini bağla
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
});

Alım API’si ile Olayları İçe Aktarma

// Olayları Mixpanel'e içe aktar (otomatik olarak Brevo'ya iletilir)
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"
      }
    }
  ])
});

// Beklenen yanıt: { "code": 200, "status": "OK", "num_records_imported": 1 }

Kohortu Brevo’ya Senkronize Etme

// Bir Mixpanel kohortunu dışa aktar ve Brevo listesine senkronize et
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
// }

Kullanıcı Profil Özelliklerini Ayarlama

// Engage API aracılığıyla kullanıcı özelliklerini ayarla
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
    }
  }])
});

Hız Sınırları

Sorun Giderme

En İyi Uygulamalar

1. Hizmet Hesapları kullanın - Sunucu tarafı kimlik doğrulama için Proje Gizli Anahtarı yerine Hizmet Hesaplarını tercih edin
2. $insert_id ekleyin - Olay yinelenen kaldırma için her zaman benzersiz bir insert ID ayarlayın
3. Profil güncellemelerini toplu işleyin - Verimlilik için istek başına 2.000’e kadar profil güncellemesi gönderin
4. AB uç noktalarını kullanın - AB veri ikametgahı için tüm API çağrıları için api-eu.mixpanel.com kullanın
5. Kohortları programa göre senkronize edin - Sürekli yoklama yerine günlük veya haftalık kohort senkronizasyonu ayarlayın
6. Rezerve edilmiş özellikleri eşleyin - Profil verileri için Mixpanel’in rezerve özelliklerini ($email, $first_name) kullanın
7. Alımı izleyin - Olayların doğru alındığını doğrulamak için Mixpanel’in Events sayfasını kullanın

Güvenlik

• Yalnızca HTTPS - Tüm API iletişimi TLS şifrelemesi gerektirir
• Hizmet Hesabı izolasyonu - Rol tabanlı izinlerle proje başına kapsamlı erişim
• Olay yinelenen kaldırma - $insert_id aracılığıyla yerleşik yinelenen kaldırma veri bütünlüğü sorunlarını önler
• SOC 2 Type II - Mixpanel SOC 2 Type II sertifikalıdır
• GDPR/CCPA - GDPR API aracılığıyla kullanıcı veri silmeyi destekler
• AB veri ikametgahı - Avrupa uyumluluğu için AB veri merkezi mevcuttur

İlgili Kaynaklar

• Segment Bağlayıcısı
• Amplitude Bağlayıcısı
• Müşteri Senkronizasyonu Yeteneği
• Brevo Olaylar API