---
title: "Mailchimp konnektor"
description: "Teljes Mailchimp integrációs útmutató közönségek, kampányok, automatizálások és elköteleződési adatok Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/hu/docs/connectors/marketing/mailchimp.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.

# Mailchimp 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 Mailchimp fiókodat a Brevóhoz a Tajo segítségével zökkenőmentes közönség-migrációhoz, kampányadat-szinkronizáláshoz és egységesített marketingautomatizáláshoz mindkét platformon.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Mailchimp |
| **Kategória** | Marketing |
| **Telepítés bonyolultsága** | Könnyű |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Kapcsolatok, Kampányok, Automatizálások, Események |
| **API alap URL** | `https://{dc}.api.mailchimp.com/3.0` |

## Funkciók

- **Közönség-szinkronizáció** – Mailchimp közönségek migrálása és szinkronizálása Brevo kapcsolatlistákkal
- **Kampányadatok** – Kampány-teljesítményadatok szinkronizálása egységesített riportoláshoz
- **Automatizálás migráció** – Mailchimp automatizálások leképezése Brevo munkafolyamatokra
- **Elköteleződési mutatók** – Megnyitások, kattintások és visszapattanási adatok szinkronizálása Brevo attribútumokba
- **Szegmens-leképezés** – Mailchimp szegmensek replikálása Brevo listákként vagy szegmensekként
- **E-kereskedelmi adatok** – Áruházi, termék- és rendelési adatok szinkronizálása a Mailchimp e-kereskedelemből
- **Címke-szinkronizáció** – Mailchimp címkék leképezése Brevo kapcsolat-attribútumokra vagy listákra
- **Sablon migráció** – Mailchimp sablonok exportálása Brevo kampányokhoz való felhasználásra

## Előfeltételek

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

1. Egy Mailchimp fiókkal (Ingyenes, Essentials, Standard vagy Premium csomag)
2. Egy Mailchimp API kulccsal vagy OAuth alkalmazással
3. Egy Brevo fiókkal API-hozzáféréssel
4. Egy Tajo fiókkal

## Hitelesítés

### API kulcs hitelesítés

Generálj API kulcsot a Mailchimp Fiók > Extrák > API kulcsok menüből.

```bash
curl https://{dc}.api.mailchimp.com/3.0/ping \
  --user "anystring:{api_key}" \
  -H "Content-Type: application/json"
```

A `{dc}` adatközpont előtag az API kulcsod utolsó része (pl. `us21`).

### OAuth 2.0

Több fiókos integrációkhoz:

```bash
# Authorization URL
https://login.mailchimp.com/oauth2/authorize?
  response_type=code&
  client_id={client_id}&
  redirect_uri={redirect_uri}

# Token exchange
curl -X POST https://login.mailchimp.com/oauth2/token \
  -d "grant_type=authorization_code" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "redirect_uri={redirect_uri}" \
  -d "code={auth_code}"
```

Adatközpont

Mindig az API kulcsodból vagy az OAuth metaadat-végpontból nyerd ki az adatközpontot. A helytelen adatközpont használata hitelesítési hibákat eredményez.

## Konfiguráció

### Alapbeállítás

```yaml
connectors:
  mailchimp:
    enabled: true
    api_key: "${MAILCHIMP_API_KEY}"
    data_center: "us21"

    # Data sync options
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Audience to Brevo list mapping
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42
```

### Mezőleképezés

Képezd le a Mailchimp összevonási mezőket Brevo kapcsolat-attribútumokhoz:

#### Default Mappings

| Parameter | Type | Description |
| --- | --- | --- |
| `email_address` required | string | Subscriber email (unique identifier) |
| `FNAME` optional | string | First name merge field, maps to FIRSTNAME |
| `LNAME` optional | string | Last name merge field, maps to LASTNAME |
| `PHONE` optional | string | Phone merge field, maps to SMS |
| `status` optional | string | Subscription status (subscribed, unsubscribed, cleaned, pending) |
| `tags` optional | array | Subscriber tags for segmentation |
| `stats.avg_open_rate` optional | number | Average email open rate |
| `stats.avg_click_rate` optional | number | Average email click rate |

