Mixpanel-kobling

Koble Mixpanel til Brevo gjennom Tajo for å bygge bro mellom produktanalyse og markedsføringsautomatisering. Synkroniser brukerprofiler, atferdshendelser og kohorter for å lage datadrevne kampanjer basert på reell produktbruk.

Oversikt

Funksjoner

• Hendelsesinntak - Importer track-hendelser via Mixpanels Ingestion API til Brevo-arbeidsflyter
• Synkronisering av brukerprofiler - Mapp Mixpanel-brukerprofilegenskaper til Brevo-kontaktattributter
• Eksport av kohorter - Synkroniser Mixpanel-kohorter til Brevo-kontaktlister for målrettede kampanjer
• Gruppeanalyse - Synkroniser data på gruppenivå for B2B-kontobasert markedsføring
• Identitetshåndtering - Utnytt Mixpanels identitetssammenslåing for enhetlige kundeprofiler
• JQL-spørringer - Kjør tilpassede JQL-spørringer for å trekke ut spesifikke datasett til Brevo
• Oppslagstabeller - Synkroniser berikelsesdata fra Mixpanel-oppslagstabeller

Forutsetninger

Før du begynner, sørg for at du har:

1. En Mixpanel-konto med et opprettet prosjekt
2. Ditt Mixpanel Project Token for sporing på klientsiden
3. En tjenestekonto med passende rettigheter for API-tilgang på tjenersiden
4. En Brevo-konto med API-tilgang
5. En Tajo-konto med API-påloggingsdetaljer

Autentisering

Tjenestekontoer (anbefalt)

Mixpanel anbefaler å bruke tjenestekontoer for API-autentisering. Tjenestekontoer bruker HTTP Basic Auth med brukernavn (tjenestekontoens brukernavn) og passord (tjenestekontoens hemmelighet).

# Autentisering med tjenestekonto
curl https://mixpanel.com/api/app/me \
  -u "SERVICE_ACCOUNT_USERNAME:SERVICE_ACCOUNT_SECRET"

Project Token

Project Token brukes for sporing av hendelser på klientsiden og er trygt å inkludere i klientkode:

// Initialisering på klientsiden
mixpanel.init("YOUR_PROJECT_TOKEN");

OAuth (for partnerintegrasjoner)

For app-integrasjoner som får tilgang til flere prosjekter:

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

Konfigurasjon

Grunnleggende oppsett

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

    # Synkroniseringsalternativer
    sync:
      events: true
      profiles: true
      cohorts: true
      groups: false

    # Tildeling av Brevo-lister
    lists:
      all_users: 15
      engaged_users: 16
      at_risk: 17

Hendelsesmapping

Mapp Mixpanel-hendelser til Brevo-hendelsestyper:

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

  # Egendefinerte hendelser
  "Feature Activated": "feature_used"
  "Subscription Renewed": "subscription_renewed"

Mapping av profilegenskaper

Mapp Mixpanel-brukeregenskaper til Brevo-kontaktattributter:

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

Kodeeksempler

Initialiser Mixpanel-kobling

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

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

// Koble til Mixpanel-prosjekt
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
});

Importer hendelser via Ingestion API

// Importer hendelser til Mixpanel (videresendes automatisk til 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"
      }
    }
  ])
});

// Forventet respons: { "code": 200, "status": "OK", "num_records_imported": 1 }

Synkroniser kohort til Brevo

// Eksporter en Mixpanel-kohort og synkroniser til en Brevo-liste
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
// }

Sett brukerprofilegenskaper

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

Ratebegrensninger

Feilsøking

Beste praksis

1. Bruk tjenestekontoer - Foretrekk tjenestekontoer fremfor Project Secret for autentisering på tjenersiden
2. Inkluder $insert_id - Sett alltid en unik insert ID for deduplisering av hendelser
3. Batch profiloppdateringer - Send opptil 2 000 profiloppdateringer per forespørsel for effektivitet
4. Bruk EU-endepunkter - For EU-databotilhold, bruk api-eu.mixpanel.com for alle API-kall
5. Synkroniser kohorter etter plan - Sett opp daglig eller ukentlig kohortsynkronisering i stedet for kontinuerlig polling
6. Mapp reserverte egenskaper - Bruk Mixpanels reserverte egenskaper ($email, $first_name) for profildata
7. Overvåk hendelsesinntak - Bruk Mixpanels Events-side for å verifisere at hendelser mottas korrekt

Sikkerhet

• Kun HTTPS - All API-kommunikasjon krever TLS-kryptering
• Isolering av tjenestekontoer - Avgrenset tilgang per prosjekt med rollebaserte rettigheter
• Deduplisering av hendelser - Innebygd dedup via $insert_id forhindrer dataintegritetsproblemer
• SOC 2 Type II - Mixpanel er SOC 2 Type II-sertifisert
• GDPR/CCPA - Støtter sletting av brukerdata via GDPR API
• EU-databotilhold - EU-datasenter tilgjengelig for europeisk samsvar

Relaterte ressurser

• Segment-kobling
• Amplitude-kobling
• Customer Sync-ferdighet
• Brevo Events API