---
title: "Amplitude Bağlayıcısı"
description: "Tajo aracılığıyla ürün analitiği olaylarını, kullanıcı özelliklerini ve davranışsal kohortları Brevo ile senkronize etmek için eksiksiz Amplitude entegrasyon rehberi."
url: https://tajo.io/tr/docs/connectors/custom/amplitude/
markdown: https://tajo.io/tr/docs/connectors/custom/amplitude.md
lang: tr-TR
robots: noindex
---

Erken erişim talep edin

Adınızı ve iş e-posta adresinizi girin. Tajo erişim talebinizi onaylamanız için size bir bağlantı göndereceğiz.

# Amplitude Bağlayıcısı

Bağlayıcı durumu: Planlandı Henüz oluşturulmadı. Tajo bu bağlayıcıyı bugün çalıştırmıyor.

| Kaynak alanı | Hedef alanı | Örnek değer |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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ış

| Özellik | Değer |
| --- | --- |
| **Platform** | Amplitude |
| **Kategori** | Analitik (Özel) |
| **Kurulum Karmaşıklığı** | Orta |
| **Resmi Entegrasyon** | Hayır |
| **Senkronize Edilen Veri** | Olaylar, Kullanıcılar, Kohortlar, Özellikler |
| **Mevcut Yetenekler** | 6 |

## Ö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.

```bash
# 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:

```bash
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

```yaml
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:

```yaml
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:

```yaml
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ı

| Yöntem | Uç Nokta | Açıklama |
| --- | --- | --- |
| `POST` | `/2/httpapi` | Olayları yükle (HTTP V2 API) |
| `POST` | `/batch` | Toplu olay yükle (Batch API) |
| `POST` | `/identify` | Kullanıcı özelliklerini ayarla |
| `POST` | `/groupidentify` | Grup özelliklerini ayarla |
| `GET` | `/2/export` | Ham olay verilerini dışa aktar |
| `GET` | `/2/usersearch` | Kullanıcıları ara |
| `GET` | `/2/useractivity` | Kullanıcı aktivite zaman çizelgesini getir |
| `POST` | `/api/3/cohort/export` | Kohort üyelerini dışa aktar |
| `GET` | `/api/3/chart/{chart_id}/query` | Kaydedilmiş grafik verilerini sorgula |

## Kod Örnekleri

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

```javascript
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

```javascript
// 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: "jane@example.com",
            plan_type: "premium"
          }
        },
        time: Date.now()
      }
    ]
  })
});

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

### Kohortu Brevo Listesine Senkronize Et

```javascript
// 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

| API | Limit | Detaylar |
| --- | --- | --- |
| **HTTP V2 API** | 1.000 olay/sn | Proje başına, 2.000/sn’ye kadar patlama |
| **Batch API** | Toplu iş başına 1.000 olay | Maksimum 20 toplu iş/sn |
| **Identify API** | 1.000 istek/sn | Proje başına |
| **Export API** | 360 istek/saat | Proje başına |
| **Kohort Dışa Aktarma** | 1 eşzamanlı dışa aktarma | Kohort başına |
| **Dashboard REST API** | 360 istek/saat | Proje başına |

Olay Boyutu Limitleri

Her olay yükü 1 MB’ı aşamaz. HTTP V2 API, istek başına en fazla 20 MB gövde boyutu ile 2.000 olay kabul eder.

## Sorun Giderme

| Sorun | Neden | Çözüm |
| --- | --- | --- |
| Olaylar `invalid` durumu döndürüyor | Gerekli alanlar eksik | Her olayda `user_id` veya `device_id` ayarlı olduğundan emin olun |
| Kullanıcı özellikleri senkronize edilmiyor | Yanlış özellik operatörü | Ayarlama için `$set`, ilk dokunuş değerleri için `$setOnce` kullanın |
| Kohort dışa aktarma boş | Kohort hala hesaplanıyor | Dışa aktarmadan önce kohort hesaplamasının tamamlanmasını bekleyin |
| 429 Too Many Requests | Hız limiti aşıldı | Üstel geri çekilme uygulayın ve batch API kullanın |
| Gelir takip edilmiyor | Gelir alanları eksik | Olay özelliklerine `price`, `quantity` ve `revenue` ekleyin |
| AB verileri yönlendirilmiyor | Yanlış veri merkezi | `data_center: "EU"` ayarlayın ve `api.eu.amplitude.com` kullanın |

## 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ı](https://tajo.io/tr/docs/connectors/custom/segment)
- [Mixpanel Bağlayıcısı](https://tajo.io/tr/docs/connectors/custom/mixpanel)
- [Müşteri Senkronizasyon Yeteneği](https://tajo.io/tr/docs/skills/data-sync/customer-sync)
- [Brevo Olaylar API’si](https://tajo.io/tr/docs/events-engagement/create-event)