Amplitude Konektor

Povežite Amplitude s Brevom putem Taja kako biste iskoristili podatke o analitici proizvoda za marketinšku automatizaciju. Sinkronizirajte bihevioralne kohorte, korisnička svojstva i događaje za pokretanje ciljanih kampanja.

Pregled

Značajke

• Prosljeđivanje događaja - Šaljite Amplitude praćene događaje u Brevo za okidače marketinške automatizacije
• Sinkronizacija kohorti - Izvozite Amplitude bihevioralne kohorte kao Brevo popise kontakata
• Sinkronizacija korisničkih svojstava - Mapirajte Amplitude korisnička svojstva na Brevo atribute kontakata
• Praćenje prihoda - Sinkronizirajte događaje prihoda za analizu životne vrijednosti klijenata
• Bihevioralna segmentacija - Koristite Amplitude angažmanske podatke u Brevo segmentima
• HTTP V2 API integracija - Izravna integracija s Amplitude HTTP V2 API-jem za unos

Preduvjeti

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

1. Amplitude račun s kreiranim projektom
2. Vaš Amplitude API Key i Secret Key
3. Brevo račun s API pristupom
4. Tajo račun s API vjerodajnicama

Autentifikacija

Amplitude API ključevi

Amplitude koristi parove API Key i Secret Key za autentifikaciju. API Key identificira vaš projekt, dok Secret Key autentificira serverske zahtjeve.

# Pronađite svoje ključeve u Amplitude-u:
# Settings > Projects > [Vaš projekt] > General

Autentifikacija HTTP V2 API-ja

HTTP V2 API koristi API ključ u tijelu zahtjeva:

curl -X POST https://api2.amplitude.com/2/httpapi \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_AMPLITUDE_API_KEY",
    "events": [...]
  }'

Konfiguracija

Osnovna konfiguracija

connectors:
  amplitude:
    enabled: true
    api_key: "your-amplitude-api-key"
    secret_key: "your-amplitude-secret-key"
    data_center: "US"  # ili "EU"

    # Opcije sinkronizacije podataka
    sync:
      events: true
      user_properties: true
      cohorts: true
      revenue: true

    # Dodjela popisa u Brevu
    lists:
      active_users: 10
      power_users: 11
      churning_users: 12

Mapiranje događaja

Mapirajte Amplitude događaje na Brevo okidače automatizacija:

event_mapping:
  # Amplitude događaj -> Brevo događaj
  "Purchase": "order_completed"
  "Sign Up": "customer_created"
  "Add to Cart": "cart_updated"
  "Page View": "page_viewed"
  "Feature Click": "feature_used"

  # Događaji prihoda
  "Revenue": "revenue_event"
  "Subscription Started": "subscription_created"

Mapiranje korisničkih svojstava

Mapirajte Amplitude korisnička svojstva na Brevo atribute kontakata:

property_mapping:
  # Amplitude svojstvo -> Brevo atribut
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS
  plan_type: PLAN
  signup_date: SIGNUP_DATE
  total_purchases: ORDER_COUNT
  lifetime_revenue: LTV
  last_active: LAST_ACTIVE
  device_type: DEVICE

API krajnje točke

Primjeri koda

Inicijalizacija Amplitude konektora

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

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

// Povezivanje Amplitude projekta
await tajo.connectors.connect('amplitude', {
  apiKey: process.env.AMPLITUDE_API_KEY,
  secretKey: process.env.AMPLITUDE_SECRET_KEY,
  dataCenter: 'US'
});

Slanje događaja putem HTTP V2 API-ja

// Slanje događaja u Amplitude (automatski se prosljeđuju u Brevo)
const response = await fetch('https://api2.amplitude.com/2/httpapi', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    api_key: process.env.AMPLITUDE_API_KEY,
    events: [
      {
        user_id: "user_123",
        event_type: "Purchase",
        event_properties: {
          revenue: 89.99,
          product_id: "SKU-001",
          product_name: "Widget Pro"
        },
        user_properties: {
          $set: {
            email: "[email protected]",
            plan_type: "premium"
          }
        },
        time: Date.now()
      }
    ]
  })
});

// Očekivani odgovor: { "code": 200, "events_ingested": 1 }

Sinkronizacija kohorte s Brevo popisom

// Izvoz Amplitude kohorte i sinkronizacija s Brevom
const cohort = await tajo.connectors.syncCohort('amplitude', {
  cohortId: 'abc123',
  targetList: 11,  // Brevo ID popisa
  syncMode: 'mirror'  // mirror, append ili remove
});

console.log(cohort);
// {
//   cohortName: "Power Users",
//   membersCount: 2450,
//   syncedToBrevo: 2450,
//   listId: 11
// }

Ograničenja brzine

Rješavanje problema

Preporučene prakse

1. Koristite HTTP V2 API - Preferirajte V2 API umjesto zastarjelog HTTP API-ja za bolje validacije i odgovore na greške
2. Skupni događaji - Šaljite događaje u serijama od do 1.000 za optimalni protok
3. Postavljajte korisnička svojstva na događajima - Uključite user_properties na praćenim događajima za smanjenje poziva identifikacije
4. Koristite kohorte za segmentaciju - Sinkronizirajte bihevioralne kohorte umjesto repliciranja složene logike segmentacije
5. Pravilno pratite događaje prihoda - Koristite polja revenue, price i productId za točno praćenje prihoda
6. Pratite zdravlje unosa - Provjerite Amplitude Ingestion Debugger za greške validacije događaja
7. Implementirajte praćenje na strani servera - Koristite serverske SDK-ove za pouzdanu isporuku događaja

Sigurnost

• Samo HTTPS - Sva API komunikacija zahtijeva TLS 1.2+
• Rotacija API ključeva - Periodično rotirajte Secret Keyeve putem Amplitude postavki
• IP dopuštanje - Dostupno na Enterprise planovima
• SOC 2 Type II - Amplitude je SOC 2 Type II certificiran
• GDPR/CCPA - Podrška za zahtjeve za brisanje i izvoz korisničkih podataka
• EU pohrana podataka - Dostupna opcija EU podatkovnog centra

Povezani resursi

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