---
title: "Braze کنیکٹر"
description: "Tajo کے ذریعے گاہک engagement ڈیٹا، مہمات، اور پیغام رسانی ایونٹس کو Brevo کے ساتھ سنک کرنے کے لیے مکمل Braze انٹیگریشن گائیڈ۔"
url: https://tajo.io/ur/docs/connectors/marketing/braze/
markdown: https://tajo.io/ur/docs/connectors/marketing/braze.md
lang: ur-PK
robots: noindex
---

ابتدائی رسائی کی درخواست کریں

اپنا پہلا نام اور دفتری ای میل پتہ درج کریں۔ ہم Tajo تک رسائی کی درخواست کی تصدیق کے لیے ایک لنک ای میل کریں گے۔

# Braze کنیکٹر

کنیکٹر کی حیثیت: منصوبہ بند ابھی تیار نہیں ہوا۔ Tajo آج یہ کنیکٹر نہیں چلاتا۔

| ماخذ فیلڈ | منزل فیلڈ | نمونہ قدر |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

متحدہ گاہک پروفائلز، کراس چینل مہم orchestration، اور یکجا مارکیٹنگ اینالیٹکس کے لیے اپنے Braze engagement پلیٹ فارم کو Brevo سے منسلک کریں۔

## جائزہ

| خاصیت | قدر |
| --- | --- |
| **پلیٹ فارم** | Braze |
| **زمرہ** | مارکیٹنگ |
| **سیٹ اپ کی پیچیدگی** | درمیانی |
| **آفیشل انٹیگریشن** | نہیں |
| **سنک شدہ ڈیٹا** | گاہک، ایونٹس، مہمات، پیغامات |
| **API قسم** | REST API |
| **تصدیق** | API Key |
| **بنیادی URL** | `https://rest.iad-XX.braze.com` (instance مخصوص) |

## خصوصیات

- **صارف پروفائل سنک** - Braze اور Brevo کے درمیان دو طرفہ گاہک خصوصیت سنکرونائزیشن
- **مہم ایونٹ ٹریکنگ** - ای میل اوپن، کلکس، تبادلے، اور ان سبسکرائب ٹریک کریں
- **Canvas فلو ڈیٹا** - متحدہ رپورٹنگ کے لیے ملٹی اسٹیپ مہم journey ڈیٹا سنک کریں
- **سیگمنٹ مرورنگ** - کراس پلیٹ فارم targeting کے لیے Braze سیگمنٹس کو Brevo فہرستوں کے طور پر نقل کریں
- **پش نوٹیفکیشن ایونٹس** - پش engagement ڈیٹا کو Brevo رابطہ ٹائم لائنز پر فارورڈ کریں
- **Catalog سنک** - ذاتی نوعیت کی سفارشات کے لیے پروڈکٹ catalogs کو ہم آہنگ کریں

## شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

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 کو مخصوص اینڈ پوائنٹس پر اسکوپ کیا جا سکتا ہے۔

### API Key بنانا

1. اپنے Braze dashboard میں لاگ ان کریں
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
```

API Key سیکیورٹی

اپنا Braze API key محفوظ طریقے سے اسٹور کریں۔ اسے کبھی کلائنٹ سائڈ کوڈ یا عوامی repositories میں ظاہر نہ کریں۔ Tajo تمام API کریڈینشلز کو AES-256 کا استعمال کرتے ہوئے آرام پر انکرپٹ کرتا ہے۔

### Tajo سے منسلک ہونا

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

## تشکیل

### بنیادی سیٹ اپ

```yaml
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 رابطہ خصوصیات پر میپ کریں:

