Σύνδεσμος Amplitude

Συνδέστε το Amplitude με το Brevo μέσω Tajo για να αξιοποιήσετε δεδομένα αναλυτικών προϊόντων για αυτοματοποίηση marketing. Συγχρονίστε συμπεριφορικά cohorts, ιδιότητες χρηστών και εκδηλώσεις προϊόντος για να τροφοδοτήσετε στοχευμένες καμπάνιες.

Επισκόπηση

Χαρακτηριστικά

• Προώθηση εκδηλώσεων - Αποστολή track events Amplitude στο Brevo για ενεργοποιητές αυτοματοποίησης marketing
• Συγχρονισμός cohort - Εξαγωγή συμπεριφορικών cohorts Amplitude ως λίστες επαφών Brevo
• Συγχρονισμός ιδιοτήτων χρήστη - Αντιστοίχιση ιδιοτήτων χρήστη Amplitude σε χαρακτηριστικά επαφών Brevo
• Παρακολούθηση εσόδων - Συγχρονισμός εκδηλώσεων εσόδων για ανάλυση αξίας κύκλου ζωής πελατών
• Συμπεριφορική τμηματοποίηση - Χρήση δεδομένων αλληλεπίδρασης Amplitude σε τμήματα Brevo
• Ενσωμάτωση HTTP V2 API - Άμεση ενσωμάτωση με το HTTP V2 API εισαγωγής Amplitude

Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό Amplitude με δημιουργημένο project
2. Το API Key και Secret Key Amplitude
3. Λογαριασμό Brevo με πρόσβαση API
4. Λογαριασμό Tajo με διαπιστευτήρια API

Πιστοποίηση

Κλειδιά API Amplitude

Το Amplitude χρησιμοποιεί ζεύγη API Key και Secret Key για πιστοποίηση. Το API Key προσδιορίζει το project σας, ενώ το Secret Key πιστοποιεί αιτήματα στην πλευρά του server.

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

Πιστοποίηση HTTP V2 API

Το HTTP V2 API χρησιμοποιεί το API key στο σώμα του αιτήματος:

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

Διαμόρφωση

Βασική Ρύθμιση

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

Αντιστοίχιση Εκδηλώσεων

Αντιστοιχίστε εκδηλώσεις Amplitude σε ενεργοποιητές αυτοματισμού Brevo:

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"

Αντιστοίχιση Ιδιοτήτων Χρήστη

Αντιστοιχίστε ιδιότητες χρήστη Amplitude σε χαρακτηριστικά επαφών Brevo:

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

Endpoints API

Παραδείγματα Κώδικα

Αρχικοποίηση Συνδέσμου Amplitude

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'
});

Αποστολή Εκδηλώσεων μέσω 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 }

Συγχρονισμός Cohort σε Λίστα Brevo

// 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
// }

Όρια Ρυθμού

Αντιμετώπιση Προβλημάτων

Βέλτιστες Πρακτικές

1. Χρησιμοποιήστε το HTTP V2 API - Προτιμήστε το V2 API αντί του παλαιού HTTP API για καλύτερη επαλήθευση και αποκρίσεις σφαλμάτων
2. Εκδηλώσεις σε batch - Αποστέλλετε εκδηλώσεις σε batches έως 1.000 για βέλτιστη απόδοση
3. Ορίστε ιδιότητες χρήστη σε εκδηλώσεις - Συμπεριλάβετε user_properties σε track events για μείωση κλήσεων identify
4. Χρησιμοποιήστε cohorts για τμηματοποίηση - Συγχρονίστε συμπεριφορικά cohorts αντί να αναπαράγετε σύνθετη λογική τμηματοποίησης
5. Παρακολουθήστε εκδηλώσεις εσόδων σωστά - Χρησιμοποιήστε πεδία revenue, price και productId για ακριβή παρακολούθηση εσόδων
6. Παρακολουθήστε την υγεία εισαγωγής - Ελέγξτε το Ingestion Debugger του Amplitude για σφάλματα επαλήθευσης εκδηλώσεων
7. Εφαρμόστε παρακολούθηση στην πλευρά server - Χρησιμοποιήστε server-side SDKs για αξιόπιστη παράδοση εκδηλώσεων

Ασφάλεια

• Μόνο HTTPS - Όλη η επικοινωνία API απαιτεί TLS 1.2+
• Εναλλαγή κλειδιών API - Εναλλάσσετε τα Secret Keys περιοδικά μέσω ρυθμίσεων Amplitude
• Λίστα επιτρεπόμενων IP - Διαθέσιμη σε Enterprise πλάνα
• SOC 2 Type II - Το Amplitude είναι πιστοποιημένο SOC 2 Type II
• GDPR/CCPA - Υποστήριξη για αιτήματα διαγραφής και εξαγωγής δεδομένων χρήστη
• Εγκατάσταση δεδομένων ΕΕ - Διαθέσιμη επιλογή κέντρου δεδομένων ΕΕ

Σχετικοί Πόροι

• Σύνδεσμος Segment
• Σύνδεσμος Mixpanel
• Δεξιότητα Συγχρονισμού Πελατών
• API Εκδηλώσεων Brevo