Laporan dan log

RBM membuat file data yang melaporkan aktivitas pengguna dan agen di tingkat ringkasan dan transaksional. Data dipisahkan menjadi beberapa file:

File Deskripsi Siapa saja yang memiliki akses
Laporan peristiwa penagihan Kumpulan data peristiwa yang dapat ditagih antara pengguna dan agen yang diluncurkan Semua operator yang memiliki lalu lintas RBM di jaringan mereka
Log aktivitas Data aktivitas platform RBM mentah Operator yang memiliki traffic RBM di jaringannya dan mengaktifkan aktivitas RCS dengan Jibe Cloud berdasarkan Persyaratan Layanan (ToS) mereka sendiri

Generasi

Laporan peristiwa penagihan dan log Aktivitas memiliki keterlambatan dua hari dalam pembuatan.

Google melaporkan peristiwa aktivitas hanya jika sesi penagihan yang dimilikinya selesai. Sesi dapat memerlukan waktu hingga 24 jam untuk diselesaikan dan, pipeline penagihan kami dijalankan sekali sehari dan hanya melaporkan sesi penagihan yang dipastikan telah selesai (jadi setidaknya sudah berlangsung 24 jam).

Contoh:

  • Pesan dikirim pada hari d dan memulai sesi penagihan, tetapi melewatkan eksekusi pipeline 1 jam sebelumnya. Oleh karena itu, tidak ada peristiwa aktivitas yang dilaporkan.

  • Saat pipeline berjalan lagi pada d+1, sesi yang dimulai oleh pesan hanya berlangsung selama 23 jam. Oleh karena itu, tidak ada peristiwa aktivitas untuk pesan ini yang dilaporkan pada d+1.

  • Saat pipeline berjalan lagi pada d+2, sesi telah selesai sehingga peristiwa aktivitas dilaporkan bersama dengan sesi penagihan.

Penyimpanan dan akses

File data dienkripsi saat dalam penyimpanan dan saat ditransfer.

Untuk mengambil file data dengan SFTP, Anda harus menyediakan kunci publik SFTP. Untuk membuat kunci, lihat Membuat pasangan kunci Secure Shell (SSH) untuk Dropbox SFTP.

Server SFTP adalah partnerupload.google.com, dan koneksi menggunakan nomor port tinggi (19321) untuk keamanan tambahan.

Anda dapat menggunakan perintah berikut untuk mengakses file data:

sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com

Google memberikan nama pengguna akun dalam format berikut:

  • rbmreports-billableevents-<carrier name>
  • rbmreports-activity-<carrier name>

Google menentukan <carrier name> dan menyediakan akun terpisah untuk setiap jenis laporan.

Akun terpisah disediakan untuk mengakses berbagai jenis laporan.

Ketersediaan file

Jika belum ada file laporan yang dibuat, Anda akan melihat error SFTP yang mirip dengan remote readdir("/"): No such file or directory. Ini hal yang normal.

File tidak akan dibuat jika tidak ada traffic RBM untuk dilaporkan. Artinya, mungkin ada hari-hari saat file tidak dibuat. Hubungi rbm-support@google.com jika Anda mengharuskan file kosong dibuat dalam situasi ini untuk menyederhanakan pemrosesan.

Muat ulang dan retensi

Setiap file data mewakili penggunaan platform selama satu hari dalam waktu UTC. Data untuk hari tertentu dibuat satu kali dan diselesaikan dalam waktu 2 hari (48 jam) setelah hari berakhir. Jika memuat file ini ke data warehouse, Anda dapat memperbarui metrik bulan berjalan.

File tidak dibuat jika tidak ada aktivitas yang perlu diperhitungkan.

Tanggal dalam nama setiap file adalah tanggal pembuatan file. Data dalam file akan mencakup hari UTC yang datang 2 hari sebelum tanggal file.

Proses ekspor yang menghasilkan file dijalankan antara pukul 02.00 dan 04.00 PST.

File data disimpan selama maksimum 30 hari sebelum dihapus.

Laporan peristiwa penagihan

Laporan peristiwa penagihan adalah data peristiwa yang dapat ditagih yang dihitung dari pesan dasar menggunakan unit penagihan yang disarankan. Peristiwa yang dapat ditagih berisi informasi rahasia, tetapi tidak berisi PII pengguna (misalnya, tanpa MSISDN, MSISDN yang di-hash, atau ID unik pengguna).

Hanya agen yang diluncurkan yang dapat membuat peristiwa penagihan. Aktivitas dari agen yang belum diluncurkan atau tidak diluncurkan tidak muncul dalam laporan penagihan.

Laporan penagihan mengasumsikan bahwa peristiwa ditagih saat pengiriman pesan, bukan saat pesan dikirim. Pesan yang tidak terkirim atau dicabut sebelum pengiriman tidak memicu peristiwa penagihan.

