Laporan peristiwa penagihan dan log aktivitas

Halaman ini menjelaskan file data yang dibuat RCS untuk Bisnis guna membantu operator dengan penagihan dan audit. Lihat FAQ Penagihan untuk mendapatkan jawaban atas pertanyaan umum tentang model penagihan RCS untuk Bisnis.

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

Pembuatan file

Setiap file data mewakili penggunaan RCS untuk Bisnis selama satu hari dalam Coordinated Universal Time (UTC). File dibuat setiap hari. Proses pembuatan dapat memerlukan waktu beberapa jam, dan waktu penyelesaian dapat bervariasi.

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

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

    Alasan penundaan adalah aktivitas RCS untuk Bisnis bagi agen percakapan dikaitkan dengan percakapan, yang dapat memerlukan waktu hingga 48 jam untuk diselesaikan. Penundaan ini memungkinkan RCS for Business mencatat semua pesan dalam percakapan sebelum menghitung peristiwa penagihan. Untuk mengetahui 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 63 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 ditransfer.

Untuk mengambil file data melalui Protokol Transfer File Aman (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 berada di 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 data yang dibuat, Anda akan melihat error SFTP yang mirip dengan remote readdir("/"): No such file or directory, yang memang sudah diperkirakan.

File tidak akan dibuat jika tidak ada traffic RCS untuk Bisnis 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 dikirimkannya. Laporan peristiwa penagihan tersedia untuk semua operator yang secara aktif mengoperasikan RCS untuk Bisnis.

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 berinteraksi dengan pengguna. Kategori penagihan tidak membatasi jumlah atau jenis pesan yang dapat dikirim agen. Namun, parameter ini menentukan cara agen 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 kategori mana pun akan ditagih sebagai agen non-percakapan.) 		Agen yang terutama mengirim pesan satu arah.
  • OTP
  • Pemberitahuan
  • Penawaran promosi
 Ditagih untuk setiap pesan yang dikirim ke pengguna.
Kealamian percakapan Agen yang dirancang untuk pertukaran dua arah dengan pengguna.
  • Menemukan produk yang tepat
  • Memesan tiket
  • Memecahkan masalah

Ditagih per percakapan: Jika salah satu pihak (agen atau pengguna) membalas pesan dari pihak lain dalam waktu 24 jam, percakapan akan dimulai. Selama jendela percakapan (24 jam setelah balasan pertama), agen dan pengguna dapat bertukar pesan dalam jumlah berapa pun, dan agen akan ditagih tarif tetap untuk percakapan tersebut.

Ditagih 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.

Diagram berikut menunjukkan contoh sesi penagihan A2P untuk agen percakapan:

Diagram penagihan

Agen percakapan versus agen 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 (Application-to-Person): Dikirim oleh bisnis.
  • P2A (Person-to-Application): Dikirim oleh pengguna.

Tabel berikut menjelaskan setiap peristiwa penagihan sebagaimana 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 bagi partner. Selalu diperlakukan sebagai peristiwa penagihan individual, terlepas dari apakah pengguna membalas atau tidak. Diperlakukan 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 memiliki konten multimedia atau pesan khusus teks dengan lebih dari 160 karakter. Selalu diperlakukan sebagai peristiwa penagihan individual, terlepas dari apakah pengguna membalas atau tidak. Diperlakukan sebagai peristiwa penagihan individual, kecuali jika pengguna membalas dalam waktu 24 jam. Dalam hal ini, pesan akan menjadi bagian dari a2p_conversation.
a2p_conversation (diprakarsai bisnis) 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 semua pesan yang dikirim dalam 24 jam berikutnya, adalah bagian dari a2p_conversation.
p2a_conversation (dimulai oleh pengguna) Dimulai saat agen membalas 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 semua pesan yang dikirim dalam 24 jam berikutnya, 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.

  • Agen mana pun (terlepas dari kategori penagihannya) 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, mereka 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 uji coba 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 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 catatan yang mewakili satu peristiwa penagihan. Kolom dalam suatu rekaman dipisahkan dengan tab. Misalnya, dua percakapan A2P dengan agen yang sama akan menghasilkan dua peristiwa penagihan dan dua catatan 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 dibuat untuk setiap peristiwa baru pada saat peristiwa tersebut dibuat. 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
type string Jenis acara:
  • basic_message
  • single_message
  • a2p_conversation
  • p2a_conversation
  • p2a_message
 single_message
agent_id string ID unik untuk agen yang berpartisipasi dalam acara. rbm-welcome-bot@rbm.goog
agent_owner string Alamat email pemilik saat ini dari akun partner tempat agen dibuat. name@aggregator.com
billing_party string Pihak yang menagih acara.
  • operator
 carrier
max_duration_single_message angka Waktu maksimum (dalam jam) yang diizinkan bagi pengguna untuk merespons pesan agen sebelum jendela inisiasi percakapan ditutup dan pesan 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 acara dimulai dalam format ISO 8601 yang dibulatkan ke jam terdekat.

Pesan A2P

  • Untuk peristiwa single_message dan basic_message, ini adalah waktu saat pesan dikirimkan kepada pengguna.
  • Untuk peristiwa a2p_conversation, ini adalah waktu saat pesan pertama dalam percakapan dikirimkan kepada pengguna.

Pesan P2A

  • Untuk peristiwa single_message dan basic_message, ini adalah waktu saat pesan dikirim oleh pengguna.
  • Untuk peristiwa p2a_conversation, ini adalah waktu saat pesan pertama dalam percakapan dikirim oleh pengguna.
 2019-07-25T08:00:00Z
duration angka Durasi acara, dibulatkan ke menit terdekat.

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

 45
mt_messages angka Jumlah pesan yang diakhiri 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 acara.

 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

Ukuran laporan harian dari partner RCS untuk Bisnis yang aktif bergantung pada seberapa banyak aktivitas yang mereka hasilkan di jaringan operator. Misalnya, jika ada 53.000 data dalam laporan, ukuran file akan sekitar 8 MB.

Log aktivitas

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

Catatan: Hanya traffic dari nomor telepon non-penguji yang disertakan dalam log aktivitas.

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 RCS untuk Bisnis di jaringan dan mengaktifkan aktivitas RCS dengan RCS Google berdasarkan Persyaratan Layanan 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 catatan dipisahkan dengan tab, dan ada satu catatan 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 terkait 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 dikirimkan ke platform RCS untuk Bisnis 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 dikirimkan ke platform RCS for Business. Untuk peristiwa yang mengirimkan konten kepada pengguna, peristiwa tidak akan dicatat dalam log aktivitas hingga pesan dikirimkan.

Misalnya, jika pesan RCS untuk Bisnis dikirim kepada pengguna pada hari Rabu pukul 13.00, dan penerima sedang offline hingga hari Minggu pukul 09.00, peristiwa akan muncul di log aktivitas yang dibuat untuk hari Minggu, tetapi stempel waktunya adalah hari Rabu, pukul 13.00.