Menggunakan Alias dan Tag: Cara Utama untuk Push yang Presisi
I. Penjelasan Konsep Inti
1. Alias: Menghubungkan ID Bisnis dengan Push ID
Alias digunakan untuk membuat pemetaan satu-ke-satu antara identitas unik pengguna (misal: userID, nomor telepon, email, dll.) di sistem bisnis dengan registration ID (registrationID / UID) di sistem push EngageLab.
Registration ID adalah identitas unik yang dihasilkan oleh SDK WebPush atau AppPush untuk setiap pengguna, digunakan untuk identifikasi pesan push. Biasanya tidak bermakna bagi pihak bisnis dan tidak terikat kuat dengan perangkat tertentu.
Fitur Utama:
- 🧩 Binding satu-ke-satu: Setiap registration ID hanya dapat terhubung ke satu alias.
- 🧠 Mudah dikenali bisnis: Menggunakan user ID asli dari sistem bisnis, memudahkan logika bisnis.
- 🔒 Berlaku permanen: Hubungan binding tetap berlaku kecuali dilepas secara eksplisit.
Contoh Penggunaan:
- Notifikasi perubahan status pesanan (misal: pesanan user123 telah dikirim)
- Notifikasi keamanan akun (misal: password user456 telah diubah)
2. Tag: Pengelompokan Dinamis Berdasarkan Atribut
Tag digunakan untuk memberi label pada atribut, perilaku, atau status pengguna, sehingga memungkinkan segmentasi dinamis dan pengiriman push berdasarkan grup.
Fitur Utama:
- 🔁 Relasi banyak-ke-banyak: Satu registration ID dapat memiliki banyak tag, dan satu tag dapat dimiliki banyak pengguna.
- 📈 Update real-time: Mendukung penambahan dan penghapusan tag secara dinamis mengikuti perubahan perilaku pengguna.
- 🧱 Mendukung multi-dimensi: Contoh, "member VIP", "tidak aktif 30 hari", "pengguna iOS".
Contoh Penggunaan:
- Kirim reward aktivasi ke "pengguna VIP yang tidak aktif 3 hari berturut-turut".
- Kirim pengingat terbatas waktu ke pengguna yang meninggalkan barang di keranjang tetapi belum checkout.
II. Mengapa Menggunakan Alias dan Tag?
🎯 Masalah yang Diselesaikan
Registration ID push EngageLab dibuat otomatis oleh SDK dan tidak terkait langsung dengan pengguna di sistem bisnis. Untuk mencapai push presisi di tingkat bisnis, developer perlu:
- ✅ Membuat binding antara user ID → registration ID di sistem bisnis (menggunakan alias).
- ✅ Membagi pengguna ke dalam grup berbeda sesuai kebutuhan bisnis (menggunakan tag).
✨ Ringkasan Nilai Inti
| Fungsi | Nilai Bisnis | Nilai Teknis |
|---|---|---|
| Alias | Push presisi ke satu pengguna untuk notifikasi pesanan, peringatan akun | Tidak perlu memelihara pemetaan registration ID dan business ID |
| Tag | Operasi grup (VIP, tidak aktif, aktif) | Tidak perlu membangun sistem segmentasi pengguna sendiri |
| Gabungan | Bangun audiens presisi dengan kombinasi wilayah + perilaku + atribut | Sederhanakan logika push, perawatan lebih efisien |
III. Petunjuk Penggunaan Detail
1. Mengatur Alias dan Tag
✅ Pengaturan API di Server
Tautan dokumentasi: Set Alias dan Tag
Contoh Request:
POST /v4/devices/{registration_id}
{
"tags": {
"add": [
"VIP",
"pengguna iOS"
]
},
"alias": "user_5678"
}
✅ Pengaturan SDK di Client
- Web SDK: setTagsAlias
- Android SDK: Tags and Alias API
- iOS SDK: Tags and Alias API
2. Mengirim Push Notifikasi
✅ Operasi di Konsol
- Pilih grup pengguna berdasarkan tag atau alias di halaman pembuatan push.
✅ Metode API
Tautan dokumentasi: Create Push API
Contoh Request:
POST v4/push
{
"from": "push",
"to": {
"tag": [
"VIP"
],
"tag_and": [
"Tidak aktif 30 hari"
]
},
"body": {
"platform": "all",
"notification": {
"alert": "Hai, MTPush!",
"android": {
"alert": "Hadiah Selamat Datang Kembali",
"title": "Pengguna VIP terhormat, selamat datang kembali! Klaim penawaran eksklusif Anda sekarang."
},
"ios": {
"alert": {
"title": "Hadiah Selamat Datang Kembali",
"body": "Pengguna VIP terhormat, selamat datang kembali! Klaim penawaran eksklusif Anda sekarang."
}
}
}
}
}
IV. Rekomendasi Praktik Terbaik
✅ Saran Desain Sistem Tag Tiga Tingkat
| Level | Contoh | Kasus Penggunaan |
|---|---|---|
| Atribut Pengguna | Wilayah, provinsi, sistem perangkat | Push presisi berdasarkan wilayah/platform |
| Perilaku | Pengguna aktif, pengguna diam, klik tidak konversi | Target perilaku & recall churn |
| Bisnis | Pengguna berbayar, pengguna dengan barang di keranjang | Strategi konversi personalisasi |
V. FAQ dan Catatan
| Pertanyaan | Jawaban |
|---|---|
| Apakah satu alias bisa untuk beberapa registration ID? | Satu alias hanya untuk satu registration ID. Jika perangkat baru mengatur alias yang sama, binding lama akan tertimpa. |
| Apakah ada batas jumlah tag? | Jumlah total tag sebaiknya dalam batas wajar. Konsultasikan dengan customer success manager untuk praktik terbaik. |
| Bagaimana cara unbind alias atau tag? | Gunakan API unbind atau metode unbind SDK terkait untuk menyelesaikan operasi. |
| Berapa lama alias berlaku setelah diatur? | Berlaku langsung, cocok untuk binding saat login/registrasi. |
VI. Ringkasan
Dengan mengonfigurasi alias dan tag secara tepat, developer dapat:
- 🧠 Mengurangi kompleksitas pengembangan dan biaya perawatan.
- 📊 Meningkatkan presisi push, tingkat konversi, dan ROI.
- 🔄 Menjangkau seluruh siklus hidup pengguna dari aktivasi hingga retensi.
👉 Untuk informasi lebih lanjut, silakan lihat Dokumentasi Developer EngageLab










