---
title: "Σύνδεσμος Mixpanel"
description: "Πλήρης οδηγός ενσωμάτωσης Mixpanel για συγχρονισμό εκδηλώσεων αναλυτικών προϊόντων, προφίλ χρηστών και cohorts με το Brevo μέσω Tajo."
url: https://tajo.io/gr/docs/connectors/custom/mixpanel/
markdown: https://tajo.io/gr/docs/connectors/custom/mixpanel.md
lang: el-GR
robots: noindex
---

Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το μικρό σας όνομα και την επαγγελματική διεύθυνση email. Θα σας στείλουμε σύνδεσμο για να επιβεβαιώσετε το αίτημα πρόσβασης στο Tajo.

# Σύνδεσμος Mixpanel

Κατάσταση συνδέσμου: Προγραμματισμένο Δεν έχει κατασκευαστεί ακόμη. Το Tajo δεν εκτελεί σήμερα αυτόν τον σύνδεσμο.

| Πεδίο πηγής | Πεδίο προορισμού | Ενδεικτική τιμή |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Συνδέστε το Mixpanel με το Brevo μέσω Tajo για να γεφυρώσετε τα αναλυτικά προϊόντος με την αυτοματοποίηση marketing. Συγχρονίστε προφίλ χρηστών, συμπεριφορικές εκδηλώσεις και cohorts για δημιουργία καμπανιών βάσει δεδομένων που βασίζονται στην πραγματική χρήση προϊόντος.

## Επισκόπηση

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Mixpanel |
| **Κατηγορία** | Αναλυτικά (Προσαρμοσμένο) |
| **Πολυπλοκότητα Ρύθμισης** | Μεσαία |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Εκδηλώσεις, Προφίλ, Cohorts, Ομάδες |
| **Διαθέσιμες Δεξιότητες** | 7 |

## Χαρακτηριστικά

- **Εισαγωγή εκδηλώσεων** - Εισαγωγή track events μέσω Ingestion API του Mixpanel σε ροές εργασίας Brevo
- **Συγχρονισμός προφίλ χρήστη** - Αντιστοίχιση ιδιοτήτων προφίλ χρήστη Mixpanel σε χαρακτηριστικά επαφών Brevo
- **Εξαγωγή cohort** - Συγχρονισμός cohorts Mixpanel σε λίστες επαφών Brevo για στοχευμένες καμπάνιες
- **Αναλυτικά ομάδας** - Συγχρονισμός δεδομένων σε επίπεδο ομάδας για B2B marketing βάσει λογαριασμών
- **Διαχείριση ταυτότητας** - Αξιοποίηση συγχώνευσης ταυτότητας Mixpanel για ενοποιημένα προφίλ πελατών
- **Ερωτήματα JQL** - Εκτέλεση προσαρμοσμένων ερωτημάτων JQL για εξαγωγή συγκεκριμένων συνόλων δεδομένων για το Brevo
- **Πίνακες αναζήτησης** - Συγχρονισμός δεδομένων εμπλουτισμού από πίνακες αναζήτησης Mixpanel

## Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό Mixpanel με δημιουργημένο project
2. Το Project Token Mixpanel για παρακολούθηση στην πλευρά client
3. Λογαριασμό Service με κατάλληλα δικαιώματα για πρόσβαση API στην πλευρά server
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με διαπιστευτήρια API

## Πιστοποίηση

### Λογαριασμοί Service (Συνιστάται)

Το Mixpanel συνιστά τη χρήση Λογαριασμών Service για πιστοποίηση API. Οι λογαριασμοί service χρησιμοποιούν HTTP Basic Auth με όνομα χρήστη (όνομα χρήστη λογαριασμού service) και κωδικό πρόσβασης (μυστικό λογαριασμού service).

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

### Project Token

Το Project Token χρησιμοποιείται για παρακολούθηση εκδηλώσεων στην πλευρά client και είναι ασφαλές να συμπεριληφθεί σε κώδικα client:

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

