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

Bu sayfada, RCS for Business'ın operatörlerin faturalandırma ve denetim işlemlerine 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 birleştirilmiş 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 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) etkinlikleri 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 temsilcileri için RCS for Business etkinliğinin oturumlarla bağlantılı olmasıdır. 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. Kaydolmak 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'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> 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şturulmadıysa remote readdir("/"): No such file or directory gibi bir SFTP hatası görürsünüz. Bu hata beklenir.

Raporlanacak bir RCS for 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 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ı, RCS for Business'ı 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) içermez. Örneğin, MSISDN, karma oluşturulmuş MSISDN veya kullanıcıya özgü tanımlayıcılar bu kapsamdadır.

Not: İş ortakları, trafiği yönetmelerine yardımcı olmak için günlük olarak toplanmış ö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ğı faturalandırma raporları başlıklı makaleyi inceleyin.

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. Faturalandırma 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.
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ırma: 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 süresi (ilk yanıttan sonraki 24 saat) boyunca temsilci ve kullanıcı dilediği kadar 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 gönderirse ajan, görüşme dışı bir ajanda olduğu gibi 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 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ışı aracılar, 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 aşamalı etkileşimler 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 (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 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 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 parçası olur.
a2p_conversation (işletme tarafından başlatılan)	Kullanıcı, mevcut bir görüşme dışında, aldığı A2P mesajına 24 saat içinde 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 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 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.	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. Ajanınızın nasıl faturalandırılacağını belirler: mesaj başına (etkileşimli olmayan ajanlar) veya sohbet başına (etkileşimli ajanlar).
• Faturalandırılabilir etkinlikler, bir RCS for Business 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 olmayan aracıların oluşturduğu etkinlikler faturalandırılabilir. Test telefon numaralarından gelen etkinlikler fatura 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.

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.

Raporun her kaydı, faturalandırılabilir her etkinlik için aşağıdaki bilgileri içerir.

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	Aracının oluşturulduğu iş ortağı hesabının mevcut sahibinin e-posta adresi.	[e-mail]
billing_party	dize	Etkinlikler için faturalandırma yapan 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 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, temsilcinin ilk mesajına 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, iletinin kullanıcı tarafından gönderildiğ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ış şekilde. 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 başlatılan (P2A) mesaj sayısı.	9
size_kilobytes	sayı	Etkinlikteki iletilere eklenen tüm dosyaların boyutu (en yakın kilobayta yuvarlanmış). 1 kB, 1024 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ı indirebilirsiniz:

• Standart 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 bir 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 sekme ile 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: MT (mobil sonlandırma) için aracıdan kullanıcıya etkinlikler 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 RCS for Business 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ü için oluşturulan etkinlik günlüğünde görünür ancak zaman damgası Çarşamba günü saat 13:00 olur.