Twilio Segment कनेक्टर

अपनी customer data pipeline को एकीकृत करने, किसी भी source से events को Brevo में route करने, और समृद्ध marketing automation के लिए Segment की identity resolution का लाभ उठाने हेतु Tajo के माध्यम से Twilio Segment को Brevo से कनेक्ट करें।

अवलोकन

विशेषताएं

• Universal data collection - Segment SDKs के माध्यम से websites, mobile apps, और servers से events एकत्र करें
• Source routing - Tajo के माध्यम से 400+ sources से data को Brevo में route करें
• Identity resolution - anonymous और known user profiles को स्वचालित रूप से merge करें
• Audience sync - Segment computed traits और audiences को Brevo lists में भेजें
• Event streaming - Segment के Connections framework के माध्यम से real-time event forwarding
• Reverse ETL - Segment Reverse ETL का उपयोग करके warehouse data को Brevo से वापस sync करें
• Schema enforcement - sync करने से पहले Segment Protocols के साथ event schemas validate करें

पूर्वावश्यकताएं

शुरू करने से पहले, सुनिश्चित करें कि आपके पास हैं:

1. configured source वाला एक Twilio Segment workspace
2. source के लिए आपकी Segment Write Key
3. API access वाला एक Brevo account
4. API credentials के साथ एक Tajo account

प्रमाणीकरण

Segment Write Key

Segment एक Write Key का उपयोग करके sources को authenticate करता है, जो प्रत्येक source से जुड़ा एक unique identifier है।

// Write Key के साथ Analytics.js initialization
analytics.load("YOUR_SEGMENT_WRITE_KEY");

Tajo API Token

Tajo connector को अपने credentials के साथ कॉन्फ़िगर करें:

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

कॉन्फ़िगरेशन

बेसिक सेटअप

connectors:
  segment:
    enabled: true
    write_key: "your-segment-write-key"
    data_region: "us"  # EU workspace के लिए "eu"

    # 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

Event Mapping

Segment track events को Brevo event types से map करें:

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"

Trait Mapping

Segment identify traits को Brevo contact attributes से map करें:

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

API Endpoints

कोड उदाहरण

Tajo Destination के साथ Segment शुरू करें

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

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

// Segment source कनेक्ट करें
await tajo.connectors.connect('segment', {
  writeKey: process.env.SEGMENT_WRITE_KEY,
  workspaceSlug: 'your-workspace'
});

Segment के माध्यम से Events ट्रैक करें

// एक user को identify करें - Brevo contacts से sync होता है
analytics.identify("user_123", {
  email: "[email protected]",
  firstName: "Jane",
  lastName: "Kim",
  plan: "premium",
  lifetimeValue: 450.00
});

// एक event ट्रैक करें - Brevo को forward होता है
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"
});

Server-Side Event Forwarding (Node.js)

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

// अपने database से users को batch identify करें
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
    }
  });
}

// queue flush करें
await analytics.flush();

Rate Limits

समस्या निवारण

सर्वोत्तम प्रथाएं

1. Track से पहले identify का उपयोग करें - यह सुनिश्चित करने के लिए कि events सही user को attribute होते हैं, हमेशा track से पहले identify call करें
2. एक tracking plan लागू करें - event schemas enforce करने के लिए Segment Protocols का उपयोग करें
3. Server-side calls batch करें - HTTP overhead कम करने के लिए server-side integrations के लिए batch API का उपयोग करें
4. Traits को स्पष्ट रूप से map करें - defaults पर निर्भर रहने के बजाय trait-to-attribute mappings परिभाषित करें
5. Segment Functions का उपयोग करें - events को Brevo तक पहुंचने से पहले in-flight transform करें
6. Event delivery monitor करें - failed events के लिए Segment के Event Delivery dashboard की जांच करें
7. Replay सेट करें - ऐतिहासिक events को पुनः process करने के लिए Segment Replay enable करें

सुरक्षा

• TLS encryption - सभी data HTTPS/TLS 1.2+ पर transmit होता है
• Write Key isolation - प्रत्येक source की अपनी Write Key होती है
• GDPR compliance - Segment data deletion और suppression requests को support करता है
• SOC 2 Type II - Segment SOC 2 Type II certified है
• Regional data hosting - data residency compliance के लिए EU workspace विकल्प

संबंधित संसाधन

• Amplitude कनेक्टर
• Mixpanel कनेक्टर
• Customer Sync Skill
• Brevo Events API