### OAuth (για Ενσωματώσεις Partner)

Για ενσωματώσεις εφαρμογών που έχουν πρόσβαση σε πολλαπλά projects:

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

## Διαμόρφωση

### Βασική Ρύθμιση

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

### Αντιστοίχιση Εκδηλώσεων

Αντιστοιχίστε εκδηλώσεις Mixpanel σε τύπους εκδηλώσεων Brevo:

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

### Αντιστοίχιση Ιδιοτήτων Προφίλ

Αντιστοιχίστε ιδιότητες χρήστη Mixpanel σε χαρακτηριστικά επαφών Brevo:

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

## Endpoints API

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `POST` | `/import` | Εισαγωγή εκδηλώσεων (Ingestion API) |
| `POST` | `/track` | Παρακολούθηση εκδηλώσεων (πλευρά client) |
| `POST` | `/engage#$set` | Ορισμός ιδιοτήτων προφίλ χρήστη |
| `POST` | `/engage#$set_once` | Ορισμός ιδιοτήτων μόνο αν δεν έχουν οριστεί |
| `POST` | `/engage#$delete` | Διαγραφή προφίλ χρήστη |
| `POST` | `/engage#$union` | Ένωση σε ιδιότητες λίστας |
| `POST` | `/groups` | Ορισμός ιδιοτήτων προφίλ ομάδας |
| `GET` | `/export` | Εξαγωγή ακατέργαστων δεδομένων εκδηλώσεων |
| `POST` | `/cohorts/list` | Λίστα αποθηκευμένων cohorts |
| `POST` | `/engage/query` | Ερώτημα προφίλ χρηστών |
| `POST` | `/jql` | Εκτέλεση προσαρμοσμένων ερωτημάτων JQL |
| `GET` | `/segmentation` | Ερώτημα αναφορών τμηματοποίησης |
| `GET` | `/retention` | Ερώτημα αναφορών διατήρησης |
| `GET` | `/funnels` | Ερώτημα αναφορών funnel |

## Παραδείγματα Κώδικα

### Αρχικοποίηση Συνδέσμου Mixpanel

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

### Εισαγωγή Εκδηλώσεων μέσω Ingestion API

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

### Συγχρονισμός Cohort στο Brevo

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

### Ορισμός Ιδιοτήτων Προφίλ Χρήστη

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

## Όρια Ρυθμού

| API | Όριο | Λεπτομέρειες |
| --- | --- | --- |
| **Ingestion API** | 2 GB/λεπτό | Ανά project |
| **Track API** | Χωρίς σκληρό όριο | Παράδοση με βέλτιστη προσπάθεια |
| **Engage API** | 2.000 ενημερώσεις/batch | Μέγ. 2 GB/λεπτό ανά project |
| **Query API** | 60 αιτήματα/ώρα | Ανά project (Λογαριασμός Service) |
| **Export API** | 60 αιτήματα/ώρα | Μέγ. 100 ημέρες ανά ερώτημα |
| **JQL API** | 60 αιτήματα/ώρα | Ανά project |
| **Εξαγωγή Cohort** | 60 αιτήματα/ώρα | Ανά project |

Αποκλεισμός Διπλοτύπων Εκδηλώσεων

Το Mixpanel αποκλείει διπλότυπα εκδηλώσεων χρησιμοποιώντας την ιδιότητα `$insert_id`. Συμπεριλαμβάνετε πάντα μοναδικό `$insert_id` για αποτροπή διπλών εκδηλώσεων κατά την επανάληψη αποτυχημένων εισαγωγών.

