Σύνδεσμος Klaviyo

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

Επισκόπηση

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

• Συγχρονισμός προφίλ - Αμφίδρομος συγχρονισμός προφίλ πελατών μεταξύ Klaviyo και Brevo
• Προώθηση εκδηλώσεων - Προώθηση παρακολουθούμενων εκδηλώσεων Klaviyo στο Brevo για triggers αυτοματισμού
• Μετεγκατάσταση λιστών - Συγχρονισμός λιστών Klaviyo σε λίστες επαφών Brevo
• Συγχρονισμός τμήματος - Εξαγωγή τμημάτων Klaviyo ως λίστες ή τμήματα Brevo
• Εξαγωγή δεδομένων ροής - Ανάκτηση δεδομένων απόδοσης ροής για διαπλατφορμικά αναλυτικά
• Συγχρονισμός καμπάνιας - Συντονισμός καμπανιών σε κανάλια Klaviyo και Brevo
• Συγχρονισμός καταλόγου - Αντικατοπτρισμός καταλόγων προϊόντων μεταξύ πλατφόρμων
• Διαχείριση κουπονιών - Συγχρονισμός κωδικών κουπονιών και δεδομένων χρήσης

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

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

1. Λογαριασμό Klaviyo με ενεργοποιημένη πρόσβαση API
2. Ιδιωτικό κλειδί API με κατάλληλα εύρη
3. Το δημόσιο κλειδί API Klaviyo σας (6-χαρακτήρες company ID)
4. Λογαριασμό Brevo με πρόσβαση API
5. Λογαριασμό Tajo με διαπιστευτήρια API

Πιστοποίηση

Ιδιωτικό Κλειδί API

Το Klaviyo χρησιμοποιεί ιδιωτικά κλειδιά API με εύρος πρόσβασης για πιστοποίηση πλευράς server. Ορίστε το κλειδί στην κεφαλίδα Authorization:

curl https://a.klaviyo.com/api/profiles/ \
  -H "Authorization: Klaviyo-API-Key your-private-api-key" \
  -H "revision: 2026-01-15"

Εύρη Κλειδιού API

Ρυθμίστε εύρη κατά τη δημιουργία του ιδιωτικού κλειδιού σας:

Δημόσιο Κλειδί API

Για παρακολούθηση πλευράς client, χρησιμοποιήστε το 6-χαρακτήρα company ID:

curl -X POST "https://a.klaviyo.com/client/events/?company_id=COMPANY_ID" \
  -H "Content-Type: application/json" \
  -d '{"data": {...}}'

OAuth (Ενσωματώσεις Συνεργατών)

Το Klaviyo υποστηρίζει OAuth για τεχνολογικούς συνεργάτες, προσφέροντας βελτιωμένη ασφάλεια και υψηλότερα όρια ρυθμού:

curl https://a.klaviyo.com/api/profiles/ \
  -H "Authorization: Bearer YOUR_OAUTH_TOKEN" \
  -H "revision: 2026-01-15"

Διαμόρφωση

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

connectors:
  klaviyo:
    enabled: true
    private_api_key: "your-klaviyo-private-key"
    public_api_key: "XXXXXX"
    api_revision: "2026-01-15"

    # Data sync options
    sync:
      profiles: true
      events: true
      lists: true
      segments: true
      catalogs: false

    # Brevo list assignment
    lists:
      all_contacts: 20
      subscribers: 21
      high_value: 22

Αντιστοίχιση Προφίλ

Αντιστοίχηση ιδιοτήτων προφίλ Klaviyo σε χαρακτηριστικά επαφών Brevo:

profile_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone_number: SMS
  city: CITY
  region: REGION
  country: COUNTRY
  zip: ZIP
  organization: COMPANY
  title: JOB_TITLE

  # Custom properties
  lifetime_value: LTV
  total_orders: ORDER_COUNT
  last_order_date: LAST_ORDER_DATE
  preferred_channel: CHANNEL_PREF

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

Αντιστοίχηση μετρικών Klaviyo σε εκδηλώσεις Brevo:

event_mapping:
  "Placed Order": "order_completed"
  "Ordered Product": "product_purchased"
  "Started Checkout": "checkout_started"
  "Added to Cart": "cart_updated"
  "Viewed Product": "product_viewed"
  "Subscribed to List": "customer_subscribed"
  "Received Email": "email_received"
  "Opened Email": "email_opened"
  "Clicked Email": "email_clicked"

Endpoints API

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

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

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

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

// Connect Klaviyo account
await tajo.connectors.connect('klaviyo', {
  privateApiKey: process.env.KLAVIYO_PRIVATE_KEY,
  publicApiKey: process.env.KLAVIYO_PUBLIC_KEY
});

