Amplitude Connector

Forbind Amplitude med Brevo gennem Tajo for at udnytte produktanalysedata til marketingautomatisering. Synkronisér adfærdsmæssige kohorter, brugeregenskaber og produkthændelser for at drive målrettede kampagner.

Oversigt

Funktioner

• Videresendelse af hændelser - Send Amplitude track-hændelser til Brevo som triggere for marketingautomatisering
• Kohortesynkronisering - Eksportér Amplitude-adfærdskohorter som Brevo-kontaktlister
• Synkronisering af brugeregenskaber - Kortlæg Amplitude-brugeregenskaber til Brevo-kontaktattributter
• Omsætningssporing - Synkronisér omsætningshændelser til analyse af kundelivstidsværdi
• Adfærdssegmentering - Brug Amplitude-engagementsdata i Brevo-segmenter
• HTTP V2 API-integration - Direkte integration med Amplitudes HTTP V2-ingestion-API

Forudsætninger

Før du begynder, skal du sikre dig, at du har:

1. En Amplitude-konto med et oprettet projekt
2. Din Amplitude API-nøgle og hemmelige nøgle
3. En Brevo-konto med API-adgang
4. En Tajo-konto med API-legitimationsoplysninger

Autentifikation

Amplitude API-nøgler

Amplitude bruger API-nøgle- og hemmelig nøglepar til autentifikation. API-nøglen identificerer dit projekt, mens den hemmelige nøgle autentificerer server-side-anmodninger.

# Find your keys in Amplitude:
# Settings > Projects > [Your Project] > General

HTTP V2 API-autentifikation

HTTP V2 API’et bruger API-nøglen i anmodningens body:

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

Konfiguration

Grundlæggende opsætning

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

    # Data sync options
    sync:
      events: true
      user_properties: true
      cohorts: true
      revenue: true

    # Brevo list assignment
    lists:
      active_users: 10
      power_users: 11
      churning_users: 12

Hændelsesmapping

Kortlæg Amplitude-hændelser til Brevo-automatiseringstriggere:

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

  # Revenue events
  "Revenue": "revenue_event"
  "Subscription Started": "subscription_created"

Mapping af brugeregenskaber

Kortlæg Amplitude-brugeregenskaber til Brevo-kontaktattributter:

property_mapping:
  # Amplitude property -> Brevo attribute
  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-endpoints

Kodeeksempler

Initialisér Amplitude-connector

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

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

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

Send hændelser via HTTP V2 API

// Send events to Amplitude (automatically forwarded to 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()
      }
    ]
  })
});

// Expected response: { "code": 200, "events_ingested": 1 }

Synkronisér kohorte til Brevo-liste

// Export an Amplitude cohort and sync to Brevo
const cohort = await tajo.connectors.syncCohort('amplitude', {
  cohortId: 'abc123',
  targetList: 11,  // Brevo list ID
  syncMode: 'mirror'  // mirror, append, or remove
});

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

Rate limits

Fejlfinding

Bedste praksis

1. Brug HTTP V2 API’et - Foretræk V2 API’et frem for det ældre HTTP API for bedre validering og fejlrespons
2. Batch-hændelser - Send hændelser i batches på op til 1.000 for optimal gennemstrømning
3. Angiv brugeregenskaber på hændelser - Inkludér user_properties på track-hændelser for at reducere identify-kald
4. Brug kohorter til segmentering - Synkronisér adfærdskohorter i stedet for at replikere kompleks segmenteringslogik
5. Spor omsætningshændelser korrekt - Brug felterne revenue, price og productId til præcis omsætningssporing
6. Overvåg ingestion-sundhed - Tjek Amplitudes Ingestion Debugger for hændelsesvalideringsfejl
7. Implementér server-side-sporing - Brug server-side SDK’er for pålidelig hændelseslevering

Sikkerhed

• Kun HTTPS - Al API-kommunikation kræver TLS 1.2+
• Rotation af API-nøgler - Rotér hemmelige nøgler regelmæssigt via Amplitude-indstillinger
• IP-allowlisting - Tilgængelig på Enterprise-planer
• SOC 2 Type II - Amplitude er SOC 2 Type II-certificeret
• GDPR/CCPA - Understøttelse af anmodninger om sletning og eksport af brugerdata
• EU-dataresidens - EU-datacentermulighed tilgængelig

Relaterede ressourcer

• Segment Connector
• Mixpanel Connector
• Customer Sync Skill
• Brevo Events API