Dengan integrasi Apsis One, setiap orang yang mendaftar akan dibuat atau diperbarui sebagai profil di Apsis One, di section yang Anda pilih, dan dapat didaftarkan (opt-in) ke salah satu langganan Apsis One Anda.
Yang Anda perlukan
- Akun Apsis One, dan pengguna yang dapat mengelola kunci API (biasanya administrator).
- Mengetahui apakah akun Apsis One Anda berada di region Europe atau Asia. Sebagian besar akun berada di Eropa.
Langkah 1: Buat kunci API di Apsis One
- Di Apsis One, buka Account settings lalu masuk ke API keys (di bawah integrasi).
- Klik untuk membuat kunci API baru. Beri nama yang mudah Anda kenali, misalnya “Scratcher”.
- Berikan kunci tersebut akses ke section yang ingin Anda gunakan untuk menerima profil dari Scratcher, dengan izin seperti di bawah ini.
- Simpan, lalu salin Client ID dan Client secret. Secret hanya ditampilkan satu kali.
Apsis memiliki panduan langkah demi langkah sendiri untuk hal ini. Tautannya tersedia di Setup guide pada dialog instalasi di Scratcher (“To install the integration, follow the guide here”).
Izin yang dibutuhkan kunci
Scratcher menggunakan kunci ini untuk:
- membaca section Anda, beserta atribut, langganan (topik persetujuan) dan event di dalamnya, sehingga Anda dapat memilihnya di kampanye;
- membuat profil dan memperbarui atributnya;
- menambahkan persetujuan (opt-in) ke profil;
- menambahkan event ke profil.
Jadi, kunci memerlukan akses baca ke section dan akses tulis ke profil, persetujuan, dan event di section yang Anda gunakan. Tanpa akses tulis, pengiriman akan gagal dengan pesan galat dari Apsis One.
Langkah 2: Hubungkan Apsis One ke Scratcher
- Di Scratcher, buka Settings > Integrasi lalu klik Apsis One.
- Pilih API region: Europe atau Asia.
- Tempelkan Client ID dan Client secret.
- Klik Install integration. Scratcher akan masuk ke Apsis One untuk memeriksa detailnya.
Langkah 3: Aktifkan di kampanye
- Di editor, buka Connect > Integrasi > Apsis One lalu klik Activate.
- Jika Anda telah menghubungkan lebih dari satu akun Apsis One, pilih akunnya di Select account.
- Di Apsis section, pilih section-nya (Select a section).
- Di Field mappings, klik Add field mapping untuk setiap kolom dan cocokkan Scratcher field dengan atribut Apsis One di Destination field. Daftar tersebut menampilkan atribut dari section yang Anda pilih, termasuk atribut buatan Anda sendiri.
- Di Subscriptions (consents), pilih langganan yang akan diikuti peserta, atau None. “Choose any subscription that the participant should be opted into.”
- Di Filter by permissions (optional), pilih kotak centang persetujuan pemasaran Anda, agar hanya orang yang mencentangnya yang dikirim.
- Klik Save, lalu Test untuk mengirim profil uji.
Pemetaan kolom
- Alamat email selalu dikirim dan digunakan untuk mengidentifikasi profil. Anda tidak perlu memetakannya.
- Untuk nomor telepon, gunakan pengaturan Format agar nomor dikirim sesuai format yang diharapkan atribut Anda.
- Atribut ya/tidak menerima nilai true atau false, jadi petakan kolom Accepted dari persetujuan ke atribut ya/tidak.
Persetujuan
Jika Anda memilih langganan, setiap orang akan didaftarkan ke langganan tersebut dengan alasan “Subscribed via” beserta nama kampanye, dan sumber “Scratcher”. Jika orang tersebut sudah terdaftar, tidak ada yang berubah. Gunakan Filter by permissions agar hanya orang yang mencentang kotak pemasaran Anda yang didaftarkan.
Jika section Anda memiliki event formulir persetujuan Apsis One, Scratcher juga mencatat pendaftaran sebagai event pada profil, beserta alamat kampanye.
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, profilnya akan diperbarui. Periksa setiap pengiriman di Settings > Integrasi > Delivery status; di sana juga ditampilkan apakah profil tersebut baru atau sudah ada sebelumnya. Lihat Periksa status pengiriman dan kirim ulang lead.
Pemecahan masalah
- “All or some of the fields are invalid...” saat instalasi: periksa region, lalu salin ulang client ID dan secret.
- Pengiriman gagal dengan galat akses dari Apsis One: kunci tidak memiliki akses ke section, atau tidak memiliki izin tulis. Edit kunci tersebut di Apsis One.
- Subscriptions (consents) kosong: section belum memiliki langganan. Buat langganan di Apsis One, lalu buka kembali integrasinya.