Braze कनेक्टर

एकीकृत ग्राहक प्रोफ़ाइल्स, क्रॉस-चैनल कैंपेन ऑर्केस्ट्रेशन, और समेकित मार्केटिंग एनालिटिक्स के लिए अपने Braze एंगेजमेंट प्लेटफ़ॉर्म को Brevo से कनेक्ट करें।

अवलोकन

विशेषताएं

• उपयोगकर्ता प्रोफ़ाइल सिंक - Braze और Brevo के बीच द्विदिशीय ग्राहक एट्रिब्यूट सिंक्रनाइज़ेशन
• कैंपेन इवेंट ट्रैकिंग - ईमेल ओपन्स, क्लिक्स, कन्वर्जन्स, और अनसब्सक्राइब्स ट्रैक करें
• Canvas फ़्लो डेटा - एकीकृत रिपोर्टिंग के लिए मल्टी-स्टेप कैंपेन यात्रा डेटा सिंक करें
• सेगमेंट मिररिंग - क्रॉस-प्लेटफ़ॉर्म टार्गेटिंग के लिए Braze सेगमेंट्स को Brevo लिस्ट्स के रूप में दोहराएं
• पुश सूचना इवेंट्स - Brevo कॉन्टैक्ट टाइमलाइन्स पर पुश एंगेजमेंट डेटा फ़ॉरवर्ड करें
• कैटलॉग सिंक - व्यक्तिगत सिफारिशों के लिए उत्पाद कैटलॉग सिंक्रनाइज़ करें

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

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

1. API एक्सेस सक्षम के साथ एक Braze खाता
2. उपयुक्त अनुमतियों के साथ एक Braze REST API key
3. आपका Braze instance URL (जैसे, rest.iad-01.braze.com)
4. API एक्सेस वाला एक Brevo खाता
5. एक सक्रिय सब्सक्रिप्शन वाला Tajo खाता

प्रमाणीकरण

Braze API key प्रमाणीकरण का उपयोग करता है। प्रत्येक API key को विशिष्ट एंडपॉइंट्स पर scope किया जा सकता है।

एक API Key बनाना

1. अपने Braze डैशबोर्ड में लॉग इन करें
2. Settings > API Keys पर जाएं
3. Create New API Key पर क्लिक करें
4. इसे “Tajo Integration” नाम दें
5. निम्नलिखित अनुमतियां सक्षम करें:

users.track
users.export.ids
users.export.segment
campaigns.list
campaigns.data_series
canvas.list
canvas.data_series
segments.list
segments.data_series
email.status
subscription.status.set
catalogs.list_items

Tajo से कनेक्ट करना

tajo connectors install braze \
  --api-key $BRAZE_API_KEY \
  --instance-url rest.iad-01.braze.com

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

बुनियादी सेटअप

connectors:
  braze:
    enabled: true
    instance_url: "rest.iad-01.braze.com"
    api_version: "v1"

    sync:
      users: true
      campaigns: true
      canvases: true
      segments: true
      events: true

    lists:
      engaged_users: 10
      dormant_users: 11

फ़ील्ड मैपिंग

Braze उपयोगकर्ता एट्रिब्यूट्स को Brevo कॉन्टैक्ट एट्रिब्यूट्स में मैप करें:

field_mapping:
  # Standard fields
  external_id: BRAZE_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Engagement metrics
  total_revenue: TOTAL_REVENUE
  push_opted_in: PUSH_OPTIN
  email_subscribe: EMAIL_STATUS

  # Custom attributes
  loyalty_points: LOYALTY_POINTS
  last_app_version: APP_VERSION
  preferred_language: LANGUAGE

API एंडपॉइंट्स

Tajo निम्नलिखित Braze REST API एंडपॉइंट्स के साथ इंटीग्रेट होता है:

कोड उदाहरण

कनेक्टर प्रारंभ करें

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

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

await tajo.connectors.connect('braze', {
  apiKey: process.env.BRAZE_API_KEY,
  instanceUrl: 'rest.iad-01.braze.com'
});

उपयोगकर्ता प्रोफ़ाइल सिंक करें

// Sync Braze users to Brevo contacts
await tajo.connectors.sync('braze', {
  type: 'incremental',
  resources: ['users'],
  since: '2024-01-01',
  batchSize: 50
});

// Check sync status
const status = await tajo.connectors.status('braze');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T10:30:00Z',
//   usersCount: 45200,
//   campaignsTracked: 28,
//   eventsProcessed: 125000
// }

कस्टम इवेंट्स ट्रैक करें

// Forward Braze events to Brevo
await tajo.connectors.handleEvent('braze', {
  type: 'user.event',
  payload: {
    external_id: 'user_12345',
    name: 'product_viewed',
    properties: {
      product_id: 'SKU-789',
      category: 'electronics',
      price: 299.99
    }
  }
});

सेगमेंट डेटा निर्यात करें

// Export a Braze segment and create a Brevo list
const result = await tajo.connectors.exportSegment('braze', {
  segmentId: 'segment_abc123',
  targetList: 15,
  includeAttributes: ['email', 'first_name', 'last_name', 'total_revenue']
});

console.log(`Exported ${result.count} users to Brevo list 15`);

दर सीमाएं

Braze आपके प्लान और इंस्टेंस के आधार पर दर सीमाएं लागू करता है:

/users/track एंडपॉइंट की डिफ़ॉल्ट सीमा 50,000 अनुरोध प्रति मिनट है। Tajo स्वचालित रूप से exponential backoff के साथ दर सीमा को संभालता है।

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

सामान्य समस्याएं

डीबग मोड

connectors:
  braze:
    debug: true
    log_level: verbose
    log_api_calls: true

कनेक्शन परीक्षण करें

tajo connectors test braze
# ✓ API connection successful
# ✓ User export accessible
# ✓ Campaign data readable
# ✓ Segment list accessible
# ✓ Event tracking operational

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

1. incremental syncs का उपयोग करें - पूर्ण निर्यात से बचें; पिछले sync के बाद से केवल बदले गए रिकॉर्ड्स सिंक करें
2. उपयोगकर्ता अपडेट बैच करें - API कॉल्स को कम करने के लिए एट्रिब्यूट परिवर्तनों को समूहबद्ध करें
3. API keys को संकीर्ण scope करें - केवल वही अनुमतियां सक्षम करें जिनकी आपके इंटीग्रेशन को आवश्यकता है
4. दर सीमाओं की निगरानी करें - Braze दर सीमाओं तक पहुंचने से पहले अलर्ट सेट करें
5. external IDs को लगातार मैप करें - Braze और Brevo में समान पहचानकर्ता का उपयोग करें
6. पहले sandbox में परीक्षण करें - प्रोडक्शन तैनाती से पहले Braze test workspace का उपयोग करें

सुरक्षा

• API Key प्रमाणीकरण - granular अनुमतियों के साथ scoped API keys
• HTTPS Only - सभी API संचार TLS 1.2+ के माध्यम से एन्क्रिप्टेड
• IP Allowlisting - Braze में API एक्सेस के लिए वैकल्पिक IP प्रतिबंध
• एन्क्रिप्टेड स्टोरेज - Tajo में रेस्ट पर API क्रेडेंशियल्स एन्क्रिप्टेड
• ऑडिट लॉगिंग - अनुपालन समीक्षा के लिए सभी API कॉल लॉग किए गए

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

• Customer.io Connector
• Iterable Connector
• Customer Sync Skill
• Brevo Contacts API