Bu sayfada, işletmeler için RCS'nin operatörlere faturalandırma ve denetim konusunda yardımcı olmak amacıyla oluşturduğu veri dosyaları açıklanmaktadır.
| Dosya | Açıklama | Erişimi olanlar |
|---|---|---|
| Faturalandırma raporu | Başlatılan aracı ve kullanıcılar 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 İşletmeler için RCS etkinliğinin ham veri günlüğü. | Google RCS Hizmeti'ni kendi Hizmet Şartları (ToS) kapsamında işleten ve İş için RCS'yi aktif olarak kullanan operatörler. |
İşletmeler için RCS, iki faturalandırma modeli kullanır: ABD dışı trafik için standart faturalandırma modeli ve ABD trafiği için ABD faturalandırma modeli. Standart model veya ABD modeline özgü bilgiler (ör. farklı faturalandırılabilir etkinlik sınıflandırmaları veya rapor alanları) açıkça belirtilir.
- Standart faturalandırma modeli ve faturalandırma modeli farklılıklarının özeti hakkında ayrıntılı bilgi için Faturalandırma SSS bölümüne bakın.
- ABD faturalandırma sınıflandırmaları hakkında ayrıntılı bilgi için ABD faturalandırma modeli kılavuzunu inceleyin.
Dosya oluşturma
Her veri dosyası, Eşgüdümlü Evrensel Saat (UTC) cinsinden bir günlük RCS Business 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 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 bir faturalandırma raporu oluşturulursa bu raporda 3 Mayıs'ta saat 11:00 (UTC) ile 4 Mayıs'ta saat 11:00 (UTC) arasındaki veriler yer alabilir.
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ırılabilir etkinlik hesaplanmadan önce İş için RCS'nin bir görüşmedeki tüm mesajları yakalaması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. Dosyanın içindeki verilerin tarihi değildir.
Saklama: Dosyalar silinmeden önce en fazla 63 gün boyunca 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ı sağlayın. 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'dir ve ek güvenlik için bağlantı 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 beklenen bir durumdur.
Raporlanacak bir İş için RCS 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.
Fatura raporları
Faturalandırma raporları, faturalandırılabilir etkinliklerin kayıtlarıdır. Bu etkinlikler, temsilcinin faturalandırma kategorisine ve gönderdiği mesajların türüne göre hesaplanır. Faturalandırma raporları, İşletmeler için RCS'yi etkin olarak kullanan tüm operatörler tarafından kullanılabilir.
Faturalandırma raporları gizli bilgiler içerir ancak kullanıcıya ait kimliği tanımlayabilecek bilgiler (PII) (ör. MSISDN, karma oluşturma işlemi uygulanmış MSISDN veya kullanıcıya özgü tanımlayıcılar) içermez.
Temsilci faturalandırma kategorileri
Bir temsilci oluştururken sahibi, 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 | Ağırlıklı olarak tek yönlü mesajlar gönderen temsilciler. |
|
Kullanıcıya teslim edilen her ileti için faturalandırılırsınız. |
| Sohbet tarzı | 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 ücret öder. 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 ayrı 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.
Faturalandırma kategorilerindeki temel fark, etkileşimli ve etkileşimsiz 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ırılabilir etkinlikler
Faturalandırma raporlarına beş tür faturalandırılabilir etkinlik kaydedilir. Bu etkinlikler arasında A2P ve P2A etkinlikleri olarak adlandırılan MT ve MO etkinlikleri yer alır.
- A2P (Uygulamadan Kişiye) MT (Mobile Terminated): İşletme tarafından gönderilen mesaj.
- P2A (Kişiden Uygulamaya) MO (Mobil Kaynaklı): Kullanıcı tarafından başlatılan bir ileti veya işlem.
Aşağıdaki tabloda, her bir faturalandırılabilir etkinlik, etkileşimli olmayan ve etkileşimli temsilciler için geçerli olduğu şekilde açıklanmaktadır.
| Etkinlik | Açıklama | Görüşmeyle ilgili olmayan 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 resim önizlemesi gösterilebilir. | Kullanıcı yanıt verip vermemesine bakılmaksızın her zaman ayrı bir faturalandırılabilir etkinlik olarak değerlendirilir. | Kullanıcı 24 saat içinde yanıt vermediği sürece ayrı bir faturalandırılabilir etkinlik olarak değerlendirilir. Bu durumda, mesaj bir a2p_conversation parçası haline gelir.
|
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ırılabilir etkinlik olarak değerlendirilir. | Kullanıcı 24 saat içinde yanıt vermediği sürece ayrı bir faturalandırılabilir etkinlik olarak değerlendirilir. Bu durumda, mesaj bir a2p_conversation parçası haline gelir.
|
a2p_conversation (işletme tarafından başlatılan)
|
Kullanıcı, mevcut bir görüşme dışında, aldığı A2P 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 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 temsilcinin, mevcut bir görüşme dışında, aldığı P2A 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 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ırılabilir etkinlik olarak değerlendirilir. | Temsilci 24 saat içinde yanıt vermediği sürece ayrı bir faturalandırılabilir etkinlik olarak değerlendirilir. |
Faturalandırma kategorileri ve faturalandırılabilir etkinlikler
Aracı faturalandırma kategorileri ile faturalandırılabilir etkinlikler arasındaki fark, aracınızın nasıl faturalandırıldığını anlamak için önemlidir.
- Faturalandırma kategorisi, aracınızı oluştururken seçtiğiniz sabit bir sınıflandırmadır. Aracınızın faturalandırılacağı yöntemi belirler: mesaj başına (iletişim kurmaya yönelik olmayan aracılar) veya ileti dizisi başına (iletişim kurmaya yönelik aracılar).
- Faturalandırılabilir etkinlikler, bir Business için RCS temsilcisi ile kullanıcı arasındaki, faturalandırma amacıyla izlenen etkileşimlerdir (örneğin,
basic_message,single_message,a2p_conversation).
Faturalandırma raporu oluşturma
Yalnızca test trafiği içermeyen aracıların oluşturduğu etkinlikler faturalandırılabilir. Test telefon numaralarından gelen etkinlikler faturalandırma 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ırılabilir etkinlikleri tetiklemez.
Faturalandırma raporu biçimi
Faturalandırma raporları, rbm_billable_events_YYYY-MM-DD.csv dosya adı biçimini kullanır.
Dosya adındaki tarih, dosyanın oluşturulma tarihidir.
Raporun her satırı, tek bir faturalandırılabilir etkinliği 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 ayrı faturalandırılabilir etkinlik ve faturalandırma raporunda iki kayıt oluşturur.
Raptaki her kayıtta, faturalandırılabilir her etkinlik 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ü:
Standart faturalandırma modeli ABD faturalandırma modeli |
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ış).
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
|
segment_count
|
sayı | Yalnızca ABD faturalandırma modeli
|
5
|
Örnek faturalandırma etkinliği raporu
Örnek raporları indirebilirsiniz:
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, İşletmeler için RCS 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 RCS for Business trafiğiniz 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, karşılık gelen delivery_receipt_event olmadan text_message gibi bir faturalandırma etkinliğiyle ilişkilendirilmemişse 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 İşletmeler için RCS 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 etkinlikler için ileti teslim edilene kadar etkinlik, etkinlik günlüğüne kaydedilmez.
Örneğin, bir kullanıcıya Çarşamba günü saat 13:00'te İş için RCS mesajı gönderilirse ve alıcı Pazar günü saat 09:00'a kadar çevrimdışı kalırsa 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.