Ajukan akses awal

Masukkan nama depan serta email atau nomor telepon Anda. Kami akan menghubungi Anda dengan detail akses Tajo.

Di halaman ini

Membuat Kontak

Tambahkan pelanggan baru ke basis data kontak Brevo Anda dengan informasi program loyalitas dan atribut khusus untuk interaksi yang dipersonalisasi.

Mulai cepat

Pembuatan kontak dasar

POST https://api.brevo.com/v3/contacts
Content-Type: application/json
api-key: YOUR_API_KEY

{
  "email": "[email protected]",
  "attributes": {
    "FIRSTNAME": "John",
    "LASTNAME": "Doe",
    "LOYALTY_POINTS": 1500,
    "LOYALTY_TIER": "Gold",
    "SIGNUP_DATE": "2024-01-15",
    "LAST_PURCHASE": "2024-01-20",
    "TOTAL_SPENT": 299.99
  },
  "listIds": [1, 2],
  "updateEnabled": true
}

Respons

{
  "id": 123456
}

Integrasi program loyalitas

Pelanggan baru dengan atribut loyalitas

{
  "email": "[email protected]",
  "attributes": {
    "FIRSTNAME": "Sarah",
    "LASTNAME": "Johnson",
    "PHONE": "+1234567890",
    "LOYALTY_ID": "LYL-2024-001",
    "LOYALTY_POINTS": 0,
    "LOYALTY_TIER": "Bronze",
    "PREFERRED_REWARDS": "Discounts",
    "BIRTHDAY": "1990-05-15",
    "SIGNUP_SOURCE": "Website",
    "REFERRAL_CODE": "REF-12345",
    "COMMUNICATION_PREFERENCES": "Email,SMS",
    "PURCHASE_CATEGORIES": ["Electronics", "Fashion"],
    "AVERAGE_ORDER_VALUE": 0
  },
  "listIds": [1], // New customers list
  "emailBlacklisted": false,
  "smsBlacklisted": false,
  "updateEnabled": true
}

Pembaruan pelanggan yang sudah ada

{
  "email": "[email protected]",
  "attributes": {
    "LOYALTY_POINTS": 2500,
    "LOYALTY_TIER": "Platinum",
    "LAST_PURCHASE": "2024-01-25",
    "TOTAL_SPENT": 1299.99,
    "RECENT_PURCHASES": ["Product A", "Product B"],
    "ENGAGEMENT_SCORE": 8.5,
    "LAST_EMAIL_OPENED": "2024-01-24",
    "PREFERRED_CONTACT_TIME": "Evening"
  },
  "listIds": [1, 3], // Add to platinum customers list
  "updateEnabled": true
}

Atribut khusus Tajo

Data loyalitas pelanggan

Nama atribut	Tipe	Deskripsi
`LOYALTY_ID`	String	ID program loyalitas yang unik
`LOYALTY_POINTS`	Number	Saldo poin saat ini
`LOYALTY_TIER`	String	Tingkat saat ini (Bronze, Silver, Gold, Platinum)
`POINTS_EARNED_YTD`	Number	Poin yang diperoleh tahun ini
`POINTS_REDEEMED_YTD`	Number	Poin yang ditukarkan tahun ini
`TIER_PROGRESS`	Number	Kemajuan menuju tingkat berikutnya (%)
`NEXT_TIER_POINTS`	Number	Poin yang dibutuhkan untuk tingkat berikutnya

Perilaku pembelian

Nama atribut	Tipe	Deskripsi
`TOTAL_SPENT`	Number	Nilai seumur hidup
`AVERAGE_ORDER_VALUE`	Number	Rata-rata nilai pembelian
`PURCHASE_FREQUENCY`	String	Seberapa sering mereka membeli
`LAST_PURCHASE`	Date	Tanggal pembelian terakhir
`FAVORITE_CATEGORIES`	Array	Kategori produk yang disukai
`SEASONAL_BUYER`	Boolean	Berbelanja secara musiman

Metrik interaksi

Nama atribut	Tipe	Deskripsi
`ENGAGEMENT_SCORE`	Number	Penilaian interaksi 1-10
`EMAIL_OPEN_RATE`	Number	Rasio buka email personal %
`CLICK_THROUGH_RATE`	Number	CTR personal %
`LAST_EMAIL_OPENED`	Date	Interaksi email terakhir
`PREFERRED_CHANNEL`	String	Email, SMS, WhatsApp

Pembuatan kontak secara massal

Buat beberapa kontak sekaligus:

{
  "contacts": [
    {
      "email": "[email protected]",
      "attributes": {
        "FIRSTNAME": "Alice",
        "LOYALTY_POINTS": 500,
        "LOYALTY_TIER": "Bronze"
      }
    },
    {
      "email": "[email protected]",
      "attributes": {
        "FIRSTNAME": "Bob",
        "LOYALTY_POINTS": 1200,
        "LOYALTY_TIER": "Silver"
      }
    }
  ],
  "listIds": [1],
  "updateEnabled": true
}

Penanganan error

Error umum dan solusinya:

{
  "code": "duplicate_parameter",
  "message": "Contact already exists",
  "details": {
    "email": "[email protected]",
    "existingId": 123456
  }
}

{
  "code": "invalid_parameter",
  "message": "Invalid list ID",
  "details": {
    "listIds": [999]
  }
}

Praktik terbaik untuk Tajo

Selalu sertakan bidang loyalitas inti: LOYALTY_POINTS, LOYALTY_TIER, LOYALTY_ID
Aktifkan pembaruan: Izinkan pembaruan pada kontak yang sudah ada
Gunakan daftar segmentasi: Kelompokkan berdasarkan tingkat, perilaku, dan preferensi
Pantau interaksi: Awasi rasio interaksi email dan SMS
Sinkronisasi data secara berkala: Jaga agar data loyalitas selalu selaras dengan sistem Anda

Langkah berikutnya

Memperbarui atribut kontak
Mengelola daftar kontak
Menyiapkan atribut khusus
Mengimpor kontak secara massal

Email Transaksional

SMS Transaksional

Kontak

Peristiwa