---
title: "Konektor Twilio Segment"
description: "Kompletní průvodce integrací Twilio Segment pro synchronizaci zákaznických dat, událostí a segmentů publika s Brevo přes Tajo."
url: https://tajo.io/cz/docs/connectors/custom/segment/
markdown: https://tajo.io/cz/docs/connectors/custom/segment.md
lang: cs-CZ
robots: noindex
---

Požádejte o přednostní přístup

Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo.

# Konektor Twilio Segment

Stav konektoru: Plánováno Zatím nevytvořeno. Tajo tento konektor dnes neprovozuje.

| Zdrojové pole | Cílové pole | Ukázková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Propojte Twilio Segment s Brevo přes Tajo pro sjednocení zákaznického datového pipeline, směrování událostí z libovolného zdroje do Brevo a využití rozlišení identit Segment pro bohatší marketingovou automatizaci.

## Přehled

| Vlastnost | Hodnota |
| --- | --- |
| **Platforma** | Twilio Segment |
| **Kategorie** | Datová platforma (Vlastní) |
| **Složitost nastavení** | Střední |
| **Oficiální integrace** | Ne |
| **Synchronizovaná data** | Události, Zákazníci, Vlastnosti, Publika |
| **Dostupné dovednosti** | 8 |

## Funkce

- **Univerzální sběr dat** – Sbírejte události z webů, mobilních aplikací a serverů přes SDK Segment
- **Směrování zdrojů** – Směrujte data z 400+ zdrojů do Brevo přes Tajo
- **Rozlišení identit** – Automaticky slučujte anonymní a známé profily uživatelů
- **Synchronizace publika** – Odesílejte vypočítané vlastnosti a publika Segment do seznamů Brevo
- **Streamování událostí** – Přeposílání událostí v reálném čase přes framework Connections Segment
- **Reverse ETL** – Synchronizujte data skladu zpět do Brevo pomocí Segment Reverse ETL
- **Vynucení schématu** – Ověřujte schémata událostí pomocí Segment Protocols před synchronizací

## Předpoklady

Než začnete, ujistěte se, že máte:

1. Pracovní prostor Twilio Segment s nakonfigurovaným zdrojem
2. Váš Write Key Segment pro zdroj
3. Účet Brevo s přístupem k API
4. Účet Tajo s API přihlašovacími údaji

## Ověření

### Write Key Segment

Segment ověřuje zdroje pomocí Write Key, který je jedinečným identifikátorem vázaným na každý zdroj.

```javascript
// Inicializace Analytics.js s Write Key
analytics.load("YOUR_SEGMENT_WRITE_KEY");
```

### API Token Tajo

Nakonfigurujte konektor Tajo se svými přihlašovacími údaji:

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

## Konfigurace

### Základní nastavení

```yaml
connectors:
  segment:
    enabled: true
    write_key: "your-segment-write-key"
    data_region: "us"  # nebo "eu" pro pracovní prostor EU

    # Možnosti synchronizace dat
    sync:
      identify: true
      track: true
      page: true
      group: false

    # Přiřazení seznamů Brevo
    lists:
      all_contacts: 5
      active_users: 6
      high_value: 7
```

### Mapování událostí

Mapujte track události Segment na typy událostí Brevo:

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

  # Vlastní události
  "Feature Used": "feature_used"
  "Plan Upgraded": "plan_upgraded"
```

### Mapování vlastností

Mapujte vlastnosti identify Segment na atributy kontaktů Brevo:

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

## Koncové body API

| Metoda | Koncový bod | Popis |
| --- | --- | --- |
| `POST` | `/v1/identify` | Identifikace uživatele s vlastnostmi |
| `POST` | `/v1/track` | Sledování události |
| `POST` | `/v1/page` | Zaznamenání zobrazení stránky |
| `POST` | `/v1/screen` | Zaznamenání zobrazení obrazovky |
| `POST` | `/v1/group` | Přidružení uživatele ke skupině |
| `POST` | `/v1/alias` | Sloučení dvou identit uživatele |
| `POST` | `/v1/batch` | Odeslání více zpráv v dávce |
| `POST` | `/v1/import` | Hromadný import historických dat |

## Příklady kódu

### Inicializace Segment s cílovou destinací Tajo

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

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

// Připojení zdroje Segment
await tajo.connectors.connect('segment', {
  writeKey: process.env.SEGMENT_WRITE_KEY,
  workspaceSlug: 'your-workspace'
});
```

