---
title: "Amplitude konektor"
description: "Kompletný sprievodca integráciou Amplitude na synchronizáciu produktových analytických udalostí, vlastností používateľov a behaviorálnych kohort s Brevo cez Tajo."
url: https://tajo.io/sk/docs/connectors/custom/amplitude/
markdown: https://tajo.io/sk/docs/connectors/custom/amplitude.md
lang: sk-SK
robots: noindex
---

Požiadajte o skorý prístup

Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo.

# Amplitude konektor

Stav konektora: Plánované Zatiaľ nevytvorené. Tajo tento konektor dnes neprevádzkuje.

| Zdrojové pole | Cieľové pole | Ukážková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Prepoj Amplitude s Brevo cez Tajo a využi dáta produktovej analytiky pre marketingovú automatizáciu. Synchronizuj behaviorálne kohorty, vlastnosti používateľov a produktové udalosti na napájanie cielených kampaní.

## Prehľad

| Vlastnosť | Hodnota |
| --- | --- |
| **Platforma** | Amplitude |
| **Kategória** | Analytika (Vlastná) |
| **Zložitosť nastavenia** | Stredná |
| **Oficiálna integrácia** | Nie |
| **Synchronizované dáta** | Udalosti, Používatelia, Kohorty, Vlastnosti |
| **Dostupné skilly** | 6 |

## Funkcie

- **Preposielanie udalostí** - Posielajaj track udalosti Amplitude do Brevo pre spúšťače marketingovej automatizácie
- **Synchronizácia kohort** - Exportuj behaviorálne kohorty Amplitude ako zoznamy kontaktov v Brevo
- **Synchronizácia vlastností používateľov** - Namapuj vlastnosti používateľov Amplitude na atribúty kontaktov v Brevo
- **Sledovanie príjmov** - Synchronizuj udalosti príjmov pre analýzu celoživotnej hodnoty zákazníka
- **Behaviorálna segmentácia** - Použi dáta o zapojení z Amplitude v segmentoch Brevo
- **Integrácia HTTP V2 API** - Priama integrácia s HTTP V2 ingestion API Amplitude

## Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Amplitude účet s vytvoreným projektom
2. API Key a Secret Key Amplitude
3. Brevo účet s API prístupom
4. Tajo účet s API prihlasovacími údajmi

## Autentifikácia

### API kľúče Amplitude

Amplitude používa páry API Key a Secret Key na autentifikáciu. API Key identifikuje tvoj projekt, zatiaľ čo Secret Key overuje požiadavky na strane servera.

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

### Autentifikácia HTTP V2 API

HTTP V2 API používa API kľúč v tele požiadavky:

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

## Konfigurácia

### Základné nastavenie

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

### Mapovanie udalostí

Namapuj udalosti Amplitude na spúšťače automatizácie v Brevo:

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

### Mapovanie vlastností používateľov

Namapuj vlastnosti používateľov Amplitude na atribúty kontaktov v Brevo:

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

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `POST` | `/2/httpapi` | Nahranie udalostí (HTTP V2 API) |
| `POST` | `/batch` | Hromadné nahranie udalostí (Batch API) |
| `POST` | `/identify` | Nastavenie vlastností používateľa |
| `POST` | `/groupidentify` | Nastavenie vlastností skupiny |
| `GET` | `/2/export` | Export raw dát udalostí |
| `GET` | `/2/usersearch` | Vyhľadávanie používateľov |
| `GET` | `/2/useractivity` | Časová os aktivity používateľa |
| `POST` | `/api/3/cohort/export` | Export členov kohorty |
| `GET` | `/api/3/chart/{chart_id}/query` | Dopyt uložených dát grafu |

## Ukážky kódu

### Inicializácia konektora Amplitude

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

### Odosielanie udalostí cez HTTP V2 API

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

### Synchronizácia kohorty do zoznamu Brevo

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

## Obmedzenia rýchlosti

| API | Limit | Podrobnosti |
| --- | --- | --- |
| **HTTP V2 API** | 1 000 udalostí/sek | Na projekt, burst až 2 000/sek |
| **Batch API** | 1 000 udalostí/dávka | Max 20 dávok/sek |
| **Identify API** | 1 000 požiadaviek/sek | Na projekt |
| **Export API** | 360 požiadaviek/hodinu | Na projekt |
| **Export kohorty** | 1 súbežný export | Na kohortu |
| **Dashboard REST API** | 360 požiadaviek/hodinu | Na projekt |

Limity veľkosti udalostí

Každý payload udalosti nesmie presiahnuť 1 MB. HTTP V2 API prijíma až 2 000 udalostí na požiadavku s max veľkosťou tela 20 MB.

## Riešenie problémov

| Problém | Príčina | Riešenie |
| --- | --- | --- |
| Udalosti majú stav `invalid` | Chýbajúce povinné polia | Uisti sa, že každá udalosť má nastavený `user_id` alebo `device_id` |
| Vlastnosti používateľa sa nesynchronizujú | Nesprávny operátor vlastnosti | Použi `$set` pre nastavenie, `$setOnce` pre hodnoty prvého kontaktu |
| Export kohorty je prázdny | Kohorta sa ešte vypočítava | Počkaj na dokončenie výpočtu kohorty pred exportom |
| 429 Too Many Requests | Prekročenie limitu | Implementuj exponenciálny backoff a použi batch API |
| Príjmy sa nesledujú | Chýbajúce polia príjmov | Zahrň `price`, `quantity` a `revenue` do vlastností udalosti |
| EU dáta sa nesmrúvajú | Nesprávne dátové centrum | Nastav `data_center: "EU"` a použi `api.eu.amplitude.com` |

## Odporúčané postupy

1. **Použi HTTP V2 API** - Preferuj V2 API pred starším HTTP API pre lepšiu validáciu a chybové odpovede
2. **Dávkuj udalosti** - Posielajaj udalosti v dávkach až 1 000 pre optimálnu priepustnosť
3. **Nastavuj vlastnosti používateľov v udalostiach** - Zahrň `user_properties` do track udalostí na zníženie počtu identify volaní
4. **Použi kohorty pre segmentáciu** - Synchronizuj behaviorálne kohorty namiesto replikovania komplexnej segmentačnej logiky
5. **Správne sleduj udalosti príjmov** - Použi polia `revenue`, `price` a `productId` pre presné sledovanie príjmov
6. **Sleduj zdravie ingestion** - Skontroluj Ingestion Debugger v Amplitude pre chyby validácie udalostí
7. **Implementuj server-side sledovanie** - Použi server-side SDK pre spoľahlivé doručenie udalostí

## Bezpečnosť

- **Iba HTTPS** - Všetka API komunikácia vyžaduje TLS 1.2+
- **Rotácia API kľúčov** - Pravidelne rotuj Secret Keys cez nastavenia Amplitude
- **IP allowlisting** - Dostupné na Enterprise plánoch
- **SOC 2 Type II** - Amplitude je certifikovaný podľa SOC 2 Type II
- **GDPR/CCPA** - Podpora pre mazanie a export dát používateľov
- **Rezidencia dát v EÚ** - Dostupná možnosť dátového centra v EÚ

## Súvisiace zdroje

- [Segment konektor](https://tajo.io/sk/docs/connectors/custom/segment)
- [Mixpanel konektor](https://tajo.io/sk/docs/connectors/custom/mixpanel)
- [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync)
- [Brevo Events API](https://tajo.io/sk/docs/events-engagement/create-event)