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 aracı ve kullanıcılar arasındaki faturalandırılabilir etkinliklerin birleştirilmiş raporu.	RCS for Business'ı 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üğü.	İşletmeler için RCS'yi etkin olarak kullanan ve Google RCS Hizmeti'ni kendi Hizmet Şartları (ToS) kapsamında işleten operatörler.

RCS for Business, 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ı, Pasifik Standart Saati'ne (PST) göre 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) etkinliği yansıtır. Oluşturma işlemi birkaç saat sürebilir ve tamamlanma süresi değişebilir.

• 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 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 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, görüşme ajanları için RCS for Business etkinliğinin oturumlarla bağlantı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 edinmek 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ı, 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 bir RCS for Business trafiği yoksa dosya oluşturulmaz. Bu nedenle, dosya oluşturulmadığı günler olabilir. 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ı

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şturulmuş MSISDN veya kullanıcıya özgü tanımlayıcılar) içermez.

Aracı faturalandırma kategorileri

Sahip, bir ajan oluştururken ajanın kullanıcılarla nasıl etkileşimde bulunacağına bağlı olarak fatura kategorisini belirler. Fatura kategorisi, bir temsilcinin gönderebileceği mesajların sayısını veya türünü kısıtlamaz. Ancak bu ayar, 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üş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.
Konuşma şeklinde	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ı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. Etkileşim aralığı (ilk yanıttan sonraki 24 saat) boyunca temsilci ve kullanıcı herhangi bir sayıda mesaj alışverişinde bulunabilir. Temsilci, etkileşim 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 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:

Etkileşimli ve etkileşimli olmayan temsilciler

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

Faturalandırma kategorilerindeki temel fark, etkileşimli ve etkileşimli olmayan aracılar 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

Not: Bu bölümdeki etkinlikler yalnızca standart faturalandırma modeli (ABD dışı trafik) için geçerlidir. ABD trafiği için faturalandırılabilir etkinlikler hakkında bilgi edinmek istiyorsanız ABD faturalandırma modeli kılavuzuna bakın.

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 (Mobil Sonlandırma): İş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 aracılar için geçerli olduğu şekilde açıklanmaktadır.

Etkinlik	Açıklama	Görüşme dışı aracılar	Etkileşimli aracılar
basic_message	Yalnızca 160 karakter veya daha az uzunlukta 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ı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 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ı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 a2p_conversation parçası olur.
a2p_conversation (işletme tarafından başlatılan)	Kullanıcı, mevcut bir görüşme dışında, A2P mesajını aldıktan sonraki 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 temsilci, mevcut bir görüşme 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ürdeki P2A mesajı.	Ajan yanıt verip vermemesine bakılmaksızın her zaman ayrı bir faturalandırılabilir etkinlik olarak değerlendirilir.	Müşteri temsilcisi 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. Bu ayar, temsilcinizin nasıl faturalandırılacağını belirler: mesaj başına (görüşme dışı temsilciler) veya görüşme başına (görüşme temsilcileri).
• Faturalandırılabilir etkinlikler, bir RCS for Business işletme temsilcisi ile 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 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.

Fatura 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.

Rapordaki 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.

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ü: Standart faturalandırma modeli basic_message single_message a2p_conversation p2a_conversation p2a_message ABD faturalandırma modeli a2P_rich_message a2p_rich_media_message p2a_rich_message p2a_rich_media_message p2a_suggested_action	single_message p2a_rich_message
agent_id	dize	Etkinliğe katılan aracının benzersiz tanımlayıcısı.	[e-mail]
agent_owner	dize	Aracının 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). 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ı 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 yuvarlanır. Değer, sohbet dışı etkinlikler için 0'dır.	45
mt_messages	sayı	Etkinlikteki mobil sonlandırmalı (A2P) mesaj sayısı.	11
mo_messages	sayı	Etkinlikteki cep telefonundan gönderilen (P2A) mesaj 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 RICH_MESSAGE etkinlikleri için hesaplanan segment sayısı.	5

Örnek fatura raporu

Örnek raporları indirebilirsiniz:

• Standart faturalandırma modeli için fatura raporu
• ABD faturalandırma modeli için fatura raporu

Tipik 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 kimliği tanımlayabilecek bilgiler (PII) içerdiğinden yalnızca operatör kendi Hizmet Şartları kapsamında RCS'yi ç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ı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 bir RCS for Business 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.