Σύνδεσμος Mixpanel

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

Επισκόπηση

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

• Εισαγωγή εκδηλώσεων - Εισαγωγή 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).

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

Project Token

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

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

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

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

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

Διαμόρφωση

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

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:

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:

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

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

Αρχικοποίηση Συνδέσμου 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
});

Εισαγωγή Εκδηλώσεων μέσω 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 }

Συγχρονισμός Cohort στο 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
// }

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

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

Όρια Ρυθμού

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

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

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
• Σύνδεσμος Amplitude
• Δεξιότητα Συγχρονισμού Πελατών
• API Εκδηλώσεων Brevo