---
title: "Mixpanel Bağlayıcısı"
description: "Ürün analitiği olaylarını, kullanıcı profillerini ve kohortları Tajo aracılığıyla Brevo ile senkronize etmek için eksiksiz Mixpanel entegrasyon kılavuzu."
url: https://tajo.io/tr/docs/connectors/custom/mixpanel/
markdown: https://tajo.io/tr/docs/connectors/custom/mixpanel.md
lang: tr-TR
robots: noindex
---

Erken erişim talep edin

Adınızı ve iş e-posta adresinizi girin. Tajo erişim talebinizi onaylamanız için size bir bağlantı göndereceğiz.

# Mixpanel Bağlayıcısı

Bağlayıcı durumu: Planlandı Henüz oluşturulmadı. Tajo bu bağlayıcıyı bugün çalıştırmıyor.

| Kaynak alanı | Hedef alanı | Örnek değer |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Ü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ış

| Özellik | Değer |
| --- | --- |
| **Platform** | Mixpanel |
| **Kategori** | Analitik (Özel) |
| **Kurulum Karmaşıklığı** | Orta |
| **Resmi Entegrasyon** | Hayır |
| **Senkronize Edilen Veri** | Olaylar, Profiller, Kohortlar, Gruplar |
| **Kullanılabilir Yetenekler** | 7 |

## Ö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.

```bash
# 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:

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

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

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

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

## Yapılandırma

### Temel Kurulum

```yaml
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:

```yaml
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:

```yaml
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ı

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `POST` | `/import` | Olayları içe aktar (Alım API) |
| `POST` | `/track` | Olayları izle (istemci tarafı) |
| `POST` | `/engage#$set` | Kullanıcı profil özelliklerini ayarla |
| `POST` | `/engage#$set_once` | Özellikleri yalnızca henüz ayarlanmamışsa ayarla |
| `POST` | `/engage#$delete` | Bir kullanıcı profilini sil |
| `POST` | `/engage#$union` | Liste özelliklerine birleştir |
| `POST` | `/groups` | Grup profil özelliklerini ayarla |
| `GET` | `/export` | Ham olay verilerini dışa aktar |
| `POST` | `/cohorts/list` | Kayıtlı kohortları listele |
| `POST` | `/engage/query` | Kullanıcı profillerini sorgula |
| `POST` | `/jql` | Özel JQL sorguları çalıştır |
| `GET` | `/segmentation` | Segmentasyon raporlarını sorgula |
| `GET` | `/retention` | Elde tutma raporlarını sorgula |
| `GET` | `/funnels` | Huni raporlarını sorgula |

## Kod Örnekleri

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

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

```javascript
// 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

```javascript
// 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

```javascript
// 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: "jane@example.com",
      $first_name: "Jane",
      $last_name: "Kim",
      plan: "premium",
      total_orders: 12,
      lifetime_value: 1250.00
    }
  }])
});
```

## Hız Sınırları

| API | Sınır | Ayrıntılar |
| --- | --- | --- |
| **Alım API** | 2 GB/dk | Proje başına |
| **Track API** | Sabit sınır yok | En iyi çaba teslimatı |
| **Engage API** | 2.000 güncelleme/toplu iş | Proje başına maksimum 2 GB/dk |
| **Sorgu API** | saatte 60 istek | Proje başına (Hizmet Hesabı) |
| **Dışa Aktarma API** | saatte 60 istek | Sorgu başına maksimum 100 gün |
| **JQL API** | saatte 60 istek | Proje başına |
| **Kohort Dışa Aktarma** | saatte 60 istek | Proje başına |

Olay Yinelenen Kaldırma

Mixpanel, `$insert_id` özelliğini kullanarak olayların yinelenenlerini kaldırır. Başarısız içe aktarmaları yeniden denerken yinelenen olayları önlemek için her zaman benzersiz bir `$insert_id` ekleyin.

## Sorun Giderme

| Sorun | Neden | Çözüm |
| --- | --- | --- |
| Olaylar görünmüyor | Yanlış proje belirteci | Belirtecin hedef projeyle eşleştiğini doğrulayın |
| Profil özellikleri eksik | Yanlış API kullanımı | Profil özellikleri için `/track` yerine `/engage#$set` kullanın |
| Kohort dışa aktarma başarısız | Yetersiz izinler | Hizmet Hesabının Admin veya Analyst rolüne sahip olduğundan emin olun |
| Yinelenen olaylar | `$insert_id` eksik | Her olayda benzersiz `$insert_id` ekleyin |
| 402 Payment Required | Veri sınırları aşıldı | Mixpanel plan sınırlarını kontrol edin ve gerekirse yükseltin |
| AB verileri yönlendirilmiyor | Yanlış veri ikametgahı | AB projeleri için `api-eu.mixpanel.com` kullanın |
| Kimlik birleştirme sorunları | Yanlış distinct\_id | Mixpanel’in kimlik yönetimi en iyi uygulamalarını izleyin |

## 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ı](https://tajo.io/tr/docs/connectors/custom/segment)
- [Amplitude Bağlayıcısı](https://tajo.io/tr/docs/connectors/custom/amplitude)
- [Müşteri Senkronizasyonu Yeteneği](https://tajo.io/tr/docs/skills/data-sync/customer-sync)
- [Brevo Olaylar API](https://tajo.io/tr/docs/events-engagement/create-event)