Laporan penagihan dan log aktivitas

Halaman ini menjelaskan file data yang dibuat RCS untuk Bisnis guna membantu operator dengan penagihan dan audit.

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

RCS for Business menggunakan dua model penagihan: model penagihan standar untuk traffic non-AS dan model penagihan AS untuk traffic AS. Informasi unik untuk model standar atau model AS (misalnya, klasifikasi peristiwa yang dapat ditagih atau kolom laporan yang berbeda) dicatat secara eksplisit.

  • Untuk mengetahui detail tentang model penagihan standar dan ringkasan perbedaan model penagihan, lihat FAQ Penagihan.
  • Untuk mengetahui detail tentang klasifikasi penagihan AS, lihat panduan model penagihan AS.

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 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 penagihan dibuat pada 5 Mei pukul 11.00 UTC, laporan tersebut mungkin 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 untuk Bisnis mencatat semua pesan dalam percakapan sebelum menghitung peristiwa yang dapat ditagih. 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 dengan 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 Anda:

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 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 penagihan

Laporan penagihan adalah catatan peristiwa yang dapat ditagih, yang dihitung berdasarkan kategori penagihan agen dan jenis pesan yang dikirimkannya. 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 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, hal 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.
  • 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.

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 yang dapat ditagih

Lima jenis peristiwa yang dapat ditagih dicatat dalam laporan penagihan. Peristiwa ini mencakup peristiwa MT dan MO, yang disebut sebagai peristiwa A2P dan P2A.

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

Tabel berikut menjelaskan setiap peristiwa yang dapat ditagih 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 yang dapat ditagih secara terpisah, terlepas dari apakah pengguna membalas atau tidak. Diperlakukan sebagai peristiwa yang dapat ditagih secara 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 yang dapat ditagih secara terpisah, terlepas dari apakah pengguna membalas atau tidak. Diperlakukan sebagai peristiwa yang dapat ditagih secara 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 pesan apa pun yang dikirim dalam 24 jam berikutnya, adalah bagian dari p2a_conversation.
p2a_message Pesan P2A dari jenis apa pun. Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara terpisah, terlepas dari apakah agen membalas atau tidak. Diperlakukan sebagai peristiwa yang dapat ditagih secara individual, kecuali jika agen membalas dalam waktu 24 jam.

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. Menentukan metode penagihan agen Anda: per pesan (Agen non-percakapan) atau per percakapan (Agen percakapan).
  • Peristiwa yang dapat ditagih adalah interaksi antara agen RCS untuk Bisnis dan pengguna yang dilacak untuk tujuan penagihan (misalnya, basic_message, single_message, a2p_conversation).

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 ditagih saat pesan 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. Kolom dalam satu kumpulan data dipisahkan dengan tab. Misalnya, dua percakapan A2P dengan agen yang sama akan menghasilkan dua peristiwa yang dapat ditagih terpisah dan dua catatan dalam laporan penagihan.

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

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:

    Model penagihan standar

  • basic_message
  • single_message
  • a2p_conversation
  • p2a_conversation
  • p2a_message

    • Model penagihan Amerika Serikat

  • a2P_rich_message
  • a2p_rich_media_message
  • p2a_rich_message
  • p2a_rich_media_message
  • suggested_action_click
 single_message

p2a_rich_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 peristiwa 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 acara, 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
segment_count angka Khusus model penagihan Amerika Serikat

Jumlah segmen yang dihitung untuk peristiwa RICH_MESSAGE.

 5

Contoh laporan peristiwa penagihan

Laporan sampel 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 for Business. 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 for Business di jaringan Anda 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 catatan 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 pesan dikirim:
  • 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 for Business 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 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.