Bu sayfada, RCS for Business'ın operatörlere faturalama ve denetim konusunda yardımcı olmak için oluşturduğu veri dosyaları açıklanmaktadır.
| Dosya | Tanım | Kimlerin erişimi var? |
|---|---|---|
| Faturalama raporu | Başlatılan temsilciler ve kullanıcılar arasındaki ücretli olayların toplu raporu. | RCS for Business'ı aktif olarak kullanan tüm operatörler. |
| Aktivite günlüğü | RCS for Business faaliyetlerine ait ham veri kaydı, faturalandırılabilir olaylar da dahil. | RCS for Business'ı aktif olarak işleten ve Google RCS Hizmetini kendi Hizmet Şartları (ToS) çerçevesinde kullanan operatörler. |
RCS for Business, ABD dışı trafik için standart bir faturalandırma modeli kullanır. Ayrıntılar için Faturalandırma SSS bölümüne bakın.
Dosya oluşturma
Her veri dosyası, Pasifik Standart Saati (PST) cinsinden RCS for Business kullanımının bir gününü temsil eder. Dosyalar günlük olarak oluşturulur ve önceki 24 saatlik döneme (gece yarısından gece yarısına) ait etkinlikleri yansıtır. Oluşturma işlemi birkaç saat sürebilir ve tamamlanma süresi değişebilir.
- Diyalog tabanlı olmayan aracı sistemler için dosyalar, dosyanın oluşturulduğu günden hemen önceki 24 saatlik döneme ait verileri içerir. Örneğin, 5 Mayıs'ta oluşturulan bir rapor, 4 Mayıs saat 00:00'dan 5 Mayıs saat 00:00'a kadar olan verileri kapsar. Belirtilen saat PST saat dilimindedir.
Konuşma tabanlı yapay zeka sistemleri için dosyalar, dosya oluşturulma zamanından 1-2 gün öncesine ait 24 saatlik döneme ait verileri içerir. Örneğin, 5 Mayıs'ta oluşturulan bir rapor, 2 veya 3 Mayıs'ın 24 saatlik dönemine ait verileri kapsar. Belirtilen zaman dilimi PST'dir.
Gecikmenin nedeni, RCS for Business'ın konuşma tabanlı aracıları için yaptığı işlemlerin oturumlarla bağlantılı olması ve bu oturumların tamamlanmasının 24 saate kadar sürebilmesidir. Bu gecikme, RCS for Business'ın faturalandırılabilir olayı hesaplamadan önce bir konuşma içindeki tüm mesajları yakalamasına olanak tanır. Konuşma tabanlı aracılar hakkında daha fazla bilgi için, Aracı faturalandırma kategorilerine bakın.
Önemli noktalar:
- Etkinlik yok : Varsayılan olarak, belirli bir günde platformda herhangi bir etkinlik yoksa dosya oluşturulmaz. Ancak, gerekirse boş dosyalar almak için bu seçeneği etkinleştirebilirsiniz. Etkinleştirmek için rbm-support@google.com adresine başvurun.
- Adlandırma : Dosya adındaki tarih, dosyanın oluşturulma tarihidir, içindeki verilerin tarihi değildir.
- Saklama Süresi : Dosyalar silinmeden önce en fazla 63 gün süreyle saklanır.
Bu dosyaları kullanarak veri ambarınızı en güncel platform kullanım metrikleriyle güncelleyebilirsiniz.
Dosya depolama ve erişim
Veri dosyaları hem depolama sırasında hem de aktarım esnasında şifrelenir.
Güvenli Dosya Aktarım Protokolü (SFTP) ile veri dosyalarını almak için SFTP genel anahtarınızı sağlayın. Anahtarlar oluşturmak için bkz. SFTP dropbox için Güvenli Kabuk (SSH) anahtar çifti oluşturma .
SFTP sunucusu partnerupload.google.com ve ek güvenlik için bağlantı yüksek bir port numarası (19321) üzerinden sağlanmaktadır.
Veri dosyalarınıza erişmek için aşağıdaki komutu kullanabilirsiniz:
sftp -i <path_to_private_key> -P 19321 <username>@partnerupload.google.com
Google, hesap kullanıcı adlarını aşağıdaki formatlarda sağlar:
-
rbmreports-billableevents-<carrier name> -
rbmreports-activity-<carrier name>
Google, <carrier name> belirtir ve her rapor türü için ayrı bir hesap sağlar.
Farklı rapor türlerine erişim için ayrı hesaplar sağlanmıştır.
Dosya kullanılabilirliği
Henüz veri dosyaları oluşturulmadıysa, beklenen şekilde remote readdir("/"): No such file or directory benzeri bir SFTP hatası göreceksiniz.
RCS for Business trafiği raporlanmazsa dosya oluşturulmaz. Bu, bazı günlerde hiç dosya oluşturulmayabileceği anlamına gelir. Sürecinizi kolaylaştırmak için boş dosyalara ihtiyacınız varsa, RCS for Business destek ekibiyle iletişime geçin .
Faturalama raporları
Faturalama raporları, acentenin faturalama kategorisine ve gönderdiği mesaj türüne göre hesaplanan, faturalandırılabilir olayların kayıtlarıdır. Faturalama raporları, RCS for Business'ı aktif olarak kullanan tüm operatörler için mevcuttur.
Faturalama raporları gizli bilgiler içerir, ancak MSISDN, karma MSISDN veya herhangi bir kullanıcıya özgü tanımlayıcı gibi kişisel olarak tanımlanabilir bilgiler (PII) içermez.
Acente faturalama kategorileri
Bir temsilci oluşturulurken, sahibi temsilcinin kullanıcılarla nasıl etkileşim kuracağına bağlı olarak faturalama kategorisini belirler. Faturalama kategorisi, bir temsilcinin gönderebileceği mesaj sayısını veya türünü kısıtlamaz. Ancak, temsilcinin mesajlar için nasıl faturalandırılacağını belirler. İki ana faturalama kategorisi aşağıdaki tabloda açıklanmıştır.
| Faturalama kategorisi | Temsilci türü | Örnek kullanım senaryoları | Faturalama yöntemi |
|---|---|---|---|
| Konuşma dışı | primarily tek yönlü mesaj gönderen aracılar. |
| Kullanıcıya iletilen her mesaj için ücret alınır. |
| Konuşma tarzında | Kullanıcılarla karşılıklı iletişim için tasarlanmış aracı yazılımlar. |
| Konuşma başına ücretlendirme : Taraflardan biri (temsilci veya kullanıcı) diğer tarafın mesajına 24 saat içinde yanıt verirse, bir konuşma başlar. Konuşma penceresi boyunca (ilk yanıttan sonraki 24 saat), temsilci ve kullanıcı diledikleri sayıda mesaj alışverişinde bulunabilir ve temsilciye konuşma için sabit bir ücret fatura edilir. Mesaj başına ücretlendirme : Eğer temsilci, kullanıcının 24 saat içinde yanıt vermediği bir mesaj iletirse, tıpkı diyalog kurmayan bir temsilci gibi, temsilciye her mesaj için ayrı ayrı ücretlendirme yapılır. |
Aşağıdaki diyagram, konuşma tabanlı temsilciler için bir A2P faturalama oturumunun örneğini göstermektedir:
Diyalogsal ve diyalogsuz aracıların karşılaştırılması
İki ana faturalandırma kategorisi vardır: konuşmaya dayalı ve konuşmaya dayalı olmayan.
Faturalandırma kategorilerindeki temel fark, diyalogsal ve diyalogsal olmayan temsilciler arasındadır:
Konuşma özelliği olmayan aracılar, kullanıcıya ilettikleri her mesaj için ücretlendirilir.
- Bu kategori, sık sık yanıt beklemeyen emlakçılar için en uygundur.
Konuşma asistanlarından, 24 saatlik süre içinde yapılan tüm mesaj alışverişlerini kapsayan sabit bir ücret alınır.
- Bu kategori, kullanıcılarla çok turlu konuşmalar gerçekleştiren temsilciler için en uygundur.
Ücretlendirilebilir etkinlikler
Faturalama raporlarında beş tür faturalandırılabilir olay kaydedilir. Bu olaylar arasında A2P ve P2A olayları olarak adlandırılan MT ve MO olayları yer alır.
- A2P (Uygulamadan Kişiye) MT (Mobil Sonlandırılmış) ise işletme tarafından gönderilen bir mesajdır.
- P2A (Kişiden Uygulamaya) MO (Mobil Kaynaklı) anlamına gelir : Kullanıcı tarafından başlatılan bir mesaj veya eylem.
Aşağıdaki tabloda, konuşma tabanlı ve konuşma tabanlı olmayan aracılar için geçerli olan her bir ücretli olay açıklanmaktadır.
| Etkinlik | Tanım | Konuşma yeteneği olmayan aracılar | Konuşma aracıları |
|---|---|---|---|
basic_message | Yalnızca 160 karakter veya daha az metin içeren A2P mesajı. Metin, OpenGraph etiketleri içeren bir web sitesinin URL'sini içeriyorsa, mesajda iş ortağına ek bir ücret ödemeden bir resim önizlemesi gösterilebilir. | Kullanıcının yanıt verip vermemesine bakılmaksızın, her zaman ayrı bir ücretli etkinlik olarak değerlendirilir. | Kullanıcı 24 saat içinde yanıt vermediği takdirde, mesaj ayrı bir ücretli etkinlik olarak değerlendirilir. Yanıt vermesi durumunda ise mesaj bir a2p_conversation parçası haline gelir. |
single_message | A2P mesajı, ya zengin içeriğe sahip olan ya da 160 karakterden uzun, yalnızca metin içeren bir mesajdır. | Kullanıcının yanıt verip vermemesine bakılmaksızın, her zaman ayrı bir ücretli etkinlik olarak değerlendirilir. | Kullanıcı 24 saat içinde yanıt vermediği takdirde, mesaj ayrı bir ücretli etkinlik olarak değerlendirilir. Yanıt vermesi durumunda ise mesaj bir a2p_conversation parçası haline gelir. |
a2p_conversation (işletme tarafından başlatılan) | Kullanıcı, mevcut bir görüşmenin dışında, A2P mesajına mesajı aldıktan sonraki 24 saat içinde yanıt verdiğinde başlatılır. | Uygulanamaz. Diyalog kurmayan aracılar asla bu tür bir olay oluşturmaz. | Birden fazla A2P mesajının gönderilmesinden sonraki 24 saat içinde bir P2A mesajı gönderilirse, görüşmeyi başlatmak için yalnızca P2A mesajından hemen önce gönderilen A2P mesajı kullanılır. Bu A2P mesajı ve sonraki 24 saat içinde gönderilen tüm mesajlar a2p_conversation bir parçasıdır. |
p2a_conversation (kullanıcı tarafından başlatıldı) | Bir temsilcinin, mevcut bir görüşmenin dışında, P2A mesajını aldıktan sonraki 24 saat içinde yanıt vermesiyle başlatılır. | Uygulanamaz. Diyalog kurmayan aracılar asla bu tür bir olay oluşturmaz. | Birden fazla P2A mesajının gönderilmesinden sonraki 24 saat içinde bir A2P mesajı gönderilirse, görüşmeyi başlatmak için yalnızca A2P mesajından hemen önce gönderilen P2A mesajı kullanılır. Bu P2A mesajı ve sonraki 24 saat içinde gönderilen tüm mesajlar, p2a_conversation bir parçasıdır. |
p2a_message | Herhangi bir türdeki P2A mesajı. | Temsilcinin yanıt verip vermemesine bakılmaksızın, her zaman ayrı bir faturalandırılabilir olay olarak değerlendirilir. | Müşteri temsilcisi 24 saat içinde yanıt vermediği takdirde, ayrı bir faturalandırılabilir olay olarak değerlendirilecektir. |
Faturalama kategorileri ve faturalandırılabilir etkinlikler
Temsilci faturalama kategorileri ve faturalandırılabilir olaylar arasındaki ayrım, temsilcinizin nasıl faturalandırıldığını anlamanın anahtarıdır.
- Fatura kategorisi, temsilcinizi oluştururken seçtiğiniz sabit bir sınıflandırmadır. Temsilcinizin nasıl faturalandırılacağını belirler: mesaj başına (konuşma gerektirmeyen temsilciler) veya konuşma başına (konuşma tabanlı temsilciler).
- Faturalandırılabilir olaylar, faturalandırma amacıyla izlenen bir RCS for Business aracısı ile kullanıcı arasındaki etkileşimlerdir (örneğin,
basic_message,single_message,a2p_conversation).
Faturalama raporu oluşturma
Yalnızca test dışı trafiğe sahip temsilciler faturalandırılabilir etkinlikler oluşturur. Test telefon numaralarından gelen etkinlikler faturalandırma raporlarında görünmez.
Bu raporlar, olayların mesajlar gönderildiğinde değil, teslim edildiğinde faturalandırıldığını varsaymaktadır. Teslim edilmemiş bir mesaj veya teslim edilmeden önce iptal edilen bir mesaj, faturalandırılabilir bir olayı tetiklemez.
Faturalama raporu formatı
Faturalama raporları rbm_billable_events_YYYY-MM-DD.csv dosya adı formatını kullanır. Dosya adındaki tarih, dosyanın oluşturulma tarihidir.
Rapordaki her satır, tek bir faturalandırılabilir olayı temsil eden bir kayıttır. Bir kayıt içindeki alanlar sekme karakteriyle ayrılmıştır. Örneğin, aynı temsilciyle yapılan iki A2P görüşmesi, iki ayrı faturalandırılabilir olay ve faturalama raporunda iki kayıt oluşturacaktır.
Rapordaki her kayıt, faturalandırılabilir her olay için aşağıdaki bilgileri içerir.
| Alan | Biçim | Tanım | Örnek |
|---|---|---|---|
billing_event_id | sicim | Ücretlendirilebilir etkinliği ayırt eden oluşturulmuş kimlik. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff |
type | sicim | Etkinlik türü:
| single_message |
agent_id | sicim | Etkinliğe katılan temsilciye ait benzersiz tanımlayıcı. | rbm-welcome-bot@rbm.goog |
agent_owner | sicim | Temsilcinin oluşturulduğu iş ortağı hesabının mevcut sahibinin e-posta adresi. | name@aggregator.com |
billing_party | sicim | Etkinliklerin faturasını kesen taraf.
| carrier |
max_duration_single_message | sayı | Kullanıcının, görüşme başlatma penceresi kapanmadan ve mesaj single_message olayı olarak sınıflandırılmadan önce temsilci mesajına yanıt vermesi için tanınan maksimum süre (saat cinsinden). | 24 |
max_duration_a2p_conversation | sayı | A2P görüşmesinin maksimum süresi, saat cinsinden. Kullanıcının temsilcinin ilk mesajına verdiği ilk yanıttan itibaren ölçülür. | 24 |
max_duration_p2a_conversation | sayı | Kişiden kişiye (P2A) yapılan bir görüşmenin maksimum süresi, saat cinsinden. Görüşmedeki ilk kullanıcı mesajından itibaren ölçülür. | 24 |
start_time | YYYY-mm-ddTHH:00:00Z | Olayın başladığı UTC tarih/saati, ISO 8601 formatında en yakın saate yuvarlanmış olarak. A2P mesajları
P2A mesajları
| 2019-07-25T08:00:00Z |
duration | sayı | Etkinliğin süresi, en yakın dakikaya yuvarlanmıştır. Konuşma dışı tüm olaylar için değer 0'dır. | 45 |
mt_messages | sayı | Olayda mobil cihaza iletilen (A2P) mesaj sayısı. | 11 |
mo_messages | sayı | Olayda mobil kaynaklı (P2A) mesaj sayısı. | 9 |
size_kilobytes | sayı | Olayda yer alan mesajlara eklenen tüm dosyaların boyutu, en yakın kilobayta yuvarlanmış olarak (1 kB, 1024 bayta eşittir). | 912 |
agent_name | sicim | Etkinliğe katılan temsilcinin adı. | XYZ Mobile USA |
owner_name | sicim | Temsilcinin oluşturulduğu iş ortağı hesabının mevcut sahibinin adı. | XYZ Mobile |
Örnek faturalama raporu
Örnek raporlar indirilmeye hazırdır:
Tipik dosya boyutu
Aktif bir RCS for Business iş ortağından gelen günlük raporun boyutu, operatörün ağında ne kadar etkinlik oluşturduklarına bağlıdır. Örneğin, raporda 53.000 kayıt varsa, dosya yaklaşık 8 MB boyutunda olacaktır.
Aktivite kayıtları
Etkinlik kayıtları, RCS for Business platformundaki etkinlikler hakkında ham veriler sağlar. Bu kayıtları, faturalandırılabilir etkinlikleri denetlemek ve özel etkinlikler oluşturmak için kullanabilirsiniz.
Etkinlik kayıtları, ayrıntılı işlem bilgileri ve abone MSISDN'leri gibi Kişisel Tanımlanabilir Bilgiler (PII) içerdiğinden, yalnızca bir operatör kendi Hizmet Şartları kapsamında RCS çalıştırdığında kullanılabilir. Ağlarınızda RCS İşletme trafiği varsa ve Google'ın Hizmet Şartları kapsamında Google RCS ile RCS etkinliğini etkinleştirirseniz, etkinlik kayıtlarına erişemezsiniz.
Aktivite günlüğü formatı
Etkinlik kayıtları rbm_activity_YYYY-MM-DD.csv dosya adı formatını kullanır. Dosya adındaki tarih, dosyanın oluşturulma tarihidir.
Bir kayıttaki alanlar sekme karakteriyle ayrılmıştır ve her satırda bir kayıt bulunur.
Etkinlik günlüğündeki her kayıt, her etkinlik için aşağıdaki alanları içerir:
| Alan | Biçim | Tanım | Örnek |
|---|---|---|---|
activity_id | sicim | Etkinliğe özgü tanımlayıcı. | b422e1d3-ac99-442a-853d-a875d5e61762 |
billing_event_id | sicim | İlgili faturalandırılabilir etkinlik için benzersiz tanımlayıcı. Etkinlik faturalandırılabilir bir etkinlikle ilişkili değilse boş bırakılabilir; örneğin, karşılık gelen delivery_receipt_event olmayan bir text_message gibi. | 91yeb201-7c3b-412b-98d2-b0a0f7abe536 |
agent_id | sicim | Temsilciye ait benzersiz tanımlayıcı. | welcome-bot@rbm.goog |
user_id | sicim | Kullanıcının MSISDN numarası. | 918369110173 |
direction | sicim | Mesajın gönderildiği yön:
| MT |
time | YYYY-mm-ddTHH:MM:SS.SSSZ | Olayın RCS for Business platformuna gönderildiği tarih ve saat (UTC formatında). Zaman damgalarına bakın. | 2019-07-25T00:29:07.033Z |
type | sicim | Aktivite türü:
| text_message |
size_bytes | sicim | Etkinliğe eklenen dosyaların boyutu (bayt cinsinden). | 912 |
Zaman damgaları
Etkinlik kayıtlarındaki zaman damgaları, bir olayın RCS for Business platformuna ne zaman gönderildiğini kaydeder. Kullanıcıya içerik ileten olaylar için, mesaj iletilene kadar etkinlik kaydına kaydedilmez.
Örneğin, bir RCS for Business mesajı Çarşamba günü saat 13:00'te bir kullanıcıya gönderilirse ve alıcı Pazar günü saat 9:00'a kadar çevrimdışıysa, olay Pazar günü için oluşturulan etkinlik günlüğünde görünür, ancak zaman damgası Çarşamba, 13:00 olur.