Halaman ini menjelaskan berkas data yang dibuat oleh RCS for Business untuk membantu perusahaan asuransi dalam penagihan dan audit.
| Mengajukan | Keterangan | Siapa yang memiliki akses? |
|---|---|---|
| Laporan penagihan | Laporan agregat dari peristiwa yang dapat ditagih antara agen yang diluncurkan dan pengguna. | Semua operator yang secara aktif mengoperasikan RCS for Business. |
| Catatan aktivitas | Log data mentah aktivitas RCS untuk Bisnis, termasuk peristiwa yang dapat ditagih. | Operator seluler yang secara aktif mengoperasikan RCS untuk Bisnis dan mengoperasikan Layanan Google RCS berdasarkan Ketentuan Layanan (ToS) mereka sendiri. |
RCS for Business menggunakan model penagihan standar untuk lalu lintas non-AS. Untuk detailnya, lihat FAQ Penagihan .
Pembuatan berkas
Setiap berkas data mewakili satu hari penggunaan RCS for Business dalam Zona Waktu Standar Pasifik (PST). Berkas dihasilkan setiap hari dan mencerminkan aktivitas dari periode 24 jam sebelumnya (tengah malam hingga tengah malam). Proses pembuatannya dapat memakan waktu beberapa jam, dan waktu penyelesaiannya dapat bervariasi.
- Untuk agen non-percakapan , file berisi data dari periode 24 jam yang langsung mendahului hari pembuatan file. Misalnya, laporan yang dibuat pada tanggal 5 Mei mencakup data dari pukul 12:00 AM tanggal 4 Mei hingga pukul 12:00 AM tanggal 5 Mei. Waktu yang ditentukan berada dalam 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 tanggal 5 Mei mencakup data dari jendela 24 jam tanggal 2 Mei atau 3 Mei. Waktu yang ditentukan berada di zona waktu PST.
Alasan keterlambatan ini adalah karena aktivitas RCS for Business untuk agen percakapan terkait dengan sesi, yang dapat memakan waktu hingga 24 jam untuk diselesaikan. Keterlambatan ini memungkinkan RCS for Business untuk menangkap semua pesan dalam percakapan sebelum menghitung peristiwa yang dapat ditagih. Untuk informasi lebih lanjut tentang agen percakapan, lihat kategori penagihan agen .
Poin-poin penting:
- Tidak ada aktivitas : Secara default, tidak ada file yang dihasilkan jika tidak ada aktivitas platform pada hari tertentu. Namun, Anda dapat memilih untuk menerima file kosong jika diperlukan. Untuk memilihnya, hubungi rbm-support@google.com.
- Penamaan : Tanggal dalam nama file adalah tanggal pembuatan file, bukan tanggal data di dalamnya.
- Retensi : File disimpan maksimal selama 63 hari sebelum dihapus.
Anda dapat menggunakan file-file ini untuk memperbarui gudang data Anda dengan metrik penggunaan platform terbaru.
Penyimpanan dan akses file
Berkas data dienkripsi saat disimpan dan saat ditransfer.
Untuk mengambil berkas data melalui Secure File Transfer Protocol (SFTP), berikan kunci publik SFTP Anda. Untuk menghasilkan kunci, lihat Menghasilkan pasangan kunci Secure Shell (SSH) untuk dropbox SFTP .
Server SFTP yang digunakan adalah partnerupload.google.com , dan koneksi menggunakan 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 menyediakan 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 berkas
Jika belum ada berkas data yang dihasilkan, Anda akan melihat kesalahan SFTP yang mirip dengan remote readdir("/"): No such file or directory , yang memang sudah diperkirakan.
File tidak akan dibuat jika tidak ada lalu lintas RCS for Business yang dilaporkan. Ini berarti mungkin ada beberapa hari di mana tidak ada file yang dibuat. Jika Anda memerlukan file kosong untuk menyederhanakan proses Anda, 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 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 agen
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-pesan tersebut. 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. |
| Ditagih untuk setiap pesan yang terkirim ke pengguna. |
| Percakapan | Agen yang dirancang untuk pertukaran timbal balik dengan pengguna. |
| Ditagih per percakapan : Jika salah satu pihak (agen atau pengguna) membalas pesan dari pihak lain dalam waktu 24 jam, percakapan dimulai. Selama jangka waktu percakapan (24 jam setelah balasan pertama), agen dan pengguna dapat bertukar pesan sebanyak apa pun, dan agen akan ditagih dengan 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, sama seperti agen non-percakapan. |
Diagram berikut menunjukkan contoh sesi penagihan A2P untuk agen percakapan:
Agen percakapan versus agen non-percakapan
Ada dua kategori penagihan utama: percakapan dan non-percakapan.
Perbedaan utama dalam kategori penagihan terletak antara agen percakapan dan agen non-percakapan:
Agen non-percakapan ditagih 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 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.
Acara yang dapat ditagih
Lima jenis kejadian yang dapat ditagih dicatat dalam laporan penagihan. Kejadian-kejadian ini meliputi kejadian MT dan MO, yang disebut sebagai kejadian 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 diprakarsai oleh pengguna.
Tabel berikut menjelaskan setiap peristiwa yang dapat ditagih sebagaimana berlaku untuk agen non-percakapan dan agen percakapan.
| Peristiwa | Keterangan | Agen non-percakapan | Agen percakapan |
|---|---|---|---|
basic_message | Pesan A2P yang hanya berisi teks dengan 160 karakter atau kurang. Jika teks tersebut menyertakan URL untuk situs web dengan tag openGraph , pesan tersebut dapat menampilkan pratinjau gambar, tanpa biaya tambahan bagi mitra. | Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara individual, 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 itu, pesan tersebut menjadi bagian dari a2p_conversation . |
single_message | Pesan A2P yang memiliki konten kaya atau berupa pesan teks saja dengan lebih dari 160 karakter. | Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara individual, 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 itu, pesan tersebut menjadi bagian dari a2p_conversation . |
a2p_conversation (diinisiasi bisnis) | Dipicu ketika pengguna merespons pesan A2P dalam waktu 24 jam setelah menerimanya, di luar percakapan yang sedang berlangsung. | Tidak berlaku. Agen non-percakapan tidak pernah menghasilkan jenis peristiwa ini. | Jika pesan P2A terkirim dalam waktu 24 jam setelah beberapa pesan A2P, hanya pesan A2P yang mendahului pesan P2A tersebut yang digunakan untuk memulai percakapan. Pesan A2P ini, dan pesan apa pun yang terkirim dalam 24 jam berikutnya, merupakan bagian dari a2p_conversation . |
p2a_conversation (diinisiasi pengguna) | Dipicu ketika agen merespons pesan P2A dalam waktu 24 jam setelah menerimanya, di luar percakapan yang sedang berlangsung. | Tidak berlaku. Agen non-percakapan tidak pernah menghasilkan jenis peristiwa ini. | Jika pesan A2P terkirim dalam waktu 24 jam setelah beberapa pesan P2A, hanya pesan P2A yang mendahului pesan A2P tersebut yang digunakan untuk memulai percakapan. Pesan P2A ini, dan pesan apa pun yang terkirim dalam 24 jam berikutnya, merupakan bagian dari p2a_conversation . |
p2a_message | Pesan P2A jenis apa pun. | Selalu diperlakukan sebagai peristiwa yang dapat ditagih secara individual, terlepas dari apakah agen tersebut 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 bagaimana agen Anda 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 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 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 ditagih ketika pesan 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. Kolom dalam sebuah catatan dipisahkan oleh tab. Misalnya, dua percakapan A2P dengan agen yang sama akan menghasilkan dua peristiwa yang dapat ditagih secara terpisah dan dua catatan dalam laporan penagihan.
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. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff |
type | rangkaian | Jenis acara:
| single_message |
agent_id | rangkaian | Pengidentifikasi unik untuk agen yang berpartisipasi dalam acara tersebut. | rbm-welcome-bot@rbm.goog |
agent_owner | rangkaian | Alamat email pemilik akun mitra saat ini tempat agen tersebut dibuat. | name@aggregator.com |
billing_party | rangkaian | Pihak yang menagih biaya untuk acara tersebut.
| carrier |
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 . | 24 |
max_duration_a2p_conversation | nomor | Durasi maksimum percakapan A2P, dalam jam. Diukur dari respons pengguna pertama hingga pesan awal agen. | 24 |
max_duration_p2a_conversation | nomor | Durasi maksimum percakapan P2A, dalam jam. Diukur dari pesan pengguna pertama dalam percakapan. | 24 |
start_time | YYYY-mm-ddTHH:00:00Z | Tanggal/waktu UTC dimulainya peristiwa dalam format ISO 8601 yang dibulatkan ke jam terdekat. Pesan A2P
Pesan P2A
| 2019-07-25T08:00:00Z |
duration | nomor | Durasi acara, dibulatkan ke menit terdekat. Nilainya adalah 0 untuk setiap kejadian yang bukan percakapan. | 45 |
mt_messages | nomor | Jumlah pesan yang diterima melalui perangkat seluler (A2P) dalam peristiwa tersebut. | 11 |
mo_messages | nomor | Jumlah pesan yang berasal dari perangkat seluler (P2A) dalam acara tersebut. | 9 |
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. | XYZ Mobile USA |
owner_name | rangkaian | Nama pemilik akun mitra saat ini tempat agen tersebut dibuat. | XYZ Mobile |
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. Misalnya, jika terdapat 53.000 catatan dalam laporan, ukuran file akan sekitar 8Mb.
Log aktivitas
Log aktivitas menyediakan data mentah tentang aktivitas di platform RCS for Business. Anda dapat menggunakan log ini untuk mengaudit peristiwa yang dapat ditagih dan membuat peristiwa khusus.
Karena log aktivitas berisi Informasi Identifikasi Pribadi (PII), seperti informasi transaksi terperinci dan MSISDN pelanggan, log tersebut hanya tersedia ketika operator menjalankan RCS berdasarkan Ketentuan Layanan mereka sendiri. Jika Anda memiliki lalu lintas RCS untuk Bisnis di jaringan Anda dan mengaktifkan aktivitas RCS dengan Google RCS berdasarkan Ketentuan 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 sebuah record dipisahkan oleh tab, dan terdapat satu record per baris.
Setiap catatan dalam log aktivitas berisi kolom-kolom berikut untuk setiap aktivitas:
| Bidang | Format | Keterangan | Contoh |
|---|---|---|---|
activity_id | rangkaian | Pengidentifikasi unik untuk aktivitas tersebut. | b422e1d3-ac99-442a-853d-a875d5e61762 |
billing_event_id | rangkaian | Pengidentifikasi unik untuk peristiwa yang dapat ditagih terkait. Dapat kosong jika aktivitas tidak terkait dengan peristiwa yang dapat ditagih, seperti text_message tanpa delivery_receipt_event yang sesuai. | 91yeb201-7c3b-412b-98d2-b0a0f7abe536 |
agent_id | rangkaian | Pengidentifikasi unik untuk agen tersebut. | welcome-bot@rbm.goog |
user_id | rangkaian | MSISDN pengguna. | 918369110173 |
direction | rangkaian | Arah pengiriman pesan:
| MT |
time | YYYY-mm-ddTHH:MM:SS.SSSZ | Tanggal dan waktu saat acara dikirimkan ke platform RCS for Business dalam format UTC. Lihat Stempel Waktu . | 2019-07-25T00:29:07.033Z |
type | rangkaian | Jenis kegiatan:
| text_message |
size_bytes | rangkaian | Ukuran file yang dilampirkan pada aktivitas, dalam byte. | 912 |
Cap waktu
Stempel waktu dalam log aktivitas mencatat kapan suatu peristiwa dikirimkan ke platform RCS for Business. Untuk peristiwa yang mengirimkan konten kepada pengguna, peristiwa tersebut tidak akan dicatat dalam log aktivitas hingga pesan tersebut terkirim.
Sebagai contoh, jika pesan RCS for Business dikirim ke pengguna pada hari Rabu pukul 13:00, dan penerima sedang offline hingga hari Minggu pukul 09:00, peristiwa tersebut akan muncul dalam log aktivitas yang dihasilkan untuk hari Minggu, tetapi stempel waktunya akan menjadi Rabu, 13:00.