--- title: "Mixpanel Konektor" description: "Kompletan vodič za integraciju Mixpanela za sinkronizaciju analitičkih događaja, korisničkih profila i kohorti s Brevom putem Taja." url: https://tajo.io/hr/docs/connectors/custom/mixpanel/ markdown: https://tajo.io/hr/docs/connectors/custom/mixpanel.md lang: hr-HR robots: noindex --- Zatražite rani pristup Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju. # Mixpanel Konektor Status konektora: Planirano Još nije izrađeno. Tajo danas ne pokreće ovaj konektor. | Izvorno polje | Odredišno polje | Primjer vrijednosti | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | 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 | Svojstvo | Vrijednost | | --- | --- | | **Platforma** | Mixpanel | | **Kategorija** | Analitika (Prilagođeno) | | **Složenost postavljanja** | Srednje | | **Službena integracija** | Ne | | **Sinkronizirani podaci** | Događaji, Profili, Kohorte, Grupe | | **Dostupne vještine** | 7 | ## 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). ```bash # 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: ```javascript // Inicijalizacija na strani klijenta mixpanel.init("YOUR_PROJECT_TOKEN"); ``` ### OAuth (za partnerske integracije) Za integracije aplikacija koje pristupaju višestrukim projektima: ```bash curl https://mixpanel.com/api/2.0/engage \ -H "Authorization: Bearer YOUR_OAUTH_TOKEN" ``` ## Konfiguracija ### Osnovna konfiguracija ```yaml 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: ```yaml 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: ```yaml 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 | Metoda | Krajnja točka | Opis | | --- | --- | --- | | `POST` | `/import` | Uvoz događaja (Ingestion API) | | `POST` | `/track` | Praćenje događaja (na strani klijenta) | | `POST` | `/engage#$set` | Postavljanje svojstava korisničkog profila | | `POST` | `/engage#$set_once` | Postavljanje svojstava samo ako nisu već postavljena | | `POST` | `/engage#$delete` | Brisanje korisničkog profila | | `POST` | `/engage#$union` | Union na svojstva popisa | | `POST` | `/groups` | Postavljanje svojstava grupnog profila | | `GET` | `/export` | Izvoz sirovih podataka o događajima | | `POST` | `/cohorts/list` | Popis pohranjenih kohorti | | `POST` | `/engage/query` | Upit korisničkih profila | | `POST` | `/jql` | Pokretanje prilagođenih JQL upita | | `GET` | `/segmentation` | Upit izvješća segmentacije | | `GET` | `/retention` | Upit izvješća o zadržavanju | | `GET` | `/funnels` | Upit izvješća o lijevcima | ## Primjeri koda ### Inicijalizacija Mixpanel konektora ```javascript 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 ```javascript // 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 ```javascript // 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 ```javascript // 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: "jane@example.com", $first_name: "Jane", $last_name: "Kim", plan: "premium", total_orders: 12, lifetime_value: 1250.00 } }]) }); ``` ## Ograničenja brzine | API | Ograničenje | Detalji | | --- | --- | --- | | **Ingestion API** | 2 GB/min | Po projektu | | **Track API** | Nema tvrdog ograničenja | Isporuka na temelju najboljeg napora | | **Engage API** | 2.000 ažuriranja/serija | Maks. 2 GB/min po projektu | | **Query API** | 60 zahtjeva/sat | Po projektu (servisni račun) | | **Export API** | 60 zahtjeva/sat | Maks. 100 dana po upitu | | **JQL API** | 60 zahtjeva/sat | Po projektu | | **Izvoz kohorte** | 60 zahtjeva/sat | Po projektu | Deduplikacija događaja Mixpanel deduplici­ra događaje koristeći svojstvo `$insert_id`. Uvijek uključite jedinstveni `$insert_id` kako biste spriječili duplikate događaja pri ponovnom pokušaju neuspjelih uvoza. ## Rješavanje problema | Problem | Uzrok | Rješenje | | --- | --- | --- | | Događaji se ne pojavljuju | Pogrešan project token | Provjerite odgovara li token ciljnom projektu | | Nedostaju svojstva profila | Koristi se pogrešan API | Koristite `/engage#$set` za svojstva profila, ne `/track` | | Izvoz kohorte ne uspijeva | Nedostatne dozvole | Osigurajte da servisni račun ima ulogu Admin ili Analyst | | Duplikati događaja | Nedostaje `$insert_id` | Uključite jedinstveni `$insert_id` na svakom događaju | | 402 Payment Required | Prekoračena ograničenja podataka | Provjerite Mixpanel ograničenja plana i nadogradite po potrebi | | EU podaci se ne usmjeravaju | Pogrešna pohrana podataka | Koristite `api-eu.mixpanel.com` za EU projekte | | Problemi spajanja identiteta | Netočan distinct\_id | Slijedite Mixpanel preporučene prakse upravljanja identitetom | ## 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](https://tajo.io/hr/docs/connectors/custom/segment) - [Amplitude Konektor](https://tajo.io/hr/docs/connectors/custom/amplitude) - [Vještina sinkronizacije korisnika](https://tajo.io/hr/docs/skills/data-sync/customer-sync) - [Brevo API događaja](https://tajo.io/hr/docs/events-engagement/create-event)