Συγχρονισμός Προφίλ στο Brevo

// Fetch Klaviyo profiles and sync to Brevo
const response = await fetch('https://a.klaviyo.com/api/profiles/', {
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Accept': 'application/vnd.api+json'
  }
});

const { data } = await response.json();

// Each profile follows JSON:API format
// {
//   "type": "profile",
//   "id": "01ABCDEF",
//   "attributes": {
//     "email": "[email protected]",
//     "first_name": "Jane",
//     "last_name": "Kim",
//     "phone_number": "+15551234567",
//     "properties": { "lifetime_value": 450.00 }
//   }
// }

Δημιουργία Εκδήλωσης

// Track an event in Klaviyo (forwarded to Brevo via Tajo)
await fetch('https://a.klaviyo.com/api/events/', {
  method: 'POST',
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Content-Type': 'application/vnd.api+json',
    'Accept': 'application/vnd.api+json'
  },
  body: JSON.stringify({
    data: {
      type: 'event',
      attributes: {
        metric: {
          data: { type: 'metric', attributes: { name: 'Placed Order' } }
        },
        profile: {
          data: { type: 'profile', attributes: { email: '[email protected]' } }
        },
        properties: {
          OrderId: 'ORD-1234',
          Value: 89.99,
          Items: [
            { ProductName: 'Widget Pro', Price: 89.99, Quantity: 1 }
          ]
        },
        value: 89.99
      }
    }
  })
});

Ερώτημα Συναθροισμάτων Μετρικών

// Get aggregate metric data for reporting
await fetch('https://a.klaviyo.com/api/metric-aggregates/', {
  method: 'POST',
  headers: {
    'Authorization': `Klaviyo-API-Key ${PRIVATE_KEY}`,
    'revision': '2026-01-15',
    'Content-Type': 'application/vnd.api+json'
  },
  body: JSON.stringify({
    data: {
      type: 'metric-aggregate',
      attributes: {
        metric_id: 'METRIC_ID',
        measurements: ['count', 'sum_value'],
        interval: 'day',
        filter: ['greater-or-equal(datetime,2024-01-01)',
                 'less-than(datetime,2024-02-01)']
      }
    }
  })
});

Όρια Ρυθμού

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

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

1. Χρησιμοποιήστε μορφή JSON:API - Ακολουθήστε προδιαγραφή JSON:API για όλα τα payloads αιτημάτων και αποκρίσεων
2. Ορίστε την κεφαλίδα revision - Πάντα να συμπεριλαμβάνετε κεφαλίδα revision με την τελευταία ημερομηνία έκδοσης API
3. Χρησιμοποιήστε sparse fieldsets - Ζητήστε μόνο τα απαιτούμενα πεδία με ?fields[profile]=email,first_name για μείωση μεγέθους payload
4. Αξιοποιήστε σχέσεις - Χρησιμοποιήστε παράμετρο JSON:API include για ανάκτηση σχετικών πόρων σε ένα αίτημα
5. Χρησιμοποιήστε σελιδοποίηση cursor - Πλοηγηθείτε σε μεγάλα σύνολα αποτελεσμάτων με παράμετρο page[cursor]
6. Υλοποιήστε μαζικές λειτουργίες - Χρησιμοποιήστε bulk endpoints για μαζικές εισαγωγές προφίλ και δημιουργία εκδηλώσεων
7. Χρησιμοποιήστε OAuth για υψηλότερα όρια - Η πιστοποίηση OAuth παρέχει 2x υψηλότερα όρια ρυθμού από ιδιωτικά κλειδιά

Ασφάλεια

• Εύρη ιδιωτικού κλειδιού API - Λεπτομερής έλεγχος πρόσβασης Read/Full ανά τύπο πόρου
• Υποστήριξη OAuth - Ασφαλής πιστοποίηση βάσει token για ενσωματώσεις συνεργατών
• Απομόνωση δημόσιου κλειδιού - Κλειδιά πλευράς client περιορισμένα σε λειτουργίες μόνο δημιουργίας
• TLS 1.2+ - Όλη η επικοινωνία API κρυπτογραφείται κατά τη μεταφορά
• SOC 2 Type II - Το Klaviyo είναι πιστοποιημένο SOC 2 Type II
• Συμμόρφωση GDPR - Data Privacy API για αιτήματα διαγραφής προφίλ

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

• Σύνδεσμος Brevo
• Σύνδεσμος Google Ads
• Σύνδεσμος Meta Ads
• Δεξιότητα Συγχρονισμού Πελατών