Laporan peristiwa penagihan dan log aktivitas

Halaman ini menjelaskan file data yang dibuat RBM untuk membantu operator dalam penagihan dan audit.

File Deskripsi Yang memiliki akses
Laporan peristiwa penagihan Laporan gabungan peristiwa yang dapat ditagih antara agen yang diluncurkan dan pengguna. Semua operator dengan MDA RBM yang ditandatangani.
Log aktivitas Log data mentah aktivitas RBM, termasuk peristiwa yang dapat ditagih. Operator dengan MDA RBM yang ditandatangani yang mengoperasikan Layanan RCS Google berdasarkan Persyaratan Layanan (ToS) mereka sendiri.

Pembuatan file

Setiap file data mewakili penggunaan RBM selama satu hari dalam Waktu Universal Terkoordinasi (UTC). File dibuat setiap hari antara pukul 10.00 dan 12.00 UTC.

  • Untuk agen non-percakapan, file berisi data dari periode 24 jam yang langsung mendahului waktu pembuatan file. Misalnya, jika laporan peristiwa penagihan dibuat pada pukul 11.00 UTC pada 5 Mei, laporan tersebut akan berisi data dari pukul 11.00 UTC pada 4 Mei hingga pukul 11.00 UTC pada 5 Mei.

  • Untuk agen percakapan, file berisi data dari periode 24 jam 1-2 hari sebelum waktu pembuatan file. Misalnya, jika laporan peristiwa penagihan dibuat pada pukul 11.00 UTC pada 5 Mei, laporan tersebut dapat berisi data dari pukul 11.00 UTC pada 3 Mei hingga pukul 11.00 UTC pada 4 Mei.

    Alasan penundaan ini adalah karena aktivitas RBM untuk agen percakapan terkait dengan percakapan, yang dapat memerlukan waktu hingga 48 jam untuk diselesaikan. Penundaan ini memungkinkan RBM merekam semua pesan dalam percakapan sebelum menghitung peristiwa penagihan. Untuk informasi selengkapnya tentang agen percakapan, lihat Kategori penagihan agen.

Poin utama:

  • Tidak ada aktivitas: Jika tidak ada aktivitas platform pada hari tertentu, tidak ada file yang dibuat.

  • Penamaan: Tanggal dalam nama file adalah tanggal pembuatan file, bukan tanggal data di dalamnya.

  • Retensi: File disimpan selama maksimum 30 hari sebelum dihapus.

Anda dapat menggunakan file ini untuk memperbarui data warehouse dengan metrik penggunaan platform terbaru.

Penyimpanan dan akses file

File data dienkripsi saat dalam penyimpanan dan saat dalam transfer.

Untuk mengambil file data melalui SFTP, berikan kunci publik SFTP Anda. 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 menyediakan 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 data yang dibuat, Anda akan melihat error SFTP yang mirip dengan remote readdir("/"): No such file or directory, yang diharapkan.

File tidak akan dibuat jika tidak ada traffic RBM yang akan dilaporkan. Artinya, mungkin ada beberapa hari saat tidak ada file yang dibuat. Jika Anda memerlukan file kosong untuk menyederhanakan proses, hubungi rbm-support@google.com.

Laporan peristiwa penagihan

Laporan peristiwa penagihan adalah catatan peristiwa penagihan, yang dihitung berdasarkan kategori penagihan agen dan jenis pesan yang dikirimnya. Laporan peristiwa penagihan tersedia untuk semua operator yang memiliki MDA RBM.

Laporan peristiwa penagihan berisi informasi rahasia, tetapi tidak ada Informasi Identitas Pribadi (PII) pengguna, seperti MSISDN, MSISDN yang di-hash, atau ID unik pengguna.

Kategori penagihan agen

Saat membuat agen, pemilik menetapkan kategori penagihan berdasarkan cara agen akan berinteraksi dengan pengguna. Kategori penagihan tidak membatasi jumlah atau jenis pesan yang dapat dikirim agen. Namun, hal ini menentukan cara agen akan ditagih untuk pesan. Dua kategori penagihan utama dijelaskan dalam tabel berikut.

Kategori penagihan Jenis agen Contoh kasus penggunaan Metode penagihan

Non-percakapan

(Mencakup kategori Pesan Dasar dan Pesan tunggal. Catatan: Tidak ada lagi perbedaan antara kedua kategori ini. Agen dalam salah satu kategori akan ditagih sebagai agen non-percakapan.) 		Agen yang terutama mengirim pesan satu arah.
  • OTP
  • Pemberitahuan
  • Penawaran promosi
 Ditagih untuk setiap pesan yang dikirimkan kepada pengguna.
