Bu sayfada, operatörlerin faturalandırma ve denetim işlemlerine yardımcı olmak için İşletmeler için RCS'nin oluşturduğu veri dosyaları açıklanmaktadır. İşletmeler için RCS faturalandırma modeliyle ilgili sık sorulan soruların yanıtları için Faturalandırmayla ilgili SSS bölümüne bakın.
| Dosya | Açıklama | Erişimi olanlar |
|---|---|---|
| Faturalandırma etkinliği raporu | Başlatılan aracıların ve kullanıcıların arasındaki faturalandırılabilir etkinliklerin birleştirilmiş raporu. | İşletmeler için RCS'yi etkin olarak kullanan tüm operatörler. |
| Etkinlik günlüğü | Faturalandırılabilir etkinlikler de dahil olmak üzere RCS for Business etkinliğinin ham veri günlüğü. | Google RCS Hizmeti'ni kendi Hizmet Şartları (ToS) kapsamında işleten ve İşletmeler için RCS'yi aktif olarak kullanan operatörler. |
Dosya oluşturma
Her veri dosyası, Eşgüdümlü Evrensel Saat (UTC) cinsinden bir günlük İş için RCS kullanımını gösterir. Dosyalar günlük olarak oluşturulur. Üretim süreci birkaç saat sürebilir ve tamamlanma süresi değişiklik gösterebilir.
Sohbet dışı aracılar için dosyalar, dosya oluşturma zamanından hemen önceki 24 saatlik döneme ait verileri içerir. Örneğin, 5 Mayıs'ta saat 11:00'de (UTC) bir faturalandırma etkinliği raporu oluşturulursa bu raporda 4 Mayıs'ta saat 11:00'den (UTC) 5 Mayıs'ta saat 11:00'e (UTC) kadar olan veriler yer alır.
Sohbet aracılarında dosyalar, dosya oluşturma zamanından 1-2 gün önceki 24 saatlik döneme ait verileri içerir. Örneğin, 5 Mayıs'ta saat 11:00 (UTC) itibarıyla oluşturulan bir faturalandırma etkinliği raporu, 3 Mayıs'ta saat 11:00 (UTC) ile 4 Mayıs'ta saat 11:00 (UTC) arasındaki verileri içerebilir.
Gecikmenin nedeni, görüşme temsilcileri için RCS Business Messaging etkinliğinin görüşmelere bağlanmasıdır. Bu işlem 48 saate kadar sürebilir. Bu gecikme, faturalandırma etkinliği hesaplanmadan önce bir görüşmedeki tüm mesajların RCS Business tarafından yakalanmasına olanak tanır. Görüşme temsilcileri hakkında daha fazla bilgi için Temsilci faturalandırma kategorileri başlıklı makaleyi inceleyin.
Önemli noktalar:
Etkinlik yok: Belirli bir günde platform etkinliği yoksa dosya oluşturulmaz.
Adlandırma: Dosya adındaki tarih, dosyanın oluşturulma tarihidir. Dosyadaki verilerin tarihi değildir.
Saklama: Dosyalar silinmeden önce en fazla 63 gün saklanır.
Bu dosyaları, veri ambarınızı en son platform kullanım metrikleriyle güncellemek için kullanabilirsiniz.
Dosya depolama ve erişim
Veri dosyaları, depolama ve aktarım sırasında şifrelenir.
Veri dosyalarını Güvenli Dosya Aktarım Protokolü (SFTP) ile almak için SFTP ortak anahtarınızı girin. Anahtar oluşturmak için SFTP dropbox için Secure Shell (SSH) anahtar çifti oluşturma başlıklı makaleyi inceleyin.
SFTP sunucusu partnerupload.google.com ve bağlantı, ek güvenlik için yüksek bir bağlantı noktası numarası (19321) üzerinden yapılı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 biçimlerde 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şmek için ayrı hesaplar sağlanır.
Dosya kullanılabilirliği
Henüz veri dosyası oluşturulmadıysa remote readdir("/"): No such file or directory benzeri bir SFTP hatası görürsünüz. Bu durum normaldir.
Raporlanacak RCS Business trafiği yoksa dosya oluşturulmaz. Bu nedenle, dosya oluşturulmayan günler olabilir. Sürecinizi kolaylaştırmak için boş dosyalara ihtiyacınız varsa rbm-support@google.com ile iletişime geçin.
Faturalandırma etkinliği raporları
Faturalandırma etkinliği raporları, temsilcinin faturalandırma kategorisine ve gönderdiği mesaj türüne göre hesaplanan faturalandırma etkinliklerinin kayıtlarıdır. Faturalandırma etkinliği raporları, İş için RCS'yi etkin olarak kullanan tüm operatörler tarafından kullanılabilir.
Faturalandırma etkinliği raporları gizli bilgiler içerir ancak MSISDN, karma oluşturma işlemi uygulanmış MSISDN veya kullanıcıya özgü tanımlayıcı gibi kullanıcı kimlik bilgileri (PII) içermez.
Temsilci faturalandırma kategorileri
Sahip, temsilci oluştururken temsilcinin kullanıcılarla nasıl etkileşimde bulunacağına bağlı olarak faturalandırma kategorisini belirler. Fatura kategorisi, bir temsilcinin gönderebileceği mesajların sayısını veya türünü kısıtlamaz. Ancak temsilcinin mesajlar için nasıl faturalandırılacağını belirler. İki ana faturalandırma kategorisi aşağıdaki tabloda açıklanmıştır.
| Faturalandırma kategorisi | Temsilci türü | Örnek kullanım alanları | Faturalandırma yöntemi |
|---|---|---|---|
Görüşmeyle ilgili değil (Temel Mesaj ve Tek Mesaj kategorilerini içerir.) Not: Bu iki kategori arasında artık fark yoktur. Her iki kategorideki temsilciler de etkileşim içermeyen temsilci olarak faturalandırılır. |
Öncelikle tek yönlü mesajlar gönderen temsilciler. |
|
Kullanıcıya teslim edilen her ileti için faturalandırılırsınız. |
| Görüşmeler | Kullanıcılarla karşılıklı etkileşim için tasarlanmış temsilciler. |
|
Görüşme başına faturalandırma: Taraflardan biri (temsilci veya kullanıcı) diğer tarafın mesajını 24 saat içinde yanıtlarsa görüşme başlatılır. Görüşme penceresi (ilk yanıttan sonraki 24 saat) boyunca temsilci ve kullanıcı herhangi bir sayıda mesaj alışverişinde bulunabilir. Temsilci, görüşme için sabit bir ücretle faturalandırılır. Mesaj başına faturalandırma: Temsilci, kullanıcının 24 saat içinde yanıt vermediği bir mesaj gönderirse temsilci, etkileşimli olmayan bir temsilciye benzer şekilde tek mesaj için faturalandırılır. |
Aşağıdaki şemada, sohbet aracılarının A2P faturalandırma oturumu örneği gösterilmektedir:
Sohbet aracısı ve sohbet aracısı olmayan karşılaştırması
İki ana faturalandırma kategorisi vardır: etkileşimli ve etkileşimli olmayan. Sohbet dışı kategori, işlevsel olarak aynı olan Temel Mesaj ve Tek Mesaj kategorilerini içerir. Bu kategorilerden birindeki temsilci, sohbet dışı temsilci olarak faturalandırılır.
Faturalandırma kategorilerindeki temel fark, etkileşimli ve etkileşimli olmayan temsilciler arasındadır:
Sohbet dışı olan temsilciler, kullanıcıya ilettikleri her mesaj için faturalandırılır.
- Bu kategori, sık yanıt beklemeyen temsilciler için en uygun seçenektir.
Sohbet aracılarından, 24 saatlik süre içinde gönderilen tüm mesajları içeren sohbetler için sabit bir ücret alınır.
- Bu kategori, kullanıcılarla çok turlu sohbetler yapan temsilciler için en uygundur.
Faturalandırma etkinlikleri
Faturalandırma etkinlik raporlarına beş farklı faturalandırma etkinliği türü kaydedilir. Bu etkinlikler arasında A2P ve P2A mesajları bulunur.
- A2P (Uygulamadan Kişiye): İşletme tarafından gönderilir.
- P2A (Kişiden Uygulamaya): Kullanıcı tarafından gönderilir.
Aşağıdaki tabloda, her bir faturalandırma etkinliği, etkileşimli olmayan ve etkileşimli aracılar için geçerli olduğu şekilde açıklanmaktadır.
| Etkinlik | Açıklama | Görüşme dışı aracılar | Konuşma aracıları |
|---|---|---|---|
basic_message
|
Yalnızca 160 karakter veya daha kısa metin içeren A2P mesajı. Metinde OpenGraph etiketleri olan bir web sitesinin URL'si varsa mesajda, iş ortağından ek ücret alınmadan bir resim önizlemesi gösterilebilir. | Kullanıcı yanıt verip vermemesine bakılmaksızın her zaman ayrı bir faturalandırma etkinliği olarak değerlendirilir. | Kullanıcı 24 saat içinde yanıt vermediği sürece ayrı bir faturalandırma etkinliği olarak değerlendirilir. Bu durumda, mesaj a2p_conversation parçası olur.
|
single_message
|
Zengin içerik barındıran veya 160 karakterden uzun olan yalnızca metin içeren A2P mesajları. | Kullanıcı yanıt verip vermemesine bakılmaksızın her zaman ayrı bir faturalandırma etkinliği olarak değerlendirilir. | Kullanıcı 24 saat içinde yanıt vermediği sürece ayrı bir faturalandırma etkinliği olarak değerlendirilir. Bu durumda, mesaj a2p_conversation parçası olur.
|
a2p_conversation (işletme tarafından başlatılan)
|
Bir kullanıcının, mevcut bir görüşme dışında, aldığı A2P mesajını 24 saat içinde yanıtlamasıyla başlatılır. | Hiçbiri. Sohbet dışı aracılar bu tür etkinlikleri hiçbir zaman oluşturmaz. | Bir P2A mesajı, birden fazla A2P mesajından sonraki 24 saat içinde teslim edilirse görüşmeyi başlatmak 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 tüm mesajlar a2p_conversation kapsamındadır.
|
p2a_conversation (kullanıcı tarafından başlatılır)
|
Bir temsilci, mevcut bir görüşmenin dışında, aldığı P2A mesajını 24 saat içinde yanıtladığında başlatılır. | Hiçbiri. Sohbet dışı aracılar bu tür etkinlikleri hiçbir zaman oluşturmaz. | Bir A2P mesajı, birden fazla P2A mesajından sonraki 24 saat içinde teslim edilirse görüşmeyi başlatmak için yalnızca A2P mesajından hemen önce gelen P2A mesajı kullanılır. Bu P2A mesajı ve sonraki 24 saat içinde teslim edilen tüm mesajlar p2a_conversation kapsamındadır.
|
p2a_message
|
Herhangi bir türde P2A mesajı. | Aracı yanıt verip vermemesine bakılmaksızın her zaman ayrı bir faturalandırma etkinliği olarak değerlendirilir. | Müşteri temsilcisi 24 saat içinde yanıt vermediği sürece ayrı bir faturalandırma etkinliği olarak değerlendirilir. |
Faturalandırma etkinlikleri ve faturalandırma kategorileri
basic_message ve single_message faturalandırma etkinlikleri, Temel Mesaj ve Tek Mesaj faturalandırma kategorileriyle karıştırılmamalıdır.
Her aracı (fatura kategorisi ne olursa olsun)
basic_messagevesingle_messagefaturalandırma etkinlikleri oluşturabilir.Temel Mesaj ve Tek Mesaj faturalandırma kategorileri, sohbet dışı aracıları sınıflandırmak için kullanılır. Bu faturalandırma kategorilerindeki temsilciler, sohbet faturalandırma etkinlikleri (
a2p_conversationsveyap2a_conversations) oluşturmaz. Bunun yerine, ayrı ayrıbasic_message,single_messagevep2a_messagefaturalandırma etkinlikleri oluştururlar.
Faturalandırma raporu oluşturma
Yalnızca test trafiği olmayan aracıların oluşturduğu trafik, faturalandırma etkinlikleri oluşturur. Test telefon numaralarından gelen etkinlikler, faturalandırma etkinliği raporlarında görünmez.
Bu raporlarda, etkinliklerin iletiler gönderildiğinde değil, teslim edildiğinde faturalandırıldığı varsayılır. Teslim edilmeyen veya teslim edilmeden önce iptal edilen iletiler, faturalandırma etkinliğini tetiklemez.
Faturalandırma raporu biçimi
Faturalandırma etkinliği raporları, dosya adı biçimini kullanır.
rbm_billable_events_YYYY-MM-DD.csv. Dosya adındaki tarih, dosyanın oluşturulma tarihidir.
Raporun her satırı, tek bir faturalandırma etkinliğini temsil eden bir kayıttır. Bir kayıttaki alanlar sekme ile ayrılır. Örneğin, aynı temsilciyle yapılan iki A2P görüşmesi, iki faturalandırma etkinliği ve faturalandırma etkinliği raporunda iki kayıt oluşturur.
Raporun her kaydında, her faturalandırma etkinliği için aşağıdaki bilgiler yer alır:
| Alan | Biçim | Açıklama | Örnek |
|---|---|---|---|
billing_event_id
|
dize | UUID tanımlayıcısı. Oluşturuldukları sırada her yeni etkinlik için rastgele bir sayı oluşturulur. | 242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
|
type
|
dize | Etkinlik türü:
|
single_message
|
agent_id
|
dize | Etkinliğe katılan temsilcinin benzersiz tanımlayıcısı. | rbm-welcome-bot@rbm.goog
|
agent_owner
|
dize | Aracının oluşturulduğu iş ortağı hesabının mevcut sahibinin e-posta adresi. | name@aggregator.com
|
billing_party
|
dize | Etkinlikler için faturalandırma yapan taraf.
|
carrier
|
max_duration_single_message
|
sayı | Kullanıcının, görüşme başlatma penceresi kapanmadan ve mesaj single_message etkinliği olarak sınıflandırılmadan önce bir temsilci mesajına yanıt vermesine izin verilen maksimum süre (saat cinsinden).
|
24
|
max_duration_a2p_conversation
|
sayı | A2P görüşmesinin maksimum süresi (saat cinsinden). Temsilcinin ilk mesajına kullanıcının verdiği ilk yanıttan itibaren ölçülür. | 24
|
max_duration_p2a_conversation
|
sayı | P2A görüşmesinin 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 | Etkinliğin başladığı UTC tarihi/saati (ISO 8601 biçiminde ve en yakın saate yuvarlanmış).
A2P mesajları
P2A mesajları
|
2019-07-25T08:00:00Z
|
duration
|
sayı | Etkinlik süresi, en yakın dakikaya yuvarlanmış şekilde.
Etkinlik türü |
45
|
mt_messages
|
sayı | Etkinlikteki mobil sonlandırmalı (A2P) mesaj sayısı. | 11
|
mo_messages
|
sayı | Etkinlikteki cep telefonundan gönderilen (P2A) mesajların sayısı. | 9
|
size_kilobytes
|
sayı | Etkinlikteki iletilere eklenen tüm dosyaların boyutu (en yakın kilobayta yuvarlanmış) (1 kB = 1024 bayt). | 912
|
agent_name
|
dize |
Etkinliğe katılan temsilcinin adı. |
XYZ Mobile USA
|
owner_name
|
dize | Aracının oluşturulduğu iş ortağı hesabının mevcut sahibinin adı. | XYZ Mobile
|
Örnek faturalandırma etkinliği raporu
Örnek fatura raporu dosyası indirilebilir.
Tipik dosya boyutu
Etkin bir RCS Business iş ortağının günlük raporunun boyutu, operatörün ağında ne kadar etkinlik oluşturduğuna bağlıdır. Örneğin, raporda 53.000 kayıt varsa dosya yaklaşık 8 MB boyutunda olur.
Etkinlik günlükleri
Etkinlik günlükleri, RCS Business Messaging platformundaki etkinliklerle ilgili ham veriler sağlar. Bu günlükleri, faturalandırma etkinliklerini denetlemek ve özel etkinlikler oluşturmak için kullanabilirsiniz.
Not: Etkinlik günlüklerine yalnızca test kullanıcısı olmayan telefon numaralarından gelen trafik dahil edilir.
Etkinlik günlükleri, ayrıntılı işlem bilgileri ve abone MSISDN'leri gibi kimliği tanımlayabilecek bilgiler (PII) içerdiğinden yalnızca operatörler RCS'yi kendi Hizmet Şartları kapsamında çalıştırdığında kullanılabilir. Ağlarınızda İşletmeler için RCS trafiği varsa ve Google'ın Hizmet Şartları uyarınca Google RCS ile RCS etkinliğini etkinleştirirseniz etkinlik günlüklerine erişemezsiniz.
Etkinlik günlüğü biçimi
Etkinlik günlükleri, rbm_activity_YYYY-MM-DD.csv dosya adı biçimini kullanır. Dosya adındaki tarih, dosyanın oluşturulma tarihidir.
Bir kayıttaki alanlar sekmeyle ayrılı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 | Açıklama | Örnek |
|---|---|---|---|
activity_id
|
dize | Etkinliğin benzersiz tanımlayıcısı. | b422e1d3-ac99-442a-853d-a875d5e61762
|
billing_event_id
|
dize | İlişkili faturalandırma etkinliğinin benzersiz tanımlayıcısı. Etkinlik, faturalandırma etkinliğiyle ilişkilendirilmemişse (ör. karşılık gelen delivery_receipt_event olmadan text_message) boş olabilir.
|
91yeb201-7c3b-412b-98d2-b0a0f7abe536
|
agent_id
|
dize | Aracının benzersiz tanımlayıcısı. | welcome-bot@rbm.goog
|
user_id
|
dize | Kullanıcının MSISDN'si. | 918369110173
|
direction
|
dize | İletinin gönderildiği yön:
|
MT
|
time
|
YYYY-mm-ddTHH:MM:SS.SSSZ | Etkinliğin UTC biçiminde RCS Business platformuna gönderildiği tarih ve saat. Zaman damgaları başlıklı makaleyi inceleyin. | 2019-07-25T00:29:07.033Z
|
type
|
dize | Etkinlik türü:
|
text_message
|
size_bytes
|
dize | Etkinliğe eklenen dosyaların bayt cinsinden boyutu. | 912
|
Zaman damgaları
Etkinlik günlüklerindeki zaman damgaları, bir etkinliğin İş için RCS platformuna ne zaman gönderildiğini kaydeder. Kullanıcıya içerik sunan etkinliklerde, ileti teslim edilene kadar etkinlik, etkinlik günlüğüne kaydedilmez.
Örneğin, bir kullanıcıya Çarşamba günü saat 13:00'te bir İş için RCS 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 ancak zaman damgası Çarşamba günü saat 13:00 olur.