## Αντιμετώπιση Προβλημάτων

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| Οι εκδηλώσεις δεν εμφανίζονται | Λάθος project token | Επαληθεύστε ότι το token αντιστοιχεί στο στοχευόμενο project |
| Λείπουν ιδιότητες προφίλ | Χρήση λάθος API | Χρησιμοποιήστε `/engage#$set` για ιδιότητες προφίλ, όχι `/track` |
| Αποτυχία εξαγωγής cohort | Ανεπαρκή δικαιώματα | Βεβαιωθείτε ότι ο Λογαριασμός Service έχει ρόλο Admin ή Analyst |
| Διπλές εκδηλώσεις | Λείπει `$insert_id` | Συμπεριλάβετε μοναδικό `$insert_id` σε κάθε εκδήλωση |
| 402 Payment Required | Υπέρβαση ορίων δεδομένων | Ελέγξτε όρια πλάνου Mixpanel και αναβαθμίστε αν χρειάζεται |
| Τα δεδομένα ΕΕ δεν δρομολογούνται | Λάθος εγκατάσταση δεδομένων | Χρησιμοποιήστε `api-eu.mixpanel.com` για projects ΕΕ |
| Προβλήματα συγχώνευσης ταυτότητας | Λανθασμένο distinct\_id | Ακολουθήστε τις βέλτιστες πρακτικές διαχείρισης ταυτότητας Mixpanel |

## Βέλτιστες Πρακτικές

1. **Χρησιμοποιήστε Λογαριασμούς Service** - Προτιμήστε Λογαριασμούς Service αντί Project Secret για πιστοποίηση στην πλευρά server
2. **Συμπεριλαμβάνετε `$insert_id`** - Ορίζετε πάντα μοναδικό insert ID για αποκλεισμό διπλοτύπων εκδηλώσεων
3. **Ενημερώσεις προφίλ σε batch** - Αποστέλλετε έως 2.000 ενημερώσεις προφίλ ανά αίτημα για αποδοτικότητα
4. **Χρησιμοποιήστε endpoints ΕΕ** - Για εγκατάσταση δεδομένων ΕΕ, χρησιμοποιήστε `api-eu.mixpanel.com` για όλες τις κλήσεις API
5. **Συγχρονίστε cohorts σε πρόγραμμα** - Ρυθμίστε ημερήσιο ή εβδομαδιαίο συγχρονισμό cohort αντί συνεχούς polling
6. **Αντιστοιχίστε δεσμευμένες ιδιότητες** - Χρησιμοποιήστε τις δεσμευμένες ιδιότητες Mixpanel (`$email`, `$first_name`) για δεδομένα προφίλ
7. **Παρακολουθήστε εισαγωγή** - Χρησιμοποιήστε τη σελίδα Events Mixpanel για επαλήθευση ότι οι εκδηλώσεις λαμβάνονται σωστά

## Ασφάλεια

- **Μόνο HTTPS** - Όλη η επικοινωνία API απαιτεί κρυπτογράφηση TLS
- **Απομόνωση Λογαριασμού Service** - Πρόσβαση βάσει scope ανά project με δικαιώματα ανά ρόλο
- **Αποκλεισμός διπλοτύπων εκδηλώσεων** - Ενσωματωμένο dedup μέσω `$insert_id` αποτρέπει προβλήματα ακεραιότητας δεδομένων
- **SOC 2 Type II** - Το Mixpanel είναι πιστοποιημένο SOC 2 Type II
- **GDPR/CCPA** - Υποστηρίζει διαγραφή δεδομένων χρήστη μέσω GDPR API
- **Εγκατάσταση δεδομένων ΕΕ** - Διαθέσιμο κέντρο δεδομένων ΕΕ για ευρωπαϊκή συμμόρφωση

## Σχετικοί Πόροι

- [Σύνδεσμος Segment](https://tajo.io/gr/docs/connectors/custom/segment)
- [Σύνδεσμος Amplitude](https://tajo.io/gr/docs/connectors/custom/amplitude)
- [Δεξιότητα Συγχρονισμού Πελατών](https://tajo.io/gr/docs/skills/data-sync/customer-sync)
- [API Εκδηλώσεων Brevo](https://tajo.io/gr/docs/events-engagement/create-event)
