PostHog konektor
Prepoj PostHog s Brevo cez Tajo na synchronizáciu dát produktovej analytiky, udalostí správania používateľov a členstva v kohortách pre marketingové kampane riadené dátami a personalizované zapojenie zákazníkov.
Prehľad
| Vlastnosť | Hodnota |
|---|---|
| Platforma | PostHog |
| Kategória | Produktová analytika (Vlastná) |
| Zložitosť nastavenia | Stredná |
| Oficiálna integrácia | Nie |
| Synchronizované dáta | Udalosti, Osoby, Feature Flags, Kohorty |
| Metóda autentifikácie | Personal API Key / Project Token |
Funkcie
- Synchronizácia udalostí - Preposielaj analytické udalosti PostHog do Brevo pre behaviorálne cielenie
- Synchronizácia profilov osôb - Synchronizuj vlastnosti osôb PostHog s atribútmi kontaktov v Brevo
- Segmentácia na základe kohort - Namapuj kohorty PostHog na zoznamy kontaktov Brevo
- Synchronizácia feature flags - Segmentuj kontakty podľa povolených feature flags
- Dáta funnela - Použi dáta konverzného funnela pre cielené re-engagement
- Metadáta session replay - Obohacuj kontakty o metriky zapojenia relácie
Predpoklady
Predtým, než začneš, uisti sa, že máš:
- PostHog účet (Cloud alebo self-hosted)
- Personal API Key z PostHog Settings
- Project API Key (token) z Project Settings
- Brevo účet s API prístupom
- Tajo účet s oprávneniami pre konektory
Autentifikácia
Personal API Key (Privátne endpointy)
# Generate at https://app.posthog.com/settings/user-api-keysexport POSTHOG_PERSONAL_API_KEY=phx_your_personal_api_keyexport POSTHOG_PROJECT_TOKEN=phc_your_project_tokenexport POSTHOG_HOST=https://us.posthog.com # or https://eu.posthog.comexport TAJO_API_KEY=your_tajo_api_keyexport BREVO_API_KEY=your_brevo_api_key// Private API endpoints use Bearer authenticationconst headers = { 'Authorization': `Bearer ${process.env.POSTHOG_PERSONAL_API_KEY}`, 'Content-Type': 'application/json'};
// Public endpoints use the project tokenconst publicHeaders = { 'Content-Type': 'application/json'};// Token is passed in the request body for public endpointsBezpečnosť API kľúča
Personal API kľúče poskytujú plný prístup k účtu. Nikdy ich nevystavuj v klientskom kóde. Použi Project API Key (token) pre verejné endpointy ako zachytávanie udalostí a vyhodnotenie feature flags.
Konfigurácia
Základné nastavenie
connectors: posthog: enabled: true host: "${POSTHOG_HOST}" personal_api_key: "${POSTHOG_PERSONAL_API_KEY}" project_token: "${POSTHOG_PROJECT_TOKEN}" project_id: "12345"
sync: persons: true events: true cohorts: true feature_flags: true schedule: "0 */3 * * *" # Every 3 hours
event_filters: - "$pageview" - "purchase_completed" - "signup_completed" - "feature_used"
lists: all_users: 25 active_users: 26 power_users: 27Mapovanie polí
field_mapping: email: email $name: FIRSTNAME $browser: BROWSER $os: OS $initial_referrer: REFERRAL_SOURCE total_events: EVENT_COUNT last_seen: LAST_ACTIVE_DATE signup_date: SIGNUP_DATE plan: SUBSCRIPTION_PLAN company: COMPANY cohort_names: POSTHOG_COHORTSAPI endpointy
| Endpoint | Metóda | Popis |
|---|---|---|
{host}/api/projects/{id}/persons/ | GET | Zoznam osôb |
{host}/api/projects/{id}/events/ | GET | Zoznam udalostí |
{host}/api/projects/{id}/cohorts/ | GET | Zoznam kohort |
{host}/api/projects/{id}/feature_flags/ | GET | Zoznam feature flags |
{host}/api/projects/{id}/feature_flags/evaluation/ | POST | Vyhodnotenie flags |
{host}/api/projects/{id}/insights/ | GET | Zoznam uložených poznatkov |
{host}/api/projects/{id}/query/ | POST | Spustenie HogQL dopytov |
{host}/i/v0/e | POST | Zachytávanie udalostí (verejné) |
{host}/decide/?v=3 | POST | Rozhodnutia feature flags (verejné) |
Ukážky kódu
Inicializácia konektora
import { TajoClient } from '@tajo/sdk';
const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY});
await tajo.connectors.connect('posthog', { host: process.env.POSTHOG_HOST, personalApiKey: process.env.POSTHOG_PERSONAL_API_KEY, projectToken: process.env.POSTHOG_PROJECT_TOKEN, projectId: '12345'});Synchronizácia osôb do Brevo
// Paginate through PostHog personslet nextUrl = `${posthogHost}/api/projects/${projectId}/persons/?` + new URLSearchParams({ limit: '100' });
while (nextUrl) { const response = await fetch(nextUrl, { headers: { 'Authorization': `Bearer ${process.env.POSTHOG_PERSONAL_API_KEY}` } });
const data = await response.json();
for (const person of data.results) { const email = person.properties.$email || person.properties.email; if (!email) continue;
await tajo.contacts.sync({ email, attributes: { FIRSTNAME: person.properties.$name || person.properties.name, LAST_ACTIVE_DATE: person.properties.$last_seen, SIGNUP_DATE: person.created_at, EVENT_COUNT: person.properties.$event_count, BROWSER: person.properties.$browser, OS: person.properties.$os, REFERRAL_SOURCE: person.properties.$initial_referrer }, listIds: [25] }); }
nextUrl = data.next;}Synchronizácia kohort ako zoznamov Brevo
// Get PostHog cohorts and sync members to Brevo listsconst cohortsResponse = await fetch( `${posthogHost}/api/projects/${projectId}/cohorts/`, { headers: { 'Authorization': `Bearer ${process.env.POSTHOG_PERSONAL_API_KEY}` } });
const { results: cohorts } = await cohortsResponse.json();
for (const cohort of cohorts) { // Get persons in this cohort const personsResponse = await fetch( `${posthogHost}/api/projects/${projectId}/cohorts/${cohort.id}/persons/`, { headers: { 'Authorization': `Bearer ${process.env.POSTHOG_PERSONAL_API_KEY}` } } );
const { results: persons } = await personsResponse.json();
for (const person of persons) { const email = person.properties.$email || person.properties.email; if (email) { await tajo.contacts.update(email, { attributes: { POSTHOG_COHORTS: cohort.name } }); } }}Spustenie HogQL dopytov pre analytiku
// Use HogQL to query analytics dataconst queryResponse = await fetch( `${posthogHost}/api/projects/${projectId}/query/`, { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.POSTHOG_PERSONAL_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ query: { kind: 'HogQLQuery', query: ` SELECT properties.$email AS email, count() AS event_count, max(timestamp) AS last_event FROM events WHERE event = 'purchase_completed' AND timestamp > now() - interval 30 day GROUP BY email HAVING event_count > 3 ORDER BY event_count DESC LIMIT 1000 ` } }) });
const queryResult = await queryResponse.json();
for (const row of queryResult.results) { await tajo.contacts.update(row[0], { attributes: { PURCHASE_COUNT_30D: row[1], LAST_PURCHASE: row[2] } });}Obmedzenia rýchlosti
| Kategória endpointu | Limit | Poznámky |
|---|---|---|
| Analytické endpointy | 240/min, 1 200/hod | GET osoby, udalosti, poznatky |
| Query endpoint | 2 400/hod | HogQL a vlastné dopyty |
| Vyhodnotenie feature flags | 600/min | Endpoint lokálneho vyhodnotenia |
| CRUD endpointy | 480/min, 4 800/hod | Vytvorenie, aktualizácia, mazanie |
| Verejné endpointy (capture) | Neobmedzene | Zachytávanie udalostí, rozhodnutia flags |
Dávkové exporty
Pre veľkoobjemové exporty dát udalostí použi funkciu dávkových exportov PostHog namiesto API. Dávkové exporty podporujú S3, BigQuery, Snowflake a iné destinácie.
Riešenie problémov
| Problém | Príčina | Riešenie |
|---|---|---|
| 401 Unauthorized | Neplatný API kľúč | Overte Personal API Key v nastaveniach |
| 400 Invalid project | Nesprávne ID projektu | Skontroluj ID projektu v URL PostHog |
| Prázdny zoznam osôb | Žiadni identifikovaní používatelia | Uisti sa, že posthog.identify() je volaný |
| Chýbajúce vlastnosti | Vlastnosti nie sú nastavené | Overte volania $set v klientskom SDK |
| Rate limit 429 | Príliš veľa požiadaviek | Implementuj backoff, skontroluj hlavičky rate limitu |
Debug režim
connectors: posthog: debug: true log_level: verbose log_queries: true log_sync: trueOdporúčané postupy
- Identifikuj používateľov - Vždy volaj
posthog.identify()s e-mailom na povolenie synchronizácie osôb - Použi kohorty pre segmentáciu - Využi behaviorálne kohorty PostHog pre zoznamy Brevo
- Dávkuj API požiadavky - Použi stránkovanie a dávkové spracovanie pre veľké datasety
- Použi HogQL pre komplexné dopyty - Extrahuj vlastnú analytiku pomocou SQL-like dopytov
- Nastav dávkové exporty - Pre veľké objemy dát preferuj dávkové exporty pred API pollingom
- Filtruj relevantné udalosti - Synchronizuj iba marketingovo relevantné udalosti na zníženie šumu
Bezpečnosť
- Personal API Key - Scoped Bearer token autentifikácia
- Project token - Verejný token iba pre operácie na strane klienta
- Iba HTTPS - Všetky endpointy vyžadujú TLS šifrovanie
- IP allowlisting - Dostupné pre self-hosted inštancie
- Obmedzenie kľúčov - Vytváraj API kľúče s konkrétnymi oprávneniami
- GitHub secret scanning - PostHog spolupracuje s GitHub pri detekcii uniknutých kľúčov