Mengirim pesan dengan Firebase Console

Anda dapat mengirim pesan notifikasi menggunakan Notifications composer di Firebase console. Meskipun tanpa fleksibilitas atau skalabilitas yang sama seperti pengiriman pesan dengan Admin SDK atau protokol HTTP dan XMPP, Notifications composer bisa sangat berguna untuk pengujian atau pemasaran dan interaksi pengguna yang ditargetkan secara khusus. Firebase console menyediakan pengujian A/B berbasis analisis untuk membantu menyaring dan menyempurnakan pesan pemasaran.

Setelah mengembangkan logika penerimaan pesan di aplikasi, Anda dapat mengizinkan pengguna non-teknis untuk mengirim pesan sesuai petunjuk di halaman Notification pada Pusat Bantuan Firebase.

Tentang kolom pesan FCM di Notifications composer

Saat Anda mengirim pesan notifikasi dari Notifications composer, Google menggunakan nilai yang dimasukkan dalam kolom formulir dengan cara berikut:

  • Kolom seperti Segmen pengguna dan Tanggal berakhir menentukan opsi target dan pengiriman pesan.
  • Kolom seperti Teks notifikasi dan Data kustom dikirim ke klien dalam payload yang terdiri dari key-value pair.

Kolom ini dipetakan ke kunci yang tersedia melalui protokol server FCM. Misalnya, key-value pair yang dimasukkan ke dalam Data kustom akan ditangani sebagai payload data untuk notifikasi tersebut. Kolom lain langsung memetakan ke kunci di payload notifikasi FCM.

Perlu diperhatikan bahwa beberapa kolom di Notifications composer tidak tersedia melalui protokol server FCM. Misalnya, Anda dapat menargetkan segmen pengguna berdasarkan versi aplikasi, bahasa, jenis dan versi browser, atau properti pengguna dengan cara yang tidak tersedia menggunakan kolom to di API server.

Kunci yang dikirim Firebase console ke klien adalah:

Kunci Label kolom console Deskripsi
notification.title Judul notifikasi Menunjukkan judul notifikasi.
notification.body Teks notifikasi Menunjukkan teks isi notifikasi.
data Data kustom Key-value pair yang Anda tetapkan. Key-value pair disampaikan sebagai payload data untuk ditangani aplikasi.

Kunci yang menentukan pengiriman pesan meliputi:

Kunci Label kolom console Deskripsi
sound Suara

Menunjukkan suara untuk diputar ketika perangkat menerima notifikasi

time_to_live Tanggal berakhir

Parameter ini menetapkan berapa lama (dalam detik) pesan harus disimpan dalam penyimpanan FCM jika perangkat sedang offline. Untuk informasi lebih lanjut, lihat Menyetel masa aktif pesan.

Log audit

Layanan Firebase menulis log audit untuk membantu Anda menjawab pertanyaan, "Siapa yang melakukan apa, di mana, dan kapan?" Data tersebut adalah Log Audit Cloud, yang disediakan sebagai bagian dari project GCP yang terhubung dengan project Firebase Anda. Setiap project Firebase Anda hanya berisi log audit untuk resource yang berada dalam project tersebut secara langsung.

Untuk ringkasan umum tentang Log Audit Cloud, buka Log Audit Cloud. Untuk mendapatkan pemahaman yang lebih mendalam tentang Log Audit Cloud, pelajari Memahami log audit.

Log Audit Cloud mempertahankan Akses Data untuk tiap project GCP.

Jika diaktifkan secara eksplisit, Firebase Notifications Console akan menulis log audit Akses Data. Log audit Akses Data berisi panggilan API yang membaca konfigurasi atau metadata resource, serta panggilan API yang dilakukan pengguna untuk membuat, mengubah, atau membaca data resource yang diberikan pengguna. Log audit Akses Data tidak merekam operasi akses data di resource yang digunakan bersama secara publik (tersedia untuk Semua Pengguna atau Semua Pengguna Terautentikasi) atau yang dapat diakses tanpa login ke GCP.

Operasi yang diaudit

Tabel berikut merangkum tindakan konsol (dan nama jenis) mana yang berkaitan dengan tiap jenis log audit di Firebase Notifications Console. Kita dapat menggunakan nama jenis dari tindakan konsol untuk menelusuri log tertentu.