```yaml
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 اینڈ پوائنٹس کے ساتھ انٹیگریٹ ہوتا ہے:

| اینڈ پوائنٹ | طریقہ | مقصد |
| --- | --- | --- |
| `/users/track` | POST | صارف خصوصیات، ایونٹس، اور خریداریاں بھیجیں |
| `/users/export/ids` | POST | external IDs کے ذریعے صارف پروفائلز ایکسپورٹ کریں |
| `/users/export/segment` | POST | ایک سیگمنٹ سے صارفین کو ایکسپورٹ کریں |
| `/campaigns/list` | GET | مہمات کی فہرست حاصل کریں |
| `/campaigns/data_series` | GET | وقت کے ساتھ مہم اینالیٹکس |
| `/canvas/list` | GET | Canvas فلوز کی فہرست حاصل کریں |
| `/canvas/data_series` | GET | وقت کے ساتھ Canvas اینالیٹکس |
| `/segments/list` | GET | سیگمنٹس کی فہرست حاصل کریں |
| `/email/status` | POST | ای میل سبسکرپشن اسٹیٹس تبدیل کریں |
| `/subscription/status/set` | POST | سبسکرپشن گروپ اسٹیٹس سیٹ کریں |
| `/catalogs/{catalog_name}/items` | GET | catalog آئٹمز حاصل کریں |

## کوڈ کی مثالیں

### کنیکٹر کو انیشیلائز کریں

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

### صارف پروفائلز سنک کریں

```javascript
// 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
// }
```

### کسٹم ایونٹس ٹریک کریں

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

### سیگمنٹ ڈیٹا ایکسپورٹ کریں

```javascript
// 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 آپ کے پلان اور instance کی بنیاد پر شرح کی حدود نافذ کرتا ہے:

| پلان | شرح کی حد | برسٹ حد |
| --- | --- | --- |
| **Starter** | 250,000 درخواستیں/گھنٹہ | N/A |
| **Pro** | 250,000 درخواستیں/گھنٹہ | N/A |
| **Enterprise** | کسٹم | کسٹم |

`/users/track` اینڈ پوائنٹ کی default حد 50,000 درخواستیں فی منٹ ہے۔ Tajo exponential backoff کے ساتھ شرح کی حد کو خودکار طور پر سنبھالتا ہے۔

بیچ درخواستیں

Tajo شرح کی حدود کے اندر throughput زیادہ سے زیادہ کرنے کے لیے فی `/users/track` درخواست 75 صارف خصوصیات، 75 ایونٹس، اور 75 خریداریاں بیچ کرتا ہے۔

## ٹربل شوٹنگ

### عام مسائل

| مسئلہ | وجہ | حل |
| --- | --- | --- |
| 401 Unauthorized | غلط یا میعاد ختم API key | Braze dashboard میں API key دوبارہ بنائیں |
| صارفین سنک نہیں ہو رہے | غلط instance URL | اپنے Braze instance URL کی تصدیق کریں (مثلاً iad-01, iad-02) |
| غائب خصوصیات | API key اسکوپ بہت تنگ | API key میں مطلوبہ اجازتیں شامل کریں |
| شرح کی حد سے تجاوز | بہت زیادہ بیک وقتی درخواستیں | بیچ سائز یا سنک تعدد کم کریں |
| ایونٹس میں تاخیر | بڑی export queue | مکمل export کے بجائے incremental sync استعمال کریں |

### ڈیبگ موڈ

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

### کنکشن ٹیسٹ کریں

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

## بہترین طرز عمل

1. **Incremental syncs استعمال کریں** - مکمل exports سے گریز کریں؛ آخری sync کے بعد صرف تبدیل شدہ ریکارڈز سنک کریں
2. **بیچ صارف اپ ڈیٹس** - API کالز کو کم کرنے کے لیے خصوصیت تبدیلیوں کو گروپ کریں
3. **API keys کو تنگ اسکوپ کریں** - صرف وہی اجازتیں فعال کریں جن کی آپ کے انٹیگریشن کو ضرورت ہے
4. **شرح کی حدود کی نگرانی کریں** - Braze شرح کی حدود تک پہنچنے سے پہلے الرٹس سیٹ کریں
5. **External IDs کو مستقل طور پر میپ کریں** - Braze اور Brevo میں ایک ہی شناخت کنندہ استعمال کریں
6. **پہلے sandbox میں ٹیسٹ کریں** - پروڈکشن تعیناتی سے پہلے Braze test workspace استعمال کریں

## سیکیورٹی

- **API Key تصدیق** - گرانولر اجازتوں کے ساتھ اسکوپڈ API keys
- **HTTPS صرف** - تمام API مواصلات TLS 1.2+ کے ذریعے انکرپٹڈ
- **IP اجازت دینا** - Braze میں API رسائی کے لیے اختیاری IP پابندی
- **انکرپٹڈ اسٹوریج** - API کریڈینشلز Tajo میں آرام پر انکرپٹڈ
- **Audit Logging** - کمپلائنس جائزے کے لیے تمام API کالز لاگ شدہ

## متعلقہ وسائل

- [Customer.io کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/customerio)
- [Iterable کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/iterable)
- [گاہک سنک اسکل](https://tajo.io/ur/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/ur/docs/contact-management)