Buka konsol

Mengirim pesan dengan Firebase Console

Anda dapat mengirimkan pesan notifikasi ke perangkat iOS dan Android menggunakan Notifications composer di Firebase console. Meskipun tidak memberikan fleksibilitas atau skalabilitas yang sama seperti mengirim pesan dengan Admin SDK atau protokol HTTP dan XMPP, cara ini bisa sangat berguna untuk pengujian atau pemasaran dan interaksi pengguna yang ditargetkan secara khusus. Firebase console menyediakan pengujian A/B berbasis analisis untuk membantu menyempurnakan dan meningkatkan pesan pemasaran.

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

Tentang kolom pesan FCM di Notifications composer

Ketika Anda mengirim pesan notifikasi dari Notifications composer, Google menggunakan kolom yang dimasukkan dalam composer dengan dua cara:

  1. Kolom seperti Segmen pengguna dan Tanggal berakhir menentukan opsi target dan pengiriman pesan.
  2. Kolom seperti Teks pesan dan Data khusus 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 khusus akan ditangani sebagai payload data untuk notifikasi tersebut. Kolom lainnya akan langsung dipetakan ke kunci di payload notifikasi FCM.

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

Kunci yang dikirim Firebase console ke klien adalah:

Kunci Label kolom console Deskripsi
notification.title Judul pesan Menunjukkan judul notifikasi.
notification.body Teks pesan Menunjukkan teks isi notifikasi.
data Data khusus 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
priority Prioritas

Menetapkan prioritas pesan.

Untuk informasi lebih lanjut, lihat Menetapkan prioritas pesan.

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 Cloud Audit Log, 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 Cloud Audit Logs, buka Cloud Audit Logs. Untuk mendapatkan pemahaman yang lebih mendalam tentang Cloud Audit Logs, pelajari Memahami log audit.

Cloud Audit Logs 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) Dapatkan kampanye GetCampaign
Log Akses Data (DATA_READ) Daftar kampanye ListCampaign
Log Akses Data (DATA_READ) Dapatkan informasi dari notifikasi uji coba ABT LegacyGetRollout
Log Akses Data (DATA_READ) Dapatkan peluang penargetan GetAudiences
Log Akses Data (DATA_READ) Dapatkan statistik fcm (jumlah Dikirim/Dibuka/Ditayangkan/Dikonversi) GetFcmStats
Log Akses Data (DATA_READ) Dapatkan daftar label analisis untuk rentang tanggal dan project. GetAnalyticsLabelList
Log Akses Data (DATA_WRITE) Buat kampanye CreateCampaign
Log Akses Data (DATA_WRITE) Hapus kampanye DeleteCampaign
Log Akses Data (DATA_WRITE) Update Kampanye UpdateCampaign
Log Akses Data (DATA_WRITE) Buat 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 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 log audit, yang berupa objek AuditLog dan disimpan di kolom protoPayload entri log.

  • Informasi audit khusus layanan opsional, yang berupa objek khusus layanan dan disimpan di kolom serviceData dari 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 Cloud Audit Logs menunjukkan project atau entity lain yang memiliki log audit. Misalnya, string berikut menunjukkan nama log untuk log audit Data Akses 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 tentang layanan logging, buka Layanan pemetaan untuk 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 log 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 mengaktifkan sebagian atau semua log audit Akses Data Anda, buka Mengonfigurasi Log akses data.

Log audit Akses Data yang Anda aktifkan dapat mempengaruhi 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 Stackdriver Logging > halaman 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, maka 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 kampanye, Anda dapat memfilter berdasarkan nama jenis. Dalam kasus 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 Stackdriver Logging > halaman 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 menentukan lebih lanjut 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 diisi sebelumnya akan mengisi otomatis isi permintaan, tetapi Anda harus memberikan [PROJECT_ID] yang valid di tiap nama log.

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

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 tentang penggunaan 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 melihat detail tentang cara mengekspor log Anda, buka Mengekspor log. Berikut adalah beberapa aplikasi dari ekspor log audit:

  • Untuk menyimpan log audit untuk jangka waktu yang lebih lama atau 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, 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 log 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 informasi lebih lanjut tentang harga log audit, pelajari harga Stackdriver.