Bu sayfa, RCS for Business'ın ABD'li operatörlere ABD RBM Çerçevesi kapsamında faturalama ve denetim konusunda yardımcı olmak için oluşturduğu veri dosyalarını açıklamaktadır. ABD RBM Çerçevesi hakkında daha fazla bilgi edinmek için usrbm.org adresini de ziyaret edebilirsiniz.
Faturalama raporu, başlatılan temsilciler ve kullanıcılar arasındaki faturalandırılabilir olayların toplu bir raporudur. Faturalandırılabilir, bir olayın ücrete tabi olduğu anlamına gelir. Operatörler, faturalandırılabilir olayların ücretlendirilip ücretlendirilmeyeceğine ve nasıl ücretlendirileceğine karar verir. RCS for Business'ı aktif olarak kullanan tüm ABD operatörleri faturalama raporlarına erişebilir.
ABD faturalama sınıflandırma modeli hakkında ayrıntılı bilgi için ABD Faturalama SSS bölümüne bakın.
Dosya oluşturma
Daha fazla bilgi için Dosya oluşturma bölümüne bakın.
Dosya depolama ve erişim
Daha fazla bilgi için Dosya depolama ve erişim bölümüne bakın.
Dosya kullanılabilirliği
Daha fazla bilgi için Dosya kullanılabilirliği bölümüne bakın.
Faturalama raporları
Faturalama raporları, acentenin faturalama kategorisine ve gönderdiği mesaj türüne göre hesaplanan, faturalandırılabilir olayların kayıtlarıdır. Faturalama raporları, RCS for Business'ı aktif olarak kullanan tüm operatörler için mevcuttur.
Faturalama raporları gizli bilgiler içerir, ancak MSISDN, karma MSISDN veya herhangi bir kullanıcıya özgü tanımlayıcı gibi kişisel olarak tanımlanabilir bilgiler (PII) içermez.
Faturalama kategorileri ve faturalandırılabilir etkinlikler
Temsilci faturalama kategorileri ve faturalandırılabilir olaylar arasındaki ayrım, temsilcinizin nasıl faturalandırılabilir olduğunu anlamanın anahtarıdır.
- Fatura kategorisi, temsilcinizi oluştururken seçtiğiniz sabit bir sınıflandırmadır. Temsilcinizin nasıl faturalandırılacağını belirler: mesaj başına (diyalogsuz temsilciler) veya oturum başına (diyaloglu temsilciler).
- Faturalandırılabilir olaylar, faturalandırma amacıyla izlenen (örneğin,
rich_message) bir RCS for Business aracısı ile kullanıcı arasındaki etkileşimlerdir.
ABD acente faturalama kategorileri
Bir temsilci oluşturulurken, sahibi temsilcinin kullanıcılarla nasıl etkileşim kuracağına bağlı olarak faturalama kategorisini belirler. Faturalama kategorisi, bir temsilcinin gönderebileceği mesaj sayısını veya türünü kısıtlamaz. Ancak, temsilcinin mesajlar için nasıl faturalandırılacağını belirler. İki ana faturalama kategorisi aşağıdaki tabloda açıklanmıştır.
| Faturalama kategorisi | Temsilci türü | Örnek kullanım senaryoları | Faturalama yöntemi |
|---|---|---|---|
| Konuşma dışı | primarily tek yönlü mesaj gönderen aracılar. |
| Kullanıcıya iletilen her mesaj için ücret alınır. |
| Konuşma tarzında | Kimin konuşmayı başlattığına bakılmaksızın kullanıcılarla karşılıklı iletişim kurmak üzere tasarlanmış aracı yazılımlar. |
| Oturum başına ücretlendirme : Oturum kriterleri karşılanırsa, 24 saatlik oturum penceresi içindeki tüm zengin ve zengin medya mesajları, uzunluk veya segmentlerden bağımsız olarak sabit bir ücret üzerinden faturalandırılır. Mesaj başına ücretlendirme : Oturum kriterleri karşılanmazsa veya bir mesaj 24 saatlik oturum penceresinin dışında kalırsa, mesaj, ilgili operatörün fiyat listesine göre zengin veya zengin medya içerikli mesaj başına ücretlendirilir. |
Diyalogsal ve diyalogsuz aracıların karşılaştırılması
Temsilci faturalandırmasında iki kategori vardır: konuşmaya dayalı ve konuşmaya dayalı olmayan.
Konuşma tabanlı olmayan müşteri temsilcileri, kullanıcıya ilettikleri her mesaj için ücretlendirilir.
- Bu kategori, sık sık yanıt beklemeyen emlakçılar için en uygundur.
Konuşma asistanları, bir oturum tetiklendiğinde oturum başına sabit bir ücrete tabidir ve bu ücret, oturumu tetikleyen mesajlar da dahil olmak üzere 24 saatlik bir süre içinde değiş tokuş edilen tüm mesajları kapsar. Konuşma asistanları, 24 saatlik bir oturumun parçası olmayan mesajlar için de ücretlendirilebilir.
- Bu kategori, kullanıcılarla çok turlu konuşmalar gerçekleştiren temsilciler için en uygundur.
Oturum faturalama mantığı
ABD faturalama modeline göre, bir oturum, tetikleyici dizideki ilk mesajdan itibaren 24 saatlik bir zaman dilimi içinde değiş tokuş edilen 4 zengin veya zengin medya mesajı (en az 2 MO ve en az 1 MT mesajı dahil) ile tetiklenir. Bu eşik karşılandığında, bu 24 saatlik zaman dilimi içindeki tüm mesajlar tek bir oturum olarak faturalandırılır. Oturumu tetiklemeyen veya oturumun dışında kalan mesajlar, ilgili operatörün fiyat listesine göre zengin veya zengin medya için standart mesaj başına ücret üzerinden faturalandırılır.
Aşağıdaki diyagram, konuşma tabanlı temsilciler için bir A2P faturalama oturumunun örneğini göstermektedir.
- MT (Mobile Terminated - Mobil Bağlantı Kesildi), işletme tarafından gönderilen bir mesajdır.
- MO (Mobil Kaynaklı), kullanıcı tarafından başlatılan bir mesaj veya eylemdir.
Ücretlendirilebilir etkinlikler
Mesajlaşma akışları, kaynaklarına ve yönlerine göre kategorize edilir. Mesajlaşma trafiğinin yönünü tanımlamak için ABD operatörleri genellikle MT/MO terminolojisini kullanır. Bu terimler, RCS for Business belgelerinde kullanılan A2P/P2A terminolojisine karşılık gelir. İşte bu terimlerin nasıl uyumlu olduğuna dair kısa bir özet:
- A2P (Uygulamadan Kişiye) MT (Mobil Sonlandırılmış) ise işletme tarafından gönderilen bir mesajdır.
- P2A (Kişiden Uygulamaya) MO (Mobil Kaynaklı) anlamına gelir : Kullanıcı tarafından başlatılan bir mesaj veya eylem.
| Etkinlik | Tanım | Konuşma yeteneği olmayan aracılar | Konuşma aracıları |
|---|---|---|---|
a2p_rich_message | Temsilci tarafından gönderilen, yalnızca metin içeren, önerilen yanıtlar veya belirli önerilen eylemler (Bir numara çevirin, URL'yi tarayıcıda açın) içeren bir mesaj. | Her zaman ayrı bir faturalandırılabilir etkinlik olarak ele alınır. Mesaj başına ücretlendirme, segmentlere göre yapılır (1 segment 160 UTF-8 bayta eşittir). | Bir oturumun parçası olmadığı sürece, ayrı bir ücretli etkinlik olarak değerlendirilir. |
p2a_rich_message | Kullanıcı tarafından gönderilen, yalnızca serbest metin içeren veya önerilen bir yanıta dokunarak oluşturulan metni içeren mesaj. | Her zaman ayrı bir faturalandırılabilir etkinlik olarak ele alınır. Segmentlere göre mesaj başına ücretlendirme yapılır. | Bir oturumun parçası olmadığı sürece, ayrı bir ücretli etkinlik olarak değerlendirilir. |
a2p_rich_media_message | Aracı tarafından gönderilen, medya (resim, video, ses), zengin kartlar, slayt gösterileri veya "Konumu görüntüle" gibi karmaşık eylemler içeren bir mesaj. | Her zaman ayrı bir faturalandırılabilir etkinlik olarak ele alınır. Boyut veya içeriğe bakılmaksızın tek, sabit bir ücret üzerinden faturalandırılır. | Bir oturumun parçası olmadığı sürece, ayrı bir ücretli etkinlik olarak değerlendirilir. |
p2a_rich_media_message | Kullanıcı tarafından gönderilen ve yüklenmiş bir medya dosyası (resim, video, ses) içeren mesaj. | Her zaman ayrı bir faturalandırılabilir etkinlik olarak ele alınır. Tek seferlik, sabit fiyatlı bir işlem olarak faturalandırılır. | Bir oturumun parçası olmadığı sürece, ayrı bir ücretli etkinlik olarak değerlendirilir. |
p2a_suggested_action | Kullanıcı, önerilen yanıtlar dışında herhangi bir önerilen eyleme (örneğin, "Konumu görüntüle") dokunur. | Her zaman ayrı bir faturalandırılabilir etkinlik olarak ele alınır. Her tıklama için bir adet ücretli etkinlik oluşturur. | Her tıklama için ayrı bir faturalandırılabilir etkinlik olarak değerlendirilir ve oturumun parçası haline gelmediği sürece tıklama başına bir faturalandırılabilir etkinlik oluşturur. |
a2p_session | Oturum tetikleyicisi başlatıldığında ve ilk mesaj MT olduğunda başlayan 24 saatlik bir etkileşim penceresi. Daha fazla bilgi için, Oturum nedir ve nasıl çalışır bölümüne bakın. | Geçerli değil. Oturumlar, diyalog tabanlı olmayan aracı sistemler için geçerli değildir. | Tetiklendiğinde, 24 saatlik süre içindeki tüm mesajlar tek bir oturum ücretine tabidir. 24 saatlik oturum içindeki faturalandırılabilir herhangi bir olay, oturumun faturalandırılabilir olay kimliğine atanır. |
p2a_session | Oturum tetikleyicisi başlatıldığında ve ilk mesaj MO olduğunda başlayan 24 saatlik etkileşim penceresi. Daha fazla bilgi için, Oturum nedir ve nasıl çalışır bölümüne bakın. | Geçerli değil. Oturumlar, diyalog tabanlı olmayan aracı sistemler için geçerli değildir. | Tetiklendiğinde, 24 saatlik süre içindeki tüm mesajlar tek bir oturum ücretine tabidir. 24 saatlik oturum içindeki faturalandırılabilir herhangi bir olay, oturumun faturalandırılabilir olay kimliğine atanır. |
Faturalama raporu oluşturma
Yalnızca test dışı trafiğe sahip temsilciler faturalandırılabilir etkinlikler oluşturur. Test telefon numaralarından gelen etkinlikler faturalandırma raporlarında görünmez.
Bu raporlar, olayların A2P mesajları gönderildiğinde değil, teslim edildiğinde faturalandırılabilir olduğunu varsaymaktadır. Teslim edilmemiş bir mesaj veya teslim edilmeden önce iptal edilen bir mesaj, faturalandırılabilir bir olayı tetiklemez.
Faturalama raporu formatı
Faturalama raporları rbm_billable_events_YYYY-MM-DD.csv dosya adı formatını kullanır. Dosya adındaki tarih, dosyanın oluşturulma tarihidir.
Rapordaki her satır, tek bir faturalandırılabilir olayı temsil eden bir kayıttır. A2P/P2A oturumları, değiş tokuş edilen her mesaj için bir satır olmak üzere birden fazla satırla temsil edilir. Bir oturumla ilişkili her satır (aynı billing_event_id paylaşan), mt_messages ve mo_messages sütunlarında tüm 24 saatlik oturum penceresi için toplam MT ve MO mesaj sayısını raporlayacaktır.
Rapordaki her kayıt, faturalandırılabilir her olay için aşağıdaki bilgileri içerir.
| Alan | Biçim | Tanım | Örnek |
|---|---|---|---|
billing_event_id | sicim | Ücretlendirilebilir etkinliği ayırt eden oluşturulmuş kimlik. Bir oturumun parçası olan tüm mesajlar aynı | 63ed6dc0454958763224ca43cf09388afe9bce5ad2f2b1d66236190074hd5g5e |
type | sicim | Etkinlik türü:a2p_rich_messagea2p_rich_media_messagep2a_rich_messagep2a_rich_media_messagep2a_suggested_action | p2a_rich_message |
agent_id | sicim | Etkinliğe katılan temsilciye ait benzersiz tanımlayıcı. | acme_342h23_agent@rbm.goog |
agent_owner | sicim | Temsilcinin oluşturulduğu iş ortağı hesabının mevcut sahibinin e-posta adresi. | marketing@xyzaggregator.com |
billing_party | sicim | Etkinliklerin faturasını kesen taraf. | taşıyıcı |
max_duration_single_message | sayı | Kullanıcının, görüşme başlatma penceresi kapanmadan ve mesaj single_message olayı olarak sınıflandırılmadan önce temsilci mesajına yanıt vermesi için tanınan maksimum süre (saat cinsinden). Bireysel zengin mesajlar için ABD modelinde geçerli değildir. | 24 |
max_duration_a2p_conversation | sayı | Oturum pilot uygulaması için bu, tetikleme dizisindeki ilk mesajdan itibaren ölçülen 24 saatlik oturum penceresini yansıtır. Süre saat cinsinden ölçülür. | 24 |
max_duration_p2a_conversation | sayı | Oturum pilot uygulaması için bu, tetikleme dizisindeki ilk mesajdan itibaren ölçülen 24 saatlik oturum penceresini yansıtır. | 24 |
start_time | YYYY-mm-ddTHH:00:00Z | Olayın başladığı UTC tarih/saati (ISO 8601). Oturumlar için bu, tetikleme dizisindeki ilk mesajın zaman damgasıdır. A2P a2p_rich_message ve a2p_rich_media_message gibi oturum dışı olaylar için, mesajın kullanıcıya iletildiği zaman dilimi budur.a2p_session olayı için bu, konuşmadaki ilk mesajın kullanıcıya iletildiği zamandır.P2A p2a_rich_message ve p2a_rich_media_message gibi oturum dışı olaylar için, bu, mesajın kullanıcı tarafından gönderildiği zamandır.p2a_session olayı için bu, kullanıcının konuşmadaki ilk mesajı gönderdiği zamandır. | 2025-05-20T08:00:00Z |
duration | sayı | Süre yalnızca oturumlar için geçerlidir ve dakika cinsinden ölçülür. Olay oturum dışı bir olay olduğunda değer 0'dır. | 45 |
mt_messages | sayı | Olaydaki mobil sonlandırılmış (A2P) mesaj sayısı. Oturumlar için, aynı billing_event_id sahip her satır, tüm oturumdaki toplam MT mesaj sayısını gösterir. | 5 |
mo_messages | sayı | Olaydaki mobil kaynaklı (P2A) mesaj sayısı. Oturumlar için, aynı billing_event_id sahip her satır, tüm oturumdaki toplam MO mesaj sayısını gösterir. | 3 |
size_kilobytes | sayı | Olayda yer alan mesajlara eklenen tüm dosyaların boyutu, en yakın kilobayta yuvarlanmış olarak (1 kB, 1024 bayta eşittir). | 912 |
agent_name | sicim | Etkinliğe katılan temsilcinin adı. | ACME Brand |
owner_name | sicim | Temsilcinin oluşturulduğu iş ortağı hesabının mevcut sahibinin adı. | XYZ Aggregator |
segment_count | sayı | a2p_rich_message events ve p2a_rich_message olayları için hesaplanan segment sayısı (1 segment 160 UTF-8 bayta eşittir). Olay belirtilenlerden biri değilse, değer 0'dır. | 5 |
session_type | sicim | Oturum türü:a2p_sessionp2a_session | a2p_session |
Örnek faturalama raporu
Örnek raporu indirmek için aşağıdaki bağlantıya tıklayabilirsiniz:
Tipik dosya boyutu
Aktif bir RCS for Business iş ortağından gelen günlük raporun boyutu, operatörün ağında ne kadar etkinlik oluşturduklarına bağlıdır.