---
title: "Amplitude konnektor"
description: "Teljes Amplitude integrációs útmutató termékanalitikai események, felhasználói tulajdonságok és viselkedési kohortok Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/custom/amplitude/
markdown: https://tajo.io/hu/docs/connectors/custom/amplitude.md
lang: hu-HU
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# Amplitude konnektor

Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd az Amplitude-ot a Brevóhoz a Tajo segítségével, hogy termékanalitikai adatokat használj marketingautomatizáláshoz. Szinkronizálj viselkedési kohortokat, felhasználói tulajdonságokat és termék-eseményeket célzott kampányok indításához.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Amplitude |
| **Kategória** | Analitika (Egyéni) |
| **Telepítés bonyolultsága** | Közepes |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Események, Felhasználók, Kohortok, Tulajdonságok |
| **Elérhető Skillek** | 6 |

## Funkciók

- **Esemény-továbbítás** – Amplitude track események küldése a Brevóba marketingautomatizálási triggerekhez
- **Kohort-szinkronizáció** – Amplitude viselkedési kohortok exportálása Brevo kapcsolatlistákként
- **Felhasználói tulajdonság-szinkronizáció** – Amplitude felhasználói tulajdonságok leképezése Brevo kapcsolat-attribútumokhoz
- **Bevételkövetés** – Bevételi események szinkronizálása az ügyfél élettartam-értékének elemzéséhez
- **Viselkedésbeli szegmentálás** – Amplitude elköteleződési adatok használata Brevo szegmensekben
- **HTTP V2 API integráció** – Közvetlen integráció az Amplitude HTTP V2 ingestion API-jával

## Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Amplitude fiókkal és létrehozott projekttel
2. Az Amplitude API kulcsoddal és titkos kulcsoddal
3. Egy Brevo fiókkal API-hozzáféréssel
4. Egy Tajo fiókkal API hitelesítő adatokkal

## Hitelesítés

### Amplitude API kulcsok

Az Amplitude API kulcs és titkos kulcs párokat használ hitelesítéshez. Az API kulcs azonosítja a projektedet, míg a titkos kulcs hitelesíti a szerver oldali kéréseket.

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

### HTTP V2 API hitelesítés

A HTTP V2 API az API kulcsot a kérés törzsében használja:

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

## Konfiguráció

### Alapbeállítás

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

### Esemény-leképezés

Képezd le az Amplitude eseményeket Brevo automatizálási triggerekhez:

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

### Felhasználói tulajdonság-leképezés

Képezd le az Amplitude felhasználói tulajdonságokat Brevo kapcsolat-attribútumokhoz:

```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 végpontok

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `POST` | `/2/httpapi` | Események feltöltése (HTTP V2 API) |
| `POST` | `/batch` | Tömeges esemény feltöltés (Batch API) |
| `POST` | `/identify` | Felhasználói tulajdonságok beállítása |
| `POST` | `/groupidentify` | Csoport tulajdonságok beállítása |
| `GET` | `/2/export` | Nyers eseményadatok exportálása |
| `GET` | `/2/usersearch` | Felhasználók keresése |
| `GET` | `/2/useractivity` | Felhasználói tevékenység idővonalának lekérése |
| `POST` | `/api/3/cohort/export` | Kohort tagok exportálása |
| `GET` | `/api/3/chart/{chart_id}/query` | Mentett diagram adatainak lekérdezése |

## Kódpéldák

### Az Amplitude konnektor inicializálása

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

### Események küldése HTTP V2 API-n keresztül

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

### Kohort szinkronizálása Brevo listával

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

## Ráta-korlátok

| API | Korlát | Részletek |
| --- | --- | --- |
| **HTTP V2 API** | 1 000 esemény/mp | Projektenként, burst max. 2 000/mp |
| **Batch API** | 1 000 esemény/köteg | Max. 20 köteg/mp |
| **Identify API** | 1 000 kérés/mp | Projektenként |
| **Export API** | 360 kérés/óra | Projektenként |
| **Kohort exportálás** | 1 egyidejű export | Kohortonként |
| **Dashboard REST API** | 360 kérés/óra | Projektenként |

Esemény méretkorlátok

Minden esemény hasznos terhelés legfeljebb 1 MB lehet. A HTTP V2 API kérésenként legfeljebb 2 000 eseményt fogad el, max. 20 MB törzsmérettel.

## Hibaelhárítás

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| Az események `invalid` státuszt kapnak | Hiányzó kötelező mezők | Győződj meg róla, hogy minden eseményen be van állítva a `user_id` vagy `device_id` |
| A felhasználói tulajdonságok nem szinkronizálódnak | Rossz tulajdonság-operátor | Beállításhoz használd a `$set`, első érintéshez a `$setOnce` operátort |
| Kohort exportálás üres | A kohort még számítódik | Várj a kohort-számítás befejezéséig exportálás előtt |
| 429 Too Many Requests | Ráta-korlát túllépve | Implementálj exponenciális visszalépést és használd a batch API-t |
| Bevétel nem kerül követésre | Hiányzó bevételi mezők | Incl `price`, `quantity` és `revenue` értékeket az esemény tulajdonságokban |
| Az EU-adatok nem irányítódnak | Rossz adatközpont | Állítsd be a `data_center: "EU"` értéket és használd az `api.eu.amplitude.com` végpontot |

## Legjobb gyakorlatok

1. **Használd a HTTP V2 API-t** – Az örökölt HTTP API helyett a V2 API-t részesítsd előnyben a jobb validálásért és hibaválaszokért
2. **Kötegelj eseményeket** – Küldj eseményeket legfeljebb 1 000-es kötegekben az optimális átvitelért
3. **Állíts be felhasználói tulajdonságokat az eseményeken** – Incl `user_properties` a track eseményeken az identify hívások csökkentéséhez
4. **Kohortokat használj szegmentáláshoz** – Szinkronizálj viselkedési kohortokat az összetett szegmentálási logika replikálása helyett
5. **Bevételi eseményeket megfelelően kövesd** – Használd a `revenue`, `price` és `productId` mezőket a pontos bevételkövetéshez
6. **Figyeld az ingestion egészségét** – Ellenőrizd az Amplitude Ingestion Debuggerét esemény-validálási hibákhoz
7. **Implementálj szerver oldali követést** – Megbízható eseménykézbesítéshez használj szerver oldali SDK-kat

## Biztonság

- **Csak HTTPS** – Minden API kommunikáció legalább TLS 1.2+-t igényel
- **API kulcs rotáció** – Forgasd a titkos kulcsokat rendszeresen az Amplitude beállításokban
- **IP engedélyezési lista** – Enterprise csomagokon elérhető
- **SOC 2 Type II** – Az Amplitude SOC 2 Type II tanúsítvánnyal rendelkezik
- **GDPR/CCPA** – Felhasználói adattörlési és exportálási kérelmek támogatása
- **EU adatrezidencia** – EU adatközpont opció elérhető

## Kapcsolódó források

- [Segment konnektor](https://tajo.io/hu/docs/connectors/custom/segment)
- [Mixpanel konnektor](https://tajo.io/hu/docs/connectors/custom/mixpanel)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)
- [Brevo Events API](https://tajo.io/hu/docs/events-engagement/create-event)