---
title: "Mixpanel konnektor"
description: "Teljes Mixpanel integrációs útmutató termékanalitikai események, felhasználói profilok és kohortok Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/custom/mixpanel/
markdown: https://tajo.io/hu/docs/connectors/custom/mixpanel.md
lang: hu-HU
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# Mixpanel konnektor

Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd a Mixpanelt a Brevóhoz a Tajo segítségével, hogy összekötöd a termékanalitikát a marketingautomatizálással. Szinkronizálj felhasználói profilokat, viselkedési eseményeket és kohortokat az adatvezérelt kampányokhoz valós termékhasználat alapján.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Mixpanel |
| **Kategória** | Analitika (Egyéni) |
| **Telepítés bonyolultsága** | Közepes |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Események, Profilok, Kohortok, Csoportok |
| **Elérhető Skillek** | 7 |

## Funkciók

- **Esemény-betöltés** – Track események importálása a Mixpanel Ingestion API-n keresztül Brevo munkafolyamatokba
- **Felhasználói profil-szinkronizáció** – Mixpanel felhasználói profil tulajdonságok leképezése Brevo kapcsolat-attribútumokhoz
- **Kohort-exportálás** – Mixpanel kohortok szinkronizálása Brevo kapcsolatlistákra célzott kampányokhoz
- **Csoport-analitika** – Csoportszintű adatok szinkronizálása B2B fiók alapú marketinghez
- **Identitáskezelés** – A Mixpanel identitás-összevonásának kihasználása egységes ügyfélprofilokhoz
- **JQL lekérdezések** – Egyedi JQL lekérdezések futtatása a Brevóhoz szükséges adatkészletek kinyeréséhez
- **Keresési táblázatok** – Bővítési adatok szinkronizálása Mixpanel keresési táblázatokból

## Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Mixpanel fiókkal és létrehozott projekttel
2. A Mixpanel Project Tokeneddel kliens oldali követéshez
3. Egy szervizfiókkal a megfelelő engedélyekkel szerver oldali API hozzáféréshez
4. Egy Brevo fiókkal API-hozzáféréssel
5. Egy Tajo fiókkal API hitelesítő adatokkal

## Hitelesítés

### Szervizfiókok (ajánlott)

A Mixpanel szervizfiókok használatát javasolja API hitelesítéshez. A szervizfiókok HTTP Basic Auth-ot használnak felhasználónévvel (szervizfiók felhasználónév) és jelszóval (szervizfiók titkos kulcs).

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

### Project Token

A Project Token kliens oldali esemény-követéshez használható és biztonságos kliens kódban is szerepeltetni:

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

### OAuth (partner integrációkhoz)

Több projektet elérő alkalmazás-integrációkhoz:

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

## Konfiguráció

### Alapbeállítás

```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"  # 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
```

### Esemény-leképezés

Képezd le a Mixpanel eseményeket Brevo esemény típusokhoz:

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

### Profil tulajdonság-leképezés

Képezd le a Mixpanel felhasználói tulajdonságokat Brevo kapcsolat-attribútumokhoz:

```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 végpontok

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `POST` | `/import` | Események importálása (Ingestion API) |
| `POST` | `/track` | Események követése (kliens oldali) |
| `POST` | `/engage#$set` | Felhasználói profil tulajdonságok beállítása |
| `POST` | `/engage#$set_once` | Tulajdonságok beállítása csak ha még nincsenek beállítva |
| `POST` | `/engage#$delete` | Felhasználói profil törlése |
| `POST` | `/engage#$union` | Listás tulajdonságokhoz való hozzáadás |
| `POST` | `/groups` | Csoportprofil tulajdonságok beállítása |
| `GET` | `/export` | Nyers eseményadatok exportálása |
| `POST` | `/cohorts/list` | Mentett kohortok listázása |
| `POST` | `/engage/query` | Felhasználói profilok lekérdezése |
| `POST` | `/jql` | Egyedi JQL lekérdezések futtatása |
| `GET` | `/segmentation` | Szegmentálási riportok lekérdezése |
| `GET` | `/retention` | Megtartási riportok lekérdezése |
| `GET` | `/funnels` | Tölcsér riportok lekérdezése |

## Kódpéldák

