Standart faturalandırma raporları ve etkinlik günlükleri

Bu sayfada, RCS for Business'ın operatörlere faturalandırma ve denetim konusunda yardımcı olmak için oluşturduğu veri dosyaları açıklanmaktadır.

Dosya	Açıklama	Erişimi olanlar
Fatura raporu	Başlatılan temsilciler ve kullanıcılar arasındaki faturalandırılabilir etkinliklerin toplu raporu.	RCS for Business'ı etkin olarak kullanan tüm operatörler.
Etkinlik günlüğü	Faturalandırılabilir etkinlikler dahil olmak üzere RCS for Business etkinliğinin ham veri günlüğü.	RCS for Business'ı aktif olarak işleten ve Google RCS Hizmeti'ni kendi Hizmet Şartları (ToS) kapsamında işleten operatörler.

RCS for Business, ABD dışı trafik için standart bir faturalandırma modeli kullanır. Ayrıntılar için Faturalandırmayla ilgili SSS bölümüne bakın.

Dosya üretme

Her veri dosyası, Pasifik Standart Saati'nde (PST) bir günlük RCS for Business kullanımını gösterir. Dosyalar günlük olarak oluşturulur ve önceki 24 saatlik dönemdeki (gece yarısından gece yarısına) etkinlikleri yansıtır. Oluşturma işlemi birkaç saat sürebilir ve tamamlanma süresi değişiklik gösterebilir.

• Sohbet dışı aracılar 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 ile 5 Mayıs saat 00:00 arasındaki verileri kapsar. Belirtilen saat, PST saat dilimindedir.

• Sohbet temsilcileri için 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 oluşturulan bir rapor, 2 Mayıs veya 3 Mayıs'taki 24 saatlik döneme ait verileri kapsar. Belirtilen saat, PST saat dilimindedir.

  Gecikmenin nedeni, etkileşimli temsilciler için RCS for Business etkinliğinin oturumlara bağlı olmasıdır. Bu oturumların tamamlanması 24 saati bulabilir. Bu gecikme, faturalandırılabilir etkinlik hesaplanmadan önce RCS for Business'ın bir görüşmedeki tüm mesajları yakalamasına olanak tanır. Etkileşimli temsilciler hakkında daha fazla bilgi için Temsilci faturalandırma kategorileri başlıklı makaleyi inceleyin.

Not: Raporlar, önceki 30 güne ait verileri de içerebilir (hem sohbet hem de sohbet dışı aracılar için). Faturalandırma, teslimat zamanına göre yapıldığından bu durumda 10 Nisan'da gönderilen ancak 4 Mayıs'ta teslim edilen bir ileti, 5 Mayıs'ta oluşturulan raporda yer alır.

Önemli noktalar:

