---
title: "Twilio Segment Konektor"
description: "Kompletan vodič za integraciju Twilio Segmenta za sinkronizaciju korisničkih podataka, događaja i segmenata publike s Brevom putem Taja."
url: https://tajo.io/hr/docs/connectors/custom/segment/
markdown: https://tajo.io/hr/docs/connectors/custom/segment.md
lang: hr-HR
robots: noindex
---

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju.

# Twilio Segment Konektor

Status konektora: Planirano Još nije izrađeno. Tajo danas ne pokreće ovaj konektor.

| Izvorno polje | Odredišno polje | Primjer vrijednosti |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Povežite Twilio Segment s Brevom putem Taja kako biste ujedinili cjevovod korisničkih podataka, usmjeravali događaje iz bilo kojeg izvora u Brevo i iskoristili Segmentovo razrješavanje identiteta za bogatiju marketinšku automatizaciju.

## Pregled

| Svojstvo | Vrijednost |
| --- | --- |
| **Platforma** | Twilio Segment |
| **Kategorija** | Platforma podataka (Prilagođeno) |
| **Složenost postavljanja** | Srednje |
| **Službena integracija** | Ne |
| **Sinkronizirani podaci** | Događaji, Korisnici, Osobine, Publike |
| **Dostupne vještine** | 8 |

## Značajke

- **Univerzalno prikupljanje podataka** - Prikupljajte događaje s web stranica, mobilnih aplikacija i servera putem Segment SDK-ova
- **Usmjeravanje izvora** - Usmjeravajte podatke iz 400+ izvora u Brevo putem Taja
- **Razrješavanje identiteta** - Automatski spajajte anonimne i poznate korisničke profile
- **Sinkronizacija publike** - Slanje Segment izračunatih osobina i publika na Brevo popise
- **Strujanje događaja** - Prosljeđivanje događaja u stvarnom vremenu putem Segmentovog okvira Connections
- **Reverse ETL** - Sinkronizacija podataka iz skladišta natrag u Brevo koristeći Segment Reverse ETL
- **Provedba sheme** - Validacija shema događaja s Segment Protocols prije sinkronizacije

## Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Twilio Segment radni prostor s konfiguriranim izvorom
2. Segment Write Key za izvor
3. Brevo račun s API pristupom
4. Tajo račun s API vjerodajnicama

## Autentifikacija

### Segment Write Key

Segment autenticira izvore koristeći Write Key, koji je jedinstveni identifikator vezan za svaki izvor.

```javascript
// Inicijalizacija Analytics.js s Write Keyom
analytics.load("YOUR_SEGMENT_WRITE_KEY");
```

### Tajo API Token

Konfigurirajte Tajo konektor s vašim vjerodajnicama:

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

## Konfiguracija

### Osnovna konfiguracija

```yaml
connectors:
  segment:
    enabled: true
    write_key: "your-segment-write-key"
    data_region: "us"  # ili "eu" za EU radni prostor

    # Opcije sinkronizacije podataka
    sync:
      identify: true
      track: true
      page: true
      group: false

    # Dodjela Brevo popisa
    lists:
      all_contacts: 5
      active_users: 6
      high_value: 7
```

### Mapiranje događaja

Mapirajte Segment track događaje na Brevo vrste događaja:

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

  # Prilagođeni događaji
  "Feature Used": "feature_used"
  "Plan Upgraded": "plan_upgraded"
```

### Mapiranje osobina

Mapirajte Segment identify osobine na Brevo atribute kontakata:

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

## API krajnje točke

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `POST` | `/v1/identify` | Identificirajte korisnika s osobinama |
| `POST` | `/v1/track` | Pratite događaj |
| `POST` | `/v1/page` | Zabilježite pregled stranice |
| `POST` | `/v1/screen` | Zabilježite pregled zaslona |
| `POST` | `/v1/group` | Povežite korisnika s grupom |
| `POST` | `/v1/alias` | Spojite dva korisnička identiteta |
| `POST` | `/v1/batch` | Pošaljite više poruka u skupini |
| `POST` | `/v1/import` | Skupni uvoz povijesnih podataka |

## Primjeri koda

### Inicijalizacija Segment konektora s Tajo odredištem

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

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

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

### Praćenje događaja putem Segmenta

```javascript
// Identificirajte korisnika - sinkronizira se s Brevo kontaktima
analytics.identify("user_123", {
  email: "jane@example.com",
  firstName: "Jane",
  lastName: "Kim",
  plan: "premium",
  lifetimeValue: 450.00
});

