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

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

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

# Σύνδεσμος Amplitude

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

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

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

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

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Amplitude |
| **Κατηγορία** | Αναλυτικά (Προσαρμοσμένο) |
| **Πολυπλοκότητα Ρύθμισης** | Μεσαία |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Εκδηλώσεις, Χρήστες, Cohorts, Ιδιότητες |
| **Διαθέσιμες Δεξιότητες** | 6 |

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

- **Προώθηση εκδηλώσεων** - Αποστολή track events Amplitude στο Brevo για ενεργοποιητές αυτοματοποίησης marketing
- **Συγχρονισμός cohort** - Εξαγωγή συμπεριφορικών cohorts Amplitude ως λίστες επαφών Brevo
- **Συγχρονισμός ιδιοτήτων χρήστη** - Αντιστοίχιση ιδιοτήτων χρήστη Amplitude σε χαρακτηριστικά επαφών Brevo
- **Παρακολούθηση εσόδων** - Συγχρονισμός εκδηλώσεων εσόδων για ανάλυση αξίας κύκλου ζωής πελατών
- **Συμπεριφορική τμηματοποίηση** - Χρήση δεδομένων αλληλεπίδρασης Amplitude σε τμήματα Brevo
- **Ενσωμάτωση HTTP V2 API** - Άμεση ενσωμάτωση με το HTTP V2 API εισαγωγής Amplitude

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

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

1. Λογαριασμό Amplitude με δημιουργημένο project
2. Το API Key και Secret Key Amplitude
3. Λογαριασμό Brevo με πρόσβαση API
4. Λογαριασμό Tajo με διαπιστευτήρια API

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

### Κλειδιά API Amplitude

Το Amplitude χρησιμοποιεί ζεύγη API Key και Secret Key για πιστοποίηση. Το API Key προσδιορίζει το project σας, ενώ το Secret Key πιστοποιεί αιτήματα στην πλευρά του server.

```bash
# Find your keys in Amplitude:
# Settings > Projects > [Your Project] > General
```

### Πιστοποίηση HTTP V2 API

Το HTTP V2 API χρησιμοποιεί το API key στο σώμα του αιτήματος:

```bash
curl -X POST https://api2.amplitude.com/2/httpapi \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_AMPLITUDE_API_KEY",
    "events": [...]
  }'
```

## Διαμόρφωση

### Βασική Ρύθμιση

```yaml
connectors:
  amplitude:
    enabled: true
    api_key: "your-amplitude-api-key"
    secret_key: "your-amplitude-secret-key"
    data_center: "US"  # or "EU"

    # Data sync options
    sync:
      events: true
      user_properties: true
      cohorts: true
      revenue: true

    # Brevo list assignment
    lists:
      active_users: 10
      power_users: 11
      churning_users: 12
```

### Αντιστοίχιση Εκδηλώσεων

Αντιστοιχίστε εκδηλώσεις Amplitude σε ενεργοποιητές αυτοματισμού Brevo:

```yaml
event_mapping:
  # Amplitude event -> Brevo event
  "Purchase": "order_completed"
  "Sign Up": "customer_created"
  "Add to Cart": "cart_updated"
  "Page View": "page_viewed"
  "Feature Click": "feature_used"

  # Revenue events
  "Revenue": "revenue_event"
  "Subscription Started": "subscription_created"
```

### Αντιστοίχιση Ιδιοτήτων Χρήστη

Αντιστοιχίστε ιδιότητες χρήστη Amplitude σε χαρακτηριστικά επαφών Brevo:

```yaml
property_mapping:
  # Amplitude property -> Brevo attribute
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS
  plan_type: PLAN
  signup_date: SIGNUP_DATE
  total_purchases: ORDER_COUNT
  lifetime_revenue: LTV
  last_active: LAST_ACTIVE
  device_type: DEVICE
```

## Endpoints API

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `POST` | `/2/httpapi` | Μεταφόρτωση εκδηλώσεων (HTTP V2 API) |
| `POST` | `/batch` | Μαζική μεταφόρτωση εκδηλώσεων (Batch API) |
| `POST` | `/identify` | Ορισμός ιδιοτήτων χρήστη |
| `POST` | `/groupidentify` | Ορισμός ιδιοτήτων ομάδας |
| `GET` | `/2/export` | Εξαγωγή ακατέργαστων δεδομένων εκδηλώσεων |
| `GET` | `/2/usersearch` | Αναζήτηση χρηστών |
| `GET` | `/2/useractivity` | Λήψη χρονοδιαγράμματος δραστηριότητας χρήστη |
| `POST` | `/api/3/cohort/export` | Εξαγωγή μελών cohort |
| `GET` | `/api/3/chart/{chart_id}/query` | Ερώτημα αποθηκευμένων δεδομένων γραφήματος |

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

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

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

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

// Connect Amplitude project
await tajo.connectors.connect('amplitude', {
  apiKey: process.env.AMPLITUDE_API_KEY,
  secretKey: process.env.AMPLITUDE_SECRET_KEY,
  dataCenter: 'US'
});
```

### Αποστολή Εκδηλώσεων μέσω HTTP V2 API

```javascript
// Send events to Amplitude (automatically forwarded to Brevo)
const response = await fetch('https://api2.amplitude.com/2/httpapi', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    api_key: process.env.AMPLITUDE_API_KEY,
    events: [
      {
        user_id: "user_123",
        event_type: "Purchase",
        event_properties: {
          revenue: 89.99,
          product_id: "SKU-001",
          product_name: "Widget Pro"
        },
        user_properties: {
          $set: {
            email: "jane@example.com",
            plan_type: "premium"
          }
        },
        time: Date.now()
      }
    ]
  })
});

