Bu sayfada, RBM'nin operatörlere faturalandırma ve denetim konusunda yardımcı olmak için oluşturduğu veri dosyaları açıklanmaktadır. RBM faturalandırma modeli hakkında sık sorulan soruların yanıtlarını RBM faturalandırmasıyla ilgili SSS sayfasında bulabilirsiniz.
| Dosya | Açıklama | Erişimi olanlar |
|---|---|---|
| Faturalandırma etkinliği raporu | Lansmanı yapılan temsilciler ile kullanıcılar arasındaki faturalandırılabilir etkinliklerin toplu raporu. | RBM'yi (RCS Business Messaging) etkin olarak kullanan tüm operatörler. |
| Etkinlik günlüğü | Faturalandırılabilir etkinlikler dahil olmak üzere RBM etkinliğinin ham veri günlüğü. | RBM'yi (RCS Business Messaging) etkin bir şekilde işleten ve Google RCS Hizmeti'ni kendi Hizmet Şartları (HŞ) kapsamında işleten operatörler. |
Dosya oluşturma
Her veri dosyası, Eşgüdümlü Evrensel Zaman (UTC) biçiminde bir günlük RBM kullanımını temsil eder. Dosyalar günlük olarak oluşturulur. Oluşturma işlemi birkaç saat sürebilir ve tamamlanma süresi değişiklik gösterebilir.
Sohbet dışı temsilciler için dosyalar, dosya oluşturma zamanından hemen önceki 24 saatlik dönemdeki verileri içerir. Örneğin, 5 Mayıs'ta saat 11:00 (UTC)'de bir faturalandırma etkinliği raporu oluşturulursa bu rapor 4 Mayıs'ta saat 11:00 (UTC) ile 5 Mayıs'ta saat 11:00 (UTC) arasındaki verileri içerir.
Sohbet temsilcileri için dosyalar, dosya oluşturma zamanından 1-2 gün önceki 24 saatlik süreye ait verileri içerir. Örneğin, 5 Mayıs'ta 11:00 (UTC) tarihinde oluşturulan bir faturalandırma etkinliği raporu, 3 Mayıs'ta 11:00 (UTC) ile 4 Mayıs'ta 11:00 (UTC) arasındaki verileri içerebilir.
Gecikmenin nedeni, sohbet temsilcileri için RBM etkinliğinin sohbetlere bağlı olmasıdır. Bu işlemin tamamlanması 48 saati bulabilir. Bu gecikme, RBM'nin faturalandırma etkinliğini hesaplamadan önce bir sohbetteki tüm mesajları yakalamasına olanak tanır. Sohbet temsilcileri hakkında daha fazla bilgi edinmek 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, içindeki verilerin tarihi değil, dosyanın oluşturulduğu tarihtir.
Saklama: Dosyalar silinmeden önce en fazla 30 gün saklanır.
Veri ambarınızı en son platform kullanım metrikleriyle güncellemek için bu dosyaları kullanabilirsiniz.
Dosya depolama ve erişimi
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'tür ve bağlantı, ek güvenlik için yüksek bir bağlantı noktası numarasında (19321) gerçekleşir.
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 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şturulmamışsa remote readdir("/"): No such file or directory ile benzer bir SFTP hatası görürsünüz. Bu durum normaldir.
Raporlanacak RBM trafiği yoksa dosya oluşturulmaz. Bu nedenle, bazı günlerde dosya oluşturulmayabilir. İşleminizi kolaylaştırmak için boş dosyalara ihtiyacınız varsa rbm-support@google.com adresinden bize ulaşın.
Faturalandırma etkinliği raporları
Faturalandırma etkinliği raporları, temsilcinin faturalandırma kategorisine ve gönderdiği iletilerin türüne göre hesaplanan faturalandırma etkinliklerinin kayıtlarıdır. Faturalandırma etkinliği raporları, RBM'yi (RCS Business Messaging) 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 herhangi bir kullanıcının benzersiz tanımlayıcısı gibi kimliği tanımlayabilecek bilgiler (PII) içermez.
Temsilci faturalandırma kategorileri
Temsilci oluştururken sahip, temsilcinin kullanıcılarla nasıl etkileşimde bulunacağına bağlı olarak faturalandırma kategorisini belirler. Faturalandırma kategorisi, 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 |
|---|---|---|---|
Sohbet tarzında olmayan (Temel Mesaj ve Tek Mesaj kategorileri dahildir. Not: Artık bu iki kategori arasında fark yoktur. Her iki kategorideki temsilciler de sohbet dışı temsilci olarak faturalandırılır.) |
Temel olarak tek yönlü mesajlar gönderen temsilciler. |
|
Kullanıcıya gönderilen her ileti için faturalandırılır. |
| Görüşmeler | Kullanıcılarla karşılıklı iletişim için tasarlanmış temsilciler. |
|
Görüşme başına faturalandırılır: Bir taraf (temsilci veya kullanıcı), diğer taraftan gelen bir mesajı 24 saat içinde yanıtlarsa görüşme başlar. Görüşme aralığı (ilk yanıttan 24 saat sonra) boyunca temsilci ve kullanıcı diledikleri kadar mesaj alışverişinde bulunabilir. Temsilciye görüşme için sabit bir ücret faturalandırılır. Mesaj başına faturalandırılır: Temsilci, kullanıcının 24 saat içinde yanıtlamadığı bir mesaj gönderirse sohbet dışı bir temsilciye benzer şekilde, mesaj başına faturalandırılır. |
Sohbet tarzında ve sohbet tarzında olmayan aracılar
İki ana faturalandırma kategorisi vardır: sohbet ve sohbet dışı. Görüşme dışı kategori, işlevsel olarak aynı olan Temel İleti ve Tek İleti kategorilerini içerir. Bu kategorilerden birinde yer alan temsilciler, sohbet etmeyen temsilci olarak faturalandırılır.
Faturalandırma kategorilerindeki temel fark, sohbet eden ve sohbet etmeyen temsilciler arasındadır:
Sohbet dışı temsilciler, kullanıcıya gönderdikleri her ileti için faturalandırılır.
- Bu kategori, sık sık yanıt beklemeyen temsilciler için idealdir.
Etkileşimli müşteri temsilcileri, 24 saat içinde gönderilen tüm mesajları içeren görüşmeler için sabit ücret öder.
- Bu kategori, kullanıcılarla çok turlu görüşmeler yapan temsilciler için en uygun seçenektir.
Faturalandırma etkinlikleri
Faturalandırma etkinliği raporlarına beş farklı faturalandırma etkinliği türü kaydedilir. Bu etkinlikler arasında A2P ve P2A mesajları yer alır.
- A2P (Uygulamadan Kullanıcıya): İşletme tarafından gönderilir.
- Kullanıcılar arası (P2A): Kullanıcı tarafından gönderilir.
Aşağıdaki tabloda, her faturalandırma etkinliği, sohbet dışı ve sohbetli temsilciler için geçerli olduğu şekilde açıklanmaktadır.
| Etkinlik | Açıklama | Konuşma dışı aracılar | Conversational Agents |
|---|---|---|---|
basic_message
|
Yalnızca 160 karakter veya daha kısa metin içeren A2P mesajı. Metinde openGraph etiketleri içeren bir web sitesinin URL'si varsa mesajda, iş ortağına ek ücret yansıtılmaksızın bir resim önizlemesi gösterilebilir. | Kullanıcının yanıt verip vermediğine bakılmaksızın her zaman ayrı bir faturalandırma etkinliği olarak değerlendirilir. | Kullanıcı 24 saat içinde yanıt vermezse ayrı bir faturalandırma etkinliği olarak değerlendirilir. Bu durumda, mesaj bir a2p_conversation'ün parçası olur.
|
single_message
|
Multimedya ve/veya 160'tan fazla karakter içeren metin içeren A2P mesajı. | Kullanıcının yanıt verip vermediğine bakılmaksızın her zaman ayrı bir faturalandırma etkinliği olarak değerlendirilir. | Kullanıcı 24 saat içinde yanıt vermezse ayrı bir faturalandırma etkinliği olarak değerlendirilir. Bu durumda, mesaj bir a2p_conversation'ün parçası olur.
|
a2p_conversation (işletme tarafından başlatılan)
|
Kullanıcı, A2P mesajını aldıktan sonraki 24 saat içinde mevcut bir görüşmenin dışında yanıtladığında başlatılır. | Hiçbiri. Etkileşimli olmayan temsilciler hiçbir zaman bu tür bir etkinlik 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 önceki A2P mesajı kullanılır. Bu A2P mesajı ve önümüzdeki 24 saat içinde teslim edilen tüm mesajlar a2p_conversation kapsamındadır.
|
p2a_conversation (kullanıcı tarafından başlatılan)
|
Bir müşteri temsilcisi, P2A mesajını aldıktan sonraki 24 saat içinde mevcut bir görüşmenin dışında yanıtladığında başlatılır. | Hiçbiri. Etkileşimli olmayan temsilciler hiçbir zaman bu tür bir etkinlik 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 önceki P2A mesajı kullanılır. Bu P2A mesajı ve sonraki 24 saat içinde gönderilen tüm mesajlar p2a_conversation kapsamındadır.
|
p2a_message
|
Herhangi bir türde P2A mesajı. | Temsilcinin yanıt verip vermediğine bakılmaksızın her zaman ayrı bir faturalandırma etkinliği olarak değerlendirilir. | Müşteri temsilcisi 24 saat içinde yanıt vermezse 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 müşteri temsilcisi (faturalandırma kategorisi ne olursa olsun)
basic_messagevesingle_messagefaturalandırma etkinlikleri oluşturabilir.Temel Mesaj ve Tek Mesaj faturalandırma kategorileri, sohbet dışı temsilcileri sınıflandırmak için kullanılır. Bu faturalandırma kategorilerindeki temsilciler, sohbet faturalandırması etkinlikleri (
a2p_conversationsveyap2a_conversations) oluşturmaz. Bunun yerine, ayrıbasic_message,single_messagevep2a_messagefaturalandırma etkinlikleri oluştururlar.
Faturalandırma raporu oluşturma
Yalnızca test kullanıcısı olmayan trafiğe sahip temsilciler faturalandırma etkinliği oluşturur. Test telefon numaralarından gelen etkinlikler, faturalandırma etkinliği raporlarında görünmez.
Bu raporlarda, etkinliklerin mesajlar gönderildiğinde değil, mesajlar teslim edildiğinde faturalandırıldığı varsayılır. Teslim edilmeyen veya teslim edilmeden önce iptal edilen iletiler faturalandırma etkinliği tetiklemez.
Faturalandırma raporu biçimi
Faturalandırma etkinliği raporları rbm_billable_events_YYYY-MM-DD.csv dosya adı biçimini kullanır. Dosya adındaki tarih, dosyanın oluşturulduğu tarihtir.
Rapordaki her satır, tek bir faturalandırma etkinliğini temsil eden bir kayıttır. Bir kayıttaki alanlar sekmeyle ayrılır. Örneğin, aynı temsilciyle yapılan iki A2P görüşmesi, faturalandırma etkinliği raporunda iki faturalandırma etkinliği ve iki kayıt oluşturur.
Rapordaki her kayıt, her faturalandırma etkinliği için aşağıdaki bilgileri içerir:
| Alan | Biçim | Açıklama | Örnek |
|---|---|---|---|
billing_event_id
|
dize | UUID tanımlayıcısı. Her yeni etkinlik için oluşturulduğu sırada oluşturulan rastgele bir sayı. | 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 | Temsilcinin oluşturulduğu iş ortağı hesabının mevcut sahibinin e-posta adresi. | name@aggregator.com
|
billing_party
|
dize | Etkinlikler için fatura düzenleyen taraf.
|
carrier
|
max_duration_single_message
|
sayı | Sohbet başlatma aralığı kapanmadan ve mesaj single_message etkinliği olarak sınıflandırılmadan önce kullanıcının bir müşteri temsilcisi mesajına yanıt vermesi için izin verilen maksimum süre (saat cinsinden).
|
24
|
max_duration_a2p_conversation
|
sayı | A2P görüşmesinin maksimum süresi (saat cinsinden). Kullanıcının ilk yanıtından temsilcinin ilk mesajına kadar geçen süredir. | 24
|
max_duration_p2a_conversation
|
sayı | Müşteri temsilcisiyle 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 | Etkinliğin başladığı UTC tarihi/saati, ISO 8601 biçiminde en yakın saate yuvarlanmış şekilde.
A2P mesajları
P2A mesajları
|
2019-07-25T08:00:00Z
|
duration
|
sayı | En yakın dakikaya yuvarlanmış etkinlik süresi.
Etkinlik türü |
45
|
mt_messages
|
sayı | Etkinlikte mobil cihazda sonlandırılan (A2P) mesajların sayısı. | 11
|
mo_messages
|
sayı | Etkinlikte mobil kaynaklı (P2A) mesajların sayısı. | 9
|
size_kilobytes
|
sayı | Etkinlikteki iletilere eklenen tüm dosyaların boyutu (en yakın kilobayta yuvarlanmış şekilde) (1 kB = 1024 bayt). | 912
|
agent_name
|
dize |
Etkinliğe katılan temsilcinin adı. |
XYZ Mobile USA
|
owner_name
|
dize | Temsilcinin oluşturulduğu iş ortağı hesabının mevcut sahibinin adı. | XYZ Mobile
|
Örnek faturalandırma etkinliği raporu
Örnek fatura raporu dosyasını indirebilirsiniz.
Tipik dosya boyutu
Etkin bir RBM iş ortağının günlük raporu yaklaşık 53.000 kayıt içerebilir ve yaklaşık 8 MB boyutunda olabilir.
Etkinlik günlükleri
Etkinlik günlükleri, RBM platformundaki etkinlikle ilgili ham veriler sağlar. Faturalandırma etkinliklerini denetlemek ve özel etkinlikler oluşturmak için bu günlükleri 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 bir operatör kendi Hizmet Şartları uyarınca RCS'yi işletirken kullanılabilir. Ağlarınızda RBM trafiğiniz varsa ve Google'ın Hükümler ve Koşulları 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şturulduğu tarihtir.
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 bir 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 | Temsilcinin 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 RBM platformuna gönderildiği tarih ve saat (UTC biçiminde). Zaman damgalarını 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 RBM platformuna ne zaman gönderildiğini kaydeder. Bir kullanıcıya içerik yayınlayan etkinlikler, mesaj gönderilene kadar etkinlik günlüğüne kaydedilmez.
Ö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 9:00'a kadar çevrimdışıysa etkinlik, Pazar günü için oluşturulan etkinlik günlüğünde görünür ancak zaman damgası Çarşamba, 13:00 olur.