---
title: "Customer.io konnektor"
description: "Teljes Customer.io integrációs útmutató emberek, események, kampányok és munkafolyamat-adatok Brevóval való szinkronizációjához a Tajo segítségével."
url: https://tajo.io/hu/docs/connectors/marketing/customerio/
markdown: https://tajo.io/hu/docs/connectors/marketing/customerio.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.

# Customer.io konnektor

Konnektor állapota: Tervezett Még nem készült el. A Tajo ma nem futtatja ezt a konnektort.

| 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 Customer.io üzenetküldési platformot a Brevóhoz egységesített ügyféladatokhoz, platformok közötti kampánykoordinációhoz és konszolidált elköteleződési analitikához.

## Áttekintés

| Tulajdonság | Érték |
| --- | --- |
| **Platform** | Customer.io |
| **Kategória** | Marketing |
| **Telepítés bonyolultsága** | Közepes |
| **Hivatalos integráció** | Nem |
| **Szinkronizált adatok** | Emberek, Események, Kampányok, Szegmensek |
| **Használt API-k** | Track API, App API, Pipelines API |
| **Hitelesítés** | Site ID + API kulcs / App API kulcs |
| **Alap URL-ek** | `track.customer.io`, `api.customer.io` |

## Funkciók

- **Személyek szinkronizációja** – Kétirányú ügyfélprofil-szinkronizálás Brevo kapcsolatokkal
- **Esemény-továbbítás** – Viselkedési események követése és továbbítása a Brevóba automatizálási kiváltókhoz
- **Kampányanalitika** – Kampány-teljesítménymutatók szinkronizálása egységesített riportoláshoz
- **Munkafolyamat-adatok** – Customer.io munkafolyamat-állapotok tükrözése Brevo kapcsolat-attribútumokban
- **Szegmens-replikáció** – Customer.io szegmensek replikálása Brevo listákként
- **Objektum-adat szinkronizáció** – Nem-személy objektumok és kapcsolati adatok szinkronizálása

## Előfeltételek

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

1. Egy Customer.io fiókkal API-hozzáféréssel
2. A Site ID-vel és Track API kulcscsal (a Beállítások > API hitelesítő adatok menüben)
3. App API kulccsal a kampány- és szegmensadatok olvasásához
4. Egy Brevo fiókkal API-hozzáféréssel
5. Egy Tajo fiókkal aktív előfizetéssel

## Hitelesítés

A Customer.io két külön API-t használ különböző hitelesítési módszerekkel:

### Track API (Viselkedési adatok)

Emberek, események és eszközadatok küldéséhez. Site ID-vel és API kulccsal hitelesít Basic Auth-on keresztül.

```bash
# Basic Auth: Site ID as username, API Key as password
curl -X POST https://track.customer.io/api/v1/customers/user123 \
  -u "$SITE_ID:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'
```

### App API (Adatolvasás)

Kampányok, szegmensek és ügyféladatok lekéréséhez. Bearer tokennel hitelesít.

```bash
curl -X GET https://api.customer.io/v1/campaigns \
  -H "Authorization: Bearer $APP_API_KEY"
```

API kulcs szétválasztás

A Track API kulcs és az App API kulcs különböző hitelesítő adatok. A Track API kulcs adatok írásához, az App API kulcs adatok olvasásához szükséges. Mindkettő szükséges a teljes Tajo integrációhoz.

### Csatlakozás a Tajóhoz

```bash
tajo connectors install customerio \
  --site-id $CIO_SITE_ID \
  --track-api-key $CIO_TRACK_API_KEY \
  --app-api-key $CIO_APP_API_KEY
```

## Konfiguráció

### Alapbeállítás

```yaml
connectors:
  customerio:
    enabled: true
    region: "us"  # or "eu" for EU data center

    sync:
      people: true
      events: true
      campaigns: true
      segments: true
      objects: false

    lists:
      all_contacts: 12
      active_subscribers: 13
      churned: 14
```

### Mezőleképezés

Képezd le a Customer.io személy-attribútumokat Brevo kapcsolat-attribútumokhoz:

```yaml
field_mapping:
  # Standard fields
  id: CIO_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Engagement metrics
  created_at: SIGNUP_DATE
  last_activity: LAST_ACTIVE
  plan: PLAN_NAME

  # Custom attributes
  company: COMPANY
  role: JOB_TITLE
  mrr: MONTHLY_REVENUE
  lifecycle_stage: LIFECYCLE_STAGE
```

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

```yaml
event_mapping:
  # Customer.io event -> Brevo event
  purchase_completed: ORDER_PLACED
  subscription_started: SUBSCRIPTION_START
  feature_activated: FEATURE_USED
  support_ticket_opened: SUPPORT_REQUEST
```

## API végpontok

A Tajo az alábbi Customer.io API végpontokkal integrálódik:

| Végpont | Módszer | API | Cél |
| --- | --- | --- | --- |
| `/api/v1/customers/{id}` | PUT | Track | Személy létrehozása vagy frissítése |
| `/api/v1/customers/{id}/events` | POST | Track | Személyesemény követése |
| `/api/v1/events` | POST | Track | Névtelen események követése |
| `/api/v2/entity` | POST | Track | Emberek/objektumok létrehozása vagy frissítése (Pipelines) |
| `/v1/campaigns` | GET | App | Kampányok listázása |
| `/v1/campaigns/{id}/metrics` | GET | App | Kampány-teljesítménymutatók |
| `/v1/segments` | GET | App | Szegmensek listázása |
| `/v1/segments/{id}/membership` | GET | App | Szegmens tagjainak lekérése |
| `/v1/customers/{id}/attributes` | GET | App | Ügyfélattribútumok lekérése |
| `/v1/customers/{id}/activities` | GET | App | Ügyfél-tevékenységnapló lekérése |

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