#### Egyéni összevonási mező leképezés

```yaml
field_mapping:
  # Standard fields
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Engagement metrics
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # E-commerce fields
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # Custom merge fields
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE
```

## API végpontok

### Közönségek (Listák)

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `GET` | `/3.0/lists` | Összes közönség listázása |
| `GET` | `/3.0/lists/{list_id}` | Közönség részleteinek lekérése |
| `GET` | `/3.0/lists/{list_id}/members` | Közönségtagok listázása |
| `POST` | `/3.0/lists/{list_id}/members` | Tag hozzáadása |
| `PUT` | `/3.0/lists/{list_id}/members/{hash}` | Tag frissítése |
| `POST` | `/3.0/lists/{list_id}` | Tömeges feliratkozás/leiratkozás |

### Kampányok

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `GET` | `/3.0/campaigns` | Kampányok listázása |
| `GET` | `/3.0/campaigns/{id}` | Kampány részleteinek lekérése |
| `GET` | `/3.0/reports/{id}` | Kampányjelentés lekérése |
| `GET` | `/3.0/reports/{id}/email-activity` | E-mail aktivitás lekérése |

### Automatizálások

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `GET` | `/3.0/automations` | Automatizálások listázása |
| `GET` | `/3.0/automations/{id}` | Automatizálás részleteinek lekérése |
| `GET` | `/3.0/automations/{id}/emails` | Automatizálási e-mailek listázása |

### E-kereskedelem

| Módszer | Végpont | Leírás |
| --- | --- | --- |
| `GET` | `/3.0/ecommerce/stores` | Csatlakoztatott áruházak listázása |
| `GET` | `/3.0/ecommerce/stores/{id}/customers` | Áruházi ügyfelek listázása |
| `GET` | `/3.0/ecommerce/stores/{id}/orders` | Áruházi rendelések listázása |
| `GET` | `/3.0/ecommerce/stores/{id}/products` | Áruházi termékek listázása |

## Események

### Kampányesemények

| Esemény | Kiváltó ok | Használati eset |
| --- | --- | --- |
| `campaign.sent` | Kampány kézbesítve | Teljesítmény-követés |
| `campaign.opened` | E-mail megnyitva | Elköteleződési pontozás |
| `campaign.clicked` | Linkre kattintottak | Érdeklődés-követés |
| `campaign.bounced` | E-mail visszapattant | Lista-higiénia |

### Feliratkozói események

| Esemény | Kiváltó ok | Használati eset |
| --- | --- | --- |
| `subscribe` | Új feliratkozó hozzáadva | Üdvözlő folyamat |
| `unsubscribe` | Feliratkozó leiratkozott | Preferencia-kezelés |
| `profile` | Profil frissítve | Attribútum-szinkronizáció |
| `cleaned` | E-mail törölve (visszapattant) | Lista-karbantartás |

### E-kereskedelmi események

| Esemény | Kiváltó ok | Használati eset |
| --- | --- | --- |
| `ecommerce.order` | Rendelés leadva | Vásárlás utáni folyamat |
| `ecommerce.cart` | Kosár frissítve | Elhagyott kosár visszaszerzés |

## Kódpéldák

### A 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 Mailchimp
await tajo.connectors.connect('mailchimp', {
  apiKey: process.env.MAILCHIMP_API_KEY
});
```

### Közönségek migrálása a Brevóba

```javascript
// Full audience migration from Mailchimp to Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

