---
title: "Twilio Segment конектор"
description: "Пълно ръководство за интеграция с Twilio Segment за синхронизация на клиентски данни, събития и audience сегменти с Brevo през Tajo."
url: https://tajo.io/bg/docs/connectors/custom/segment/
markdown: https://tajo.io/bg/docs/connectors/custom/segment.md
lang: bg-BG
robots: noindex
---

Заявете ранен достъп

Въведете собственото си име и служебен имейл адрес. Ще ви изпратим връзка за потвърждение на заявката за достъп до Tajo.

# Twilio Segment конектор

Статус на конектора: Планиран Все още не е изграден. Tajo не изпълнява този конектор днес.

| Поле източник | Целево поле | Примерна стойност |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Свържи Twilio Segment с Brevo през Tajo, за да унифицираш pipeline-а си за клиентски данни, да рутираш събития от всеки източник към Brevo и да използваш identity resolution на Segment за по-богата маркетингова автоматизация.

## Преглед

| Свойство | Стойност |
| --- | --- |
| **Платформа** | Twilio Segment |
| **Категория** | Data Platform (персонализирана) |
| **Сложност на настройка** | Средна |
| **Официална интеграция** | Не |
| **Синхронизирани данни** | Събития, клиенти, traits, audiences |
| **Налични скилове** | 8 |

## Функции

- **Универсално събиране на данни** – Събирай събития от уебсайтове, мобилни приложения и сървъри чрез Segment SDK-тата
- **Рутиране на източници** – Рутирай данни от 400+ източника към Brevo през Tajo
- **Identity resolution** – Автоматично обединявай анонимни и известни потребителски профили
- **Синхронизация на audience-и** – Изпращай изчислените от Segment traits и audiences към списъци в Brevo
- **Event streaming** – Препращане на събития в реално време чрез Connections рамката на Segment
- **Reverse ETL** – Синхронизирай данни от warehouse обратно към Brevo чрез Segment Reverse ETL
- **Enforcement на схеми** – Валидирай схемите на събитията чрез Segment Protocols преди синхронизация

## Предварителни условия

Преди да започнеш, увери се, че имаш:

1. Twilio Segment workspace с конфигуриран източник
2. Segment Write Key за източника
3. Акаунт в Brevo с API достъп
4. Акаунт в Tajo с API credentials

## Автентикация

### Segment Write Key

Segment автентикира източниците чрез Write Key – уникален идентификатор, свързан с всеки източник.

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

### Tajo API Token

Конфигурирай Tajo конектора с credentials:

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

## Конфигурация

### Основна настройка

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

### Мапване на събития

Мапвай track събития от Segment към типове събития в 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"
```

### Мапване на traits

Мапвай identify traits от Segment към атрибути на контактите в Brevo:

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

## API крайни точки

| Метод | Крайна точка | Описание |
| --- | --- | --- |
| `POST` | `/v1/identify` | Идентифицирай потребител с traits |
| `POST` | `/v1/track` | Проследи събитие |
| `POST` | `/v1/page` | Запиши преглед на страница |
| `POST` | `/v1/screen` | Запиши преглед на screen |
| `POST` | `/v1/group` | Асоциирай потребител с група |
| `POST` | `/v1/alias` | Обедини две потребителски идентичности |
| `POST` | `/v1/batch` | Изпрати множество съобщения в пакет |
| `POST` | `/v1/import` | Масов импорт на исторически данни |

## Примери с код

### Инициализация на Segment с Tajo destination

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

### Проследяване на събития чрез 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"
});
```

### Сървърно препращане на събития (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();
```

## Ограничения на заявките

| Tier | Лимит | Прозорец |
| --- | --- | --- |
| **Free** | 1 000 събития/сек | На източник |
| **Team** | 10 000 събития/сек | На източник |
| **Business** | Персонализиран | На workspace |
| **Batch API** | 500 KB макс | На заявка |
| **Макс. batch size** | 100 събития | На batch извикване |

Лимити на размера на пакета

Всяка batch заявка може да съдържа максимум 100 събития и не трябва да надвишава 500 KB. За големи исторически импорти използвай Segment Bulk Import API.

## Отстраняване на проблеми

| Проблем | Причина | Решение |
| --- | --- | --- |
| Събитията не се появяват в Brevo | Destination не е активен | Активирай Tajo destination в Segment |
| Потребителските traits не се синхронизират | Липсва имейл идентификатор | Увери се, че `email` trait е включен в identify извикванията |
| Дублирани контакти | Множество анонимни ID-та | Внедри правилни `alias` извиквания за обединяване на идентичност |
| Събитията се забавят | Опашка с голям обем | Провери event delivery dashboard на Segment |
| Нарушения на схемата | Непланирани събития | Прегледай tracking plan в Segment Protocols |
| 429 rate limit грешки | Твърде много заявки | Внедри batching или намали честотата на събитията |

## Добри практики

1. **Използвай identify преди track** – Винаги извиквай `identify` преди `track`, за да се гарантира, че събитията се приписват на правилния потребител
2. **Внедри tracking plan** – Използвай Segment Protocols, за да налагаш схеми за събития
3. **Пакетирай сървърни извиквания** – Използвай batch API за сървърни интеграции, за да намалиш HTTP overhead
4. **Мапвай traits явно** – Дефинирай мапвания на trait към атрибут, вместо да разчиташ на defaults
5. **Използвай Segment Functions** – Трансформирай събития в движение, преди да достигнат Brevo
6. **Мониторирай доставката на събития** – Проверявай Event Delivery dashboard на Segment за неуспешни събития
7. **Настрой Replay** – Активирай Segment Replay за повторна обработка на исторически събития

## Сигурност

- **TLS криптиране** – Всички данни се предават през HTTPS/TLS 1.2+
- **Изолация на Write Key** – Всеки източник има собствен Write Key
- **GDPR съвместимост** – Segment поддържа заявки за изтриване и suppression на данни
- **SOC 2 Type II** – Segment е SOC 2 Type II сертифициран
- **Регионален хостинг на данни** – Опция за EU workspace за съвместимост с data residency

## Свързани ресурси

- [Amplitude конектор](https://tajo.io/bg/docs/connectors/custom/amplitude)
- [Mixpanel конектор](https://tajo.io/bg/docs/connectors/custom/mixpanel)
- [Customer Sync скил](https://tajo.io/bg/docs/skills/data-sync/customer-sync)
- [Brevo Events API](https://tajo.io/bg/docs/events-engagement/create-event)