Konektor Mixpanel

Propojte Mixpanel s Brevo přes Tajo pro propojení produktové analytiky s marketingovou automatizací. Synchronizujte profily uživatelů, behaviorální události a kohorty pro vytváření kampaní řízených daty na základě skutečného využití produktu.

Přehled

Funkce

• Ingestion událostí – Importujte track události přes Ingestion API Mixpanel do pracovních toků Brevo
• Synchronizace profilů uživatelů – Mapujte vlastnosti profilů uživatelů Mixpanel na atributy kontaktů Brevo
• Export kohort – Synchronizujte kohorty Mixpanel do seznamů kontaktů Brevo pro cílené kampaně
• Skupinová analytika – Synchronizujte data na úrovni skupin pro B2B marketing na základě účtů
• Správa identit – Využijte sloučení identit Mixpanel pro sjednocené profily zákazníků
• JQL dotazy – Spouštějte vlastní JQL dotazy pro extrakci konkrétních datových sad pro Brevo
• Vyhledávací tabulky – Synchronizujte obohacující data z vyhledávacích tabulek Mixpanel

Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Mixpanel s vytvořeným projektem
2. Token projektu Mixpanel pro sledování na straně klienta
3. Servisní účet s příslušnými oprávněními pro přístup k API na straně serveru
4. Účet Brevo s přístupem k API
5. Účet Tajo s API přihlašovacími údaji

Ověření

Servisní účty (doporučeno)

Mixpanel doporučuje používat servisní účty pro ověřování API. Servisní účty používají HTTP Basic Auth s uživatelským jménem (uživatelské jméno servisního účtu) a heslem (tajný klíč servisního účtu).

# Ověření servisním účtem
curl https://mixpanel.com/api/app/me \
  -u "SERVICE_ACCOUNT_USERNAME:SERVICE_ACCOUNT_SECRET"

Token projektu

Token projektu se používá pro sledování událostí na straně klienta a je bezpečný pro zahrnutí do klientského kódu:

// Inicializace na straně klienta
mixpanel.init("YOUR_PROJECT_TOKEN");

OAuth (pro partnerské integrace)

Pro aplikační integrace přistupující k více projektům:

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

Konfigurace

Základní nastavení

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"  # nebo "EU"

    # Možnosti synchronizace dat
    sync:
      events: true
      profiles: true
      cohorts: true
      groups: false

    # Přiřazení seznamů Brevo
    lists:
      all_users: 15
      engaged_users: 16
      at_risk: 17

Mapování událostí

Mapujte události Mixpanel na typy událostí Brevo:

event_mapping:
  # Událost Mixpanel -> Událost Brevo
  "Purchase": "order_completed"
  "Sign Up": "customer_created"
  "Add to Cart": "cart_updated"
  "Page View": "page_viewed"
  "$experiment_started": "experiment_started"

  # Vlastní události
  "Feature Activated": "feature_used"
  "Subscription Renewed": "subscription_renewed"

Mapování vlastností profilu

Mapujte vlastnosti uživatelů Mixpanel na atributy kontaktů 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

Koncové body API

Příklady kódu

Inicializace konektoru Mixpanel

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Připojení projektu Mixpanel
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
});

Import událostí přes Ingestion API

// Import událostí do Mixpanel (automaticky přeposíláno do 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"
      }
    }
  ])
});

// Očekávaná odpověď: { "code": 200, "status": "OK", "num_records_imported": 1 }

Synchronizace kohorty do Brevo

// Export kohorty Mixpanel a synchronizace do seznamu Brevo
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
// }

Nastavení vlastností profilu uživatele

// Nastavení vlastností uživatele přes 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
    }
  }])
});

Omezení rychlosti

Řešení problémů

Osvědčené postupy

1. Používejte servisní účty – Upřednostňujte servisní účty před tajným klíčem projektu pro ověřování na straně serveru
2. Zahrňte $insert_id – Vždy nastavujte jedinečné ID vložení pro deduplikaci událostí
3. Dávkujte aktualizace profilů – Odesílejte až 2 000 aktualizací profilu na požadavek pro efektivitu
4. Používejte koncové body EU – Pro rezidenci dat EU používejte api-eu.mixpanel.com pro všechna volání API
5. Synchronizujte kohorty podle plánu – Nastavte denní nebo týdenní synchronizaci kohort místo nepřetržitého pollingu
6. Mapujte rezervované vlastnosti – Používejte rezervované vlastnosti Mixpanel ($email, $first_name) pro data profilu
7. Monitorujte ingestion – Používejte stránku Událostí Mixpanel pro ověření, zda jsou události přijímány správně

Zabezpečení

• Pouze HTTPS – Veškerá komunikace API vyžaduje šifrování TLS
• Izolace servisního účtu – Rozsahový přístup na projekt s oprávněními na základě rolí
• Deduplikace událostí – Vestavěná deduplikace přes $insert_id zabraňuje problémům s integritou dat
• SOC 2 Type II – Mixpanel je certifikován podle SOC 2 Type II
• GDPR/CCPA – Podporuje mazání uživatelských dat přes GDPR API
• Rezidence dat EU – Datové centrum EU dostupné pro evropský soulad s předpisy

Související zdroje

• Konektor Segment
• Konektor Amplitude
• Dovednost synchronizace zákazníků
• API událostí Brevo