---
title: "Klaviyo konnektor"
description: "Teljes Klaviyo integrációs útmutató profilok, események, listák, szegmensek és kampányadatok Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/marketing/klaviyo/
markdown: https://tajo.io/hu/docs/connectors/marketing/klaviyo.md
lang: hu-HU
robots: noindex
---

Kérj korai hozzáférést

Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét.

# Klaviyo konnektor

Konnektor állapota: Fejlesztés alatt Készül. Még nincs ellenőrizve.

| Forrásmező | Célmező | Mintaérték |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Csatlakoztasd a Klaviyo-t a Brevóhoz a Tajo segítségével marketing adatok migrálásához vagy szinkronizálásához platformok között. Szinkronizálj profilokat, eseményeket, listákat, szegmenseket, folyamatokat és kampányadatokat az egységesített többcsatornás marketing stratégiáért.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Klaviyo |
| **Kategória** | Marketing |
| **Telepítés bonyolultsága** | Közepes |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Profilok, Események, Listák, Szegmensek, Kampányok |
| **Elérhető Skillek** | 10 |
| **API szabvány** | JSON:API |

## Funkciók

- **Profil-szinkronizáció** – Kétirányú ügyfélprofil-szinkronizálás a Klaviyo és Brevo között
- **Esemény-továbbítás** – Klaviyo nyomon követett események továbbítása a Brevóba automatizálási kiváltókhoz
- **Lista migráció** – Klaviyo listák szinkronizálása Brevo kapcsolatlistákká
- **Szegmens-szinkronizáció** – Klaviyo szegmensek exportálása Brevo listákként vagy szegmensekként
- **Folyamatadatok exportálása** – Folyamat-teljesítményadatok lekérése platformok közötti analitikához
- **Kampány-szinkronizáció** – Kampányok koordinálása a Klaviyo és Brevo csatornák között
- **Katalógus-szinkronizáció** – Termékkatalógusok tükrözése platformok között
- **Kuponkezelés** – Kuponkódok és felhasználási adatok szinkronizálása

## Előfeltételek

Mielőtt elkezdenéd, győződj meg róla, hogy rendelkezel:

1. Egy Klaviyo fiókkal API-hozzáféréssel
2. Egy privát API kulccsal megfelelő hatókörökkel
3. A Klaviyo nyilvános API kulcsával (6 karakteres cégazonosító)
4. Egy Brevo fiókkal API-hozzáféréssel
5. Egy Tajo fiókkal API hitelesítő adatokkal

## Hitelesítés

### Privát API kulcs

A Klaviyo hatókörhöz kötött privát API kulcsokat használ szerver oldali hitelesítéshez. A kulcsot az `Authorization` fejlécben kell megadni:

```bash
curl https://a.klaviyo.com/api/profiles/ \
  -H "Authorization: Klaviyo-API-Key your-private-api-key" \
  -H "revision: 2026-01-15"
```

### API kulcs hatókörök

Konfiguráld a hatóköröket a privát kulcs létrehozásakor:

| Hatókör | Hozzáférés | Leírás |
| --- | --- | --- |
| `profiles` | Olvasás/Teljes | Kapcsolatprofilok elérése |
| `events` | Olvasás/Teljes | Nyomon követett események elérése |
| `lists` | Olvasás/Teljes | Kapcsolatlisták elérése |
| `segments` | Olvasás | Szegmensek elérése |
| `campaigns` | Olvasás | Kampányadatok elérése |
| `metrics` | Olvasás | Metrika-definíciók elérése |
| `flows` | Olvasás | Folyamatkonfigurációk elérése |
| `catalogs` | Olvasás | Termékkatalógusok elérése |

### Nyilvános API kulcs

Kliens oldali nyomon követéshez használd a 6 karakteres cégazonosítót:

```bash
curl -X POST "https://a.klaviyo.com/client/events/?company_id=COMPANY_ID" \
  -H "Content-Type: application/json" \
  -d '{"data": {...}}'
```

### OAuth (Partner integrációk)

A Klaviyo OAuth-t támogat technológiai partnerek számára, jobb biztonságot és magasabb ráta-korlátokat kínálva:

```bash
curl https://a.klaviyo.com/api/profiles/ \
  -H "Authorization: Bearer YOUR_OAUTH_TOKEN" \
  -H "revision: 2026-01-15"
```

