---
title: "Hubungkan Bloomreach"
description: "Buat kunci API di Bloomreach Engagement, hubungkan, lalu buat atau perbarui data pelanggan beserta persetujuan mereka."
url: https://scratcher.io/id/help/integrations/bloomreach
language: id
---

1. [Pusat bantuan](https://scratcher.io/id/help)
2. [Integrasi](https://scratcher.io/id/help/integrations)
3. Hubungkan Bloomreach

# 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](https://scratcher.io/id/help/integrations/delivery-status).

## 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.

Integrasi

- [Cara kerja integrasi](https://scratcher.io/id/help/integrations/how-integrations-work)
- [Semua integrasi](https://scratcher.io/id/help/integrations/other-integrations)
- [Periksa status pengiriman dan kirim ulang lead](https://scratcher.io/id/help/integrations/delivery-status)
- [Hubungkan HubSpot](https://scratcher.io/id/help/integrations/hubspot)
- [Hubungkan Salesforce Marketing Cloud](https://scratcher.io/id/help/integrations/salesforce-marketing-cloud)
- [Hubungkan Microsoft Dynamics 365 dengan Zapier](https://scratcher.io/id/help/integrations/microsoft-dynamics-365)
- [Hubungkan Emarsys](https://scratcher.io/id/help/integrations/emarsys)
- [Hubungkan Klaviyo](https://scratcher.io/id/help/integrations/klaviyo)
- [Hubungkan Mailchimp](https://scratcher.io/id/help/integrations/mailchimp)
- [Hubungkan ActiveCampaign](https://scratcher.io/id/help/integrations/activecampaign)
- [Hubungkan Apsis One](https://scratcher.io/id/help/integrations/apsis-one)
- [Hubungkan Drip](https://scratcher.io/id/help/integrations/drip)
- [Hubungkan HeyLoyalty](https://scratcher.io/id/help/integrations/heyloyalty)
- [Hubungkan Peytz](https://scratcher.io/id/help/integrations/peytz)
- [Hubungkan Marketingplatform](https://scratcher.io/id/help/integrations/marketingplatform)
- [Hubungkan Campaign Monitor dengan Zapier](https://scratcher.io/id/help/integrations/campaign-monitor)
- [Hubungkan ActiveTrail dengan Zapier](https://scratcher.io/id/help/integrations/activetrail)
- [Hubungkan Bloomreach](https://scratcher.io/id/help/integrations/bloomreach)
- [Hubungkan Iterable](https://scratcher.io/id/help/integrations/iterable)
- [Hubungkan Mapp](https://scratcher.io/id/help/integrations/mapp)
- [Hubungkan Agillic](https://scratcher.io/id/help/integrations/agillic)
- [Hubungkan Ortto](https://scratcher.io/id/help/integrations/ortto)
- [Hubungkan Emarketeer](https://scratcher.io/id/help/integrations/emarketeer)
- [Hubungkan Shopify](https://scratcher.io/id/help/integrations/shopify)
- [Hubungkan Hello Retail](https://scratcher.io/id/help/integrations/hello-retail)
- [Hubungkan 8.000+ aplikasi dengan Zapier](https://scratcher.io/id/help/integrations/zapier)
- [Hubungkan monday.com dengan Zapier](https://scratcher.io/id/help/integrations/monday-com)
- [Hubungkan Asana dengan Zapier](https://scratcher.io/id/help/integrations/asana)
- [Hubungkan Podio dengan Zapier](https://scratcher.io/id/help/integrations/podio)
- [Hubungkan Intercom dengan Zapier](https://scratcher.io/id/help/integrations/intercom)

Terus belajar

## Artikel terkait

- [Cara kerja integrasi](https://scratcher.io/id/help/integrations/how-integrations-work): Hubungkan alat email atau CRM Anda sekali saja, aktifkan di setiap kampanye, pilih daftar, petakan kolom Anda, dan kirim hanya orang yang telah memberikan persetujuan.
- [Periksa status pengiriman dan kirim ulang lead](https://scratcher.io/id/help/integrations/delivery-status): Lihat lead mana saja yang telah dikirim ke alat Anda, pahami pesan kesalahannya, perbaiki masalahnya, lalu kirim ulang.
- [Minta persetujuan dan tambahkan syarat dan ketentuan](https://scratcher.io/id/help/forms/consent-and-permissions): Tambahkan kotak centang persetujuan untuk buletin, tautkan syarat Anda, pilih kotak centang mana yang mendaftarkan orang sebagai pelanggan, dan kirim hanya orang yang menyetujuinya ke alat email Anda.

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](https://platform.scratcher.io/id/login)**

    Masuk dan klik tombol chat di pojok kanan bawah. Rex langsung menjawab, dan tim kami hanya sejauh satu klik.
- **[Jadwalkan pertemuan](https://scratcher.io/id/book-a-meeting)**

    Panggilan video gratis 30 menit dengan tim kami: tur produk, ide kampanye, atau bantuan penyiapan.
- **[Kirim email](mailto:contact@scratcher.io)**

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