Konektor Customer.io

Propojte svou zasílací platformu Customer.io s Brevo pro sjednocená zákaznická data, koordinaci kampaní napříč platformami a konsolidovanou analytiku zapojení.

Přehled

Funkce

• Synchronizace osob – Obousměrná synchronizace zákaznických profilů s kontakty Brevo
• Přeposílání událostí – Sledujte behaviorální události a přeposílejte do Brevo pro spouštěče automatizací
• Analytika kampaní – Synchronizujte metriky výkonu kampaní pro sjednocené reportování
• Data pracovních toků – Zrcadlete stavy pracovních toků Customer.io v atributech kontaktů Brevo
• Replikace segmentů – Replikujte segmenty Customer.io jako seznamy Brevo
• Synchronizace dat objektů – Synchronizujte ne-osobní objekty a data vztahů

Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Customer.io s přístupem k API
2. Vaše Site ID a Track API klíč (nalezené v Nastavení > API Credentials)
3. App API klíč pro čtení dat kampaní a segmentů
4. Účet Brevo s přístupem k API
5. Účet Tajo s aktivním předplatným

Ověření

Customer.io používá dvě oddělená API s různými metodami ověřování:

Track API (Behaviorální data)

Používá se pro odesílání osob, událostí a dat zařízení. Ověřuje pomocí Site ID a API klíče přes Basic Auth.

# Základní ověření: Site ID jako uživatelské jméno, API klíč jako heslo
curl -X POST https://track.customer.io/api/v1/customers/user123 \
  -u "$SITE_ID:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

App API (Čtení dat)

Používá se pro načítání kampaní, segmentů a zákaznických dat. Ověřuje pomocí Bearer tokenu.

curl -X GET https://api.customer.io/v1/campaigns \
  -H "Authorization: Bearer $APP_API_KEY"

Připojení k Tajo

tajo connectors install customerio \
  --site-id $CIO_SITE_ID \
  --track-api-key $CIO_TRACK_API_KEY \
  --app-api-key $CIO_APP_API_KEY

Konfigurace

Základní nastavení

connectors:
  customerio:
    enabled: true
    region: "us"  # nebo "eu" pro datové centrum EU

    sync:
      people: true
      events: true
      campaigns: true
      segments: true
      objects: false

    lists:
      all_contacts: 12
      active_subscribers: 13
      churned: 14

Mapování polí

Mapujte atributy osob Customer.io na atributy kontaktů Brevo:

field_mapping:
  # Standardní pole
  id: CIO_ID
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Metriky zapojení
  created_at: SIGNUP_DATE
  last_activity: LAST_ACTIVE
  plan: PLAN_NAME

  # Vlastní atributy
  company: COMPANY
  role: JOB_TITLE
  mrr: MONTHLY_REVENUE
  lifecycle_stage: LIFECYCLE_STAGE

Mapování událostí

event_mapping:
  # Událost Customer.io -> Událost Brevo
  purchase_completed: ORDER_PLACED
  subscription_started: SUBSCRIPTION_START
  feature_activated: FEATURE_USED
  support_ticket_opened: SUPPORT_REQUEST

Koncové body API

Tajo se integruje s následujícími koncovými body Customer.io API:

Příklady kódu

Inicializace konektoru

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,
  trackApiKey: process.env.CIO_TRACK_API_KEY,
  appApiKey: process.env.CIO_APP_API_KEY,
  region: 'us'
});

Synchronizace osob do Brevo

// Přírůstková synchronizace osob Customer.io
await tajo.connectors.sync('customerio', {
  type: 'incremental',
  resources: ['people'],
  since: '2024-01-01',
  batchSize: 100
});

const status = await tajo.connectors.status('customerio');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-03-15T14:20:00Z',
//   peopleCount: 32500,
//   campaignsTracked: 18,
//   eventsProcessed: 87000
// }

Přeposílání událostí

// Přeposílání webhookových událostí reportování Customer.io do Brevo
app.post('/webhooks/customerio', async (req, res) => {
  const events = req.body;

  for (const event of events) {
    await tajo.connectors.handleEvent('customerio', {
      type: event.metric,
      payload: {
        customerId: event.data.customer_id,
        campaignId: event.data.campaign_id,
        timestamp: event.timestamp
      }
    });
  }

  res.status(200).send('OK');
});

Export segmentu

const result = await tajo.connectors.exportSegment('customerio', {
  segmentId: 42,
  targetList: 13,
  includeAttributes: ['email', 'first_name', 'last_name', 'plan']
});

console.log(`Exportováno ${result.count} osob do seznamu Brevo 13`);

Omezení rychlosti

Customer.io vynucuje různé limity rychlosti pro každé API:

Řešení problémů

Časté problémy

Režim ladění

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

Test připojení

tajo connectors test customerio
# ✓ Připojení Track API úspěšné
# ✓ Připojení App API úspěšné
# ✓ Osoby přístupné
# ✓ Kampaně čitelné
# ✓ Segmenty vypisovatelné

Osvědčené postupy

1. Používejte Pipelines API pro hromadná data – Novější Pipelines API je optimalizováno pro velkoobjerné zpracování
2. Nastavte reportovací webhooky – Přeposílejte e-mailové události Customer.io do Tajo v reálném čase
3. Mapujte fáze životního cyklu – Synchronizujte členství v segmentech Customer.io na atributy Brevo
4. Používejte konzistentní identifikátory – Shodujte pole id napříč Customer.io a Brevo
5. Synchronizujte přírůstkově – Vyhněte se úplným exportům; využívejte časová razítka last_activity
6. Monitorujte doručení webhooků – Nastavte upozornění pro neúspěšná doručení webhooků

Zabezpečení

• Základní ověření – Track API ověřuje pomocí Site ID a API klíče
• Bearer token – App API používá bearer tokeny ve stylu OAuth
• Pouze HTTPS – Veškerá API komunikace šifrovaná přes TLS 1.2+
• Regionální datová centra – Možnost datového centra EU pro soulad s GDPR
• Šifrované úložiště – Všechny přihlašovací údaje šifrované v klidu v Tajo
• Podpisy webhooků – Ověřujte payloady webhooků pomocí podpisů HMAC

Související zdroje

• Konektor Braze
• Konektor Iterable
• Dovednost synchronizace zákazníků
• Brevo Contacts API