---
title: "Twilio Segment konektor"
description: "Kompletný sprievodca integráciou Twilio Segment na synchronizáciu zákazníckych dát, udalostí a segmentov publika s Brevo cez Tajo."
url: https://tajo.io/sk/docs/connectors/custom/segment/
markdown: https://tajo.io/sk/docs/connectors/custom/segment.md
lang: sk-SK
robots: noindex
---

Požiadajte o skorý prístup

Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo.

# Twilio Segment konektor

Stav konektora: Plánované Zatiaľ nevytvorené. Tajo tento konektor dnes neprevádzkuje.

| Zdrojové pole | Cieľové pole | Ukážková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Prepoj Twilio Segment s Brevo cez Tajo na zjednotenie pipeline zákazníckych dát, smerovanie udalostí z akéhokoľvek zdroja do Brevo a využitie rozlíšenia identity Segment pre bohatšiu marketingovú automatizáciu.

## Prehľad

| Vlastnosť | Hodnota |
| --- | --- |
| **Platforma** | Twilio Segment |
| **Kategória** | Dátová platforma (Vlastná) |
| **Zložitosť nastavenia** | Stredná |
| **Oficiálna integrácia** | Nie |
| **Synchronizované dáta** | Udalosti, Zákazníci, Traits, Publiká |
| **Dostupné skilly** | 8 |

## Funkcie

- **Univerzálny zber dát** - Zbieraj udalosti z webstránok, mobilných aplikácií a serverov cez Segment SDK
- **Smerovanie zdrojov** - Smeruj dáta z 400+ zdrojov do Brevo cez Tajo
- **Rozlíšenie identity** - Zlučuj anonymné a známe profily používateľov automaticky
- **Synchronizácia publika** - Posielajaj computed traits a publiká Segment do zoznamov Brevo
- **Streamovanie udalostí** - Preposielanie udalostí v reálnom čase cez Connections framework Segment
- **Reverse ETL** - Synchronizuj dáta warehousu späť do Brevo pomocou Segment Reverse ETL
- **Vynútenie schémy** - Validuj schémy udalostí pomocou Segment Protocols pred synchronizáciou

## Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Twilio Segment workspace s nakonfigurovaným zdrojom
2. Write Key Segment pre zdroj
3. Brevo účet s API prístupom
4. Tajo účet s API prihlasovacími údajmi

## Autentifikácia

### Segment Write Key

Segment overuje zdroje pomocou Write Key, čo je unikátny identifikátor viazaný na každý zdroj.

```javascript
// Analytics.js initialization with Write Key
analytics.load("YOUR_SEGMENT_WRITE_KEY");
```

### Tajo API Token

Nakonfiguruj konektor Tajo so svojimi prihlasovacími údajmi:

```bash
tajo connectors install segment \
  --write-key $SEGMENT_WRITE_KEY \
  --workspace-slug your-workspace \
  --brevo-api-key $BREVO_API_KEY
```

## Konfigurácia

### Základné nastavenie

```yaml
connectors:
  segment:
    enabled: true
    write_key: "your-segment-write-key"
    data_region: "us"  # or "eu" for EU workspace

    # Data sync options
    sync:
      identify: true
      track: true
      page: true
      group: false

    # Brevo list assignment
    lists:
      all_contacts: 5
      active_users: 6
      high_value: 7
```

### Mapovanie udalostí

Namapuj track udalosti Segment na typy udalostí Brevo:

```yaml
event_mapping:
  # Segment event -> Brevo event
  "Order Completed": "order_completed"
  "Product Viewed": "product_viewed"
  "Cart Updated": "cart_updated"
  "Signed Up": "customer_created"
  "Checkout Started": "checkout_started"

  # Custom events
  "Feature Used": "feature_used"
  "Plan Upgraded": "plan_upgraded"
```

### Mapovanie traits

Namapuj identify traits Segment na atribúty kontaktov v Brevo:

```yaml
trait_mapping:
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS
  plan: PLAN_TYPE
  company: COMPANY
  createdAt: SIGNUP_DATE
  lifetimeValue: LTV
```

## API endpointy

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `POST` | `/v1/identify` | Identifikácia používateľa s traits |
| `POST` | `/v1/track` | Sledovanie udalosti |
| `POST` | `/v1/page` | Zaznamenanie zobrazenia stránky |
| `POST` | `/v1/screen` | Zaznamenanie zobrazenia obrazovky |
| `POST` | `/v1/group` | Priradenie používateľa ku skupine |
| `POST` | `/v1/alias` | Zlúčenie dvoch identít používateľa |
| `POST` | `/v1/batch` | Odoslanie viacerých správ v dávke |
| `POST` | `/v1/import` | Hromadný import historických dát |

