---
title: "Amplitude Konektor"
description: "Kompletan vodič za integraciju Amplitudea za sinkronizaciju analitičkih događaja, korisničkih svojstava i bihevioralnih kohorti s Brevom putem Taja."
url: https://tajo.io/hr/docs/connectors/custom/amplitude/
markdown: https://tajo.io/hr/docs/connectors/custom/amplitude.md
lang: hr-HR
robots: noindex
---

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju.

# Amplitude Konektor

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

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

Povežite Amplitude s Brevom putem Taja kako biste iskoristili podatke o analitici proizvoda za marketinšku automatizaciju. Sinkronizirajte bihevioralne kohorte, korisnička svojstva i događaje za pokretanje ciljanih kampanja.

## Pregled

| Svojstvo | Vrijednost |
| --- | --- |
| **Platforma** | Amplitude |
| **Kategorija** | Analitika (Prilagođeno) |
| **Složenost postavljanja** | Srednje |
| **Službena integracija** | Ne |
| **Sinkronizirani podaci** | Događaji, Korisnici, Kohorte, Svojstva |
| **Dostupne vještine** | 6 |

## Značajke

- **Prosljeđivanje događaja** - Šaljite Amplitude praćene događaje u Brevo za okidače marketinške automatizacije
- **Sinkronizacija kohorti** - Izvozite Amplitude bihevioralne kohorte kao Brevo popise kontakata
- **Sinkronizacija korisničkih svojstava** - Mapirajte Amplitude korisnička svojstva na Brevo atribute kontakata
- **Praćenje prihoda** - Sinkronizirajte događaje prihoda za analizu životne vrijednosti klijenata
- **Bihevioralna segmentacija** - Koristite Amplitude angažmanske podatke u Brevo segmentima
- **HTTP V2 API integracija** - Izravna integracija s Amplitude HTTP V2 API-jem za unos

## Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Amplitude račun s kreiranim projektom
2. Vaš Amplitude API Key i Secret Key
3. Brevo račun s API pristupom
4. Tajo račun s API vjerodajnicama

## Autentifikacija

### Amplitude API ključevi

Amplitude koristi parove API Key i Secret Key za autentifikaciju. API Key identificira vaš projekt, dok Secret Key autentificira serverske zahtjeve.

```bash
# Pronađite svoje ključeve u Amplitude-u:
# Settings > Projects > [Vaš projekt] > General
```

### Autentifikacija HTTP V2 API-ja

HTTP V2 API koristi API ključ u tijelu zahtjeva:

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

## Konfiguracija

### Osnovna konfiguracija

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

    # Opcije sinkronizacije podataka
    sync:
      events: true
      user_properties: true
      cohorts: true
      revenue: true

    # Dodjela popisa u Brevu
    lists:
      active_users: 10
      power_users: 11
      churning_users: 12
```

### Mapiranje događaja

Mapirajte Amplitude događaje na Brevo okidače automatizacija:

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

  # Događaji prihoda
  "Revenue": "revenue_event"
  "Subscription Started": "subscription_created"
```

### Mapiranje korisničkih svojstava

Mapirajte Amplitude korisnička svojstva na Brevo atribute kontakata:

```yaml
property_mapping:
  # Amplitude svojstvo -> Brevo atribut
  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 krajnje točke

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `POST` | `/2/httpapi` | Učitavanje događaja (HTTP V2 API) |
| `POST` | `/batch` | Skupno učitavanje 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` | Pretraživanje korisnika |
| `GET` | `/2/useractivity` | Dohvaćanje vremenske linije korisničkih aktivnosti |
| `POST` | `/api/3/cohort/export` | Izvoz članova kohorte |
| `GET` | `/api/3/chart/{chart_id}/query` | Upit na pohranjene podatke grafikona |

## Primjeri 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
});

// Povezivanje Amplitude projekta
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-ja

```javascript
// Slanje događaja u Amplitude (automatski se prosljeđuju u 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čekivani odgovor: { "code": 200, "events_ingested": 1 }
```

### Sinkronizacija kohorte s Brevo popisom