await tajo.connectors.connect('customerio', {
  siteId: process.env.CIO_SITE_ID,
  trackApiKey: process.env.CIO_TRACK_API_KEY,
  appApiKey: process.env.CIO_APP_API_KEY,
  region: 'us'
});
```

### Személyek szinkronizálása a Brevóba

```javascript
// Incremental sync of Customer.io people
await tajo.connectors.sync('customerio', {
  type: 'incremental',
  resources: ['people'],
  since: '2024-01-01',
  batchSize: 100
});

const status = await tajo.connectors.status('customerio');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T14:20:00Z',
//   peopleCount: 32500,
//   campaignsTracked: 18,
//   eventsProcessed: 87000
// }
```

### Események továbbítása

```javascript
// Forward Customer.io reporting webhook events to Brevo
app.post('/webhooks/customerio', async (req, res) => {
  const events = req.body;

  for (const event of events) {
    await tajo.connectors.handleEvent('customerio', {
      type: event.metric,
      payload: {
        customerId: event.data.customer_id,
        campaignId: event.data.campaign_id,
        timestamp: event.timestamp
      }
    });
  }

  res.status(200).send('OK');
});
```

### Szegmens exportálása

```javascript
const result = await tajo.connectors.exportSegment('customerio', {
  segmentId: 42,
  targetList: 13,
  includeAttributes: ['email', 'first_name', 'last_name', 'plan']
});

console.log(`Exported ${result.count} people to Brevo list 13`);
```

## Ráta-korlátok

A Customer.io különböző ráta-korlátokat alkalmaz API-nként:

| API | Ráta-korlát | Megjegyzések |
| --- | --- | --- |
| **Track API** | ~100 kérés/másodperc | Munkaterületenként |
| **App API** | 10 kérés/másodperc | API kulcsonként |
| **Pipelines API** | 100 kérés/másodperc | Nagy adatforgalomhoz ajánlott |
| **Batch végpont** | 1 000 személy kérésenként | Max. 500 KB haszon |

Batch végpontok használata

Nagy szinkronizálásokhoz a Tajo a Customer.io batch végpontot használja, amely kérésenként legfeljebb 1 000 személyt küld, jelentősen csökkentve az API hívások számát.

## Hibaelhárítás

### Gyakori problémák

| Probléma | Ok | Megoldás |
| --- | --- | --- |
| 401 Unauthorized | Érvénytelen Site ID vagy API kulcs | Ellenőrizd a hitelesítő adatokat a Customer.io Beállítások > API menüben |
| Személyek nem szinkronizálódnak | Hiányzó azonosító | Győződj meg róla, hogy minden személynek van `id` vagy `email` értéke |
| Események nem követve | Rossz API kulcstípus | A Track API kulcsot használd eseményekhez, ne az App API kulcsot |
| EU adatok nem elérhetők | Rossz régió van konfigurálva | Állítsd a régiót `eu`-ra EU munkaterületeknél |
| Ráta-korlát hibák | Túl sok App API hívás | Csökkentsd a lekérdezési gyakoriságot kampányadatoknál |

### Hibakeresési mód

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

### Kapcsolat tesztelése

```bash
tajo connectors test customerio
# ✓ Track API connection successful
# ✓ App API connection successful
# ✓ People accessible
# ✓ Campaigns readable
# ✓ Segments listable
```

## Legjobb gyakorlatok

1. **Használd a Pipelines API-t tömeges adatokhoz** – Az újabb Pipelines API nagy volumenű adatbevitelre van optimalizálva
2. **Állíts be riportolási webhookokat** – Customer.io e-mail eseményeket valós időben továbbíts a Tajóba
3. **Képezd le az életciklus-szakaszokat** – Customer.io szegmenstagságot szinkronizálj Brevo attribútumokhoz
4. **Használj egységes azonosítókat** – Az `id` mezőket egyeztesd a Customer.io és Brevo között
5. **Szinkronizálj növekményesen** – Kerüld a teljes exportálásokat; használj `last_activity` időbélyegeket
6. **Figyeld a webhook kézbesítést** – Állíts be riasztásokat a sikertelen webhook kézbesítésekhez

## Biztonság

- **Basic Auth** – A Track API Site ID-vel és API kulccsal hitelesít
- **Bearer Token** – Az App API OAuth stílusú bearer tokeneket használ
- **Csak HTTPS** – Minden API kommunikáció TLS 1.2+-on keresztül titkosítva
- **Regionális adatközpontok** – EU adatközpont opció GDPR megfelelőséghez
- **Titkosított tárolás** – Minden hitelesítő adat titkosítva tárolódik a Tajóban
- **Webhook aláírások** – Webhook terhelések ellenőrzése HMAC aláírásokkal

## Kapcsolódó források

- [Braze konnektor](https://tajo.io/hu/docs/connectors/marketing/braze)
- [Iterable konnektor](https://tajo.io/hu/docs/connectors/marketing/iterable)
- [Ügyfél-szinkronizáció Skill](https://tajo.io/hu/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/hu/docs/contact-management)