---
title: "Twilio Segment Connector"
description: "Popoln vodnik za integracijo Twilio Segment za sinhronizacijo podatkov o strankah, wydarzeniih in segmentov občinstva z Brevo prek Tajo."
url: https://tajo.io/sl/docs/connectors/custom/segment/
markdown: https://tajo.io/sl/docs/connectors/custom/segment.md
lang: sl-SI
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# Twilio Segment Connector

Stanje konektorja: Načrtovano Še ni izdelano. Tajo danes ne poganja tega konektorja.

| Izvorno polje | Ciljno polje | Vzorčna vrednost |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Poveži Twilio Segment z Brevo prek Tajo za poenotenje cevovoda podatkov o strankah, usmerjanje événements iz katerega koli vira v Brevo in izkoriščanje razreševanja identitet Segment za bogatejšo marketinško avtomatizacijo.

## Pregled

| Lastnost | Vrednost |
| --- | --- |
| **Platforma** | Twilio Segment |
| **Kategorija** | Podatkovna platforma (po meri) |
| **Zahtevnost nastavitve** | Srednja |
| **Uradna integracija** | Ne |
| **Sinhronizirani podatki** | Dogodki, stranke, lastnosti, občinstvo |
| **Razpoložljivi Skills** | 8 |

## Funkcionalnosti

- **Univerzalno zbiranje podatkov** – zbiraj événements s spletnih mest, mobilnih aplikacij in strežnikov prek SDK Segment
- **Usmerjanje vira** – usmerjaj podatke iz 400+ virov v Brevo prek Tajo
- **Razreševanje identitet** – samodejno združuj anonimne in znane profile uporabnikov
- **Sinhronizacija občinstva** – pošlji izračunane lastnosti in občinstvo Segment v sezname Brevo
- **Pretakanje wydarzeniih** – posredovanje événements v realnem času prek okvirja Connections Segment
- **Reverse ETL** – sinhronizacija podatkov skladišča nazaj v Brevo z Reverse ETL Segment
- **Uveljavljanje sheme** – potrdi sheme événements s protokoli Segment pred sinhronizacijo

## Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Delovno okolje Twilio Segment s konfiguriranim virom
2. Pisalni ključ Segment za vir
3. Brevo račun z dostopom do API
4. Tajo račun s poverilnicami API

## Avtentikacija

### Pisalni ključ Segment

Segment avtenticira vire z Writnim ključem, ki je enolični identifikator, vezan na vsak vir.

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

### API žeton Tajo

Nastavi konektor Tajo s poverilnicami:

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

## Konfiguracija

### Osnovna nastavitev

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

### Preslikava événements

Preslikaj sledilne événements Segment v vrste événements 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"
```

### Preslikava lastnosti

Preslikaj lastnosti identificiranja Segment v atribute stikov Brevo:

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

## Končne točke API

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `POST` | `/v1/identify` | Identificiraj uporabnika z lastnostmi |
| `POST` | `/v1/track` | Sledi événementu |
| `POST` | `/v1/page` | Zabeleži ogled strani |
| `POST` | `/v1/screen` | Zabeleži ogled zaslona |
| `POST` | `/v1/group` | Poveži uporabnika s skupino |
| `POST` | `/v1/alias` | Združi dve identiteti uporabnika |
| `POST` | `/v1/batch` | Pošlji več sporočil v paketu |
| `POST` | `/v1/import` | Množičen uvoz zgodovinskih podatkov |

## Primeri kode

### Inicializacija Segment z destinacijo 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'
});
```

### Sledenje événementom prek 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"
});
```

### Posredovanje événements na strani strežnika (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();
```

## Omejitve hitrosti

| Paket | Omejitev | Okno |
| --- | --- | --- |
| **Free** | 1.000 événements/s | Na vir |
| **Team** | 10.000 événements/s | Na vir |
| **Business** | Po meri | Na delovno okolje |
| **Batch API** | Največ 500 KB | Na zahtevek |
| **Največja velikost paketa** | 100 événements | Na klic paketa |

Omejitve velikosti paketov

Vsak paketni zahtevek lahko vsebuje največ 100 événements in ne sme preseči 500 KB. Za velike zgodovinske uvoze uporabi Bulk Import API Segment.

## Odpravljanje težav

| Težava | Vzrok | Rešitev |
| --- | --- | --- |
| Dogodki se ne prikažejo v Brevo | Destinacija ni omogočena | Omogoči destinacijo Tajo v Segment |
| Lastnosti uporabnika se ne sinhronizirajo | Manjka identifikator e-mail | Zagotovi, da je lastnost `email` vključena v klice identify |
| Podvojeni stiki | Več anonimnih ID-jev | Implementiraj pravilne klice `alias` za združevanje identitet |
| Zakasnjeni dogodki | Čakalna vrsta z velikim obsegom | Preveri nadzorno ploščo dostave événements Segment |
| Kršitve sheme | Nenačrtovani dogodki | Preglej plan sledenja Segment Protocols |
| Napake omejitve hitrosti 429 | Preveč zahtevkov | Implementiraj paketiranje ali zmanjšaj pogostost événements |

## Najboljše prakse

1. **Najprej identificiraj, nato sledi** – vedno pokliči `identify` pred `track`, da zagotoviš pravilno pripisovanje événements
2. **Implementiraj plan sledenja** – za uveljavljanje shem événements uporabi Segment Protocols
3. **Paketni klici na strani strežnika** – za zmanjšanje strežkov HTTP uporabi Batch API za integracije na strani strežnika
4. **Eksplicitno preslikaj lastnosti** – namesto zanašanja na privzetke opredeli preslikave lastnosti v atribute
5. **Uporabi Segment Functions** – preoblikuj événements med letom, preden dosežejo Brevo
6. **Spremljaj dostavo événements** – v nadzorni plošči Event Delivery Segment preveri neuspele événements
7. **Nastavi Replay** – za ponovnu obdelavo zgodovinskih événements omogoči Segment Replay

## Varnost

- **TLS šifriranje** – vsi podatki se prenašajo prek HTTPS/TLS 1.2+
- **Izolacija pisalnega ključa** – vsak vir ima lasten pisalni ključ
- **Skladnost z GDPR** – Segment podpira zahteve za brisanje in zavrnitev podatkov
- **SOC 2 Type II** – Segment je certificiran po SOC 2 Type II
- **Regionalno gostovanje podatkov** – možnost delovnega okolja EU za skladnost z lokacijo podatkov

## Povezani viri

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