Amplitude Bağlayıcısı

Amplitude’u Tajo üzerinden Brevo’ya bağlayarak pazarlama otomasyonu için ürün analitiği verilerinden yararlanın. Hedefli kampanyaları güçlendirmek için davranışsal kohortları, kullanıcı özelliklerini ve ürün olaylarını senkronize edin.

Genel Bakış

Özellikler

• Olay iletme - Amplitude track olaylarını pazarlama otomasyonu tetikleyicileri için Brevo’ya gönderin
• Kohort senkronizasyonu - Amplitude davranışsal kohortlarını Brevo kişi listeleri olarak dışa aktarın
• Kullanıcı özelliği senkronizasyonu - Amplitude kullanıcı özelliklerini Brevo kişi özniteliklerine eşleyin
• Gelir takibi - Müşteri yaşam boyu değeri analizi için gelir olaylarını senkronize edin
• Davranışsal segmentasyon - Brevo segmentlerinde Amplitude etkileşim verilerini kullanın
• HTTP V2 API entegrasyonu - Amplitude’un HTTP V2 ingestion API’si ile doğrudan entegrasyon

Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. Oluşturulmuş bir projesi olan Amplitude hesabı
2. Amplitude API Anahtarınız ve Secret Anahtarınız
3. API erişimi olan bir Brevo hesabı
4. API kimlik bilgileri olan bir Tajo hesabı

Kimlik Doğrulama

Amplitude API Anahtarları

Amplitude, kimlik doğrulama için API Anahtarı ve Secret Anahtar çiftleri kullanır. API Anahtarı projenizi tanımlarken, Secret Anahtar sunucu tarafı isteklerini doğrular.

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

HTTP V2 API Kimlik Doğrulaması

HTTP V2 API, istek gövdesinde API anahtarını kullanır:

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

Yapılandırma

Temel Kurulum

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

Olay Eşleme

Amplitude olaylarını Brevo otomasyon tetikleyicilerine eşleyin:

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"

Kullanıcı Özelliği Eşleme

Amplitude kullanıcı özelliklerini Brevo kişi özniteliklerine eşleyin:

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 Uç Noktaları

Kod Örnekleri

Amplitude Bağlayıcısını Başlat

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 Üzerinden Olay Gönder

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

Kohortu Brevo Listesine Senkronize Et

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

Hız Limitleri

Sorun Giderme

En İyi Uygulamalar

1. HTTP V2 API’yi kullanın - Daha iyi doğrulama ve hata yanıtları için eski HTTP API yerine V2 API’yi tercih edin
2. Olayları toplu gönderin - Optimal verim için olayları 1.000’e kadar gruplar halinde gönderin
3. Olaylarda kullanıcı özellikleri ayarlayın - Identify çağrılarını azaltmak için track olaylarına user_properties ekleyin
4. Segmentasyon için kohortları kullanın - Karmaşık segmentasyon mantığını çoğaltmak yerine davranışsal kohortları senkronize edin
5. Gelir olaylarını doğru şekilde takip edin - Doğru gelir takibi için revenue, price ve productId alanlarını kullanın
6. Ingestion sağlığını izleyin - Olay doğrulama hataları için Amplitude’un Ingestion Debugger’ını kontrol edin
7. Sunucu tarafı takibi uygulayın - Güvenilir olay teslimi için sunucu tarafı SDK’larını kullanın

Güvenlik

• Yalnızca HTTPS - Tüm API iletişimi TLS 1.2+ gerektirir
• API anahtarı rotasyonu - Amplitude ayarları üzerinden Secret Anahtarları düzenli olarak döndürün
• IP izin listesi - Enterprise planlarında mevcuttur
• SOC 2 Type II - Amplitude SOC 2 Type II sertifikalıdır
• GDPR/CCPA - Kullanıcı verisi silme ve dışa aktarma taleplerini destekler
• AB veri ikameti - AB veri merkezi seçeneği mevcuttur

İlgili Kaynaklar

• Segment Bağlayıcısı
• Mixpanel Bağlayıcısı
• Müşteri Senkronizasyon Yeteneği
• Brevo Olaylar API’si