---
title: "Konektor Amplitude"
description: "Kompletní průvodce integrací Amplitude pro synchronizaci analytických událostí produktů, vlastností uživatelů a behaviorálních kohort s Brevo přes Tajo."
url: https://tajo.io/cz/docs/connectors/custom/amplitude/
markdown: https://tajo.io/cz/docs/connectors/custom/amplitude.md
lang: cs-CZ
robots: noindex
---

Požádejte o přednostní přístup

Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo.

# Konektor Amplitude

Stav konektoru: Plánováno Zatím nevytvořeno. Tajo tento konektor dnes neprovozuje.

| Zdrojové pole | Cílové pole | Ukázková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Propojte Amplitude s Brevo přes Tajo, abyste využili data produktové analytiky pro marketingovou automatizaci. Synchronizujte behaviorální kohorty, vlastnosti uživatelů a produktové události pro spouštění cílených kampaní.

## Přehled

| Vlastnost | Hodnota |
| --- | --- |
| **Platforma** | Amplitude |
| **Kategorie** | Analytika (Vlastní) |
| **Složitost nastavení** | Střední |
| **Oficiální integrace** | Ne |
| **Synchronizovaná data** | Události, Uživatelé, Kohorty, Vlastnosti |
| **Dostupné dovednosti** | 6 |

## Funkce

- **Přeposílání událostí** – Odesílejte track události Amplitude do Brevo jako spouštěče marketingové automatizace
- **Synchronizace kohort** – Exportujte behaviorální kohorty Amplitude jako seznamy kontaktů Brevo
- **Synchronizace vlastností uživatelů** – Mapujte vlastnosti uživatelů Amplitude na atributy kontaktů Brevo
- **Sledování výnosů** – Synchronizujte události příjmů pro analýzu celoživotní hodnoty zákazníka
- **Behaviorální segmentace** – Používejte data zapojení Amplitude v segmentech Brevo
- **Integrace HTTP V2 API** – Přímá integrace s ingestion API HTTP V2 od Amplitude

## Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Amplitude s vytvořeným projektem
2. Váš API klíč a tajný klíč Amplitude
3. Účet Brevo s přístupem k API
4. Účet Tajo s API přihlašovacími údaji

## Ověření

### API klíče Amplitude

Amplitude používá pro ověření páry API klíče a tajného klíče. API klíč identifikuje váš projekt, zatímco tajný klíč ověřuje požadavky na straně serveru.

```bash
# Najděte své klíče v Amplitude:
# Settings > Projects > [Váš projekt] > General
```

### Ověření HTTP V2 API

HTTP V2 API používá API klíč v těle požadavku:

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

## Konfigurace

### Základní nastavení

```yaml
connectors:
  amplitude:
    enabled: true
    api_key: "your-amplitude-api-key"
    secret_key: "your-amplitude-secret-key"
    data_center: "US"  # nebo "EU"

    # Možnosti synchronizace dat
    sync:
      events: true
      user_properties: true
      cohorts: true
      revenue: true

    # Přiřazení seznamů Brevo
    lists:
      active_users: 10
      power_users: 11
      churning_users: 12
```

### Mapování událostí

Mapujte události Amplitude na spouštěče automatizace Brevo:

```yaml
event_mapping:
  # Událost Amplitude -> Událost Brevo
  "Purchase": "order_completed"
  "Sign Up": "customer_created"
  "Add to Cart": "cart_updated"
  "Page View": "page_viewed"
  "Feature Click": "feature_used"

  # Události příjmů
  "Revenue": "revenue_event"
  "Subscription Started": "subscription_created"
```

### Mapování vlastností uživatelů

Mapujte vlastnosti uživatelů Amplitude na atributy kontaktů Brevo:

```yaml
property_mapping:
  # Vlastnost Amplitude -> Atribut Brevo
  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
```

## Koncové body API

| Metoda | Koncový bod | Popis |
| --- | --- | --- |
| `POST` | `/2/httpapi` | Nahrání událostí (HTTP V2 API) |
| `POST` | `/batch` | Hromadné nahrání událostí (Batch API) |
| `POST` | `/identify` | Nastavení vlastností uživatele |
| `POST` | `/groupidentify` | Nastavení vlastností skupiny |
| `GET` | `/2/export` | Export surových dat událostí |
| `GET` | `/2/usersearch` | Vyhledávání uživatelů |
| `GET` | `/2/useractivity` | Získání časové osy aktivity uživatele |
| `POST` | `/api/3/cohort/export` | Export členů kohorty |
| `GET` | `/api/3/chart/{chart_id}/query` | Dotaz na data uloženého grafu |

## Příklady kódu

