Laporan penagihan dan log aktivitas

Halaman ini menjelaskan file data yang dibuat RCS for Business untuk membantu operator dalam 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 satu hari penggunaan RCS for Business dalam Waktu Standar Pasifik (PST). File dibuat setiap hari dan mencerminkan aktivitas dari periode 24 jam sebelumnya (tengah malam hingga tengah malam). Proses pembuatan dapat memerlukan waktu beberapa jam, dan waktu penyelesaiannya dapat bervariasi.

• Untuk agen non-percakapan, file berisi data dari periode 24 jam yang langsung mendahului hari saat file dibuat. Misalnya, laporan yang dibuat pada 5 Mei mencakup data dari 4 Mei pukul 00.00 hingga 5 Mei pukul 00.00. Waktu yang ditentukan berada di zona waktu PST.

• Untuk agen percakapan, file berisi data dari periode 24 jam 1-2 hari sebelum waktu pembuatan file. Misalnya, laporan yang dibuat pada 5 Mei mencakup data dari periode 24 jam pada 2 Mei atau 3 Mei. Waktu yang ditentukan berada dalam zona waktu PST.

  Alasan penundaan ini adalah karena aktivitas RCS untuk Bisnis bagi agen percakapan dikaitkan dengan sesi, yang dapat memerlukan waktu hingga 24 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.

Catatan: Laporan juga dapat berisi data dari 30 hari sebelumnya (baik untuk agen percakapan maupun non-percakapan). Karena penagihan didasarkan pada waktu pengiriman, dalam hal ini, jika pesan dikirim pada 10 April, tetapi dikirim pada 4 Mei, pesan tersebut akan ada dalam laporan yang dibuat pada 5 Mei.

Poin-poin utama:

• Tidak ada aktivitas: Secara default, tidak ada file yang dibuat jika tidak ada aktivitas platform pada hari tertentu. Namun, Anda dapat memilih untuk menerima file kosong jika diperlukan. Untuk mengaktifkan fitur ini, hubungi [e-mail].
• 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 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 akan dilaporkan. Artinya, mungkin ada beberapa hari saat tidak ada file yang dibuat. Jika Anda memerlukan file kosong untuk menyederhanakan proses, hubungi tim dukungan RCS for Business.

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, metode ini menentukan cara penagihan pesan untuk agen. 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 dikirimkan kepada 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 periode 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:

Agen percakapan versus 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 jangka waktu 24 jam.

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

Peristiwa yang dapat ditagih

Catatan: Peristiwa di bagian ini hanya berlaku untuk model penagihan standar (traffic non-AS). Untuk mempelajari peristiwa yang dapat ditagih untuk traffic Amerika Serikat, lihat panduan model penagihan Amerika Serikat.

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 pesan apa pun 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 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. Bagian ini menentukan metode penagihan agen Anda: per pesan (Agen non-percakapan) atau per percakapan (Agen percakapan).
• Peristiwa yang dapat ditagih adalah interaksi antara agen RCS for Business 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 yang dihasilkan yang membedakan peristiwa yang dapat ditagih.	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 p2a_suggested_action	single_message p2a_rich_message
agent_id	string	ID unik untuk agen yang berpartisipasi dalam acara.	[e-mail]
agent_owner	string	Alamat email pemilik saat ini dari akun partner tempat agen dibuat.	[e-mail]
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. Nilainya adalah 0 untuk setiap peristiwa non-percakapan.	45
mt_messages	angka	Jumlah pesan yang ditujukan ke 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
segment_count	angka	Khusus model penagihan Amerika Serikat Jumlah segmen yang dihitung untuk peristiwa RICH_MESSAGE.	5

Contoh laporan penagihan

Laporan sampel tersedia untuk didownload:

• Laporan penagihan untuk model penagihan standar
• Laporan penagihan untuk model penagihan AS

Ukuran file umum

Ukuran laporan harian dari partner RCS untuk Bisnis yang aktif bergantung pada seberapa banyak aktivitas yang dihasilkan 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 yang dapat ditagih 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 jika operator mengoperasikan RCS berdasarkan Persyaratan Layanan mereka sendiri. Jika Anda memiliki traffic RCS for Business 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 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 yang dapat ditagih terkait. Dapat kosong jika aktivitas tidak dikaitkan dengan peristiwa yang dapat ditagih, seperti text_message tanpa delivery_receipt_event yang sesuai.	91yeb201-7c3b-412b-98d2-b0a0f7abe536
agent_id	string	ID unik untuk agen.	[e-mail]
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 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.