// Expected response: { "code": 200, "events_ingested": 1 }
```

### Συγχρονισμός Cohort σε Λίστα Brevo

```javascript
// Export an Amplitude cohort and sync to Brevo
const cohort = await tajo.connectors.syncCohort('amplitude', {
  cohortId: 'abc123',
  targetList: 11,  // Brevo list ID
  syncMode: 'mirror'  // mirror, append, or remove
});

console.log(cohort);
// {
//   cohortName: "Power Users",
//   membersCount: 2450,
//   syncedToBrevo: 2450,
//   listId: 11
// }
```

## Όρια Ρυθμού

| API | Όριο | Λεπτομέρειες |
| --- | --- | --- |
| **HTTP V2 API** | 1.000 εκδηλώσεις/δευτ. | Ανά project, έκρηξη έως 2.000/δευτ. |
| **Batch API** | 1.000 εκδηλώσεις/batch | Μέγ. 20 batches/δευτ. |
| **Identify API** | 1.000 αιτ./δευτ. | Ανά project |
| **Export API** | 360 αιτήματα/ώρα | Ανά project |
| **Εξαγωγή Cohort** | 1 ταυτόχρονη εξαγωγή | Ανά cohort |
| **Dashboard REST API** | 360 αιτήματα/ώρα | Ανά project |

Όρια Μεγέθους Εκδηλώσεων

Κάθε payload εκδήλωσης δεν μπορεί να υπερβαίνει τα 1 MB. Το HTTP V2 API δέχεται έως 2.000 εκδηλώσεις ανά αίτημα με μέγιστο μέγεθος σώματος 20 MB.

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

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| Οι εκδηλώσεις επιστρέφουν κατάσταση `invalid` | Λείπουν υποχρεωτικά πεδία | Βεβαιωθείτε ότι το `user_id` ή `device_id` ορίζεται σε κάθε εκδήλωση |
| Οι ιδιότητες χρήστη δεν συγχρονίζονται | Λανθασμένος τελεστής ιδιότητας | Χρησιμοποιήστε `$set` για ορισμό, `$setOnce` για τιμές πρώτης επαφής |
| Η εξαγωγή cohort είναι κενή | Το cohort υπολογίζεται ακόμα | Αναμείνετε την ολοκλήρωση υπολογισμού cohort πριν την εξαγωγή |
| 429 Too Many Requests | Υπέρβαση ορίου ρυθμού | Εφαρμόστε εκθετική καθυστέρηση και χρησιμοποιήστε batch API |
| Τα έσοδα δεν παρακολουθούνται | Λείπουν πεδία εσόδων | Συμπεριλάβετε `price`, `quantity` και `revenue` στις ιδιότητες εκδήλωσης |
| Τα δεδομένα ΕΕ δεν δρομολογούνται | Λάθος κέντρο δεδομένων | Ορίστε `data_center: "EU"` και χρησιμοποιήστε `api.eu.amplitude.com` |

## Βέλτιστες Πρακτικές

1. **Χρησιμοποιήστε το HTTP V2 API** - Προτιμήστε το V2 API αντί του παλαιού HTTP API για καλύτερη επαλήθευση και αποκρίσεις σφαλμάτων
2. **Εκδηλώσεις σε batch** - Αποστέλλετε εκδηλώσεις σε batches έως 1.000 για βέλτιστη απόδοση
3. **Ορίστε ιδιότητες χρήστη σε εκδηλώσεις** - Συμπεριλάβετε `user_properties` σε track events για μείωση κλήσεων identify
4. **Χρησιμοποιήστε cohorts για τμηματοποίηση** - Συγχρονίστε συμπεριφορικά cohorts αντί να αναπαράγετε σύνθετη λογική τμηματοποίησης
5. **Παρακολουθήστε εκδηλώσεις εσόδων σωστά** - Χρησιμοποιήστε πεδία `revenue`, `price` και `productId` για ακριβή παρακολούθηση εσόδων
6. **Παρακολουθήστε την υγεία εισαγωγής** - Ελέγξτε το Ingestion Debugger του Amplitude για σφάλματα επαλήθευσης εκδηλώσεων
7. **Εφαρμόστε παρακολούθηση στην πλευρά server** - Χρησιμοποιήστε server-side SDKs για αξιόπιστη παράδοση εκδηλώσεων

## Ασφάλεια

- **Μόνο HTTPS** - Όλη η επικοινωνία API απαιτεί TLS 1.2+
- **Εναλλαγή κλειδιών API** - Εναλλάσσετε τα Secret Keys περιοδικά μέσω ρυθμίσεων Amplitude
- **Λίστα επιτρεπόμενων IP** - Διαθέσιμη σε Enterprise πλάνα
- **SOC 2 Type II** - Το Amplitude είναι πιστοποιημένο SOC 2 Type II
- **GDPR/CCPA** - Υποστήριξη για αιτήματα διαγραφής και εξαγωγής δεδομένων χρήστη
- **Εγκατάσταση δεδομένων ΕΕ** - Διαθέσιμη επιλογή κέντρου δεδομένων ΕΕ

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

- [Σύνδεσμος Segment](https://tajo.io/gr/docs/connectors/custom/segment)
- [Σύνδεσμος Mixpanel](https://tajo.io/gr/docs/connectors/custom/mixpanel)
- [Δεξιότητα Συγχρονισμού Πελατών](https://tajo.io/gr/docs/skills/data-sync/customer-sync)
- [API Εκδηλώσεων Brevo](https://tajo.io/gr/docs/events-engagement/create-event)