Kategori log audit Tindakan Firebase Notifications Console Nama jenis (digunakan untuk penelusuran di UI untuk log)
Log Akses Data (DATA_READ) Mendapatkan campaign GetCampaign
Log Akses Data (DATA_READ) Membuat daftar campaign ListCampaign
Log Akses Data (DATA_READ) Mendapatkan informasi dari notifikasi uji coba ABT LegacyGetRollout
Log Akses Data (DATA_READ) Mendapatkan peluang penargetan GetAudiences
Log Akses Data (DATA_READ) Mendapatkan statistik fcm (jumlah Dikirim/Dibuka/Ditayangkan/Dikonversi) GetFcmStats
Log Akses Data (DATA_READ) Mendapatkan daftar label analisis untuk rentang tanggal dan project. GetAnalyticsLabelList
Log Akses Data (DATA_WRITE) Membuat campaign CreateCampaign
Log Akses Data (DATA_WRITE) Menghapus campaign DeleteCampaign
Log Akses Data (DATA_WRITE) Mengupdate campaign UpdateCampaign
Log Akses Data (DATA_WRITE) Membuat Peluncuran dari ABT LegacyCreateRollout

Format log audit

Entri log audit, yang dapat dilihat di Stackdriver Logging menggunakan Logs Viewer, Stackdriver Logging API, atau Cloud SDK, mencakup objek berikut:

  • Entri log itu sendiri, yang merupakan objek jenis LogEntry. Kolom yang berguna meliputi yang berikut ini:

    • logName berisi identifikasi project dan jenis log audit
    • resource berisi target operasi yang diaudit
    • timeStamp berisi waktu operasi yang diaudit
    • protoPayload berisi informasi yang diaudit
  • Data logging audit, yang merupakan objek AuditLog dan disimpan di kolom protoPayload pada entri log.

  • Informasi audit khusus layanan opsional, yang merupakan objek khusus layanan dan disimpan di kolom serviceData pada objek AuditLog. Untuk mengetahui detailnya, buka Data audit khusus layanan.

Untuk kolom lain dalam objek ini, serta cara menafsirkannya, pelajari Memahami log audit.

Nama log

Nama resource Log Audit Cloud menunjukkan project atau entity lain yang memiliki log audit. Misalnya, string berikut menunjukkan nama log untuk log audit Akses Data project:

projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access

Nama layanan

Log audit Firebase Notifications Console menggunakan nama layanan gcmcontextualcampaign-pa.googleapis.com.

Untuk detail lebih lanjut mengenai layanan logging, buka Memetakan layanan ke resource.

Jenis resource

Log audit Firebase Notifications Console menggunakan jenis resource audited_resource untuk semua log audit.

Untuk melihat daftar lengkapnya, buka Jenis resource yang dimonitor.

Mengaktifkan logging audit

Log audit Akses Data dinonaktifkan secara default dan tidak ditulis kecuali diaktifkan secara eksplisit (dengan pengecualian log audit Akses Data untuk BigQuery, yang tidak dapat dinonaktifkan).

Untuk melihat petunjuk cara mengaktifkan sebagian atau semua log audit Akses Data Anda, buka Mengonfigurasi Log akses data.

Log audit Akses Data yang Anda aktifkan dapat memengaruhi harga log di stackdriver_name_short. Pelajari bagian Harga pada halaman ini.

Izin log audit

Izin dan peran pada Cloud Identity and Access Management menentukan log audit mana yang dapat Anda lihat atau ekspor. Log berada di dalam project dan dalam beberapa entity lain termasuk organisasi, folder, dan akun penagihan. Untuk informasi lebih lanjut, buka Memahami peran.

Untuk melihat log audit Aktivitas Admin, Anda harus memiliki salah satu peran Cloud IAM berikut dalam project yang berisi log audit Anda:

Untuk melihat log audit Akses Data, Anda harus memiliki salah satu dari peran berikut dalam project yang berisi log audit Anda:

Melihat log

Anda memiliki beberapa opsi untuk melihat entri log audit Anda:

Viewer Dasar

