Halaman ini menjelaskan file data yang dibuat RCS for Business untuk membantu operator Amerika Serikat dalam penagihan dan audit berdasarkan Framework RBM Amerika Serikat. Untuk mempelajari lebih lanjut US RBM Framework, Anda juga dapat membuka usrbm.org.
Laporan penagihan adalah laporan gabungan peristiwa yang dapat ditagih antara agen dan pengguna yang diluncurkan. Dapat ditagih hanya berarti bahwa suatu peristiwa memenuhi syarat untuk dikenai biaya. Operator menentukan apakah dan bagaimana peristiwa yang dapat ditagih dikenai biaya. Semua operator Amerika Serikat yang secara aktif mengoperasikan RCS for Business memiliki akses ke laporan penagihan.
Untuk mengetahui detail tentang model klasifikasi penagihan AS, lihat FAQ Penagihan AS.
Pembuatan file
Untuk mengetahui informasi selengkapnya, lihat Pembuatan file.
Penyimpanan dan akses file
Untuk mengetahui informasi selengkapnya, lihat Penyimpanan dan akses file.
Ketersediaan file
Untuk mengetahui informasi selengkapnya, lihat Ketersediaan file.
Laporan penagihan
Laporan penagihan adalah catatan peristiwa yang dapat ditagih, yang dihitung berdasarkan kategori penagihan agen dan jenis pesan yang dikirimnya. Laporan penagihan tersedia untuk semua operator yang secara aktif mengoperasikan RCS untuk Bisnis.
Laporan penagihan berisi informasi rahasia, tetapi tidak ada Informasi Identitas Pribadi (PII) pengguna, seperti MSISDN, MSISDN yang di-hash, atau ID unik pengguna.
Kategori penagihan versus peristiwa yang dapat ditagih
Perbedaan antara kategori penagihan agen dan peristiwa yang dapat ditagih sangat penting untuk memahami cara penagihan agen Anda.
- Kategori penagihan adalah klasifikasi tetap yang Anda pilih saat membuat agen. Setelan ini menentukan metode penagihan agen Anda: per pesan (agen non-percakapan) atau per sesi (agen percakapan).
- Peristiwa yang dapat ditagih adalah interaksi antara agen RCS for Business dan pengguna yang dilacak untuk tujuan penagihan (misalnya,
rich_message).
Kategori penagihan agen AS
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 | Agen yang terutama mengirim pesan satu arah. |
|
Dapat ditagih untuk setiap pesan yang dikirimkan kepada pengguna. |
| Percakapan | Agen yang dirancang untuk pertukaran pesan dua arah dengan pengguna, terlepas dari siapa yang memulai percakapan. |
|
Dapat ditagih per sesi: Jika kriteria sesi terpenuhi, semua pesan media kaya dan media interaktif dalam jangka waktu sesi 24 jam dapat ditagih dengan tarif tetap, terlepas dari durasi atau segmennya. Dapat ditagih per pesan: Jika kriteria sesi tidak terpenuhi atau pesan berada di luar jangka waktu sesi 24 jam, pesan akan ditagih satu per satu dengan tarif per pesan untuk media kaya atau media interaktif sesuai dengan kartu tarif masing-masing operator. |
Agen percakapan versus non-percakapan
Ada dua kategori penagihan agen: percakapan dan non-percakapan.
Agen non-percakapan dapat ditagih untuk setiap pesan yang dikirimkannya kepada pengguna.
- Kategori ini paling cocok untuk agen yang tidak mengharapkan balasan yang sering.
Agen Percakapan dikenai biaya tarif tetap untuk sesi asalkan sesi dipicu dan kemudian akan mencakup semua pesan yang dipertukarkan dalam periode 24 jam, termasuk pesan yang memicu sesi. Agen percakapan masih dapat dikenai biaya untuk pesan yang bukan bagian dari sesi 24 jam.
- Kategori ini paling cocok untuk agen yang melakukan percakapan multi-giliran dengan pengguna.
Logika penagihan sesi
Dalam model Penagihan AS, sesi dipicu oleh urutan 4 pesan multimedia atau media interaktif (termasuk setidaknya 2 pesan MO dan setidaknya 1 pesan MT) yang dipertukarkan dalam jangka waktu 24 jam sejak pesan pertama dalam urutan pemicu. Setelah batas ini tercapai, semua pesan dalam periode 24 jam tersebut dapat ditagih sebagai satu sesi. Pesan apa pun yang berada di luar atau gagal memicu sesi dapat ditagih dengan tarif per pesan standar untuk media kaya atau media kaya menurut kartu tarif masing-masing operator.
Diagram berikut menunjukkan contoh sesi penagihan A2P untuk agen percakapan.
- MT (Mobile Terminated) adalah pesan yang dikirim oleh bisnis.
- MO (Mobile Originated) adalah pesan atau tindakan yang dimulai oleh pengguna.
Peristiwa yang dapat ditagih
Alur pesan dikategorikan berdasarkan asal dan arahnya. Untuk mendeskripsikan arah lalu lintas pesan, operator Amerika Serikat biasanya menggunakan terminologi MT/MO. Istilah ini sesuai dengan terminologi A2P/P2A yang digunakan di seluruh dokumentasi RCS for Business. Berikut perincian singkat tentang kesesuaian istilah-istilah ini:
- A2P (Application-to-Person) adalah MT (Mobile Terminated): Pesan yang dikirim oleh bisnis.
- P2A (Person-to-Application) adalah MO (Mobile Originated): Pesan atau tindakan yang dimulai oleh pengguna.
| Acara | Deskripsi | Agen non-percakapan | Agen percakapan |
|---|---|---|---|
a2p_rich_message |
Pesan yang dikirim agen yang hanya berisi teks, saran balasan, atau saran tindakan tertentu (Hubungi nomor, Buka URL di browser). | Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara terpisah. Dapat ditagih per pesan berdasarkan segmen (1 segmen sama dengan 160 byte UTF-8). |
Diperlakukan sebagai peristiwa yang dapat ditagih secara terpisah kecuali jika menjadi bagian dari sesi. |
p2a_rich_message |
Pesan yang dikirim pengguna yang hanya berisi teks bentuk bebas atau teks dari mengetuk balasan yang disarankan. | Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara terpisah. Dapat ditagih per pesan berdasarkan segmen. |
Diperlakukan sebagai peristiwa yang dapat ditagih secara terpisah kecuali jika menjadi bagian dari sesi. |
a2p_rich_media_message |
Pesan yang dikirim agen yang berisi media (gambar, video, audio), kartu informasi, carousel, atau tindakan kompleks seperti "Lihat lokasi". | Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara terpisah. Dapat ditagih sebagai satu peristiwa tarif tetap, terlepas dari ukuran atau kontennya. |
Diperlakukan sebagai peristiwa yang dapat ditagih secara terpisah kecuali jika menjadi bagian dari sesi. |
p2a_rich_media_message |
Pesan yang dikirim pengguna yang berisi file media yang diupload (gambar, video, audio). | Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara terpisah. Dapat ditagih sebagai satu peristiwa tarif tetap. |
Diperlakukan sebagai peristiwa yang dapat ditagih secara terpisah kecuali jika menjadi bagian dari sesi. |
p2a_suggested_action |
Pengguna mengetuk tindakan yang disarankan (misalnya, "Lihat lokasi") yang bukan merupakan balasan yang disarankan. | Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara terpisah. Menghasilkan satu peristiwa yang dapat ditagih per klik. |
Diperlakukan sebagai peristiwa yang dapat ditagih secara terpisah dan menghasilkan satu peristiwa yang dapat ditagih per klik, kecuali jika menjadi bagian dari sesi. |
a2p_session |
Jendela interaksi 24 jam yang dimulai saat pemicu sesi dimulai dan pesan pertama diterjemahkan. Untuk mengetahui informasi selengkapnya, lihat Apa itu sesi dan cara kerjanya. | T/A. Sesi tidak berlaku untuk agen non-percakapan. | Setelah dipicu, semua pesan dalam jangka waktu 24 jam akan tercakup dalam satu biaya sesi. Setiap peristiwa yang dapat ditagih dalam sesi 24 jam akan ditetapkan ke ID peristiwa yang dapat ditagih dalam sesi tersebut. |
p2a_session |
Periode interaksi 24 jam yang dimulai saat pemicu sesi dimulai dan pesan pertama adalah MO. Untuk mengetahui informasi selengkapnya, lihat Apa itu sesi dan cara kerjanya. | T/A. Sesi tidak berlaku untuk agen non-percakapan. | Setelah dipicu, semua pesan dalam jangka waktu 24 jam akan tercakup dalam satu biaya sesi. Setiap peristiwa yang dapat ditagih dalam sesi 24 jam akan ditetapkan ke ID peristiwa yang dapat ditagih dalam sesi tersebut. |
Pembuatan laporan penagihan
Hanya agen dengan traffic non-penguji yang menghasilkan peristiwa yang dapat ditagih. Aktivitas dari nomor telepon uji coba tidak muncul dalam laporan penagihan.
Laporan ini mengasumsikan bahwa peristiwa dapat ditagih saat pesan A2P dikirim, bukan saat pesan dikirim. Pesan yang tidak terkirim atau pesan yang dibatalkan sebelum pengiriman tidak memicu peristiwa yang dapat ditagih.
Format laporan penagihan
Laporan 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 yang dapat ditagih.
Sesi A2P/P2A diwakili oleh beberapa baris—satu untuk setiap pesan yang dipertukarkan. Setiap baris yang terkait dengan sesi (berbagi
billing_event_id yang sama) akan melaporkan jumlah total pesan MT dan MO untuk
seluruh periode sesi 24 jam di kolom mt_messages dan mo_messages.
Setiap data dalam laporan berisi informasi berikut untuk setiap peristiwa yang dapat ditagih.
| Kolom | Format | Deskripsi | Contoh |
|---|---|---|---|
billing_event_id |
string | ID yang dihasilkan yang membedakan peristiwa yang dapat ditagih. Semua pesan yang merupakan bagian dari sesi akan memiliki |
63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type |
string | Jenis acara:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action |
p2a_rich_message |
agent_id |
string | ID unik untuk agen yang berpartisipasi dalam acara. | acme_342h23_agent@rbm.goog |
agent_owner |
string | Alamat email pemilik saat ini dari akun partner tempat agen dibuat. | marketing@xyzaggregator.com |
billing_party |
string | Pihak yang menagih acara. | operator |
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. Tidak berlaku untuk model Amerika Serikat untuk pesan multimedia individual. |
24 |
max_duration_a2p_conversation |
angka | Untuk uji coba sesi, ini mencerminkan periode sesi 24 jam yang diukur dari pesan pertama dalam urutan pemicu. Durasi diukur dalam jam. | 24 |
max_duration_p2a_conversation |
angka | Untuk uji coba sesi, ini mencerminkan periode sesi 24 jam yang diukur dari pesan pertama dalam urutan pemicu. | 24 |
start_time |
YYYY-mm-ddTHH:00:00Z | Tanggal/waktu UTC saat acara dimulai (ISO 8601). Untuk sesi, ini adalah stempel waktu pesan pertama dalam urutan pemicu. A2P a2p_rich_message dan a2p_rich_media_message, ini adalah waktu saat pesan dikirimkan kepada pengguna.a2p_session, ini adalah waktu saat pesan pertama dalam percakapan dikirimkan kepada pengguna.P2A p2a_rich_message dan p2a_rich_media_message, ini adalah waktu saat pesan dikirim oleh pengguna.p2a_session, ini adalah waktu saat pesan pertama dalam percakapan dikirim oleh pengguna. |
2025-05-20T08:00:00Z |
duration |
angka | Durasi hanya berlaku untuk sesi dan diukur dalam menit. Jika peristiwa adalah peristiwa non-sesi, nilainya adalah 0. | 45 |
mt_messages |
angka | Jumlah pesan yang diakhiri perangkat seluler (A2P) dalam peristiwa. Untuk sesi, setiap baris yang memiliki billing_event_id yang sama menunjukkan jumlah total pesan MT dalam seluruh sesi. |
5 |
mo_messages |
angka | Jumlah pesan yang berasal dari perangkat seluler (P2A) dalam peristiwa. Untuk sesi, setiap baris yang memiliki billing_event_id yang sama menunjukkan jumlah total pesan MO dalam seluruh sesi. |
3 |
size_kilobytes |
angka | Ukuran semua file yang dilampirkan ke pesan dalam peristiwa, dibulatkan ke kilobyte terdekat (1 kB sama dengan 1024 byte). | 912 |
agent_name |
string | Nama agen yang berpartisipasi dalam acara. | ACME Brand |
owner_name |
string | Nama pemilik saat ini dari akun partner tempat agen dibuat. | XYZ Aggregator |
segment_count |
angka | Jumlah segmen yang dihitung untuk peristiwa a2p_rich_message events dan p2a_rich_message (1 segmen sama dengan 160 byte UTF-8). Jika peristiwa bukan salah satu yang disebutkan, nilainya adalah 0. |
5 |
session_type |
string | Jenis sesi:a2p_sessionp2a_session |
a2p_session |
Contoh laporan penagihan
Contoh laporan tersedia untuk didownload:
Ukuran file umum
Ukuran laporan harian dari partner RCS untuk Bisnis yang aktif bergantung pada seberapa banyak aktivitas yang dihasilkan di jaringan operator.