// Pratite događaj - prosljeđuje se u Brevo
analytics.track("Order Completed", {
  orderId: "ORD-1234",
  revenue: 89.99,
  currency: "USD",
  products: [
    { id: "SKU-001", name: "Widget", price: 89.99 }
  ]
});

// Praćenje pregledavanja stranica
analytics.page("Pricing", {
  title: "Pricing - Tajo",
  url: "https://tajo.io/pricing"
});
```

### Prosljeđivanje događaja na strani servera (Node.js)

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

// Skupno identificirajte korisnike iz vaše baze podataka
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
    }
  });
}

// Isperite red čekanja
await analytics.flush();
```

## Ograničenja brzine

| Razina | Ograničenje | Prozor |
| --- | --- | --- |
| **Besplatno** | 1.000 događaja/s | Po izvoru |
| **Tim** | 10.000 događaja/s | Po izvoru |
| **Poslovno** | Prilagođeno | Po radnom prostoru |
| **Batch API** | Maks. 500 KB | Po zahtjevu |
| **Maks. veličina skupne obrade** | 100 događaja | Po batch pozivu |

Ograničenja veličine skupne obrade

Svaki batch zahtjev može sadržavati najviše 100 događaja i ne smije premašiti 500 KB. Za veliki povijesni uvoz, koristite Segment Bulk Import API.

## Rješavanje problema

| Problem | Uzrok | Rješenje |
| --- | --- | --- |
| Događaji se ne pojavljuju u Brevu | Odredište nije omogućeno | Omogućite Tajo odredište u Segmentu |
| Osobine korisnika se ne sinkroniziraju | Nedostaje identifikator e-maila | Osigurajte da je osobina `email` uključena u identify pozive |
| Duplikati kontakata | Višestruki anonimni ID-ovi | Implementirajte odgovarajuće `alias` pozive za spajanje identiteta |
| Zakašnjeli događaji | Viskovoluenski red čekanja | Provjerite Segmentovu nadzornu ploču isporuke događaja |
| Kršenja sheme | Neplanirani događaji | Pregledajte Segment Protocols plan praćenja |
| Greške ograničenja brzine 429 | Previše zahtjeva | Implementirajte skupnu obradu ili smanjite učestalost događaja |

## Preporučene prakse

1. **Koristite identify prije track** - Uvijek pozovite `identify` prije `track` kako biste osigurali da su događaji pripisani ispravnom korisniku
2. **Implementirajte plan praćenja** - Koristite Segment Protocols za provedbu shema događaja
3. **Skupni pozivi na strani servera** - Koristite batch API za integracije na strani servera za smanjenje HTTP opterećenja
4. **Eksplicitno mapirajte osobine** - Definirajte mapiranja osobina na atribute umjesto oslanjanja na zadane vrijednosti
5. **Koristite Segment Functions** - Transformirajte događaje u letu prije nego što stignu u Brevo
6. **Pratite isporuku događaja** - Provjerite Segmentovu nadzornu ploču isporuke događaja za neuspjele događaje
7. **Postavite Replay** - Omogućite Segment Replay za ponovnu obradu povijesnih događaja

## Sigurnost

- **TLS enkripcija** - Svi podaci preneseni putem HTTPS/TLS 1.2+
- **Izolacija Write Keya** - Svaki izvor ima vlastiti Write Key
- **GDPR usklađenost** - Segment podržava zahtjeve za brisanje i suzbijanje podataka
- **SOC 2 Type II** - Segment je SOC 2 Type II certificiran
- **Regionalno hostanje podataka** - Opcija EU radnog prostora za usklađenost s rezidencijom podataka

## Povezani resursi

- [Amplitude Konektor](https://tajo.io/hr/docs/connectors/custom/amplitude)
- [Mixpanel Konektor](https://tajo.io/hr/docs/connectors/custom/mixpanel)
- [Vještina sinkronizacije korisnika](https://tajo.io/hr/docs/skills/data-sync/customer-sync)
- [Brevo API događaja](https://tajo.io/hr/docs/events-engagement/create-event)