```javascript
// Izvoz Amplitude kohorte i sinkronizacija s Brevom
const cohort = await tajo.connectors.syncCohort('amplitude', {
  cohortId: 'abc123',
  targetList: 11,  // Brevo ID popisa
  syncMode: 'mirror'  // mirror, append ili remove
});

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

## Ograničenja brzine

| API | Ograničenje | Detalji |
| --- | --- | --- |
| **HTTP V2 API** | 1.000 događaja/sek | Po projektu, naglo do 2.000/sek |
| **Batch API** | 1.000 događaja/serija | Maks. 20 serija/sek |
| **Identify API** | 1.000 zah./sek | Po projektu |
| **Export API** | 360 zahtjeva/sat | Po projektu |
| **Izvoz kohorte** | 1 istovremeni izvoz | Po kohorti |
| **Dashboard REST API** | 360 zahtjeva/sat | Po projektu |

Ograničenja veličine događaja

Svaki sadržaj događaja ne smije prelaziti 1 MB. HTTP V2 API prihvaća do 2.000 događaja po zahtjevu s maksimalnom veličinom tijela od 20 MB.

## Rješavanje problema

| Problem | Uzrok | Rješenje |
| --- | --- | --- |
| Događaji vraćaju status `invalid` | Nedostaju obavezna polja | Osigurajte da je `user_id` ili `device_id` postavljen na svakom događaju |
| Korisnička svojstva se ne sinkroniziraju | Pogrešan operator svojstava | Koristite `$set` za postavljanje, `$setOnce` za vrijednosti prvog dodira |
| Izvoz kohorte je prazan | Kohorta se još izračunava | Pričekajte da izračun kohorte završi prije izvoza |
| 429 Too Many Requests | Prekoračeno ograničenje brzine | Implementirajte eksponencijalni povratak i koristite batch API |
| Prihod se ne prati | Nedostaju polja prihoda | Uključite `price`, `quantity` i `revenue` u svojstva događaja |
| EU podaci se ne usmjeravaju | Pogrešan podatkovni centar | Postavite `data_center: "EU"` i koristite `api.eu.amplitude.com` |

## Preporučene prakse

1. **Koristite HTTP V2 API** - Preferirajte V2 API umjesto zastarjelog HTTP API-ja za bolje validacije i odgovore na greške
2. **Skupni događaji** - Šaljite događaje u serijama od do 1.000 za optimalni protok
3. **Postavljajte korisnička svojstva na događajima** - Uključite `user_properties` na praćenim događajima za smanjenje poziva identifikacije
4. **Koristite kohorte za segmentaciju** - Sinkronizirajte bihevioralne kohorte umjesto repliciranja složene logike segmentacije
5. **Pravilno pratite događaje prihoda** - Koristite polja `revenue`, `price` i `productId` za točno praćenje prihoda
6. **Pratite zdravlje unosa** - Provjerite Amplitude Ingestion Debugger za greške validacije događaja
7. **Implementirajte praćenje na strani servera** - Koristite serverske SDK-ove za pouzdanu isporuku događaja

## Sigurnost

- **Samo HTTPS** - Sva API komunikacija zahtijeva TLS 1.2+
- **Rotacija API ključeva** - Periodično rotirajte Secret Keyeve putem Amplitude postavki
- **IP dopuštanje** - Dostupno na Enterprise planovima
- **SOC 2 Type II** - Amplitude je SOC 2 Type II certificiran
- **GDPR/CCPA** - Podrška za zahtjeve za brisanje i izvoz korisničkih podataka
- **EU pohrana podataka** - Dostupna opcija EU podatkovnog centra

## Povezani resursi

- [Segment Konektor](https://tajo.io/hr/docs/connectors/custom/segment)
- [Mixpanel Konektor](https://tajo.io/hr/docs/connectors/custom/mixpanel)
- [Vještina sinkronizacije korisnika](https://tajo.io/hr/docs/skills/data-sync/customer-sync)
- [Brevo API događaja](https://tajo.io/hr/docs/events-engagement/create-event)