// Check migration status
const status = await tajo.connectors.status('mailchimp');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 52000,
//   campaignsSynced: 245,
//   segmentsMapped: 18
// }
```

### Kampány-elköteleződési adatok szinkronizálása

```javascript
// Sync campaign performance to Brevo attributes
await tajo.connectors.sync('mailchimp', {
  type: 'incremental',
  resources: ['campaigns'],
  options: {
    syncEngagement: true,
    updateContactMetrics: true,
    since: '2024-01-01'
  }
});
```

## Ráta-korlátok

A Mailchimp Marketing API ráta-korlátjai:

| Típus | Korlát | Részletek |
| --- | --- | --- |
| Standard | 10 párhuzamos kérés | API kulcsonként |
| Batch műveletek | 500 művelet kérésenként | Kérésenként |
| Exportálási korlát | 1 párhuzamos exportálás | Fiókonként |
| Tranzakciós | 25 kérés/másodperc | API kulcsonként |

Ráta-korlát stratégia

A Mailchimp párhuzamos kapcsolatokat korlátoz, nem másodpercenkénti kéréseket. Használj batch végpontokat és implementálj újrapróbálkozási logikát exponenciális visszalépéssel `429` válaszoknál.

## Hibaelhárítás

### Gyakori problémák

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| 401 Unauthorized | Érvénytelen API kulcs vagy helytelen adatközpont | Ellenőrizd az API kulcsot és nyerd ki a helyes `dc` előtagot |
| Tag már létezik | E-mail már a közönségben van | Használj PUT-ot POST helyett a meglévő tagok frissítéséhez |
| Megfelelőségi állapot | GDPR törlés megakadályozza az újbóli hozzáadást | A kapcsolatnak egy feliratkozási űrlapon keresztül kell újra feliratkoznia |
| Batch időtúllépés | Nagy batch művelet | Bontsd kisebb, 500 műveletes kötegekre |
| Hiányzó összevonási mezők | Egyéni mezők nem létrehozva | Hozd létre az összevonási mezőket a Mailchimpben a leképezés előtt |

### Hibakeresési mód

Engedélyezd a részletes naplózást:

```yaml
connectors:
  mailchimp:
    debug: true
    log_level: verbose
    log_api_calls: true
```

### Kapcsolat tesztelése

```bash
tajo connectors test mailchimp
# ✓ API connection successful
# ✓ Audiences readable
# ✓ Campaigns readable
# ✓ E-commerce data accessible
# ✓ Webhook configured
```

## Legjobb gyakorlatok

1. **Használj batch műveleteket** – Tömeges feliratkozáshoz/leiratkozáshoz használj batch subscribe/unsubscribe végpontokat
2. **Őrizd meg a feliratkozói státuszt** – Tartsd tiszteletben a feliratkozási hozzájárulást migráció során
3. **Előbb képezd le az összevonási mezőket** – Hozd létre a megfelelő Brevo attribútumokat a szinkronizálás előtt
4. **Szinkronizálj elköteleződési adatokat** – Importálj megnyitási/kattintási arányokat a korábbi szegmentáláshoz
5. **Kezeld a megfelelőségi állapotokat** – Tartsd tiszteletben a GDPR és a végleges törlési állapotokat
6. **Használj növekményes szinkronizálást** – Csak az utolsó szinkronizálás óta bekövetkezett változásokat szinkronizáld az API-használat csökkentéséhez

## Biztonság

- **API kulcs hitelesítés** – Titkos kulcs HTTP Basic Auth jelszóként átadva
- **OAuth 2.0** – Token alapú engedélyezés több fiókos hozzáféréshez
- **TLS titkosítás** – Minden API kommunikáció HTTPS-en keresztül titkosítva
- **Webhook ellenőrzés** – Webhook forrás validálása megosztott titkos kulccsal
- **Adatközpont izoláció** – Adatok régióspecifikus adatközpontokban tárolva

## Kapcsolódó források

- [Mailchimp Marketing API referencia](https://mailchimp.com/developer/marketing/api/)
- [Mailchimp API útmutatók](https://mailchimp.com/developer/marketing/guides/quick-start/)
- [Brevo konnektor](https://tajo.io/hu/docs/connectors/marketing/brevo)
- [ActiveCampaign konnektor](https://tajo.io/hu/docs/connectors/marketing/activecampaign)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)