• Etkinlik yok: Belirli bir günde platform etkinliği yoksa varsayılan olarak dosya oluşturulmaz. Ancak, gerekirse boş dosyaları almayı etkinleştirebilirsiniz. Bu özelliği etkinleştirmek için [e-mail] ile iletişime geçin.
• 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 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ı, aktif olmadıkları 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 Güvenli Kabuk (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 beklenen bir durumdur.

Raporlanacak RCS for Business trafiği yoksa dosya oluşturulmaz. Bu nedenle, bazı günlerde dosya oluşturulmayabilir. Sürecinizi kolaylaştırmak için boş dosyalara ihtiyacınız varsa RCS for Business Destek Ekibi ile iletişime geçin.

Fatura raporları

Fatura raporları, faturalandırılabilir etkinliklerin kayıtlarıdır. Bu etkinlikler, aracının faturalandırma kategorisine ve gönderdiği mesajların türüne göre hesaplanır. Fatura raporları, RCS for Business'ı etkin olarak kullanan tüm operatörler tarafından kullanılabilir.

Fatura raporları gizli bilgi içerir ancak kullanıcıya ait kişisel veri (PII) (ör. MSISDN, karma oluşturma işlemi uygulanmış MSISDN veya kullanıcıya özgü benzersiz tanımlayıcı) içermez.

Not: İş ortakları, trafiği yönetmelerine yardımcı olmak için günlük olarak birleştirilmiş özet raporlar da alır. Bu raporlar, trafik verileriyle ilgili değerli analizler ve gerekli görünürlük sağlar. Daha fazla bilgi için İş ortağı fatura raporları başlıklı makaleyi inceleyin.

Ajan faturalandırma kategorileri

Sahip, bir ajan oluştururken ajanın kullanıcılarla nasıl etkileşimde bulunacağına bağlı olarak faturalandırma kategorisini belirler. Faturalandırma kategorisi, bir temsilcinin gönderebileceği mesajların sayısını veya türünü kısıtlamaz. Ancak, ajanın 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üşme dışı	Öncelikle tek yönlü mesajlar gönderen temsilciler.	OTP'ler Uyarılar Promosyon teklifleri	Kullanıcıya teslim edilen her ileti için faturalandırılırsınız.
Görüşme	Kullanıcılarla karşılıklı etkileşim için tasarlanmış temsilciler.	Doğru ürünü bulma Bilet rezervasyonu yapma Sorun giderme	Görüşme başına faturalandırılır: Taraflardan biri (temsilci veya kullanıcı) diğer tarafın mesajına 24 saat içinde yanıt verirse görüşme başlatılır. Görüşme aralığı (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: Ajan, kullanıcının 24 saat içinde yanıt vermediği bir mesajı teslim ederse ajan, etkileşimli olmayan bir ajana benzer şekilde tek mesaj için faturalandırılır.

Aşağıdaki şemada, sohbet aracıları için bir A2P faturalandırma oturumu örneği gösterilmektedir:

Etkileşimli ve etkileşimli olmayan ajanlar

İki ana faturalandırma kategorisi vardır: etkileşimli ve etkileşimli olmayan.

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.

• Etkileşimli ajanlar, 24 saatlik süre içinde gönderilen veya alınan tüm mesajları içeren sohbetler için sabit bir ücretle faturalandırılı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, A2P ve P2A etkinlikleri olarak adlandırılan MT ve MO etkinliklerini içerir.

• A2P (Application-to-Person) MT (Mobile Terminated): İşletme tarafından gönderilen mesaj.
• P2A (Kişiden Uygulamaya) MO (Mobile Originated): Kullanıcı tarafından başlatılan bir mesaj veya işlem.

Aşağıdaki tabloda, her bir faturalandırılabilir etkinlik, etkileşimli olmayan ve etkileşimli aracılar için geçerli olduğu şekilde açıklanmaktadır.

Etkinlik	Açıklama	Etkileşimli olmayan ajanlar	Etkileşimli ajanlar
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ğına ek ücret yansıtılmadan 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 ileti, a2p_conversation adlı tartışmanın bir 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ı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 ileti, a2p_conversation adlı tartışmanın bir 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üşme dışında yanıt verdiğinde başlatılır.	Hiçbiri. Sohbet etmeyen ajanlar bu tür etkinlikleri asla 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 etmeyen ajanlar bu tür etkinlikleri asla 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ürdeki P2A mesajı.	Ajan 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. Ajanınızın nasıl faturalandırılacağını belirler: mesaj başına (etkileşimli olmayan ajanlar) veya görüşme başına (etkileşimli ajanlar).
• Faturalandırılabilir etkinlikler, bir RCS for Business ajanı ile bir kullanıcı arasındaki, faturalandırma amacıyla izlenen etkileşimlerdir (örneğin, basic_message, single_message, a2p_conversation).

Fatura raporu oluşturma

Yalnızca test kullanıcısı olmayan trafiğe sahip aracıların oluşturduğu etkinlikler faturalandırılabilir. Test telefonu 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.

Fatura raporu biçimi

Fatura raporlarında rbm_billable_events_YYYY-MM-DD.csv dosya adı biçimi kullanılır. Dosya adındaki tarih, dosya üretme 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 fatura raporunda iki kayıt oluşturur.

Dosyalar, bayt sırası işareti olmadan UTF-8 olarak kodlanır ve satır sonları için satır besleme kullanılır. Her dosyanın ilk satırı, alan adlarının yer aldığı bir başlık satırıdır.

Raporun her kaydında, faturalandırılabilir her etkinlik için aşağıdaki bilgiler yer alır.

Alan	Biçim	Açıklama	Örnek
billing_event_id	dize	Faturalandırılabilir etkinliği ayıran oluşturulmuş kimlik.	242f1d9f-7c3f-4e5b-ab3f-818f188fa3ff
type	dize	Etkinlik türü: basic_message single_message a2p_conversation p2a_conversation p2a_message	single_message p2a_rich_message
agent_id	dize	Etkinliğe katılan temsilcinin benzersiz tanımlayıcısı.	[e-mail]
agent_owner	dize	Temsilcinin oluşturulduğu iş ortağı hesabının mevcut sahibinin e-posta adresi.	[e-mail]
billing_party	dize	Etkinlikler için fatura kesen taraf. operatör	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 ilk kullanıcının verdiği yanıttan itibaren ölçülür.	24
max_duration_p2a_conversation	sayı	P2A görüşmesinin maksimum süresi (saat). 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ı single_message ve basic_message etkinlikleri için bu, iletinin kullanıcıya teslim edildiği zamandır. a2p_conversation etkinliği için bu, görüşmedeki ilk mesajın kullanıcıya teslim edildiği zamandır. P2A mesajları single_message ve basic_message etkinlikleri için bu, kullanıcının mesajı gönderdiği zamandır. p2a_conversation etkinliği için bu, görüşmedeki ilk mesajın kullanıcı tarafından gönderildiği zamandır.	2019-07-25T08:00:00Z
duration	sayı	Etkinlik süresi (en yakın dakikaya yuvarlanmış). Değer, sohbet dışı etkinlikler için 0'dır.	45
mt_messages	sayı	Etkinlikteki mobil sonlandırmalı (A2P) ileti 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, 1.024 bayta eşittir.	912
agent_name	dize	Etkinliğe katılan aracının adı.	XYZ Mobile USA
owner_name	dize	Aracının oluşturulduğu iş ortağı hesabının mevcut sahibinin adı.	XYZ Mobile

Örnek fatura raporu

Örnek raporlar indirilebilir:

• Standart faturalandırma modeli için fatura raporu

Normal dosya boyutu

Etkin bir RCS for 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 for Business platformundaki etkinliklerle ilgili ham veriler sağlar. Bu günlükleri, faturalandırılabilir etkinlikleri 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 kişisel veri (PII) içerdiğinden yalnızca bir operatör kendi Hizmet Şartları kapsamında RCS'yi çalıştırdığında kullanılabilir. Ağlarınızda RCS for Business 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 üretilme tarihidir.

Bir kayıttaki alanlar sekme ile ayrılır ve her satırda bir kayıt bulunur.

Dosyalar, bayt sırası işareti olmadan UTF-8 olarak kodlanır ve satır sonları için satır besleme kullanılır. Her dosyanın ilk satırı, alan adlarının yer aldığı bir başlık satırıdır.

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ırılabilir etkinliğin benzersiz tanımlayıcısı. Etkinlik, faturalandırılabilir bir etkinlikle (ör. karşılık gelen delivery_receipt_event olmadan text_message) ilişkilendirilmemişse boş olabilir.	91yeb201-7c3b-412b-98d2-b0a0f7abe536
agent_id	dize	Aracının benzersiz tanımlayıcısı.	[e-mail]
user_id	dize	Kullanıcının MSISDN'si.	918369110173
direction	dize	İletinin gönderildiği yön: Ajan-kullanıcı etkinlikleri için MT (mobil sonlandırma) Kullanıcıdan temsilciye etkinlikleri için MO (mobil kaynaklı)	MT
time	YYYY-mm-ddTHH:MM:SS.SSSZ	Etkinliğin UTC biçiminde RCS for 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 file_transfer rich_card/carousel suggestion_tap delivery_receipt_event read_receipt_event spam_report	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 RCS for Business mesajı gönderilirse ve alıcı Pazar günü saat 09:00'a kadar çevrimdışı olursa etkinlik, Pazar günü oluşturulan etkinlik günlüğünde görünür ancak zaman damgası Çarşamba günü saat 13:00 olur.