Anda dapat menggunakan antarmuka dasar Logs Viewer di GCP Console untuk mengambil entri log audit Anda. Lakukan hal berikut:

  1. Buka halaman Stackdriver Logging > Log (Logs Viewer) di GCP Console:

    Buka halaman Logs Viewer

  2. Pilih project GCP yang sudah ada di bagian atas halaman, atau buat project baru.

  3. Di menu drop-down pertama, pilih jenis resource yang ingin Anda lihat log auditnya. Anda dapat memilih resource tertentu atau Global untuk semua resource.

  4. Di menu drop-down kedua, pilih jenis log yang ingin Anda lihat: data_access untuk log audit Akses Data.

    Jika opsi tersebut tidak ditampilkan, tidak ada log audit dengan jenis tersebut yang tersedia dalam project.

  5. Jika Anda ingin menelusuri jenis log tertentu, misalnya, log yang berhubungan dengan pembuatan campaign, Anda dapat memfilter berdasarkan nama jenis. Dalam hal ini, namanya adalah: CreateCampaign.

Viewer Lanjutan

Anda dapat menggunakan antarmuka lanjutan Logs Viewer di GCP Console untuk mengambil entri log audit Anda. Lakukan hal berikut:

  1. Buka halaman Stackdriver Logging > Log (Logs Viewer) di GCP Console:

    Buka halaman Logs Viewer

  2. Pilih project GCP yang sudah ada di bagian atas halaman, atau buat project baru.

  3. Di menu drop-down pertama, pilih jenis resource yang ingin Anda lihat log auditnya. Anda dapat memilih resource tertentu atau Global untuk semua resource.

  4. Klik panah drop-down (▾) di bagian paling kanan kotak filter penelusuran dan pilih Konversi ke filter lanjutan.

  5. Buat filter yang lebih lanjut menentukan entri log yang ingin Anda lihat. Untuk mengambil semua log audit di project Anda, tambahkan filter berikut. Berikan [PROJECT_ID] yang valid di tiap nama log.

      logName = ("projects/[PROJECT_ID]logs/cloudaudit.googleapis.com%2Fdata_access")
    

    Untuk detail lebih lanjut tentang filter, buka Filter log lanjutan.

API

Untuk melihat entri log audit Anda menggunakan Stackdriver Logging API:

  1. Buka bagian Coba API ini di dokumentasi untuk metode entries.list.

  2. Masukkan string berikut ke dalam bagian Isi permintaan dari formulir Coba API ini. Mengklik formulir yang telah diisi sebelumnya ini akan otomatis mengisi bagian permintaan, tetapi Anda harus memberikan [PROJECT_ID] yang valid di setiap nama log.

      {
        "resourceNames": [
          "projects/[PROJECT_ID]"
        ],
        "pageSize": 5,
        "filter": "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"
      }
    
  3. Klik Jalankan.

Untuk detail lebih lanjut tentang filter, buka Filter log lanjutan.

SDK

Untuk membaca entri log Anda menggunakan Cloud SDK, jalankan perintah berikut. Berikan [PROJECT_ID] yang valid di tiap nama log.

gcloud logging read "projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"

Buka Membaca entri log untuk mendapatkan informasi lebih lanjut cara menggunakan Cloud SDK.

Untuk sampel entri log audit dan cara mencari informasi yang paling penting di dalamnya, buka Memahami log audit.

Mengekspor log audit

Anda dapat mengekspor log audit dengan cara yang sama seperti saat mengekspor jenis log lainnya. Untuk mengetahui cara mengekspor log Anda, buka Mengekspor log. Berikut adalah beberapa penerapan dari ekspor log audit:

  • Untuk menyimpan log audit dalam jangka panjang atau untuk menggunakan kemampuan penelusuran yang lebih andal, Anda dapat mengekspor salinan log audit Anda ke Google Cloud Storage, BigQuery, atau Google Cloud Pub/Sub. Dengan Cloud Pub/Sub, Anda dapat mengekspor ke aplikasi lain, repositori lain, dan ke pihak ketiga.

  • Untuk mengelola log audit di seluruh organisasi, Anda dapat membuat sink ekspor gabungan yang dapat mengekspor log dari satu atau semua project di organisasi.

  • Jika log audit Akses Data yang diaktifkan membuat project Anda melebihi alokasi log-nya, Anda dapat mengekspor dan mengecualikan log audit Akses Data dari Logging. Untuk mengetahui detailnya, buka Mengecualikan log.

Harga

Stackdriver Logging tidak mengenakan biaya kepada Anda untuk log audit yang selalu dibuat dan tidak dapat dinonaktifkan, termasuk semua log audit Aktivitas Admin.

Stackdriver Logging mengenakan biaya kepada Anda untuk log audit Akses Data yang secara jelas Anda minta.

Untuk mengetahui informasi selengkapnya tentang harga log audit, pelajari harga Stackdriver.