### A Mixpanel konnektor inicializálása

```javascript
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
});
```

### Események importálása az Ingestion API-n keresztül

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

### Kohort szinkronizálása a Brevóba

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

### Felhasználói profil tulajdonságok beállítása

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

## Ráta-korlátok

| API | Korlát | Részletek |
| --- | --- | --- |
| **Ingestion API** | 2 GB/perc | Projektenként |
| **Track API** | Nincs kemény korlát | Legjobb-erőfeszítés kézbesítés |
| **Engage API** | 2 000 frissítés/köteg | Max. 2 GB/perc projektenként |
| **Query API** | 60 kérés/óra | Projektenként (Szervizfiók) |
| **Export API** | 60 kérés/óra | Max. 100 nap lekérésenként |
| **JQL API** | 60 kérés/óra | Projektenként |
| **Kohort exportálás** | 60 kérés/óra | Projektenként |

Esemény deduplikáció

A Mixpanel a `$insert_id` tulajdonsággal deduplikálja az eseményeket. Mindig incl egy egyedi `$insert_id`-t, hogy megelőzd a duplikált eseményeket sikertelen importálások újrapróbálásakor.

## Hibaelhárítás

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| Az események nem jelennek meg | Rossz project token | Ellenőrizd, hogy a token a célprojektnek felel meg |
| Profil tulajdonságok hiányoznak | Rossz API használata | Profil tulajdonságokhoz használd az `/engage#$set`-et, ne a `/track`-et |
| Kohort exportálás sikertelen | Elégtelen engedélyek | Győződj meg róla, hogy a Szervizfióknak Admin vagy Analyst szerepköre van |
| Duplikált események | Hiányzó `$insert_id` | Incl egyedi `$insert_id`-t minden eseményen |
| 402 Payment Required | Adatkorlátok túllépve | Ellenőrizd a Mixpanel csomag korlátait és szükség esetén frissíts |
| Az EU-adatok nem irányítódnak | Rossz adatrezidencia | Használd az `api-eu.mixpanel.com`-ot EU projektekhez |
| Identitás-összevonási problémák | Helytelen distinct\_id | Kövesd a Mixpanel identitáskezelési legjobb gyakorlatait |

## Legjobb gyakorlatok

1. **Használj szervizfiókokat** – Szerver oldali hitelesítéshez a Project Secret helyett a szervizfiókokat részesítsd előnyben
2. **Incl `$insert_id`-t** – Mindig állíts be egyedi insert azonosítót az esemény deduplikáláshoz
3. **Kötegelj profil frissítéseket** – Kérésenként legfeljebb 2 000 profil frissítést küldj a hatékonyságért
4. **Használj EU végpontokat** – EU adatrezidenciához használd az `api-eu.mixpanel.com`-ot minden API híváshoz
5. **Ütemezetten szinkronizálj kohortokat** – Állíts be napi vagy heti kohort szinkronizálást a folyamatos lekérdezés helyett
6. **Képezd le a fenntartott tulajdonságokat** – Profil adatokhoz használd a Mixpanel fenntartott tulajdonságait (`$email`, `$first_name`)
7. **Figyeld a betöltést** – Ellenőrizd a Mixpanel Események oldalán, hogy az eseményeket megfelelően fogadják

## Biztonság

- **Csak HTTPS** – Minden API kommunikáció TLS titkosítást igényel
- **Szervizfiók izoláció** – Hatókörrel korlátozott hozzáférés projektenként szerepkör alapú engedélyekkel
- **Esemény deduplikáció** – Beépített deduplikáció `$insert_id`-val megakadályozza az adatintegritási problémákat
- **SOC 2 Type II** – A Mixpanel SOC 2 Type II tanúsítvánnyal rendelkezik
- **GDPR/CCPA** – Felhasználói adattörlés támogatása a GDPR API-n keresztül
- **EU adatrezidencia** – EU adatközpont elérhető az európai megfelelőséghez

## Kapcsolódó források

- [Segment konnektor](https://tajo.io/hu/docs/connectors/custom/segment)
- [Amplitude konnektor](https://tajo.io/hu/docs/connectors/custom/amplitude)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)
- [Brevo Events API](https://tajo.io/hu/docs/events-engagement/create-event)