---
title: "Konektor Amplitude"
description: "Kompletny przewodnik integracji Amplitude do synchronizacji zdarzeń analityki produktowej, właściwości użytkowników i kohort behawioralnych z Brevo przez Tajo."
url: https://tajo.io/pl/docs/connectors/custom/amplitude/
markdown: https://tajo.io/pl/docs/connectors/custom/amplitude.md
lang: pl-PL
robots: noindex
---

Poproś o wcześniejszy dostęp

Podaj imię i firmowy adres e-mail. Wyślemy Ci link potwierdzający prośbę o dostęp do Tajo.

# Konektor Amplitude

Status konektora: Planowany Jeszcze niezbudowany. Tajo nie uruchamia dziś tego konektora.

| Pole źródłowe | Pole docelowe | Przykładowa wartość |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Połącz Amplitude z Brevo przez Tajo, aby wykorzystać dane analityki produktowej do automatyzacji marketingu. Synchronizuj behawioralne kohorty, właściwości użytkowników i zdarzenia produktowe, aby zasilać ukierunkowane kampanie.

## Przegląd

| Właściwość | Wartość |
| --- | --- |
| **Platforma** | Amplitude |
| **Kategoria** | Analityka (Niestandardowa) |
| **Poziom konfiguracji** | Średni |
| **Integracja oficjalna** | Nie |
| **Synchronizowane dane** | Zdarzenia, Użytkownicy, Kohorty, Właściwości |
| **Dostępne Skills** | 6 |

## Funkcje

- **Przekazywanie zdarzeń** - Wysyłaj zdarzenia śledzenia Amplitude do Brevo jako wyzwalacze automatyzacji marketingu
- **Synchronizacja kohort** - Eksportuj behawioralne kohorty Amplitude jako listy kontaktów Brevo
- **Synchronizacja właściwości użytkowników** - Mapuj właściwości użytkowników Amplitude na atrybuty kontaktów Brevo
- **Śledzenie przychodów** - Synchronizuj zdarzenia przychodów dla analizy wartości klienta w całym cyklu życia
- **Segmentacja behawioralna** - Używaj danych zaangażowania z Amplitude w segmentach Brevo
- **Integracja HTTP V2 API** - Bezpośrednia integracja z API pozyskiwania HTTP V2 Amplitude

## Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

1. Konto Amplitude z utworzonym projektem
2. Klucz API i Secret Key Amplitude
3. Konto Brevo z dostępem do API
4. Konto Tajo z danymi uwierzytelniającymi API

## Uwierzytelnianie

### Klucze API Amplitude

Amplitude używa par klucza API i Secret Key do uwierzytelniania. Klucz API identyfikuje twój projekt, a Secret Key uwierzytelnia żądania po stronie serwera.

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

### Uwierzytelnianie HTTP V2 API

HTTP V2 API używa klucza API w treści żądania:

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

## Konfiguracja

### Podstawowa konfiguracja

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

### Mapowanie zdarzeń

Mapuj zdarzenia Amplitude na wyzwalacze automatyzacji 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"
```

### Mapowanie właściwości użytkowników

Mapuj właściwości użytkowników Amplitude na atrybuty kontaktów 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
```

## Endpointy API

| Metoda | Endpoint | Opis |
| --- | --- | --- |
| `POST` | `/2/httpapi` | Prześlij zdarzenia (HTTP V2 API) |
| `POST` | `/batch` | Zbiorcze przesyłanie zdarzeń (Batch API) |
| `POST` | `/identify` | Ustaw właściwości użytkownika |
| `POST` | `/groupidentify` | Ustaw właściwości grupy |
| `GET` | `/2/export` | Eksportuj surowe dane zdarzeń |
| `GET` | `/2/usersearch` | Wyszukaj użytkowników |
| `GET` | `/2/useractivity` | Pobierz oś czasu aktywności użytkownika |
| `POST` | `/api/3/cohort/export` | Eksportuj członków kohorty |
| `GET` | `/api/3/chart/{chart_id}/query` | Odpytaj dane zapisanego wykresu |