Setiap agen RBM memiliki Kategori Penagihan, yang ditetapkan oleh developer agen sebelum mengirimkan agen untuk peluncuran. Kategori Penagihan menentukan apakah pesan yang dikirim agen bersifat terpisah atau apakah pesan tersebut dapat digabungkan ke dalam peristiwa penagihan percakapan.

Ada lima jenis peristiwa yang dapat ditagih:

Event Definisi
Pesan Dasar

Pesan {i>application-to-person<i} (A2P) yang

  • berisi hingga 160 karakter
  • hanya berisi teks

Hanya agen percakapan: jika pesan P2A dikirimkan sebagai respons terhadap pesan A2P dalam waktu 24 jam ke depan, Pesan Dasar akan menjadi bagian dari percakapan A2P; jika tidak, sesi akan berakhir. Pesan Dasar selalu dikirim dari agen ke pengguna.
Satu Pesan

Pesan {i>application-to-person<i} (A2P) yang

  • berisi multimedia atau teks dengan lebih dari 160 karakter

Khusus agen percakapan: jika pesan P2A dikirimkan dalam waktu 24 jam ke depan, Pesan Tunggal menjadi bagian dari percakapan A2P; jika tidak, sesi akan dihentikan. Satu Pesan selalu dikirim dari agen ke pengguna.
Percakapan A2P Hanya berlaku untuk agen percakapan: Percakapan A2P dimulai saat pesan P2A dikirim dalam waktu 24 jam sejak Pesan Tunggal A2P atau Pesan Dasar A2P. Perhatikan bahwa jika pesan P2A dikirim dalam waktu 24 jam dari beberapa pesan A2P, hanya pesan A2P yang berada tepat sebelum pesan P2A yang digunakan untuk membuat sesi percakapan. Pesan A2P ini, beserta semua pesan yang dikirim dalam 24 jam ke depan, adalah bagian dari percakapan A2P yang baru.
Percakapan P2A Hanya berlaku untuk agen percakapan: Percakapan P2A dimulai saat tidak ada sesi yang aktif (Pesan Tunggal A2P, Percakapan A2P, atau Percakapan P2A) dan pesan P2A akan dikirimkan, dan bisnis merespons dalam waktu 24 jam.
Pesan P2A Agen non-percakapan: Pesan P2A yang dikirim dari pengguna kepada agen dengan Kategori Penagihan Pesan Tunggal atau Pesan Dasar.

Agen percakapan: Pesan P2A yang dikirim dari pengguna menuju agen jika tidak ada percakapan dan agen tidak membalas.

Ketersediaan

Laporan peristiwa penagihan tersedia untuk semua operator yang memiliki traffic RBM di jaringan mereka.

Format

Laporan peristiwa penagihan menggunakan format nama file YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv.

Tanggal dalam nama file adalah tanggal pembuatan file. Data dalam file umumnya akan mencakup aktivitas untuk hari yang 2 hari sebelum tanggal ini.

Kolom dalam data dipisahkan dengan tab, dan ada satu data per baris.

Akan ada satu data untuk setiap peristiwa penagihan, yaitu dua percakapan A2P dengan agen yang sama akan menghasilkan dua peristiwa penagihan dan dua data dalam laporan penagihan.

Setiap data dalam laporan peristiwa yang dapat ditagih berisi informasi berikut untuk setiap peristiwa:

Kolom Format Deskripsi Contoh
billing_event_id string ID UUID, angka acak, yang dihasilkan untuk setiap peristiwa baru pada saat dibuat.
type string Jenis peristiwa:
  • basic_message
  • single_message
  • a2p_conversation
  • p2a_conversation
  • p2a_message
 single_message
agent_id string ID agen yang berpartisipasi dalam peristiwa. rbm-welcome-bot@rbm.goog
agent_owner string Email pemilik agen yang berpartisipasi dalam acara. Ini adalah pihak yang mendaftarkan agen RBM, dalam sebagian besar kasus merupakan agregator, tetapi dalam beberapa kasus yang jarang terjadi mungkin merupakan merek. Nilai ini diambil dari kolom 'RBM Akun Google' yang disediakan saat developer mendaftar untuk menggunakan RBM. name@aggregator.com
billing_party string Pihak yang menagih acara.
  • google
  • operator
 carrier
