Langsung ke konten
Rex, asisten AI Anda: pekerjaan rutin beres, idenya tetap milik Anda 👉 Kenalan dengan Rex

Hubungkan Bloomreach

Buat kunci API di Bloomreach Engagement, hubungkan, lalu buat atau perbarui data pelanggan beserta persetujuan mereka.

Dengan integrasi Bloomreach, setiap orang yang mendaftar akan dibuat atau diperbarui sebagai pelanggan di proyek Bloomreach Engagement Anda, yang diidentifikasi melalui alamat email mereka. Anda juga dapat memberikan persetujuan (consent) Bloomreach kepada mereka, sehingga Anda boleh mengirimkan materi pemasaran.

Yang Anda butuhkan

  • Proyek Bloomreach Engagement, dan pengguna yang dapat mengelola akses API di pengaturan proyek (biasanya administrator proyek).

Langkah 1: Buat kunci API di Bloomreach

  1. Di Bloomreach Engagement, buka proyek dan masuk ke Project settings > Access management > API.
  2. Salin Project token dan API base URL yang ditampilkan di halaman tersebut.
  3. Di bagian grup API, buat grup baru dengan Private access, lalu beri nama, misalnya “Scratcher”.
  4. Buat kunci API baru di grup tersebut. Salin API key ID dan API secret. Secret hanya ditampilkan satu kali.
  5. Berikan izin di bawah ini kepada grup tersebut, lalu simpan.

Izin yang dibutuhkan kunci

Pada izin grup, izinkan:

  • Customer properties: get dan set, untuk menemukan pelanggan serta membuat atau memperbaruinya, dan untuk menampilkan properti pelanggan Anda di pemetaan bidang.
  • Events: set, untuk event consent, agar Scratcher dapat mencatat persetujuan.

Tidak ada izin lain yang diperlukan. Tanpa izin set, pengiriman akan gagal dengan pesan kesalahan akses dari Bloomreach.

Langkah 2: Hubungkan Bloomreach ke Scratcher

  1. Di Scratcher, buka Pengaturan > Integrasi lalu klik Bloomreach.
  2. Tempelkan API base URL, project token, API key ID, dan API secret ke kolom yang sesuai.
  3. Klik Pasang integrasi. Scratcher akan memverifikasi detailnya dengan Bloomreach.

Langkah 3: Aktifkan di kampanye

  1. Di editor, buka Hubungkan > Integrasi > Bloomreach lalu klik Aktifkan.
  2. Jika Anda telah menghubungkan lebih dari satu proyek, pilih proyeknya di Pilih akun.
  3. Di Pemetaan bidang, klik Tambah pemetaan bidang dan cocokkan setiap Bidang Scratcher dengan properti pelanggan Bloomreach, misalnya “Lead - Nama depan” ke first_name.
  4. Pilih kategori persetujuan yang akan diberikan kepada peserta, misalnya “newsletter”, atau tidak sama sekali.
  5. Di Filter berdasarkan izin (opsional), pilih kotak centang persetujuan pemasaran Anda, agar hanya orang yang mencentangnya yang dikirim.
  6. Klik Simpan, lalu Uji.

Perlu diketahui: Bloomreach tidak memiliki daftar. Semua orang masuk ke proyek, dan Anda mengelompokkannya dengan segmen di Bloomreach. Jadi, Scratcher langsung mulai mengirim data begitu Anda mengklik Aktifkan. Aktifkan sebelum kampanye ditayangkan, atau langsung siapkan dari awal.

Pemetaan bidang

  • Alamat email selalu dikirim dan digunakan untuk menemukan pelanggan. Anda tidak perlu memetakannya.
  • Daftar Bidang tujuan menampilkan properti pelanggan di proyek Anda. Jika properti belum ada, buat terlebih dahulu di Bloomreach.
  • Untuk menandai asal pelanggan, petakan Gunakan nilai kustom seperti “Scratcher summer game” ke properti yang Anda gunakan untuk sumber.

Persetujuan

Jika Anda memilih kategori persetujuan, Scratcher akan mencatat event consent dengan aksi accept dan nama kampanye sebagai sumbernya. Kategori tersebut harus sudah ada di Bloomreach (di pengaturan persetujuan pada Project settings). Gunakan Filter berdasarkan izin agar hanya orang yang mencentang kotak pemasaran Anda yang mendapatkan persetujuan.

Apa yang dikirim dan kapan

Pendaftar baru dikirim dalam satu atau dua menit. Saat Anda mengaktifkan integrasi, lead yang sudah ada di kampanye juga ikut dikirim. Jika seseorang berpartisipasi lagi, data pelanggan akan diperbarui. Periksa setiap pengiriman di Pengaturan > Integrasi > Status pengiriman. Lihat Periksa status pengiriman dan kirim ulang lead.

Pemecahan masalah

  • “All or some of the fields are invalid...” saat pemasangan: periksa API base URL dan project token, lalu salin ulang key ID dan secret.
  • Pengiriman gagal dengan kesalahan akses: grup API belum memiliki salah satu izin di atas. Ubah di Bloomreach.
  • Persetujuan tidak muncul pada pelanggan: kategori persetujuan tidak ada di Bloomreach, atau ejaannya berbeda.
  • Bloomreach memiliki panduan sendiri untuk kunci API. Cari “API access management” di dokumentasi Bloomreach jika tampilan menunya berbeda.
Butuh bantuan?

Masih butuh bantuan?

Tim kami siap membantu. Jika Anda sudah menggunakan Scratcher, cara tercepat adalah lewat chat di dalam platform.

  • Chat dengan kami

    Masuk dan klik tombol chat di pojok kanan bawah. Rex langsung menjawab, dan tim kami hanya sejauh satu klik.

  • Jadwalkan pertemuan

    Panggilan video gratis 30 menit dengan tim kami: tur produk, ide kampanye, atau bantuan penyiapan.

  • Kirim email

    Kirim email ke contact@scratcher.io dan kami akan segera membalas.