Bisa percakapan Agen yang dirancang untuk melakukan interaksi dua arah dengan pengguna.
  • Menemukan produk yang tepat
  • Memesan tiket
  • Memecahkan masalah

Ditagihkan per percakapan: Jika salah satu pihak (agen atau pengguna) membalas pesan dari pihak lain dalam waktu 24 jam, percakapan akan dimulai. Selama periode percakapan (24 jam setelah balasan pertama), agen dan pengguna dapat bertukar pesan sebanyak mungkin, dan agen akan ditagih dengan tarif tetap untuk percakapan tersebut.

Ditagihkan per pesan: Jika agen mengirimkan pesan yang tidak dibalas pengguna dalam waktu 24 jam, agen akan ditagih untuk setiap pesan, mirip dengan agen non-percakapan.

Agen percakapan versus non-percakapan

Ada dua kategori penagihan utama: percakapan dan non-percakapan. Kategori non-percakapan mencakup kategori Pesan Dasar dan Pesan tunggal, yang secara fungsional identik. Agen dalam salah satu kategori ini ditagih sebagai agen non-percakapan.

Perbedaan utama dalam kategori penagihan adalah antara agen percakapan dan non-percakapan:

  • Agen non-percakapan ditagih untuk setiap pesan yang dikirimkan kepada pengguna.

    • Kategori ini paling cocok untuk agen yang tidak mengharapkan balasan yang sering.

  • Agen percakapan ditagih dengan tarif tetap untuk percakapan, yang mencakup semua pesan yang dipertukarkan dalam periode 24 jam.

    • Kategori ini paling cocok untuk agen yang terlibat dalam percakapan multi-giliran dengan pengguna.

Peristiwa penagihan

Lima jenis peristiwa penagihan yang berbeda dicatat dalam laporan peristiwa penagihan. Peristiwa ini mencakup pesan A2P dan P2A.

  • A2P (Aplikasi ke Orang): Dikirim oleh brand.
  • P2A (Person-to-Application): Dikirim oleh pengguna.

Tabel berikut menjelaskan setiap peristiwa penagihan yang berlaku untuk agen non-percakapan dan percakapan.

Acara Deskripsi Agen non-percakapan Agen percakapan
basic_message Pesan A2P yang hanya menyertakan teks dengan 160 karakter atau kurang. Jika teks menyertakan URL untuk situs dengan tag openGraph, pesan dapat menampilkan pratinjau gambar, tanpa biaya tambahan untuk partner. Selalu diperlakukan sebagai peristiwa penagihan individual, terlepas dari apakah pengguna membalas atau tidak. Dianggap sebagai peristiwa penagihan individual, kecuali jika pengguna membalas dalam waktu 24 jam. Dalam hal ini, pesan akan menjadi bagian dari a2p_conversation.
single_message Pesan A2P yang menyertakan multimedia dan/atau teks dengan lebih dari 160 karakter. Selalu diperlakukan sebagai peristiwa penagihan individual, terlepas dari apakah pengguna membalas atau tidak. Dianggap sebagai peristiwa penagihan individual, kecuali jika pengguna membalas dalam waktu 24 jam. Dalam hal ini, pesan akan menjadi bagian dari a2p_conversation.
a2p_conversation (diinisiasi merek) Dimulai saat pengguna merespons pesan A2P dalam waktu 24 jam setelah menerimanya, di luar percakapan yang ada. T/A. Agen non-percakapan tidak pernah menghasilkan jenis peristiwa ini. Jika pesan P2A dikirim dalam waktu 24 jam setelah beberapa pesan A2P, hanya pesan A2P yang langsung mendahului pesan P2A yang digunakan untuk memulai percakapan. Pesan A2P ini, dan pesan apa pun yang dikirim dalam 24 jam ke depan, adalah bagian dari a2p_conversation.
p2a_conversation (dimulai oleh pengguna) Dimulai saat agen merespons pesan P2A dalam waktu 24 jam setelah menerimanya, di luar percakapan yang ada. T/A. Agen non-percakapan tidak pernah menghasilkan jenis peristiwa ini. Jika pesan A2P dikirim dalam waktu 24 jam setelah beberapa pesan P2A, hanya pesan P2A yang langsung mendahului pesan A2P yang digunakan untuk memulai percakapan. Pesan P2A ini, dan pesan apa pun yang dikirim dalam 24 jam ke depan, adalah bagian dari p2a_conversation.
p2a_message Pesan P2A dari jenis apa pun. Selalu diperlakukan sebagai peristiwa penagihan individual, terlepas dari apakah agen membalas atau tidak. Diperlakukan sebagai peristiwa penagihan individual, kecuali jika agen membalas dalam waktu 24 jam.

