Mixpanel Konektor

Povežite Mixpanel s Brevom putem Taja kako biste premostili jaz između analitike proizvoda i marketinške automatizacije. Sinkronizirajte korisničke profile, bihevioralne događaje i kohorte za stvaranje kampanja temeljenih na podacima na osnovi stvarne upotrebe proizvoda.

Pregled

Značajke

• Unos događaja - Uvozite praćene događaje putem Mixpanel Ingestion API-ja u Brevo tijekove rada
• Sinkronizacija korisničkih profila - Mapirajte Mixpanel korisnička svojstva profila na Brevo atribute kontakata
• Izvoz kohorti - Sinkronizirajte Mixpanel kohorte na Brevo popise kontakata za ciljane kampanje
• Grupna analitika - Sinkronizirajte podatke na razini grupe za B2B marketing temeljen na računima
• Upravljanje identitetom - Iskoristite Mixpanel spajanje identiteta za unificiranim korisničkim profilima
• JQL upiti - Pokretajte prilagođene JQL upite za izvlačenje specifičnih skupova podataka za Brevo
• Tablice pretraživanja - Sinkronizirajte podatke obogaćivanja iz Mixpanel tablica pretraživanja

Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Mixpanel račun s kreiranim projektom
2. Vaš Mixpanel Project Token za praćenje na strani klijenta
3. Servisni račun s odgovarajućim dozvolama za API pristup na strani servera
4. Brevo račun s API pristupom
5. Tajo račun s API vjerodajnicama

Autentifikacija

Servisni računi (Preporučeno)

Mixpanel preporučuje korištenje servisnih računa za API autentifikaciju. Servisni računi koriste HTTP Basic Auth s korisničkim imenom (korisničko ime servisnog računa) i lozinkom (tajna servisnog računa).

# Autentifikacija servisnog računa
curl https://mixpanel.com/api/app/me \
  -u "SERVICE_ACCOUNT_USERNAME:SERVICE_ACCOUNT_SECRET"

Project Token

Project Token se koristi za praćenje događaja na strani klijenta i siguran je za uključivanje u klijentski kod:

// Inicijalizacija na strani klijenta
mixpanel.init("YOUR_PROJECT_TOKEN");

OAuth (za partnerske integracije)

Za integracije aplikacija koje pristupaju višestrukim projektima:

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

Konfiguracija

Osnovna konfiguracija

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

    # Opcije sinkronizacije podataka
    sync:
      events: true
      profiles: true
      cohorts: true
      groups: false

    # Dodjela popisa u Brevu
    lists:
      all_users: 15
      engaged_users: 16
      at_risk: 17

Mapiranje događaja

Mapirajte Mixpanel događaje na Brevo vrste događaja:

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

  # Prilagođeni događaji
  "Feature Activated": "feature_used"
  "Subscription Renewed": "subscription_renewed"

Mapiranje svojstava profila

Mapirajte Mixpanel korisnička svojstva na Brevo atribute kontakata:

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 krajnje točke

Primjeri koda

Inicijalizacija Mixpanel konektora

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

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

// Povezivanje Mixpanel projekta
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
});

Uvoz događaja putem Ingestion API-ja

// Uvoz događaja u Mixpanel (automatski se prosljeđuju u 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čekivani odgovor: { "code": 200, "status": "OK", "num_records_imported": 1 }

Sinkronizacija kohorte s Brevom

// Izvoz Mixpanel kohorte i sinkronizacija s Brevo popisom
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
// }

Postavljanje svojstava korisničkog profila

// Postavljanje korisničkih svojstava putem Engage API-ja
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
    }
  }])
});

Ograničenja brzine

Rješavanje problema

Preporučene prakse

1. Koristite servisne račune - Preferirajte servisne račune umjesto Project Secreta za autentifikaciju na strani servera
2. Uključite $insert_id - Uvijek postavite jedinstveni insert ID za deduplikaciju događaja
3. Skupna ažuriranja profila - Šaljite do 2.000 ažuriranja profila po zahtjevu radi učinkovitosti
4. Koristite EU krajnje točke - Za EU pohranu podataka, koristite api-eu.mixpanel.com za sve API pozive
5. Sinkronizirajte kohorte prema rasporedu - Postavite dnevnu ili tjednu sinkronizaciju kohorti umjesto kontinuiranog anketiranja
6. Mapirajte rezervirana svojstva - Koristite Mixpanel rezervirana svojstva ($email, $first_name) za podatke profila
7. Pratite unos - Koristite Mixpanel stranicu Događaji za provjeru primitka događaja

Sigurnost

• Samo HTTPS - Sva API komunikacija zahtijeva TLS enkripciju
• Izolacija servisnog računa - Opsežni pristup po projektu s dozvolama temeljenim na ulogama
• Deduplikacija događaja - Ugrađena deduplikacija putem $insert_id sprječava probleme integriteta podataka
• SOC 2 Type II - Mixpanel je SOC 2 Type II certificiran
• GDPR/CCPA - Podržava brisanje korisničkih podataka putem GDPR API-ja
• EU pohrana podataka - EU podatkovni centar dostupan za europsku usklađenost

Povezani resursi

• Segment Konektor
• Amplitude Konektor
• Vještina sinkronizacije korisnika
• Brevo API događaja