logoDokumen
Cari

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

POST /v4/devices/{registration_id} { "tags": { "add": [ "VIP", "pengguna iOS" ] }, "alias": "user_5678" }
              
              POST /v4/devices/{registration_id}
{
    "tags": {
        "add": [
            "VIP",
            "pengguna iOS"
        ]
    },
    "alias": "user_5678"
}

            
Tampilkan blok kode ini di jendela mengambang

✅ Pengaturan SDK di Client

2. Mengirim Push Notifikasi

✅ Operasi di Konsol

  • Pilih grup pengguna berdasarkan tag atau alias di halaman pembuatan push.

✅ Metode API

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." } } } } }
              
              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."
                }
            }
        }
    }
}

            
Tampilkan blok kode ini di jendela mengambang

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

icon
Hubungi Sales