---
title: "Amplitude-koppling"
description: "Komplett integrationsguide för Amplitude för att synkronisera produktanalyshändelser, användaregenskaper och beteendekohorter med Brevo via Tajo."
url: https://tajo.io/se/docs/connectors/custom/amplitude/
markdown: https://tajo.io/se/docs/connectors/custom/amplitude.md
lang: sv-SE
robots: noindex
---

Ansök om tidig åtkomst

Ange ditt förnamn och din e-postadress på jobbet. Vi skickar en länk för att bekräfta din begäran om åtkomst till Tajo.

# Amplitude-koppling

Kopplingens status: Planerad Inte byggd än. Tajo kör inte den här kopplingen i dag.

| Källfält | Målfält | Exempelvärde |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Anslut Amplitude till Brevo via Tajo för att utnyttja data från produktanalys för marknadsautomation. Synka beteendekohorter, användaregenskaper och produkthändelser för att driva målinriktade kampanjer.

## Översikt

| Egenskap | Värde |
| --- | --- |
| **Plattform** | Amplitude |
| **Kategori** | Analys (Anpassad) |
| **Installationskomplexitet** | Medel |
| **Officiell integration** | Nej |
| **Data som synkas** | Händelser, användare, kohorter, egenskaper |
| **Tillgängliga skills** | 6 |

## Funktioner

- **Vidarebefordran av händelser** - Skicka Amplitude-track-händelser till Brevo för att utlösa marknadsautomation
- **Kohortsynkronisering** - Exportera Amplitudes beteendekohorter som Brevo-kontaktlistor
- **Synkronisering av användaregenskaper** - Mappa Amplitude-användaregenskaper till Brevo-kontaktattribut
- **Intäktsspårning** - Synka intäktshändelser för analys av kundens livstidsvärde
- **Beteendesegmentering** - Använd Amplitudes engagemangsdata i Brevo-segment
- **Integration med HTTP V2 API** - Direkt integration med Amplitudes HTTP V2-ingestions-API

## Förutsättningar

Innan du börjar, se till att du har:

1. Ett Amplitude-konto med ett skapat projekt
2. Din Amplitude API Key och Secret Key
3. Ett Brevo-konto med API-åtkomst
4. Ett Tajo-konto med API-uppgifter

## Autentisering

### Amplitude API-nycklar

Amplitude använder par av API Key och Secret Key för autentisering. API-nyckeln identifierar ditt projekt, medan Secret Key autentiserar serversidans förfrågningar.

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

### Autentisering för HTTP V2 API

HTTP V2 API använder API-nyckeln i förfrågningens body:

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

## Konfiguration

### Grundinställning

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

### Händelsemappning

Mappa Amplitude-händelser till Brevo-automationsutlösare:

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

### Mappning av användaregenskaper

Mappa Amplitude-användaregenskaper till Brevo-kontaktattribut:

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

| Metod | Endpoint | Beskrivning |
| --- | --- | --- |
| `POST` | `/2/httpapi` | Ladda upp händelser (HTTP V2 API) |
| `POST` | `/batch` | Mass-uppladdning av händelser (Batch API) |
| `POST` | `/identify` | Ställ in användaregenskaper |
| `POST` | `/groupidentify` | Ställ in gruppegenskaper |
| `GET` | `/2/export` | Exportera rå händelsedata |
| `GET` | `/2/usersearch` | Sök efter användare |
| `GET` | `/2/useractivity` | Hämta tidslinje för användaraktivitet |
| `POST` | `/api/3/cohort/export` | Exportera kohortmedlemmar |
| `GET` | `/api/3/chart/{chart_id}/query` | Fråga data från sparat diagram |

## Kodexempel

### Initiera Amplitude-kopplingen

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

### Skicka händelser via 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 }
```

### Synka kohort till Brevo-lista

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

## Hastighetsbegränsningar

| API | Gräns | Detaljer |
| --- | --- | --- |
| **HTTP V2 API** | 1 000 händelser/sek | Per projekt, burst upp till 2 000/sek |
| **Batch API** | 1 000 händelser/batch | Max 20 batcher/sek |
| **Identify API** | 1 000 förfr./sek | Per projekt |
| **Export API** | 360 förfrågningar/timme | Per projekt |
| **Cohort Export** | 1 samtidig export | Per kohort |
| **Dashboard REST API** | 360 förfrågningar/timme | Per projekt |

Storleksgränser för händelser

Varje händelsenyttolast får inte överstiga 1 MB. HTTP V2 API accepterar upp till 2 000 händelser per förfrågan med max body-storlek 20 MB.

## Felsökning

| Problem | Orsak | Lösning |
| --- | --- | --- |
| Händelser returnerar status `invalid` | Obligatoriska fält saknas | Säkerställ att `user_id` eller `device_id` är satt på varje händelse |
| Användaregenskaper synkas inte | Fel egenskapsoperator | Använd `$set` för inställning, `$setOnce` för förstagångsvärden |
| Tom kohortexport | Kohort beräknas fortfarande | Vänta tills kohortberäkningen är klar innan export |
| 429 Too Many Requests | Hastighetsbegränsning överskriden | Implementera exponentiell backoff och använd batch-API |
| Intäkter spåras inte | Saknar intäktsfält | Inkludera `price`, `quantity` och `revenue` i händelseegenskaper |
| EU-data routas inte | Fel datacenter | Sätt `data_center: "EU"` och använd `api.eu.amplitude.com` |

## Bästa praxis

1. **Använd HTTP V2 API** - Föredra V2-API:et framför det äldre HTTP API:et för bättre validering och felsvar
2. **Batcha händelser** - Skicka händelser i batcher om upp till 1 000 för optimal genomströmning
3. **Sätt användaregenskaper på händelser** - Inkludera `user_properties` på track-händelser för att minska identify-anrop
4. **Använd kohorter för segmentering** - Synka beteendekohorter istället för att replikera komplex segmenteringslogik
5. **Spåra intäktshändelser korrekt** - Använd fälten `revenue`, `price` och `productId` för noggrann intäktsspårning
6. **Övervaka ingestionshälsa** - Kontrollera Amplitudes Ingestion Debugger för valideringsfel på händelser
7. **Implementera server-side tracking** - Använd server-side SDK:er för tillförlitlig händelseleverans

## Säkerhet

- **Endast HTTPS** - All API-kommunikation kräver TLS 1.2+
- **Rotation av API-nycklar** - Rotera Secret Keys periodiskt via Amplitude-inställningar
- **IP-allowlisting** - Tillgängligt i Enterprise-planer
- **SOC 2 Type II** - Amplitude är SOC 2 Type II-certifierat
- **GDPR/CCPA** - Stöd för förfrågningar om radering och export av användardata
- **EU-dataresidens** - EU-datacenteralternativ tillgängligt

## Relaterade resurser

- [Segment-koppling](https://tajo.io/se/docs/connectors/custom/segment)
- [Mixpanel-koppling](https://tajo.io/se/docs/connectors/custom/mixpanel)
- [Skill för kundsynkronisering](https://tajo.io/se/docs/skills/data-sync/customer-sync)
- [Brevo Events API](https://tajo.io/se/docs/events-engagement/create-event)