max_duration_single_message angka Durasi, dalam jam, untuk mengirim pesan agen tanpa menerima respons untuk mengidentifikasi satu sesi pesan. 24
max_duration_a2p_conversation angka Durasi maksimum sesi A2P, dalam jam. Diukur dari respons pengguna pertama hingga pesan awal agen. 24
max_duration_p2a_conversation angka Durasi maksimum sesi P2A, dalam jam. Diukur dari pesan pengguna pertama dalam percakapan. 24
start_time YYYY-mm-ddTHH:00:00Z Tanggal/waktu UTC dimulainya peristiwa dalam format ISO 8601 yang dibulatkan ke jam terdekat.
  • Untuk peristiwa a2p_conversation dan p2a_conversation, ini adalah waktu sesi dimulai.
  • Untuk peristiwa single_message dan basic_message, ini adalah waktu peristiwa tersebut terjadi.
2019-07-25T08:00:00Z
duration angka Durasi peristiwa, yang dibulatkan ke menit terdekat.

Jika jenis peristiwa adalah single_message atau basic_message, nilainya akan 0.

45
mt_messages angka Jumlah pesan yang dihentikan seluler dalam peristiwa. 11
mo_messages angka Jumlah pesan buatan seluler dalam peristiwa. 9
size_kilobytes angka Ukuran semua file yang dilampirkan ke pesan dalam peristiwa tersebut, yang dibulatkan ke kilobyte terdekat (1 kB = 1.024 byte). 912
agent_name string

Agen yang berpartisipasi dalam acara.

 XYZ Mobile USA
owner_name string Pemilik agen yang berpartisipasi dalam acara. Ini adalah pihak yang mendaftarkan agen RBM. Pada umumnya, entitas ini adalah agregator, tetapi dalam beberapa kasus yang jarang terjadi mungkin adalah merek. Nilai ini diambil dari "Nama tampilan yang lebih disukai untuk akun partner Anda" yang diberikan saat developer mendaftar untuk menggunakan RBM. XYZ Mobile

File contoh

Contoh file laporan penagihan tersedia untuk didownload.

Ukuran file standar

File laporan harian dari partner aktif dapat berukuran sekitar 53.000 kumpulan data dan berukuran sekitar 8 Mb.

Log aktivitas

Log aktivitas adalah log data mentah aktivitas di platform RBM untuk tujuan mengaudit peristiwa yang dapat ditagih dan pembuatan peristiwa kustom.

Ketersediaan

Log aktivitas hanya tersedia untuk operator yang memiliki traffic RBM di jaringan mereka dan mengaktifkan aktivitas RCS dengan Jibe Cloud berdasarkan Persyaratan Layanan (ToS) mereka sendiri. Jika menggunakan Jibe Cloud berdasarkan ToS Jibe, Anda tidak akan memiliki akses ke log aktivitas.

Format

Log aktivitas menggunakan format nama file YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv.

Tanggal dalam nama file adalah tanggal pembuatan file. Data dalam file umumnya akan mencakup aktivitas untuk hari yang 2 hari sebelum tanggal ini.

Kolom dalam data dipisahkan dengan tab, dan ada satu data per baris.

Setiap catatan dalam log aktivitas berisi kolom berikut untuk setiap peristiwa aktivitas.

Kolom Format Deskripsi Contoh
activity_id string ID untuk aktivitas.
billing_event_id string ID untuk peristiwa penagihan tempat aktivitas berlangsung. Dapat kosong jika aktivitas tidak dikaitkan dengan sesi apa pun, seperti text_message tanpa delivery_receipt_event yang sesuai.
agent_id string ID agen. welcome-bot@rbm.goog
user_id string MSISDN pengguna. 918369110173
direction string Arah pengiriman pesan:
  • MT (penghentian seluler) untuk aktivitas agen-ke-pengguna
  • MO (berasal dari seluler) untuk aktivitas pengguna-ke-agen
 MT
time YYYY-mm-ddTHH:MM:SS.SSSZ Tanggal/waktu UTC saat peristiwa dikirimkan ke platform RBM. Lihat catatan di bawah. 2019-07-25T00:29:07.033Z
type string Jenis aktivitas:
  • text_message
  • file_transfer
  • rich_card/carousel
  • suggestion_tap
  • delivery_receipt_event
  • read_receipt_event
  • spam_report
 text_message
size_bytes string Ukuran file yang dilampirkan ke aktivitas, dalam byte. 912

Catatan tentang stempel waktu

Stempel waktu di log Aktivitas merekam waktu saat peristiwa dikirim ke platform RBM. Untuk peristiwa yang mengirimkan konten kepada pengguna, peristiwa tidak akan ditulis ke Log aktivitas hingga pesan dikirim.

Misalnya, jika pesan RBM dikirim kepada pengguna pada hari Rabu pukul 13.00 dan penerima sedang offline hingga hari Minggu pukul 09.00, peristiwa tersebut akan muncul di log Aktivitas yang dibuat untuk hari Minggu. Stempel waktu untuk peristiwa di log Aktivitas adalah hari Rabu, pukul 13.00.