---
title: "Amplitude konektor"
description: "Kompletan vodič za Amplitude integraciju za sinhronizaciju događaja analize proizvoda, korisničkih svojstava i bihevioralnih kohorti sa Brevo putem Tajo."
url: https://tajo.io/sr/docs/connectors/custom/amplitude/
markdown: https://tajo.io/sr/docs/connectors/custom/amplitude.md
lang: sr-Latn-RS
robots: noindex
---

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslaćemo vam vezu za potvrdu zahteva za pristup Taju.

# Amplitude konektor

Status konektora: Planirano Još nije izrađeno. Tajo danas ne pokreće ovaj konektor.

| Izvorno polje | Odredišno polje | Primer vrednosti |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Poveži Amplitude sa Brevo putem Tajo kako bi iskoristio/la podatke o analizi proizvoda za marketing automatizaciju. Sinhronizuj bihevioralne kohorte, korisnička svojstva i događaje o proizvodu za pokretanje ciljanih kampanja.

## Pregled

| Svojstvo | Vrednost |
| --- | --- |
| **Platforma** | Amplitude |
| **Kategorija** | Analitika (Prilagođeno) |
| **Složenost podešavanja** | Srednje |
| **Zvanična integracija** | Ne |
| **Sinhronizovani podaci** | Događaji, Korisnici, Kohorte, Svojstva |
| **Dostupne veštine** | 6 |

## Karakteristike

- **Prosleđivanje događaja** - Slanje Amplitude track događaja u Brevo za okidače marketing automatizacije
- **Sinhronizacija kohorti** - Izvoz Amplitude bihevioralnih kohorti kao Brevo lista kontakata
- **Sinhronizacija korisničkih svojstava** - Mapiranje Amplitude korisničkih svojstava na Brevo atribute kontakta
- **Praćenje prihoda** - Sinhronizacija događaja prihoda za analizu lifetime vrednosti kupca
- **Bihevioralna segmentacija** - Korišćenje Amplitude podataka o angažovanju u Brevo segmentima
- **HTTP V2 API integracija** - Direktna integracija sa Amplitude HTTP V2 API za unos

## Preduslovi

Pre nego što započneš, proveri da imaš:

1. Amplitude nalog sa kreiranim projektom
2. Tvoj Amplitude API Key i Secret Key
3. Brevo nalog sa API pristupom
4. Tajo nalog sa API kredencijalima

## Autentifikacija

### Amplitude API ključevi

Amplitude koristi parove API Key i Secret Key za autentifikaciju. API Key identifikuje tvoj projekat, dok Secret Key autentifikuje server-side zahteve.

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

### HTTP V2 API autentifikacija

HTTP V2 API koristi API ključ u telu zahteva:

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

## Konfiguracija

### Osnovno podešavanje

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

### Mapiranje događaja

Mapiranje Amplitude događaja na okidače Brevo automatizacije:

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

### Mapiranje korisničkih svojstava

Mapiranje Amplitude korisničkih svojstava na Brevo atribute kontakta:

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

| Metoda | Endpoint | Opis |
| --- | --- | --- |
| `POST` | `/2/httpapi` | Otpremanje događaja (HTTP V2 API) |
| `POST` | `/batch` | Grupno otpremanje događaja (Batch API) |
| `POST` | `/identify` | Postavljanje korisničkih svojstava |
| `POST` | `/groupidentify` | Postavljanje grupnih svojstava |
| `GET` | `/2/export` | Izvoz sirovih podataka o događajima |
| `GET` | `/2/usersearch` | Pretraga korisnika |
| `GET` | `/2/useractivity` | Dohvatanje vremenske linije aktivnosti korisnika |
| `POST` | `/api/3/cohort/export` | Izvoz članova kohorte |
| `GET` | `/api/3/chart/{chart_id}/query` | Upit sačuvanih podataka grafikona |

## Primeri koda

### Inicijalizacija Amplitude konektora

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

### Slanje događaja putem 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 }
```

### Sinhronizacija kohorte sa Brevo listom

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

## Ograničenja brzine

| API | Limit | Detalji |
| --- | --- | --- |
| **HTTP V2 API** | 1.000 događaja/sek | Po projektu, burst do 2.000/sek |
| **Batch API** | 1.000 događaja/batch | Maksimalno 20 batch-eva/sek |
| **Identify API** | 1.000 zahteva/sek | Po projektu |
| **Export API** | 360 zahteva/sat | Po projektu |
| **Cohort Export** | 1 istovremeni izvoz | Po kohorti |
| **Dashboard REST API** | 360 zahteva/sat | Po projektu |

Ograničenja veličine događaja

Svaki payload događaja ne sme prelaziti 1 MB. HTTP V2 API prihvata do 2.000 događaja po zahtevu sa maksimalnom veličinom tela od 20 MB.

## Rešavanje problema

| Problem | Uzrok | Rešenje |
| --- | --- | --- |
| Događaji imaju `invalid` status | Nedostaju obavezna polja | Proveri da je `user_id` ili `device_id` postavljen na svakom događaju |
| Korisnička svojstva se ne sinhronizuju | Pogrešan operator svojstva | Koristi `$set` za postavljanje, `$setOnce` za vrednosti prvog dodira |
| Izvoz kohorte je prazan | Kohorta se još računa | Sačekaj da se izračunavanje kohorte završi pre izvoza |
| 429 Too Many Requests | Prekoračen limit brzine | Implementiraj eksponencijalno usporavanje i koristi batch API |
| Prihod se ne prati | Nedostaju polja prihoda | Uključi `price`, `quantity` i `revenue` u svojstvima događaja |
| EU podaci se ne rutiraju | Pogrešan data center | Postavi `data_center: "EU"` i koristi `api.eu.amplitude.com` |

## Najbolje prakse

1. **Koristi HTTP V2 API** - Preferiraj V2 API umesto zastarelog HTTP API za bolju validaciju i odgovore o greškama
2. **Grupiši događaje** - Šalji događaje u batch-evima do 1.000 za optimalni propusni opseg
3. **Postavi korisnička svojstva na događajima** - Uključi `user_properties` na track događajima da smanjiš identify pozive
4. **Koristi kohorte za segmentaciju** - Sinhronizuj bihevioralne kohorte umesto repliciranja složene logike segmentacije
5. **Pravilno prati događaje prihoda** - Koristi polja `revenue`, `price` i `productId` za tačno praćenje prihoda
6. **Prati zdravlje unosa** - Proveri Amplitude Ingestion Debugger za greške validacije događaja
7. **Implementiraj server-side praćenje** - Koristi server-side SDK-ove za pouzdanu isporuku događaja

## Bezbednost

- **Samo HTTPS** - Sva API komunikacija zahteva TLS 1.2+
- **Rotacija API ključeva** - Periodično rotiraj Secret Keys putem Amplitude podešavanja
- **IP allowlisting** - Dostupno na Enterprise planovima
- **SOC 2 Type II** - Amplitude je SOC 2 Type II sertifikovan
- **GDPR/CCPA** - Podrška za brisanje i izvoz korisničkih podataka
- **EU rezidencija podataka** - Dostupna opcija EU data centra

## Povezani resursi

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