### Sledování událostí přes Segment

```javascript
// Identifikace uživatele - synchronizuje se do kontaktů Brevo
analytics.identify("user_123", {
  email: "jane@example.com",
  firstName: "Jane",
  lastName: "Kim",
  plan: "premium",
  lifetimeValue: 450.00
});

// Sledování události - přeposílá do Brevo
analytics.track("Order Completed", {
  orderId: "ORD-1234",
  revenue: 89.99,
  currency: "USD",
  products: [
    { id: "SKU-001", name: "Widget", price: 89.99 }
  ]
});

// Sledování zobrazení stránky
analytics.page("Pricing", {
  title: "Pricing - Tajo",
  url: "https://tajo.io/pricing"
});
```

### Přeposílání událostí na straně serveru (Node.js)

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

// Dávková identifikace uživatelů z databáze
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
    }
  });
}

// Vyprázdnění fronty
await analytics.flush();
```

## Omezení rychlosti

| Vrstva | Limit | Okno |
| --- | --- | --- |
| **Free** | 1 000 událostí/s | Na zdroj |
| **Team** | 10 000 událostí/s | Na zdroj |
| **Business** | Vlastní | Na pracovní prostor |
| **Batch API** | Max 500 KB | Na požadavek |
| **Max velikost dávky** | 100 událostí | Na volání dávky |

Limity velikosti dávky

Každý požadavek na dávku může obsahovat maximálně 100 událostí a nesmí překročit 500 KB. Pro velké historické importy používejte Segment Bulk Import API.

## Řešení problémů

| Problém | Příčina | Řešení |
| --- | --- | --- |
| Události se nezobrazují v Brevo | Destinace není povolena | Povolte destinaci Tajo v Segment |
| Vlastnosti uživatele se nesynchronizují | Chybějící identifikátor e-mailu | Ujistěte se, že vlastnost `email` je zahrnuta ve volání identify |
| Duplicitní kontakty | Více anonymních ID | Implementujte správná volání `alias` pro sloučení identit |
| Zpoždění událostí | Fronta s vysokým objemem | Zkontrolujte řídicí panel doručování událostí Segment |
| Porušení schématu | Neplánované události | Zkontrolujte plán sledování Segment Protocols |
| Chyby limitu rychlosti 429 | Příliš mnoho požadavků | Implementujte dávkování nebo snižte frekvenci událostí |

## Osvědčené postupy

1. **Používejte identify před track** – Vždy volejte `identify` před `track` pro zajištění přiřazení událostí správnému uživateli
2. **Implementujte plán sledování** – Používejte Segment Protocols pro vynucení schémat událostí
3. **Dávkujte volání na straně serveru** – Používejte batch API pro integrace na straně serveru ke snížení HTTP zátěže
4. **Explicitně mapujte vlastnosti** – Definujte mapování vlastností na atributy místo spoléhání na výchozí nastavení
5. **Používejte Segment Functions** – Transformujte události za letu před jejich příchodem do Brevo
6. **Monitorujte doručování událostí** – Kontrolujte řídicí panel Doručování událostí Segment pro neúspěšné události
7. **Nastavte Replay** – Povolte Segment Replay pro opětovné zpracování historických událostí

## Zabezpečení

- **Šifrování TLS** – Všechna data přenášena přes HTTPS/TLS 1.2+
- **Izolace Write Key** – Každý zdroj má svůj vlastní Write Key
- **Soulad s GDPR** – Segment podporuje požadavky na mazání a potlačení dat
- **SOC 2 Type II** – Segment je certifikován podle SOC 2 Type II
- **Regionální hosting dat** – Možnost pracovního prostoru EU pro soulad s rezidencí dat

## Související zdroje

- [Konektor Amplitude](https://tajo.io/cz/docs/connectors/custom/amplitude)
- [Konektor Mixpanel](https://tajo.io/cz/docs/connectors/custom/mixpanel)
- [Dovednost synchronizace zákazníků](https://tajo.io/cz/docs/skills/data-sync/customer-sync)
- [API událostí Brevo](https://tajo.io/cz/docs/events-engagement/create-event)