Peristiwa penagihan versus kategori penagihan

Peristiwa penagihan basic_message dan single_message tidak boleh disamakan dengan kategori penagihan Pesan Dasar dan Pesan Tunggal.

  • Setiap agen (terlepas dari kategori penagihan-nya) dapat menghasilkan peristiwa penagihan basic_message dan single_message.

  • Kategori penagihan Pesan Dasar dan Pesan Tunggal digunakan untuk mengklasifikasikan agen non-percakapan. Agen dalam kategori penagihan ini tidak menghasilkan peristiwa penagihan percakapan (a2p_conversations atau p2a_conversations). Sebagai gantinya, agen tersebut menghasilkan peristiwa penagihan basic_message, single_message, dan p2a_message individual.

Pembuatan laporan penagihan

Hanya agen dengan traffic non-penguji yang menghasilkan peristiwa penagihan. Aktivitas dari nomor telepon pengujian tidak muncul dalam laporan peristiwa penagihan.

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

Format laporan penagihan

Laporan peristiwa penagihan menggunakan format nama file rbm_billable_events_YYYY-MM-DD.csv. Tanggal dalam nama file adalah tanggal pembuatan file.

Setiap baris dalam laporan adalah data yang mewakili satu peristiwa penagihan. Kolom dalam data dipisahkan dengan tab. Misalnya, dua percakapan A2P dengan agen yang sama akan menghasilkan dua peristiwa penagihan dan dua data dalam laporan peristiwa penagihan.

Setiap data dalam laporan berisi informasi berikut untuk setiap peristiwa penagihan:

Kolom Format Deskripsi Contoh
billing_event_id string ID UUID. Angka acak yang dihasilkan untuk setiap peristiwa baru pada saat peristiwa tersebut dibuat. 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
type string Jenis peristiwa:
  • basic_message
  • single_message
  • a2p_conversation
  • p2a_conversation
  • p2a_message
 single_message
agent_id string ID unik untuk agen yang berpartisipasi dalam peristiwa. rbm-welcome-bot@rbm.goog
agent_owner string Alamat email pemilik akun partner saat ini tempat agen dibuat. name@aggregator.com
billing_party string Pihak yang menagih peristiwa.
  • google
  • operator
 carrier
max_duration_single_message angka Waktu maksimum (dalam jam) yang diizinkan bagi pengguna untuk merespons pesan agen sebelum periode inisiasi percakapan ditutup dan pesan tersebut diklasifikasikan sebagai peristiwa single_message. 24
max_duration_a2p_conversation angka Durasi maksimum percakapan A2P, dalam jam. Diukur dari respons pengguna pertama terhadap pesan awal agen. 24
max_duration_p2a_conversation angka Durasi maksimum percakapan P2A, dalam jam. Diukur dari pesan pengguna pertama dalam percakapan. 24
start_time YYYY-mm-ddTHH:00:00Z Tanggal/waktu UTC saat peristiwa dimulai dalam format ISO 8601 yang dibulatkan ke jam terdekat.
  • Untuk peristiwa a2p_conversation dan p2a_conversation, ini adalah waktu percakapan dimulai.
  • Untuk peristiwa single_message dan basic_message, ini adalah waktu terjadinya peristiwa.
 2019-07-25T08:00:00Z
duration angka Durasi peristiwa, dibulatkan ke menit terdekat.

Jika jenis peristiwanya adalah single_message atau basic_message, nilainya adalah 0.

 45
mt_messages angka Jumlah pesan yang diakhiri di perangkat seluler (A2P) dalam peristiwa. 11
mo_messages angka Jumlah pesan yang berasal dari perangkat seluler (P2A) dalam peristiwa. 9
size_kilobytes angka Ukuran semua file yang dilampirkan ke pesan dalam peristiwa, dibulatkan ke kilobyte terdekat (1 kB = 1024 byte). 912
agent_name string

Nama agen yang berpartisipasi dalam peristiwa.

 XYZ Mobile USA
owner_name string Nama pemilik akun partner saat ini tempat agen dibuat. XYZ Mobile

Contoh laporan peristiwa penagihan

Contoh file laporan penagihan tersedia untuk didownload.

Ukuran file umum

