---
title: "Amplitude Connector"
description: "Popoln vodnik za integracijo Amplitude za sinhronizacijo dogodkov produktne analitike, lastnosti uporabnikov in vedenjskih kohort z Brevo prek Tajo."
url: https://tajo.io/sl/docs/connectors/custom/amplitude/
markdown: https://tajo.io/sl/docs/connectors/custom/amplitude.md
lang: sl-SI
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# Amplitude Connector

Stanje konektorja: Načrtovano Še ni izdelano. Tajo danes ne poganja tega konektorja.

| Izvorno polje | Ciljno polje | Vzorčna vrednost |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Poveži Amplitude z Brevo prek Tajo, da izkoristiš podatke produktne analitike za marketinško avtomatizacijo. Sinhronizacija vedenjskih kohort, lastnosti uporabnikov in produktnih dogodkov za pogon ciljanih kampanj.

## Pregled

| Lastnost | Vrednost |
| --- | --- |
| **Platforma** | Amplitude |
| **Kategorija** | Analitika (po meri) |
| **Zahtevnost nastavitve** | Srednja |
| **Uradna integracija** | Ne |
| **Sinhronizirani podatki** | Dogodki, uporabniki, kohorte, lastnosti |
| **Razpoložljivi Skills** | 6 |

## Funkcionalnosti

- **Posredovanje dogodkov** – pošlji sledilne dogodke Amplitude v Brevo za sprožilce marketinške avtomatizacije
- **Sinhronizacija kohort** – izvozi vedenjske kohorte Amplitude kot sezname stikov Brevo
- **Sinhronizacija lastnosti uporabnikov** – preslikaj lastnosti uporabnikov Amplitude v atribute stikov Brevo
- **Sledenje prihodkom** – sinhronizacija dogodkov prihodkov za analizo vrednosti stranke skozi čas
- **Vedenjska segmentacija** – uporabi podatke o angažiranosti Amplitude v segmentih Brevo
- **Integracija HTTP V2 API** – neposredna integracija z HTTP V2 API za vnos Amplitude

## Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun Amplitude z ustvarjenim projektom
2. API ključ in tajni ključ Amplitude
3. Brevo račun z dostopom do API
4. Tajo račun s poverilnicami API

## Avtentikacija

### API ključi Amplitude

Amplitude za avtentikacijo uporablja pare API ključ in tajni ključ. API ključ identificira tvoj projekt, tajni ključ pa avtenticira zahtevke na strani strežnika.

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

### Avtentikacija HTTP V2 API

HTTP V2 API uporablja API ključ v telesu zahtevka:

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

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

### Preslikava dogodkov

Preslikaj dogodke Amplitude v sprožilce avtomatizacije 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"
```

### Preslikava lastnosti uporabnikov

Preslikaj lastnosti uporabnikov Amplitude v atribute stikov 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
```

## Končne točke API

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `POST` | `/2/httpapi` | Naloži dogodke (HTTP V2 API) |
| `POST` | `/batch` | Množično nalaganje dogodkov (Batch API) |
| `POST` | `/identify` | Nastavi lastnosti uporabnika |
| `POST` | `/groupidentify` | Nastavi lastnosti skupine |
| `GET` | `/2/export` | Izvozi surove podatke o dogodkih |
| `GET` | `/2/usersearch` | Iskanje uporabnikov |
| `GET` | `/2/useractivity` | Pridobi časovnico aktivnosti uporabnika |
| `POST` | `/api/3/cohort/export` | Izvozi člane kohorte |
| `GET` | `/api/3/chart/{chart_id}/query` | Poizvedba shranjenih podatkov grafikona |

## Primeri kode

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

### Pošiljanje dogodkov prek 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 s seznamom 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
// }
```

## Omejitve hitrosti

| API | Omejitev | Podrobnosti |
| --- | --- | --- |
| **HTTP V2 API** | 1.000 dogodkov/s | Na projekt, sunki do 2.000/s |
| **Batch API** | 1.000 dogodkov/paket | Največ 20 paketov/s |
| **Identify API** | 1.000 zahtevkov/s | Na projekt |
| **Export API** | 360 zahtevkov/uro | Na projekt |
| **Izvoz kohorte** | 1 sočasni izvoz | Na kohorto |
| **Dashboard REST API** | 360 zahtevkov/uro | Na projekt |

Omejitve velikosti dogodkov

Vsebina posameznega dogodka ne sme preseči 1 MB. HTTP V2 API sprejme do 2.000 dogodkov na zahtevek z največjo velikostjo telesa 20 MB.

## Odpravljanje težav

| Težava | Vzrok | Rešitev |
| --- | --- | --- |
| Dogodki vrnejo status `invalid` | Manjkajoča obvezna polja | Zagotovi, da je `user_id` ali `device_id` nastavljen na vsakem dogodku |
| Lastnosti uporabnika se ne sinhronizirajo | Napačen operator lastnosti | Za nastavljanje uporabi `$set`, za vrednosti prvega dotika `$setOnce` |
| Izvoz kohorte je prazen | Kohorta se še računá | Počakaj, da se računanje kohorte zaključi, preden jo izvoziš |
| 429 Too Many Requests | Prekoračena omejitev hitrosti | Implementiraj eksponentni odlog in uporabi Batch API |
| Prihodki se ne sledijo | Manjkajoča polja prihodkov | V lastnostih dogodka vključi `price`, `quantity` in `revenue` |
| Podatki EU se ne usmerjajo | Napačen podatkovni center | Nastavi `data_center: "EU"` in uporabi `api.eu.amplitude.com` |

## Najboljše prakse

1. **Uporabi HTTP V2 API** – daj prednost V2 API pred zastarelim HTTP API za boljšo validacijo in odgovore na napake
2. **Paketni dogodki** – pošiljaj dogodke v paketih do 1.000 za optimalni pretok
3. **Nastavi lastnosti uporabnikov na dogodkih** – vključi `user_properties` na sledilnih dogodkih za zmanjšanje klicev identify
4. **Uporabi kohorte za segmentacijo** – sinhronizacija vedenjskih kohort namesto podvajanja kompleksne logike segmentacije
5. **Pravilno sledenje prihodkov** – za natančno sledenje prihodkov uporabi polja `revenue`, `price` in `productId`
6. **Spremljaj zdravje vnosa** – v Amplitude Ingestion Debugger preveri napake pri validaciji dogodkov
7. **Implementiraj sledenje na strani strežnika** – za zanesljivo dostavo dogodkov uporabi SDK na strani strežnika

## Varnost

- **Samo HTTPS** – vsa komunikacija API zahteva TLS 1.2+
- **Rotacija API ključev** – periodično menjaj tajne ključe prek nastavitev Amplitude
- **Dovoljeni IP-ji** – na voljo v paketih Enterprise
- **SOC 2 Type II** – Amplitude je certificiran po SOC 2 Type II
- **GDPR/CCPA** – podpora za brisanje in izvoz podatkov uporabnikov
- **Hramba podatkov v EU** – možnost podatkovnega centra v EU

## Povezani viri

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