Mixpanel konnektor

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

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).

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

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

OAuth (partner integrációkhoz)

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

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

Konfiguráció

Alapbeállítás

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:

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:

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

Kódpéldák

A Mixpanel konnektor inicializálása

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

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

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

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

Ráta-korlátok

Hibaelhárítás

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
• Amplitude konnektor
• Ügyfél-szinkronizáció Skill
• Brevo Events API