## Przykłady kodu

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

### Wysyłaj zdarzenia przez 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 }
```

### Synchronizuj kohortę z listą 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
// }
```

## Limity API

| API | Limit | Szczegóły |
| --- | --- | --- |
| **HTTP V2 API** | 1 000 zdarzeń/sek | Na projekt, burst do 2 000/sek |
| **Batch API** | 1 000 zdarzeń/partia | Maks. 20 partii/sek |
| **Identify API** | 1 000 żądań/sek | Na projekt |
| **Export API** | 360 żądań/godzinę | Na projekt |
| **Eksport kohorty** | 1 współbieżny eksport | Na kohortę |
| **Dashboard REST API** | 360 żądań/godzinę | Na projekt |

Limity rozmiaru zdarzeń

Każdy ładunek zdarzenia nie może przekraczać 1 MB. HTTP V2 API akceptuje do 2 000 zdarzeń na żądanie z maksymalnym rozmiarem treści 20 MB.

## Rozwiązywanie problemów

| Problem | Przyczyna | Rozwiązanie |
| --- | --- | --- |
| Zdarzenia zwracają status `invalid` | Brak wymaganych pól | Upewnij się, że `user_id` lub `device_id` jest ustawiony na każdym zdarzeniu |
| Właściwości użytkownika nie synchronizują się | Zły operator właściwości | Używaj `$set` do ustawiania, `$setOnce` dla wartości first-touch |
| Eksport kohorty pusty | Kohorta wciąż obliczana | Poczekaj na zakończenie obliczeń kohorty przed eksportem |
| 429 Too Many Requests | Przekroczono limit | Wdrożyj wykładnicze wycofanie i używaj batch API |
| Przychody nie śledzą | Brak pól przychodów | Uwzględnij `price`, `quantity` i `revenue` w właściwościach zdarzeń |
| Dane EU nie przekierowują | Zły data center | Ustaw `data_center: "EU"` i używaj `api.eu.amplitude.com` |

## Najlepsze praktyki

1. **Używaj HTTP V2 API** - Preferuj V2 API nad starszym HTTP API dla lepszej walidacji i odpowiedzi błędów
2. **Wsaduj zdarzenia** - Wysyłaj zdarzenia w partiach do 1 000 dla optymalnej przepustowości
3. **Ustaw właściwości użytkownika na zdarzeniach** - Uwzględnij `user_properties` na zdarzeniach śledzenia, aby zmniejszyć wywołania identify
4. **Używaj kohort do segmentacji** - Synchronizuj behawioralne kohorty zamiast replikowania złożonej logiki segmentacji
5. **Właściwie śledź zdarzenia przychodów** - Używaj pól `revenue`, `price` i `productId` dla dokładnego śledzenia przychodów
6. **Monitoruj kondycję pozyskiwania** - Sprawdzaj Ingestion Debugger Amplitude pod kątem błędów walidacji zdarzeń
7. **Wdrożyj śledzenie po stronie serwera** - Używaj SDK po stronie serwera dla niezawodnego dostarczania zdarzeń

## Bezpieczeństwo

- **Tylko HTTPS** - Cała komunikacja API wymaga TLS 1.2+
- **Rotacja kluczy API** - Regularnie rotuj Secret Keys przez ustawienia Amplitude
- **Allowlisting IP** - Dostępne w planach Enterprise
- **SOC 2 Type II** - Amplitude posiada certyfikat SOC 2 Type II
- **RODO/CCPA** - Obsługa żądań usunięcia i eksportu danych użytkownika
- **Rezydencja danych UE** - Dostępna opcja centrum danych UE

## Powiązane zasoby

- [Konektor Segment](https://tajo.io/pl/docs/connectors/custom/segment)
- [Konektor Mixpanel](https://tajo.io/pl/docs/connectors/custom/mixpanel)
- [Skill synchronizacji klientów](https://tajo.io/pl/docs/skills/data-sync/customer-sync)
- [Brevo Events API](https://tajo.io/pl/docs/events-engagement/create-event)