Laporan harian dari partner RBM aktif dapat berisi sekitar 53.000 data dan berukuran sekitar 8 Mb.

Log aktivitas

Log aktivitas memberikan data mentah tentang aktivitas di platform RBM. Anda dapat menggunakan log ini untuk mengaudit peristiwa penagihan dan membuat peristiwa kustom.

Karena log aktivitas berisi Informasi Identitas Pribadi (PII), seperti informasi transaksi mendetail dan MSISDN pelanggan, log tersebut hanya tersedia saat operator mengoperasikan RCS berdasarkan Persyaratan Layanan mereka sendiri. Jika Anda memiliki traffic RBM di jaringan dan mengaktifkan aktivitas RCS dengan Google RCS Cloud berdasarkan ToS Google, Anda tidak akan memiliki akses ke log aktivitas.

Format log aktivitas

Log aktivitas menggunakan format nama file rbm_activity_YYYY-MM-DD.csv. Tanggal dalam nama file adalah tanggal pembuatan file.

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

Setiap data dalam log aktivitas berisi kolom berikut untuk setiap aktivitas:

Kolom Format Deskripsi Contoh
activity_id string ID unik untuk aktivitas. b422e1d3-ac99-442a-853d-a875d5e61762
billing_event_id string ID unik untuk peristiwa penagihan terkait. Dapat kosong jika aktivitas tidak dikaitkan dengan peristiwa penagihan, seperti text_message tanpa delivery_receipt_event yang sesuai. 91yeb201-7c3b-412b-98d2-b0a0f7abe536
agent_id string ID unik untuk agen. welcome-bot@rbm.goog
user_id string MSISDN pengguna. 918369110173
direction string Arah pengiriman pesan:
  • MT (mobile terminating) untuk aktivitas agen ke pengguna
  • MO (berasal dari perangkat seluler) untuk aktivitas pengguna ke agen
 MT
time YYYY-mm-ddTHH:MM:SS.SSSZ Tanggal dan waktu saat peristiwa dikirim ke platform RBM dalam format UTC. Lihat Stempel waktu. 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

Stempel waktu

Stempel waktu dalam log aktivitas mencatat saat peristiwa dikirim ke platform RBM. Untuk peristiwa yang mengirimkan konten kepada pengguna, peristiwa tersebut tidak akan dicatat dalam log aktivitas hingga pesan dikirim.

Misalnya, jika pesan RBM dikirim ke pengguna pada hari Rabu pukul 13.00, dan penerima tidak online hingga Minggu pukul 09.00, peristiwa akan muncul dalam log aktivitas yang dibuat untuk hari Minggu, tetapi stempel waktunya adalah Rabu, pukul 13.00.

FAQ

Apa yang dimaksud dengan percakapan?

Di RBM, percakapan adalah serangkaian pesan yang dipertukarkan antara pengguna dan agen percakapan selama periode 24 jam. Hanya agen dengan kategori penagihan percakapan yang dapat menghasilkan percakapan dan ditagih untuk peristiwa penagihan ini:

  • Percakapan A2P: Percakapan yang dimulai oleh brand.
  • Percakapan P2A: Percakapan yang dimulai oleh pengguna.

Cara kerja percakapan

  • Mulai: Percakapan dimulai saat salah satu pihak (agen atau pengguna) merespons pesan dari pihak lain dalam waktu 24 jam setelah menerimanya, di luar percakapan yang ada.

    • Percakapan A2P: Dimulai saat pengguna merespons pesan agen.
    • Percakapan P2A: Dimulai saat agen merespons pesan pengguna.

  • Jendela percakapan: Percakapan tetap aktif selama 24 jam setelah dimulai. Percakapan mencakup semua pesan dalam periode 24 jam ini, serta pesan pertama yang awalnya direspons.

  • Penagihan: Alih-alih menagih untuk setiap pesan, agen percakapan ditagih berdasarkan seluruh percakapan. Artinya, biaya terkait dengan rangkaian pesan percakapan, bukan jumlah pesan di dalamnya.

Penting:

  • Percakapan tidak berlaku untuk agen non-percakapan. Agen dengan kategori penagihan Pesan Dasar atau Satu Pesan ditagih per pesan, terlepas dari apakah pengguna membalas atau tidak.

  • Untuk agen percakapan, pembuatan laporan peristiwa penagihan dan log aktivitas dapat tertunda hingga dua hari. Penundaan ini memungkinkan RBM mengambil semua pesan dalam percakapan sebelum menghitung peristiwa penagihan.