## Ukážky kódu

### Inicializácia Segment s Tajo destináciou

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

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

// Connect Segment source
await tajo.connectors.connect('segment', {
  writeKey: process.env.SEGMENT_WRITE_KEY,
  workspaceSlug: 'your-workspace'
});
```

### Sledovanie udalostí cez Segment

```javascript
// Identify a user - syncs to Brevo contacts
analytics.identify("user_123", {
  email: "jane@example.com",
  firstName: "Jane",
  lastName: "Kim",
  plan: "premium",
  lifetimeValue: 450.00
});

// Track an event - forwards to Brevo
analytics.track("Order Completed", {
  orderId: "ORD-1234",
  revenue: 89.99,
  currency: "USD",
  products: [
    { id: "SKU-001", name: "Widget", price: 89.99 }
  ]
});

// Page view tracking
analytics.page("Pricing", {
  title: "Pricing - Tajo",
  url: "https://tajo.io/pricing"
});
```

### Preposielanie udalostí na strane servera (Node.js)

```javascript
const Analytics = require('analytics-node');
const analytics = new Analytics(process.env.SEGMENT_WRITE_KEY);

// Batch identify users from your database
const users = await db.query('SELECT * FROM users WHERE updated_at > $1', [lastSync]);

for (const user of users) {
  analytics.identify({
    userId: user.id,
    traits: {
      email: user.email,
      firstName: user.first_name,
      lastName: user.last_name,
      totalOrders: user.order_count,
      lifetimeValue: user.ltv
    }
  });
}

// Flush the queue
await analytics.flush();
```

## Obmedzenia rýchlosti

| Tier | Limit | Okno |
| --- | --- | --- |
| **Free** | 1 000 udalostí/sek | Na zdroj |
| **Team** | 10 000 udalostí/sek | Na zdroj |
| **Business** | Vlastné | Na workspace |
| **Batch API** | Max 500 KB | Na požiadavku |
| **Max veľkosť dávky** | 100 udalostí | Na dávkové volanie |

Limity veľkosti dávky

Každá dávková požiadavka môže obsahovať maximálne 100 udalostí a nesmie presiahnuť 500 KB. Pre veľké historické importy použi Segment Bulk Import API.

## Riešenie problémov

| Problém | Príčina | Riešenie |
| --- | --- | --- |
| Udalosti sa neobjavujú v Brevo | Destinácia nie je povolená | Povol Tajo destináciu v Segment |
| Traits používateľa sa nesynchronizujú | Chýbajúci identifikátor e-mail | Uisti sa, že trait `email` je zahrnutý v identify volaniach |
| Duplicitné kontakty | Viacero anonymných ID | Implementuj správne `alias` volania pre zlúčenie identity |
| Oneskorené udalosti | Front s vysokým objemom | Skontroluj dashboard doručenia udalostí v Segment |
| Porušenia schémy | Neplánované udalosti | Preskúmaj tracking plán Segment Protocols |
| Chyby 429 rate limit | Príliš veľa požiadaviek | Implementuj dávkovanie alebo zredukuj frekvenciu udalostí |

## Odporúčané postupy

1. **Použi identify pred track** - Vždy volaj `identify` pred `track` na zabezpečenie správneho priradenia udalostí
2. **Implementuj tracking plán** - Použi Segment Protocols na vynútenie schém udalostí
3. **Dávkuj volania na strane servera** - Použi batch API pre serverové integrácie na zníženie HTTP réžie
4. **Explicitne namapuj traits** - Definuj mapovania trait-na-atribút namiesto spoliehania sa na predvolené
5. **Použi Segment Functions** - Transformuj udalosti za behu pred ich dosiahnutím Brevo
6. **Sleduj doručenie udalostí** - Skontroluj dashboard Event Delivery v Segment pre zlyhané udalosti
7. **Nastav Replay** - Povol Segment Replay pre opätovné spracovanie historických udalostí

## Bezpečnosť

- **TLS šifrovanie** - Všetky dáta prenášané cez HTTPS/TLS 1.2+
- **Izolácia Write Key** - Každý zdroj má vlastný Write Key
- **GDPR súlad** - Segment podporuje mazanie a potlačenie dát
- **SOC 2 Type II** - Segment je certifikovaný podľa SOC 2 Type II
- **Regionálne hostovanie dát** - Možnosť EU workspace pre súlad s rezidenciou dát

## Súvisiace zdroje

- [Amplitude konektor](https://tajo.io/sk/docs/connectors/custom/amplitude)
- [Mixpanel konektor](https://tajo.io/sk/docs/connectors/custom/mixpanel)
- [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync)
- [Brevo Events API](https://tajo.io/sk/docs/events-engagement/create-event)