## Konfiguráció

### Alapbeállítás

```yaml
connectors:
  klaviyo:
    enabled: true
    private_api_key: "your-klaviyo-private-key"
    public_api_key: "XXXXXX"
    api_revision: "2026-01-15"

    # Data sync options
    sync:
      profiles: true
      events: true
      lists: true
      segments: true
      catalogs: false

    # Brevo list assignment
    lists:
      all_contacts: 20
      subscribers: 21
      high_value: 22
```

### Profil-leképezés

Képezd le a Klaviyo profil-tulajdonságokat Brevo kapcsolat-attribútumokhoz:

```yaml
profile_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone_number: SMS
  city: CITY
  region: REGION
  country: COUNTRY
  zip: ZIP
  organization: COMPANY
  title: JOB_TITLE

  # Custom properties
  lifetime_value: LTV
  total_orders: ORDER_COUNT
  last_order_date: LAST_ORDER_DATE
  preferred_channel: CHANNEL_PREF
```

### Esemény-leképezés

Képezd le a Klaviyo metrikákat Brevo eseményekhez:

```yaml
event_mapping:
  "Placed Order": "order_completed"
  "Ordered Product": "product_purchased"
  "Started Checkout": "checkout_started"
  "Added to Cart": "cart_updated"
  "Viewed Product": "product_viewed"
  "Subscribed to List": "customer_subscribed"
  "Received Email": "email_received"
  "Opened Email": "email_opened"
  "Clicked Email": "email_clicked"
```

## API végpontok

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `GET` | `/api/profiles/` | Profilok listázása |
| `POST` | `/api/profiles/` | Profil létrehozása |
| `PATCH` | `/api/profiles/{id}/` | Profil frissítése |
| `POST` | `/api/profile-merge/` | Duplikált profilok összevonása |
| `GET` | `/api/events/` | Események listázása |
| `POST` | `/api/events/` | Esemény létrehozása |
| `GET` | `/api/lists/` | Összes lista listázása |
| `POST` | `/api/lists/{id}/relationships/profiles/` | Profilok hozzáadása listához |
| `GET` | `/api/segments/` | Szegmensek listázása |
| `GET` | `/api/campaigns/` | Kampányok listázása |
| `GET` | `/api/flows/` | Folyamatok listázása |
| `GET` | `/api/metrics/` | Metrikák listázása |
| `POST` | `/api/metric-aggregates/` | Metrika-aggregátumok lekérdezése |
| `GET` | `/api/catalog-items/` | Katalóguselemek listázása |

## Kódpéldák

### A Klaviyo konnektor inicializálása

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Klaviyo account
await tajo.connectors.connect('klaviyo', {
  privateApiKey: process.env.KLAVIYO_PRIVATE_KEY,
  publicApiKey: process.env.KLAVIYO_PUBLIC_KEY
});
```

### Profilok szinkronizálása a Brevóba

```javascript
// Fetch Klaviyo profiles and sync to Brevo
const response = await fetch('https://a.klaviyo.com/api/profiles/', {
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Accept': 'application/vnd.api+json'
  }
});

const { data } = await response.json();