### Inicializace konektoru Amplitude

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Připojení projektu Amplitude
await tajo.connectors.connect('amplitude', {
  apiKey: process.env.AMPLITUDE_API_KEY,
  secretKey: process.env.AMPLITUDE_SECRET_KEY,
  dataCenter: 'US'
});
```

### Odesílání událostí přes HTTP V2 API

```javascript
// Odeslání událostí do Amplitude (automaticky přeposíláno do 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()
      }
    ]
  })
});

// Očekávaná odpověď: { "code": 200, "events_ingested": 1 }
```

### Synchronizace kohorty do seznamu Brevo

```javascript
// Export kohorty Amplitude a synchronizace do Brevo
const cohort = await tajo.connectors.syncCohort('amplitude', {
  cohortId: 'abc123',
  targetList: 11,  // ID seznamu Brevo
  syncMode: 'mirror'  // mirror, append nebo remove
});

console.log(cohort);
// {
//   cohortName: "Power Users",
//   membersCount: 2450,
//   syncedToBrevo: 2450,
//   listId: 11
// }
```

## Omezení rychlosti

| API | Limit | Podrobnosti |
| --- | --- | --- |
| **HTTP V2 API** | 1 000 událostí/s | Na projekt, burst až 2 000/s |
| **Batch API** | 1 000 událostí/dávka | Max 20 dávek/s |
| **Identify API** | 1 000 požadavků/s | Na projekt |
| **Export API** | 360 požadavků/hodinu | Na projekt |
| **Export kohorty** | 1 souběžný export | Na kohortu |
| **Dashboard REST API** | 360 požadavků/hodinu | Na projekt |

Limity velikosti událostí

Každý payload události nesmí překročit 1 MB. HTTP V2 API přijímá až 2 000 událostí na požadavek s maximální velikostí těla 20 MB.

## Řešení problémů

| Problém | Příčina | Řešení |
| --- | --- | --- |
| Události vrací stav `invalid` | Chybějící povinná pole | Zajistěte, aby bylo `user_id` nebo `device_id` nastaveno u každé události |
| Vlastnosti uživatelů se nesynchronizují | Nesprávný operátor vlastnosti | Používejte `$set` pro nastavení, `$setOnce` pro hodnoty prvního kontaktu |
| Export kohorty je prázdný | Kohorta se stále počítá | Počkejte na dokončení výpočtu kohorty před exportem |
| 429 Too Many Requests | Překročen limit rychlosti | Implementujte exponenciální zpětné odběrání a používejte Batch API |
| Výnosy se nesledují | Chybějící pole příjmů | Zahrňte `price`, `quantity` a `revenue` ve vlastnostech události |
| Data EU se nerouted správně | Nesprávné datové centrum | Nastavte `data_center: "EU"` a používejte `api.eu.amplitude.com` |

## Osvědčené postupy

1. **Používejte HTTP V2 API** – Upřednostňujte V2 API před starším HTTP API pro lepší validaci a chybové odpovědi
2. **Dávkujte události** – Odesílejte události v dávkách až 1 000 pro optimální propustnost
3. **Nastavujte vlastnosti uživatelů na událostech** – Zahrňte `user_properties` do track událostí ke snížení počtu volání identify
4. **Používejte kohorty pro segmentaci** – Synchronizujte behaviorální kohorty místo replikace složité segmentační logiky
5. **Správně sledujte události příjmů** – Používejte pole `revenue`, `price` a `productId` pro přesné sledování výnosů
6. **Monitorujte stav ingestion** – Kontrolujte Ingestion Debugger Amplitude pro chyby validace událostí
7. **Implementujte sledování na straně serveru** – Používejte serverové SDK pro spolehlivé doručování událostí

## Zabezpečení

- **Pouze HTTPS** – Veškerá komunikace API vyžaduje TLS 1.2+
- **Rotace API klíčů** – Pravidelně rotujte tajné klíče přes nastavení Amplitude
- **Whitelisting IP** – Dostupné v plánech Enterprise
- **SOC 2 Type II** – Amplitude je certifikována podle SOC 2 Type II
- **GDPR/CCPA** – Podpora požadavků na mazání a export uživatelských dat
- **Rezidence dat EU** – Dostupná možnost datového centra EU

## Související zdroje

- [Konektor Segment](https://tajo.io/cz/docs/connectors/custom/segment)
- [Konektor Mixpanel](https://tajo.io/cz/docs/connectors/custom/mixpanel)
- [Dovednost synchronizace zákazníků](https://tajo.io/cz/docs/skills/data-sync/customer-sync)
- [API událostí Brevo](https://tajo.io/cz/docs/events-engagement/create-event)