Customer.io Connector

Poveži Customer.io z Brevo prek Tajo za sinhronizacijo vedenjskih podatkov strank, dogodkov in kampanj za enotno večkanalno avtomatizacijo marketinga.

Pregled

Funkcionalnosti

• Sinhronizacija profilov – sinhroniziraj profile strank med Customer.io in Brevo
• Posredovanje dogodkov – pošlji vedenjske dogodke Customer.io v avtomatizacije Brevo
• Sinhronizacija segmentov – preslikaj segmente Customer.io v sezname stikov Brevo
• Migracija kampanj – prenos kampanj in sporočilnih tokov med platformama
• Sledenje atributom – sinhroniziraj atribute strank za ciljanje in personalizacijo
• Integracija webhooks – obravnavaj sporočilne in kampanjske dogodke v realnem času

Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun Customer.io z dostopom do API
2. API ključ spletnega mesta (za sledenje) in App API ključ (za upravljanje)
3. Brevo račun z dostopom do API
4. Tajo račun z dovoljenji za konektorje

Avtentikacija

API ključ spletnega mesta (sledenje)

# Site API key for Track API
export CIO_SITE_ID=your_site_id
export CIO_API_KEY=your_api_key
export TAJO_API_KEY=your_tajo_api_key
export BREVO_API_KEY=your_brevo_api_key

App API ključ (upravljanje)

# Bearer token for App API
curl https://api.customer.io/v1/customers \
  -H "Authorization: Bearer YOUR_APP_API_KEY"

Konfiguracija

Osnovna nastavitev

connectors:
  customerio:
    enabled: true
    site_id: "${CIO_SITE_ID}"
    api_key: "${CIO_API_KEY}"
    app_api_key: "${CIO_APP_API_KEY}"
    region: "us"  # or "eu"

    sync:
      customers: true
      events: true
      segments: true
      campaigns: true

    lists:
      all_customers: 10
      active_users: 11
      churned: 12

Preslikava polj

field_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS
  plan: SUBSCRIPTION_PLAN
  created_at: SIGNUP_DATE
  last_active: LAST_ACTIVITY_DATE
  segment_ids: CIO_SEGMENTS

Končne točke API

Primeri kode

Inicializacija konektorja

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('customerio', {
  siteId: process.env.CIO_SITE_ID,
  apiKey: process.env.CIO_API_KEY,
  appApiKey: process.env.CIO_APP_API_KEY
});

Sinhronizacija profila stranke

// Identify/update a customer in Customer.io
const response = await fetch(
  `https://track.customer.io/api/v1/customers/${customerId}`,
  {
    method: 'PUT',
    headers: {
      'Authorization': `Basic ${Buffer.from(
        `${process.env.CIO_SITE_ID}:${process.env.CIO_API_KEY}`
      ).toString('base64')}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      email: '[email protected]',
      first_name: 'Jane',
      last_name: 'Kim',
      plan: 'premium',
      created_at: Math.floor(Date.now() / 1000)
    })
  }
);

Sledenje vedenjskim dogodkom

// Track an event and forward to Brevo via Tajo
await fetch(
  `https://track.customer.io/api/v1/customers/${customerId}/events`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Basic ${Buffer.from(
        `${process.env.CIO_SITE_ID}:${process.env.CIO_API_KEY}`
      ).toString('base64')}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: 'purchase_completed',
      data: {
        order_id: 'ORD-789',
        revenue: 99.99,
        products: ['Widget Pro']
      }
    })
  }
);

Omejitve hitrosti

Odpravljanje težav

Način odpravljanja napak

connectors:
  customerio:
    debug: true
    log_level: verbose
    log_events: true
    log_api_calls: true

Najboljše prakse

1. Najprej identificiraj stranke – vedno ustvari profil stranke pred sledenjem dogodkov
2. Uporabi ustrezno regijo – nastavi regijo EU ali ZDA glede na lokacijo tvojega računa
3. Paketni dogodki – za zmanjšanje stroškov HTTP na strani strežnika uporabi Batch API
4. Sinhronizacija segmentov – redno sinhroniziraj segmente Customer.io za ažurne sezname Brevo
5. Preslikaj atribute dosledno – ohrani dosledno poimenovanje atributov med platformama
6. Upravljaj odjave – sinhroniziraj odjave med Customer.io in Brevo za skladnost

Varnost

• HTTP Basic Auth – poverilnice zakodirane z Base64 za Track API
• Avtentikacija z žetonom prinosnika – App API ključ prek glave Authorization
• TLS šifriranje – vsa komunikacija API šifrirana prek HTTPS
• Izolacija ključev – ločeni ključi za sledenje in upravljalne operacije
• Regionalna izolacija podatkov – ločeno gostovanje podatkov EU/ZDA

Povezani viri

• Brevo Connector
• Klaviyo Connector
• Customer Sync Skill
• Customer.io API dokumentacija