// Each profile follows JSON:API format
// {
//   "type": "profile",
//   "id": "01ABCDEF",
//   "attributes": {
//     "email": "jane@example.com",
//     "first_name": "Jane",
//     "last_name": "Kim",
//     "phone_number": "+15551234567",
//     "properties": { "lifetime_value": 450.00 }
//   }
// }
```

### Esemény létrehozása

```javascript
// Track an event in Klaviyo (forwarded to Brevo via Tajo)
await fetch('https://a.klaviyo.com/api/events/', {
  method: 'POST',
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Content-Type': 'application/vnd.api+json',
    'Accept': 'application/vnd.api+json'
  },
  body: JSON.stringify({
    data: {
      type: 'event',
      attributes: {
        metric: {
          data: { type: 'metric', attributes: { name: 'Placed Order' } }
        },
        profile: {
          data: { type: 'profile', attributes: { email: 'jane@example.com' } }
        },
        properties: {
          OrderId: 'ORD-1234',
          Value: 89.99,
          Items: [
            { ProductName: 'Widget Pro', Price: 89.99, Quantity: 1 }
          ]
        },
        value: 89.99
      }
    }
  })
});
```

### Metrika-aggregátumok lekérdezése

```javascript
// Get aggregate metric data for reporting
await fetch('https://a.klaviyo.com/api/metric-aggregates/', {
  method: 'POST',
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Content-Type': 'application/vnd.api+json'
  },
  body: JSON.stringify({
    data: {
      type: 'metric-aggregate',
      attributes: {
        metric_id: 'METRIC_ID',
        measurements: ['count', 'sum_value'],
        interval: 'day',
        filter: ['greater-or-equal(datetime,2024-01-01)',
                 'less-than(datetime,2024-02-01)']
      }
    }
  })
});
```

## Ráta-korlátok

| Hitelesítés | Burst korlát | Steady korlát |
| --- | --- | --- |
| **Privát API kulcs** | 75 kérés/mp | 700 kérés/perc |
| **OAuth** | 150 kérés/mp | 1 500 kérés/perc |
| **Client API** | 100 kérés/mp | N/A |
| **Bulk műveletek** | 10 kérés/mp | 100 kérés/perc |

Revision fejléc szükséges

Minden Klaviyo API kéréshez szükséges a `revision` fejléc érvényes API verzió dátummal (pl. `2026-01-15`). Az e fejléc nélküli kérések elutasításra kerülnek.

## Hibaelhárítás

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| `400 Bad Request` | Érvénytelen vagy hiányzó API kulcs | Ellenőrizd, hogy a privát API kulcs helyes-e |
| `403 Forbidden` | Elégtelen hatókör | Ellenőrizd, hogy az API kulcs hatókörei megfelelnek-e a szükséges jogosultságoknak |
| Hiányzó `revision` fejléc | Fejléc nincs beállítva | Adj hozzá `revision: 2026-01-15` fejlécet minden kéréshez |
| Profil nem található | Helytelen azonosító | Klaviyo profil azonosítót használj, ne e-mailt a keresésekhez |
| Események nem szinkronizálódnak | Helytelen metrika név | Egyeztesd a metrika neveket a Klaviyo-ban meghatározottakkal |
| `429 Too Many Requests` | Ráta-korlát túllépve | Implementálj exponenciális visszalépést; fontold meg OAuth használatát magasabb korlátokhoz |
| JSON:API formátum hibák | Helytelen tartalomtípus | Használj `application/vnd.api+json` értéket a Content-Type és Accept fejlécekben |

## Legjobb gyakorlatok

1. **Használj JSON:API formátumot** – Kövesd a JSON:API specifikációt minden kérés és válasz terheléshez
2. **Állítsd be a revision fejlécet** – Mindig szerepeltesd a `revision` fejlécet a legújabb API verzió dátummal
3. **Használj sparse fieldset-eket** – Csak a szükséges mezőket kérd le a `?fields[profile]=email,first_name` paraméterrel a terhelés méretének csökkentéséhez
4. **Használd ki a kapcsolatokat** – Használj JSON:API `include` paramétert kapcsolódó erőforrások egyetlen kérésben való lekéréséhez
5. **Használj kurzoros lapozást** – Nagy eredményhalmazokban navigálj a `page[cursor]` paraméterrel
6. **Implementálj bulk műveleteket** – Használj bulk végpontokat tömeges profil-importáláshoz és esemény-létrehozáshoz
7. **Használj OAuth-t magasabb korlátokhoz** – Az OAuth hitelesítés 2x magasabb ráta-korlátokat biztosít a privát kulcsoknál

## Biztonság

- **Privát API kulcs hatókörök** – Részletes Olvasás/Teljes hozzáférés-vezérlés erőforrástípusonként
- **OAuth támogatás** – Biztonságos token alapú hitelesítés partner integrációkhoz
- **Nyilvános kulcs izoláció** – Kliens oldali kulcsok csak létrehozási műveletekre korlátozva
- **TLS 1.2+** – Minden API kommunikáció titkosítva az átvitel során
- **SOC 2 Type II** – A Klaviyo SOC 2 Type II minősítéssel rendelkezik
- **GDPR megfelelőség** – Data Privacy API profil-törlési kérésekhez

## Kapcsolódó források

- [Brevo konnektor](https://tajo.io/hu/docs/connectors/marketing/brevo)
- [Google Ads konnektor](https://tajo.io/hu/docs/connectors/marketing/google-ads)
- [Meta Ads konnektor](https://tajo.io/hu/docs/connectors/marketing/meta-ads)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)