---
title: "Σύνδεσμος Braze"
description: "Πλήρης οδηγός ενσωμάτωσης Braze για συγχρονισμό δεδομένων αφοσίωσης πελατών, καμπανιών και εκδηλώσεων μηνυμάτων με το Brevo μέσω Tajo."
url: https://tajo.io/gr/docs/connectors/marketing/braze/
markdown: https://tajo.io/gr/docs/connectors/marketing/braze.md
lang: el-GR
robots: noindex
---

Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το μικρό σας όνομα και την επαγγελματική διεύθυνση email. Θα σας στείλουμε σύνδεσμο για να επιβεβαιώσετε το αίτημα πρόσβασης στο Tajo.

# Σύνδεσμος Braze

Κατάσταση συνδέσμου: Προγραμματισμένο Δεν έχει κατασκευαστεί ακόμη. Το Tajo δεν εκτελεί σήμερα αυτόν τον σύνδεσμο.

| Πεδίο πηγής | Πεδίο προορισμού | Ενδεικτική τιμή |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Συνδέστε την πλατφόρμα αφοσίωσης Braze με το Brevo για ενοποιημένα προφίλ πελατών, ενορχήστρωση καμπανιών πολλαπλών καναλιών και ενοποιημένα αναλυτικά marketing.

## Επισκόπηση

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Braze |
| **Κατηγορία** | Marketing |
| **Πολυπλοκότητα Ρύθμισης** | Μέτρια |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Πελάτες, Εκδηλώσεις, Καμπάνιες, Μηνύματα |
| **Τύπος API** | REST API |
| **Πιστοποίηση** | API Key |
| **Βασικό URL** | `https://rest.iad-XX.braze.com` (συγκεκριμένο για instance) |

## Χαρακτηριστικά

- **Συγχρονισμός προφίλ χρήστη** - Αμφίδρομος συγχρονισμός χαρακτηριστικών πελάτη μεταξύ Braze και Brevo
- **Παρακολούθηση εκδηλώσεων καμπάνιας** - Παρακολούθηση ανοιγμάτων email, κλικ, μετατροπών και κατάργησης εγγραφής
- **Δεδομένα ροής Canvas** - Συγχρονισμός δεδομένων διαδρομής καμπάνιας πολλαπλών βημάτων για ενοποιημένες αναφορές
- **Αντικατοπτρισμός τμήματος** - Αναπαραγωγή τμημάτων Braze ως λίστες Brevo για στόχευση διαπλατφόρμων
- **Εκδηλώσεις ειδοποιήσεων push** - Προώθηση δεδομένων αφοσίωσης push σε χρονοδιαγράμματα επαφών Brevo
- **Συγχρονισμός καταλόγου** - Συγχρονισμός καταλόγων προϊόντων για εξατομικευμένες συστάσεις

## Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό Braze με ενεργοποιημένη πρόσβαση API
2. Κλειδί REST API Braze με κατάλληλα δικαιώματα
3. Το URL του instance Braze σας (π.χ. `rest.iad-01.braze.com`)
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με ενεργή συνδρομή

## Πιστοποίηση

Το Braze χρησιμοποιεί πιστοποίηση με κλειδί API. Κάθε κλειδί API μπορεί να έχει εύρος σε συγκεκριμένα endpoints.

### Δημιουργία Κλειδιού API

1. Συνδεθείτε στο dashboard Braze
2. Μεταβείτε στις **Ρυθμίσεις** > **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

Αποθηκεύστε το κλειδί API Braze με ασφάλεια. Μην το εκθέτετε ποτέ σε κώδικα πλευράς client ή δημόσια αποθετήρια. Το 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
```

## Endpoints API

Το Tajo ενσωματώνεται με τα ακόλουθα endpoints REST API Braze:

| Endpoint | Μέθοδος | Σκοπός |
| --- | --- | --- |
| `/users/track` | POST | Αποστολή χαρακτηριστικών χρήστη, εκδηλώσεων και αγορών |
| `/users/export/ids` | POST | Εξαγωγή προφίλ χρήστη κατά εξωτερικά 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 | Αλλαγή κατάστασης εγγραφής email |
| `/subscription/status/set` | POST | Ορισμός κατάστασης ομάδας συνδρομής |
| `/catalogs/{catalog_name}/items` | GET | Ανάκτηση στοιχείων καταλόγου |

## Παραδείγματα Κώδικα

### Αρχικοποίηση Συνδέσμου

```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 σας:

| Πλάνο | Όριο Ρυθμού | Burst Limit |
| --- | --- | --- |
| **Starter** | 250.000 αιτήματα/ώρα | Δ/Ε |
| **Pro** | 250.000 αιτήματα/ώρα | Δ/Ε |
| **Enterprise** | Προσαρμοσμένο | Προσαρμοσμένο |

Το endpoint `/users/track` έχει προεπιλεγμένο όριο 50.000 αιτημάτων ανά λεπτό. Το Tajo χειρίζεται αυτόματα τον περιορισμό ρυθμού με εκθετική καθυστέρηση.

Αιτήματα Batch

Το Tajo ομαδοποιεί έως 75 χαρακτηριστικά χρήστη, 75 εκδηλώσεις και 75 αγορές ανά αίτημα `/users/track` για μεγιστοποίηση throughput εντός ορίων ρυθμού.

## Αντιμετώπιση Προβλημάτων

### Συνήθη Προβλήματα

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| 401 Unauthorized | Μη έγκυρο ή ληγμένο κλειδί API | Αναγεννήστε κλειδί API στο dashboard Braze |
| Οι χρήστες δεν συγχρονίζονται | Λανθασμένο URL instance | Επαληθεύστε το URL instance Braze (π.χ. iad-01, iad-02) |
| Λείπουν χαρακτηριστικά | Εύρος κλειδιού API πολύ στενό | Προσθέστε απαιτούμενα δικαιώματα στο κλειδί API |
| Υπέρβαση ορίου ρυθμού | Υπερβολικά πολλά ταυτόχρονα αιτήματα | Μειώστε μέγεθος batch ή συχνότητα συγχρονισμού |
| Καθυστέρηση εκδηλώσεων | Μεγάλη ουρά εξαγωγής | Χρησιμοποιήστε σταδιακό συγχρονισμό αντί για πλήρη εξαγωγή |

### Λειτουργία Εντοπισμού Σφαλμάτων

```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. **Χρησιμοποιήστε σταδιακούς συγχρονισμούς** - Αποφύγετε πλήρεις εξαγωγές· συγχρονίστε μόνο αλλαγμένες εγγραφές από τον τελευταίο συγχρονισμό
2. **Ομαδοποιήστε ενημερώσεις χρήστη** - Ομαδοποιήστε αλλαγές χαρακτηριστικών για ελαχιστοποίηση κλήσεων API
3. **Ορίστε εύρος κλειδιών API στενά** - Ενεργοποιήστε μόνο τα δικαιώματα που χρειάζεται η ενσωμάτωσή σας
4. **Παρακολουθήστε όρια ρυθμού** - Ρυθμίστε ειδοποιήσεις πριν φτάσετε σε όρια ρυθμού Braze
5. **Αντιστοιχίστε εξωτερικά IDs με συνέπεια** - Χρησιμοποιήστε το ίδιο αναγνωριστικό σε Braze και Brevo
6. **Δοκιμάστε πρώτα σε sandbox** - Χρησιμοποιήστε χώρο εργασίας δοκιμής Braze πριν την ανάπτυξη παραγωγής

## Ασφάλεια

- **Πιστοποίηση API Key** - Κλειδιά API με εύρος και λεπτομερή δικαιώματα
- **Μόνο HTTPS** - Όλη η επικοινωνία API κρυπτογραφείται μέσω TLS 1.2+
- **IP Allowlisting** - Προαιρετικός περιορισμός IP για πρόσβαση API στο Braze
- **Κρυπτογραφημένη Αποθήκευση** - Τα διαπιστευτήρια API κρυπτογραφούνται σε ηρεμία στο Tajo
- **Αρχείο Καταγραφής Ελέγχου** - Όλες οι κλήσεις API καταγράφονται για έλεγχο συμμόρφωσης

## Σχετικοί Πόροι

- [Σύνδεσμος Customer.io](https://tajo.io/gr/docs/connectors/marketing/customerio)
- [Σύνδεσμος Iterable](https://tajo.io/gr/docs/connectors/marketing/iterable)
- [Δεξιότητα Συγχρονισμού Πελατών](https://tajo.io/gr/docs/skills/data-sync/customer-sync)
- [API Επαφών Brevo](https://tajo.io/gr/docs/contact-management)