---
title: "Konektor Twilio Segment"
description: "Kompletny przewodnik integracji Twilio Segment do synchronizacji danych klientów, zdarzeń i segmentów odbiorców z Brevo przez Tajo."
url: https://tajo.io/pl/docs/connectors/custom/segment/
markdown: https://tajo.io/pl/docs/connectors/custom/segment.md
lang: pl-PL
robots: noindex
---

Poproś o wcześniejszy dostęp

Podaj imię i firmowy adres e-mail. Wyślemy Ci link potwierdzający prośbę o dostęp do Tajo.

# Konektor Twilio Segment

Status konektora: Planowany Jeszcze niezbudowany. Tajo nie uruchamia dziś tego konektora.

| Pole źródłowe | Pole docelowe | Przykładowa wartość |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Połącz Twilio Segment z Brevo przez Tajo, aby ujednolicić swój pipeline danych klientów, kierować zdarzenia z dowolnego źródła do Brevo i korzystać z rozwiązywania tożsamości Segment dla bogatszej automatyzacji marketingu.

## Przegląd

| Właściwość | Wartość |
| --- | --- |
| **Platforma** | Twilio Segment |
| **Kategoria** | Platforma danych (Niestandardowa) |
| **Poziom konfiguracji** | Średni |
| **Integracja oficjalna** | Nie |
| **Synchronizowane dane** | Zdarzenia, Klienci, Cechy, Odbiorcy |
| **Dostępne Skills** | 8 |

## Funkcje

- **Powszechne zbieranie danych** - Zbieraj zdarzenia ze stron internetowych, aplikacji mobilnych i serwerów przez SDK Segment
- **Routing źródeł** - Kieruj dane z 400+ źródeł do Brevo przez Tajo
- **Rozwiązywanie tożsamości** - Automatycznie scalaj anonimowe i znane profile użytkowników
- **Synchronizacja odbiorców** - Wysyłaj obliczone cechy i odbiorców Segment do list Brevo
- **Strumieniowanie zdarzeń** - Przekazywanie zdarzeń w czasie rzeczywistym przez framework Connections Segment
- **Reverse ETL** - Synchronizuj dane hurtowni z powrotem do Brevo używając Segment Reverse ETL
- **Egzekwowanie schematu** - Waliduj schematy zdarzeń za pomocą Segment Protocols przed synchronizacją

## Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

1. Workspace Twilio Segment ze skonfigurowanym źródłem
2. Klucz zapisu (Write Key) Segment dla źródła
3. Konto Brevo z dostępem do API
4. Konto Tajo z danymi uwierzytelniającymi API

## Uwierzytelnianie

### Klucz zapisu Segment

Segment uwierzytelnia źródła używając klucza zapisu (Write Key), który jest unikalnym identyfikatorem powiązanym z każdym źródłem.

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

### Token API Tajo

Skonfiguruj konektor Tajo ze swoimi danymi uwierzytelniającymi:

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

## Konfiguracja

### Podstawowa konfiguracja

```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
```

### Mapowanie zdarzeń

Mapuj zdarzenia śledzenia Segment na typy zdarzeń 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"
```

### Mapowanie cech

Mapuj cechy identyfikacji Segment na atrybuty kontaktów Brevo:

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

## Endpointy API

| Metoda | Endpoint | Opis |
| --- | --- | --- |
| `POST` | `/v1/identify` | Identyfikuj użytkownika z cechami |
| `POST` | `/v1/track` | Śledź zdarzenie |
| `POST` | `/v1/page` | Zarejestruj wyświetlenie strony |
| `POST` | `/v1/screen` | Zarejestruj wyświetlenie ekranu |
| `POST` | `/v1/group` | Powiąż użytkownika z grupą |
| `POST` | `/v1/alias` | Scal dwie tożsamości użytkownika |
| `POST` | `/v1/batch` | Wyślij wiele wiadomości w partii |
| `POST` | `/v1/import` | Zbiorczy import danych historycznych |

## Przykłady kodu

### Inicjalizuj Segment z destynacją Tajo

```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'
});
```

### Śledź zdarzenia przez 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"
});
```

### Przekazywanie zdarzeń po stronie serwera (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();
```

## Limity API

| Warstwa | Limit | Okno |
| --- | --- | --- |
| **Free** | 1 000 zdarzeń/sek | Na źródło |
| **Team** | 10 000 zdarzeń/sek | Na źródło |
| **Business** | Niestandardowy | Na workspace |
| **Batch API** | Maks. 500 KB | Na żądanie |
| **Maks. rozmiar partii** | 100 zdarzeń | Na wywołanie batch |

Limity rozmiaru partii

Każde żądanie wsadowe może zawierać maksymalnie 100 zdarzeń i nie może przekraczać 500 KB. Dla dużych importów historycznych używaj Segment Bulk Import API.

## Rozwiązywanie problemów

| Problem | Przyczyna | Rozwiązanie |
| --- | --- | --- |
| Zdarzenia nie pojawiają się w Brevo | Destynacja nie włączona | Włącz destynację Tajo w Segment |
| Cechy użytkownika nie synchronizują się | Brak identyfikatora e-mail | Upewnij się, że cecha `email` jest uwzględniona w wywołaniach identify |
| Duplikaty kontaktów | Wiele anonimowych ID | Wdrożyj właściwe wywołania `alias` dla scalania tożsamości |
| Opóźnione zdarzenia | Kolejka o wysokim wolumenie | Sprawdź dashboard dostarczania zdarzeń Segment |
| Naruszenia schematu | Nieplanowane zdarzenia | Przejrzyj plan śledzenia Segment Protocols |
| Błędy limitu 429 | Za dużo żądań | Wdrożyj wsadowanie lub zmniejsz częstotliwość zdarzeń |

## Najlepsze praktyki

1. **Używaj identify przed track** - Zawsze wywołuj `identify` przed `track`, aby zdarzenia były przypisane do właściwego użytkownika
2. **Wdrożyj plan śledzenia** - Używaj Segment Protocols do egzekwowania schematów zdarzeń
3. **Wsadowe wywołania po stronie serwera** - Używaj batch API dla integracji po stronie serwera, aby zmniejszyć narzut HTTP
4. **Mapuj cechy jawnie** - Definiuj mapowania cecha-atrybut zamiast polegać na domyślnych
5. **Używaj Segment Functions** - Przekształcaj zdarzenia w locie przed dotarciem do Brevo
6. **Monitoruj dostarczanie zdarzeń** - Sprawdzaj dashboard Event Delivery Segment pod kątem nieudanych zdarzeń
7. **Konfiguruj Replay** - Włącz Segment Replay do ponownego przetwarzania historycznych zdarzeń

## Bezpieczeństwo

- **Szyfrowanie TLS** - Wszystkie dane przesyłane przez HTTPS/TLS 1.2+
- **Izolacja klucza zapisu** - Każde źródło ma własny klucz zapisu
- **Zgodność z RODO** - Segment obsługuje żądania usunięcia i wyciszenia danych
- **SOC 2 Type II** - Segment posiada certyfikat SOC 2 Type II
- **Regionalne hosting danych** - Opcja workspace UE dla zgodności z rezydencją danych

## Powiązane zasoby

- [Konektor Amplitude](https://tajo.io/pl/docs/connectors/custom/amplitude)
- [Konektor Mixpanel](https://tajo.io/pl/docs/connectors/custom/mixpanel)
- [Skill synchronizacji klientów](https://tajo.io/pl/docs/skills/data-sync/customer-sync)
- [Brevo Events API](https://tajo.io/pl/docs/events-engagement/create-event)