RBM, özet ve işlem düzeylerinde kullanıcı ve aracı etkinliğini raporlayan veri dosyaları oluşturur. Veriler birden çok dosyaya ayrılır:
| Dosya | Açıklama | Erişimi olanlar |
|---|---|---|
| Faturalandırma etkinliği raporu | Başlatılan temsilciler ve kullanıcılar arasındaki faturalandırılabilir etkinliklerin kaydı | Ağlarında RBM trafiği olan tüm operatörler |
| Etkinlik günlüğü | Ham RBM platform etkinliği verileri | Ağlarında RBM trafiği olan ve kendi Hizmet Şartları (ToS) kapsamında Jibe Cloud ile RCS etkinliğini etkinleştiren operatörler |
Nesil
Faturalandırma etkinliği raporlarının ve Etkinlik günlüklerinin oluşturulmasında iki günlük bir gecikme yaşanmaktadır.
Google, bir etkinlik etkinliğini yalnızca ait olduğu faturalandırma oturumu tamamlandığında raporlar. Bir oturumun tamamlanması 24 saat sürebilir ve faturalandırma ardışık düzenimiz günde bir kez yürütülür ve yalnızca tamamlandığından emin olunan (en az 24 saat öncesine ait) faturalandırma oturumlarını raporlar.
Örneğin:
d. günde bir mesaj gönderilir ve faturalandırma oturumu başlatılır. Ancak mesaj, 1 saat önce ardışık düzen yürütmesini kaçırmıştır. Bu nedenle, herhangi bir etkinlik raporlanmaz.
Ardışık düzen d+1 tarihinde tekrar çalıştırıldığında mesajın başlattığı oturum yalnızca 23 saat önce gerçekleşir. Bu nedenle, d+1'de bu ileti için herhangi bir etkinlik etkinliği raporlanmaz.
Ardışık düzen d+2'de tekrar çalıştığında oturum tamamlanmıştır. Böylece etkinlik etkinliği, faturalandırma oturumuyla birlikte raporlanır.
Depolama ve erişim
Veri dosyaları aktif değilken ve aktarım sırasında şifrelenir.
Veri dosyalarını SFTP ile almak için SFTP ortak anahtarınızı sağlamanız gerekir. Anahtar oluşturmak için SFTP açılır kutusu için Secure Shell (SSH) anahtar çifti oluşturma başlıklı makaleyi inceleyin.
SFTP sunucusu partnerupload.google.com ve bağlantıda daha fazla güvenlik için yüksek bir bağlantı noktası numarası (19321) bulunur.
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 biçimlerde sağlar:
rbmreports-billableevents-<carrier name>rbmreports-activity-<carrier name>
Google, <carrier name> değerini belirtir ve her bir rapor türü için ayrı hesap sağlar.
Farklı rapor türlerine erişim için ayrı hesaplar sağlanır.
Dosya kullanılabilirliği
Henüz rapor dosyası oluşturulmadıysa remote readdir("/"): No such file or directory benzeri bir SFTP hatası görürsünüz. Bu beklenen bir durumdur.
Bildirilecek RBM trafiği yoksa dosya oluşturulmaz. Bu, dosyaların oluşturulmadığı bazı günler olabileceği anlamına gelir. İşlemenizi kolaylaştırmak için bu durumda boş dosyaların oluşturulmasını zorunlu tutuyorsanız rbm-support@google.com adresiyle iletişime geçin.
Yenileme ve saklama
Her veri dosyası, UTC saatine göre platform kullanımının bir gününü temsil eder. Belirli bir güne ait kayıtlar bir kez oluşturulur ve gün sona erdikten sonra 2 gün (48 saat) içinde kesinleştirilir. Bu dosyaları bir veri ambarına yüklerseniz geçerli ayın metriklerini güncelleyebilirsiniz.
Hesaba katılacak bir etkinlik yoksa dosya oluşturulmaz.
Her dosyanın adındaki tarih, dosyanın oluşturulduğu tarihtir. Dosyadaki kayıtlar, dosya tarihinden 2 gün önce gelen UTC gününü kapsar.
Dosyaları oluşturan dışa aktarma işlemi, 02:00-04:00 (PST) arasında yürütülür.
Veri dosyaları, silinmeden önce en fazla 30 gün boyunca saklanır.
Faturalandırma etkinliği raporları
Faturalandırma etkinliği raporları, önerilen faturalandırma birimleri kullanılarak temel mesajlardan hesaplanan faturalandırılabilir etkinliklerin kayıtlarıdır. Faturalandırılabilir etkinlikler gizli bilgiler içerir ancak kullanıcının kimliği tanımlayabilecek bilgiler içermez (ör. MSISDN, karma oluşturma işlemi uygulanmış MSISDN veya herhangi bir kullanıcı benzersiz tanımlayıcısı).
Faturalandırma etkinliklerini yalnızca başlatılan aracılar oluşturur. Henüz kullanıma sunulmamış etkinlikler veya başlatılmamış aracılar faturalandırma raporlarında görünmez.
Faturalandırma raporları, etkinliklerin mesaj gönderildiğinde değil, teslim edildiğinde faturalandırıldığını varsayar. Teslimattan önce teslim edilmemiş veya iptal edilmiş mesajlar faturalandırma etkinliğini tetiklemez.
Her RBM temsilcisinin, lansman için göndermeden önce temsilci geliştiricisi tarafından belirlenen bir Faturalandırma Kategorisi vardır. Faturalandırma Kategorisi, temsilcinin gönderdiği mesajların ayrı olup olmadığını veya bunların görüşme faturalandırma etkinliklerinde birleştirilip birleştirilmeyeceğini belirler.
Beş tür faturalandırılabilir etkinlik vardır:
| Etkinlik | Tanım |
|---|---|
| Temel Mesaj | Başvurudan kişiye (A2P) mesaj:
Yalnızca görüşme aracıları: Sonraki 24 saat içinde A2P mesajına yanıt olarak bir P2A mesajı teslim edilirse Temel Mesaj, A2P görüşmesinin bir parçası haline gelir. Aksi takdirde oturum sonlandırılır. Temel Mesaj her zaman bir temsilciden kullanıcıya iletilir. |
| Tek Mesaj | Başvurudan kişiye (A2P) mesaj:
Yalnızca görüşme aracıları: Sonraki 24 saat içinde bir P2A mesajı gönderilirse Tek Mesaj, A2P görüşmesinin bir parçası haline gelir. Aksi takdirde oturum sonlandırılır. Tek Bir Mesaj her zaman bir temsilciden kullanıcıya teslim edilir. |
| A2P İletişim | Yalnızca sohbet aracıları için geçerlidir: Bir A2P tek mesajı veya A2P temel mesajından sonraki 24 saat içinde P2A mesajı teslim edildiğinde A2P iletişimi başlatılır. Bir P2A mesajı, birden fazla A2P mesajından sonraki 24 saat içinde teslim edilirse sohbet oturumunu oluşturmak için yalnızca P2A mesajından hemen önce gelen A2P mesajı kullanılır. Bu A2P mesajı ve sonraki 24 saat içinde teslim edilen mesajlar, yeni A2P görüşmesinin bir parçasıdır. |
| P2A Sohbeti | Yalnızca görüşme temsilcileri için geçerlidir: Etkin bir oturum olmadığında (A2P Tek Mesajı, A2P Görüşmesi veya P2A Görüşmesi) ve P2A mesajı teslim edildiğinde ve işletme 24 saat içinde yanıt verdiğinde P2A Görüşmesi başlatılır. |
| P2A Mesajı | Konuşma dışı aracılar: Bir kullanıcıdan, Tek Mesaj veya Temel Mesaj Faturalandırma Kategorisi'ne sahip bir temsilciye gönderilen P2A mesajı.
Sohbet aracıları: Mevcut bir görüşmenin olmadığı ve temsilcinin yanıt döndürmediği, bir kullanıcıdan temsilciye gönderilen P2A mesajı. |
Kullanılabilirlik
Faturalandırma etkinliği raporları, ağlarında RBM trafiğine sahip olan tüm operatörler tarafından kullanılabilir.
Biçim
Faturalandırma etkinliği raporları şu dosya adı biçimini kullanır: YYYY/MM/DD/rbm_billable_events_YYYY-MM-DD.csv.
Dosya adındaki tarih, dosyanın oluşturulduğu tarihtir. Dosyadaki kayıtlar genellikle bu tarihten 2 gün önce gerçekleşen etkinliği kapsar.
Kayıttaki alanlar sekmeyle ayrılır ve her satıra bir kayıt vardır.
Her faturalandırma etkinliği için bir kayıt olur. Yani aynı temsilciyle yapılan iki A2P görüşmesi, faturalandırma raporunda iki faturalandırma etkinliği ve iki kayıt oluşturur.
Faturalandırılabilir etkinlik raporundaki her kayıt, her etkinlik için aşağıdaki bilgileri içerir:
| Alan | Biçim | Açıklama | Örnek |
|---|---|---|---|
billing_event_id
|
dize | Oluşturulduğunda her yeni etkinlik için oluşturulan rastgele bir sayı olan UUID tanımlayıcısı. | |
type
|
dize | Etkinliğin türü:
|
single_message
|
agent_id
|
dize | Etkinliğe katılan temsilcinin tanımlayıcısı. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
dize | Etkinliğe katılan temsilcinin sahibinin e-posta adresi. Bu, RBM temsilcisini kaydeden taraftır (çoğu durumda toplayıcı; ancak nadiren de olsa marka olabilir). Bu değer, geliştirici RBM'yi kullanmak için kaydolduğunda sağlanan "RBM Google hesabı" alanından alınır. | name@aggregator.com
|
billing_party
|
dize | Etkinliklerin faturasını yapan taraf.
|
carrier
|
max_duration_single_message
|
sayı | Temsilcinin mesajının, tek bir mesaj oturumunu tanımlamak için herhangi bir yanıt almadan gideceği (saat cinsinden) süre. | 24
|
max_duration_a2p_conversation
|
sayı | A2P oturumunun saat cinsinden maksimum süresi. İlk kullanıcı yanıtından temsilcinin ilk mesajına kadar ölçülür. | 24
|
max_duration_p2a_conversation
|
sayı | P2A oturumunun saat cinsinden maksimum süresi. Görüşmedeki ilk kullanıcı mesajından itibaren ölçülür. | 24
|
start_time
|
YYYY-mm-ddTHH:00:00Z | Etkinliğin ISO 8601 biçiminde başladığı, en yakın saate yuvarlanmış UTC tarih/saat değeri.
|
2019-07-25T08:00:00Z
|
duration
|
sayı | En yakın dakikaya yuvarlanmış şekilde etkinliğin süresi.
Etkinlik türü |
45
|
mt_messages
|
sayı | Etkinlikteki mobil tarafından sonlandırılan iletilerin sayısı. | 11
|
mo_messages
|
sayı | Etkinlikteki mobil kaynaklı iletilerin sayısı. | 9
|
size_kilobytes
|
sayı | Etkinlikteki mesajlara eklenen tüm dosyaların en yakın kilobayt değerine (1 kB = 1.024 bayt) yuvarlanmış boyutu. | 912
|
agent_name
|
dize |
Etkinliğe katılan temsilci. |
XYZ Mobile USA
|
owner_name
|
dize | Etkinliğe katılan temsilcinin sahibi. Bu, RBM temsilcisini kaydeden taraftır. Bu taraf çoğu durumda toplayıcıdır ancak bazı durumlarda marka olabilir. Bu değer, geliştirici RBM'yi kullanmak için kaydolduğunda sağlanan "İş ortağı hesabınız için tercih edilen görünen ad"dan alınır. | XYZ Mobile
|
Örnek dosya
Örnek bir faturalandırma raporu dosyası indirilebilir.
Normal dosya boyutu
Etkin bir iş ortağından gelen günlük rapor dosyası yaklaşık 53.000 kayıt ve yaklaşık 8 MB boyutunda olabilir.
Etkinlik günlükleri
Etkinlik günlükleri, faturalandırılabilir etkinlikleri denetlemek ve özel etkinlikler oluşturmak amacıyla RBM platformundaki etkinliklerin ham veri günlüğüdür.
Kullanılabilirlik
Etkinlik günlükleri, yalnızca ağlarında RBM trafiği olan ve Jibe Cloud ile RCS etkinliğini kendi Hizmet Şartları (ToS) kapsamında etkinleştiren operatörler tarafından kullanılabilir. Jibe'ın Hizmet Şartları kapsamında Jibe Cloud kullanıyorsanız etkinlik günlüklerine erişemezsiniz.
Biçim
Etkinlik günlükleri, YYYY/MM/DD/rbm_activity_YYYY-MM-DD.csv dosya adı biçimini kullanır.
Dosya adındaki tarih, dosyanın oluşturulduğu tarihtir. Dosyadaki kayıtlar genellikle bu tarihten 2 gün önce gerçekleşen etkinliği kapsar.
Kayıttaki alanlar sekmeyle ayrılır ve her satıra bir kayıt vardır.
Etkinlik günlüğündeki her kayıt, her etkinlik etkinliği için aşağıdaki alanları içerir.
| Alan | Biçim | Açıklama | Örnek |
|---|---|---|---|
activity_id
|
dize | Etkinliğin tanımlayıcısı. | |
billing_event_id
|
dize | Etkinliğin gerçekleştiği faturalandırma etkinliğinin tanımlayıcısı. Aktivite, herhangi bir oturumla ilişkilendirilmemişse (örneğin, karşılık gelen delivery_receipt_event değeri olmayan bir text_message) boş olabilir.
| |
agent_id
|
dize | Temsilcinin tanımlayıcısı. | welcome-bot@rbm.goog
|
user_id
|
dize | Kullanıcının MSISDN'si. | 918369110173
|
direction
|
dize | İletinin gönderildiği yol:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | Etkinliğin RBM platformuna gönderildiği UTC tarihi/saati. Aşağıdaki notu inceleyin. | 2019-07-25T00:29:07.033Z
|
type
|
dize | Etkinliğin türü:
|
text_message
|
size_bytes
|
dize | Etkinliğe eklenen dosyaların bayt cinsinden boyutu. | 912
|
Zaman damgalarıyla ilgili not
Etkinlik günlüklerindeki zaman damgaları, bir etkinliğin RBM platformuna gönderildiği zamanı kaydeder. Bir kullanıcıya içerik gönderen etkinlikler söz konusu olduğunda, mesaj teslim edilene kadar etkinlik Etkinlik günlüğüne yazılmaz.
Örneğin, bir kullanıcıya Çarşamba günü saat 13:00'te bir RBM mesajı gönderilirse ve alıcı Pazar günü saat 09:00'a kadar çevrimdışı olursa etkinlik, Pazar günü için oluşturulan etkinlik günlüğünde görünür. Etkinlik günlüğündeki etkinliğin zaman damgası Çarşamba günü 13:00'da olacaktır.