Halaman ini menjelaskan berkas data yang dibuat oleh RCS for Business untuk membantu operator telekomunikasi AS dalam penagihan dan audit berdasarkan Kerangka Kerja RBM AS. Untuk mempelajari lebih lanjut tentang Kerangka Kerja RBM AS, Anda juga dapat mengunjungi usrbm.org .
Laporan penagihan adalah laporan agregat dari peristiwa yang dapat ditagih antara agen yang diluncurkan dan pengguna. Dapat ditagih berarti bahwa suatu peristiwa memenuhi syarat untuk dikenakan biaya. Operator menentukan apakah dan bagaimana peristiwa yang dapat ditagih dikenakan biaya. Semua operator AS yang aktif mengoperasikan RCS for Business memiliki akses ke laporan penagihan.
Untuk detail mengenai model klasifikasi penagihan AS, lihat FAQ Penagihan AS .
Pembuatan berkas
Untuk informasi selengkapnya, lihat Pembuatan berkas .
Penyimpanan dan akses file
Untuk informasi selengkapnya, lihat Penyimpanan dan akses berkas .
Ketersediaan berkas
Untuk informasi selengkapnya, lihat Ketersediaan berkas .
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 aktif mengoperasikan RCS for Business.
Laporan penagihan berisi informasi rahasia, tetapi tidak mengandung Informasi Identifikasi Pribadi (PII) pengguna, seperti MSISDN, MSISDN yang di-hash, atau pengidentifikasi unik pengguna apa pun.
Kategori penagihan versus peristiwa yang dapat ditagih
Perbedaan antara kategori penagihan agen dan peristiwa yang dapat ditagih sangat penting untuk memahami bagaimana agen Anda dapat ditagih.
- Kategori penagihan adalah klasifikasi tetap yang Anda pilih saat membuat agen Anda. Kategori 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 akan berinteraksi dengan pengguna. Kategori penagihan tidak membatasi jumlah atau jenis pesan yang dapat dikirim agen. Namun, kategori ini menentukan bagaimana agen akan ditagih untuk pesan-pesannya. Dua kategori penagihan utama dijelaskan dalam tabel berikut.
| Kategori penagihan | Jenis agen | Contoh kasus penggunaan | Metode penagihan |
|---|---|---|---|
| Tidak bersifat percakapan | Agen yang terutama mengirimkan pesan satu arah. |
| Dikenakan biaya untuk setiap pesan yang dikirimkan kepada pengguna. |
| Percakapan | Agen yang dirancang untuk pertukaran timbal balik dengan pengguna tanpa memandang siapa yang memulai percakapan. |
| Ditagih per sesi : Jika kriteria sesi terpenuhi, semua pesan kaya dan pesan media kaya dalam jendela sesi 24 jam akan ditagih dengan tarif tetap, terlepas dari panjang atau segmennya. Ditagih per pesan : Jika kriteria sesi tidak terpenuhi atau pesan berada di luar jendela sesi 24 jam, pesan tersebut akan ditagih secara individual dengan tarif per pesan untuk rich media atau rich data sesuai dengan daftar harga masing-masing operator. |
Agen percakapan versus agen non-percakapan
Ada dua kategori penagihan agen: percakapan dan non-percakapan.
Agen non-percakapan akan dikenakan biaya untuk setiap pesan yang mereka sampaikan kepada pengguna.
- Kategori ini paling cocok untuk agen yang tidak mengharapkan balasan yang sering.
Agen percakapan dikenakan tarif tetap untuk setiap sesi, dengan syarat sesi tersebut dipicu, dan tarif tersebut akan mencakup semua pesan yang dipertukarkan dalam periode 24 jam, termasuk pesan yang memicu sesi tersebut. Agen percakapan masih dapat dikenakan biaya untuk pesan yang bukan bagian dari sesi 24 jam.
- Kategori ini paling cocok untuk agen yang terlibat dalam percakapan multi-giliran dengan pengguna.
Logika penagihan sesi
Berdasarkan model penagihan AS, sebuah sesi dipicu oleh serangkaian 4 pesan kaya atau pesan media kaya (termasuk setidaknya 2 pesan MO dan setidaknya 1 pesan MT) yang dipertukarkan dalam jangka waktu 24 jam sejak pesan pertama dalam rangkaian pemicu. Setelah ambang batas ini terpenuhi, semua pesan dalam jangka waktu 24 jam tersebut akan ditagih sebagai satu sesi tunggal . Pesan apa pun yang berada di luar jangka waktu tersebut atau gagal memicu sesi akan ditagih dengan tarif per pesan standar untuk pesan kaya atau pesan media kaya sesuai dengan daftar 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 diprakarsai oleh pengguna.
Acara yang dapat ditagih
Alur pesan dikategorikan berdasarkan asal dan arahnya. Untuk menggambarkan arah lalu lintas pesan, operator AS biasanya menggunakan terminologi MT/MO . Istilah-istilah ini sesuai dengan terminologi A2P/P2A yang digunakan di seluruh dokumentasi RCS for Business. Berikut adalah uraian singkat tentang bagaimana istilah-istilah ini selaras:
- 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 diprakarsai oleh pengguna.
| Peristiwa | Keterangan | Agen non-percakapan | Agen percakapan |
|---|---|---|---|
a2p_rich_message | Pesan yang dikirim oleh agen yang hanya berisi teks, saran balasan, atau saran tindakan spesifik (Hubungi nomor, Buka URL di peramban). | Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara individual. Dikenakan biaya per pesan berdasarkan segmen (1 segmen sama dengan 160 byte UTF-8). | Diperlakukan sebagai acara yang dapat ditagih secara individual kecuali jika menjadi bagian dari sesi. |
p2a_rich_message | Pesan yang dikirim pengguna hanya berisi teks bebas atau teks dari balasan yang disarankan. | Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara individual. Ditagih per pesan berdasarkan segmen. | Diperlakukan sebagai acara yang dapat ditagih secara individual kecuali jika menjadi bagian dari sesi. |
a2p_rich_media_message | Pesan yang dikirim oleh agen yang berisi media (gambar, video, audio), rich card, carousel, atau tindakan kompleks seperti "Lihat lokasi". | Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara individual. Dapat ditagih sebagai satu acara dengan tarif tetap, terlepas dari ukuran atau isinya. | Diperlakukan sebagai acara yang dapat ditagih secara individual kecuali jika menjadi bagian dari sesi. |
p2a_rich_media_message | Pesan yang dikirim pengguna berisi file media yang diunggah (gambar, video, audio). | Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara individual. Dapat ditagih sebagai satu acara dengan tarif tetap. | Diperlakukan sebagai acara yang dapat ditagih secara individual 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 individual. Menghasilkan satu transaksi yang dapat ditagih per klik. | Diperlakukan sebagai peristiwa yang dapat ditagih secara individual dan menghasilkan satu peristiwa yang dapat ditagih per klik kecuali jika menjadi bagian dari sesi. |
a2p_session | Jendela interaksi 24 jam yang dimulai ketika pemicu sesi diaktifkan dan pesan pertama adalah MT. Untuk informasi lebih lanjut, lihat Apa itu sesi dan bagaimana cara kerjanya . | Tidak berlaku. Sesi tidak berlaku untuk agen non-percakapan. | Setelah diaktifkan, semua pesan dalam jangka waktu 24 jam akan dicakup oleh satu biaya sesi. Setiap kejadian yang dapat ditagih dalam sesi 24 jam akan ditetapkan ke ID kejadian yang dapat ditagih dalam sesi tersebut. |
p2a_session | Jendela interaksi 24 jam yang dimulai ketika pemicu sesi diaktifkan dan pesan pertama adalah MO. Untuk informasi lebih lanjut, lihat Apa itu sesi dan bagaimana cara kerjanya . | Tidak berlaku. Sesi tidak berlaku untuk agen non-percakapan. | Setelah diaktifkan, semua pesan dalam jangka waktu 24 jam akan dicakup oleh satu biaya sesi. Setiap kejadian yang dapat ditagih dalam sesi 24 jam akan ditetapkan ke ID kejadian yang dapat ditagih dalam sesi tersebut. |
Pembuatan laporan penagihan
Hanya agen dengan lalu lintas non-penguji yang menghasilkan peristiwa yang dapat ditagih. Aktivitas dari nomor telepon uji tidak muncul dalam laporan penagihan.
Laporan ini mengasumsikan bahwa peristiwa dapat ditagih ketika pesan A2P terkirim, bukan ketika 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 merupakan 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 (yang memiliki billing_event_id yang sama) akan melaporkan jumlah total pesan MT dan MO untuk seluruh jendela sesi 24 jam di kolom mt_messages dan mo_messages .
Setiap catatan dalam laporan berisi informasi berikut untuk setiap peristiwa yang dapat ditagih.
| Bidang | Format | Keterangan | Contoh |
|---|---|---|---|
billing_event_id | rangkaian | ID yang dihasilkan untuk membedakan peristiwa yang dapat ditagih. Semua pesan yang merupakan bagian dari sebuah sesi akan memiliki | 63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type | rangkaian | Jenis acara:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action | p2a_rich_message |
agent_id | rangkaian | Pengidentifikasi unik untuk agen yang berpartisipasi dalam acara tersebut. | acme_342h23_agent@rbm.goog |
agent_owner | rangkaian | Alamat email pemilik akun mitra saat ini tempat agen tersebut dibuat. | marketing@xyzaggregator.com |
billing_party | rangkaian | Pihak yang menagih biaya untuk acara tersebut. | pembawa |
max_duration_single_message | nomor | Waktu maksimum (dalam jam) yang diizinkan bagi pengguna untuk menanggapi pesan agen sebelum jendela inisiasi percakapan ditutup dan pesan diklasifikasikan sebagai peristiwa single_message . Tidak berlaku untuk model AS untuk pesan kaya individual. | 24 |
max_duration_a2p_conversation | nomor | Untuk uji coba sesi, ini mencerminkan jendela sesi 24 jam yang diukur dari pesan pertama dalam urutan pemicu. Durasi diukur dalam jam. | 24 |
max_duration_p2a_conversation | nomor | Untuk uji coba sesi, ini mencerminkan jendela sesi 24 jam yang diukur dari pesan pertama dalam urutan pemicu. | 24 |
start_time | YYYY-mm-ddTHH:00:00Z | Tanggal/waktu UTC saat peristiwa 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 ketika pesan dikirimkan ke pengguna.a2p_session , ini adalah waktu ketika pesan pertama dalam percakapan dikirimkan kepada pengguna.P2A p2a_rich_message dan p2a_rich_media_message , ini adalah waktu ketika pesan dikirim oleh pengguna.p2a_session , ini adalah waktu ketika pesan pertama dalam percakapan dikirim oleh pengguna. | 2025-05-20T08:00:00Z |
duration | nomor | Durasi hanya berlaku untuk sesi dan diukur dalam menit. Jika peristiwa tersebut bukan peristiwa sesi, nilainya adalah 0. | 45 |
mt_messages | nomor | Jumlah pesan yang diterima melalui perangkat seluler (A2P) dalam acara tersebut. Untuk sesi, setiap baris yang memiliki billing_event_id yang sama menunjukkan jumlah total pesan MT dalam keseluruhan sesi. | 5 |
mo_messages | nomor | Jumlah pesan yang berasal dari perangkat seluler (P2A) dalam acara tersebut. Untuk sesi, setiap baris yang memiliki billing_event_id yang sama menunjukkan jumlah total pesan MO dalam keseluruhan sesi. | 3 |
size_kilobytes | nomor | Ukuran semua file yang dilampirkan pada pesan dalam acara tersebut, dibulatkan ke kilobyte terdekat (1kB sama dengan 1024 byte). | 912 |
agent_name | rangkaian | Nama agen yang berpartisipasi dalam acara tersebut. | ACME Brand |
owner_name | rangkaian | Nama pemilik akun mitra saat ini tempat agen tersebut dibuat. | XYZ Aggregator |
segment_count | nomor | Jumlah segmen yang dihitung untuk a2p_rich_message events dan peristiwa p2a_rich_message (1 segmen sama dengan 160 byte UTF-8). Jika peristiwa tersebut bukan salah satu yang disebutkan, nilainya adalah 0. | 5 |
session_type | rangkaian | Jenis sesi:a2p_sessionp2a_session | a2p_session |
Contoh laporan penagihan
Contoh laporan tersedia untuk diunduh:
Ukuran file tipikal
Ukuran laporan harian dari mitra RCS for Business yang aktif bergantung pada seberapa banyak aktivitas yang mereka hasilkan di jaringan operator.