- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- Talep gövdesi
- Yanıt gövdesi
- Yetki Kapsamları
- AndroidDeliveryData
- Tarih
- Veri
- MesajSonucuYüzdeleri
- TeslimatPerformansYüzdeleri
- MesajInsightPercents
- Dene!
Belirtilen Android uygulaması için toplu teslimat verilerini listeleyin.
HTTP isteği
GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData
URL, gRPC Kod Dönüştürme sözdizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
parent | Gerekli. Teslimat verilerinin listeleneceği uygulama. Biçim: |
Sorgu parametreleri
Parametreler | |
---|---|
pageSize | Döndürülecek maksimum giriş sayısı. Hizmet bu değerden daha azını döndürebilir. Belirtilmemişse en fazla 1.000 giriş döndürülecektir. Maksimum değer 10.000'dir; 10.000'in üzerindeki değerler 10.000 ile sınırlandırılacaktır. Bu varsayılan zaman içinde değişebilir. |
pageToken | Önceki bir |
Talep gövdesi
İstek gövdesi boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt gövdesi aşağıdaki yapıya sahip verileri içerir:
DeliveryData.list için yanıt mesajı.
JSON gösterimi |
---|
{
"androidDeliveryData": [
{
object ( |
Alanlar | |
---|---|
androidDeliveryData[] | Sağlanan uygulamaya ilişkin teslimat verileri. Uygulama, tarih ve analiz etiketi kombinasyonu başına bir giriş olacaktır. |
nextPageToken | Sonraki sayfayı almak için |
Yetki Kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
-
https://www.googleapis.com/auth/cloud-platform
AndroidDeliveryData
Belirli bir tarih, uygulama ve analiz etiketi kombinasyonu için mesaj teslim verileri.
JSON gösterimi |
---|
{ "appId": string, "date": { object ( |
Alanlar | |
---|---|
appId | Mesajların gönderildiği uygulama kimliği. |
date | Bu girişin temsil ettiği tarih. |
analyticsLabel | Gönderilen mesajlarla ilişkili analiz etiketi. Analiz etiketi olmadan gönderilen tüm iletiler tek bir girişte gruplandırılacaktır. |
data | Belirtilen |
Tarih
Doğum günü gibi tam veya kısmi bir takvim tarihini temsil eder. Günün saati ve saat dilimi ya başka bir yerde belirtilmiştir ya da önemsizdir. Tarih Gregoryen Takvimine göredir. Bu aşağıdakilerden birini temsil edebilir:
- Sıfır olmayan yıl, ay ve gün değerlerine sahip tam tarih.
- Sıfır yılı olan bir ay ve gün (örneğin, yıl dönümü).
- Sıfır ayı ve sıfır günü olan, başlı başına bir yıl.
- Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartının son kullanma tarihi).
İlgili türler:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
JSON gösterimi |
---|
{ "year": integer, "month": integer, "day": integer } |
Alanlar | |
---|---|
year | Tarihin yılı. Yıl olmadan bir tarih belirtmek için 1 ile 9999 arasında veya 0 olmalıdır. |
month | Bir yılın ayı. Ay ve gün olmadan yılı belirtmek için 1 ile 12 arasında veya 0 olmalıdır. |
day | Bir ayın günü. 1'den 31'e kadar olmalı ve yıl ve ay için geçerli olmalıdır veya tek başına bir yıl veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 olmalıdır. |
Veri
Mesajlaşma dağıtımını detaylandıran veriler
JSON gösterimi |
---|
{ "countMessagesAccepted": string, "messageOutcomePercents": { object ( |
Alanlar | |
---|---|
countMessagesAccepted | FCM tarafından Android cihazlara yönelik olarak kabul edilen mesajların sayısı. Hedeflenen cihazın kullanım ve teşhis bilgilerinin toplanmasına izin vermiş olması gerekir. |
messageOutcomePercents | Mesaj teslimi sonuçlarının birbirini dışlayan dökümü. |
deliveryPerformancePercents | Başarıyla teslim edilen iletilerin teslim performansı hakkında ek bilgi. |
messageInsightPercents | İleti teslimiyle ilgili ek genel bilgiler. |
MesajSonucuYüzdeleri
Mesaj teslim sonuçlarının yüzdesel dökümü. Bu kategoriler birbirini dışlar. Tüm yüzdeler payda olarak countMessagesAccepted
ile hesaplanır. Bu kategoriler tüm mesaj sonuçlarını hesaba katmayabilir.
JSON gösterimi |
---|
{ "delivered": number, "pending": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number } |
Alanlar | |
---|---|
delivered | Cihaza başarıyla teslim edilen tüm kabul edilen mesajların yüzdesi. |
pending | Cihaz bağlantısının kesilmesi nedeniyle (mesajın FCM'ye gönderildiği Amerika/Los_Angeles gününün sonu itibarıyla) bu günde kabul edilen ve bırakılmayan ve teslim edilmeyen mesajların yüzdesi. Bu mesajların bir kısmı ertesi gün cihaz bağlandığında iletilecek, ancak diğerleri bir daha asla yeniden bağlanmayacak cihazlara gönderilecek. |
droppedTooManyPendingMessages | Çok fazla teslim edilmemiş, daraltılamaz ileti nedeniyle reddedilen kabul edilen iletilerin yüzdesi. Spesifik olarak, her uygulama örneğinde, bağlantısı kesilen bir cihaz için sunucularımızda depolanan yalnızca 100 bekleyen mesaj bulunabilir. Bu cihaz yeniden bağlandığında bu mesajlar iletilir. Maksimum bekleyen mesaj sayısı aşıldığında mesajları iletmek yerine SDK'mızda OnDeletedMessages()' ı çağırırız. |
droppedAppForceStopped | Teslim sırasında uygulamanın cihazda zorla durdurulması ve yeniden denemelerin başarısız olması nedeniyle bırakılan kabul edilen mesajların yüzdesi. |
droppedDeviceInactive | Hedef cihazın etkin olmaması nedeniyle bırakılan kabul edilen mesajların yüzdesi. Hedef cihazın sunucularımız tarafından etkin olmadığı kabul edilirse FCM mesaj bırakacaktır. Bir cihaz yeniden bağlanırsa mesajları iletmek yerine SDK'mızda OnDeletedMessages() öğesini çağırırız. |
TeslimatPerformansYüzdeleri
Başarıyla teslim edilen mesajların teslim performansına genel bakış. Tüm yüzdeler payda olarak countMessagesAccepted
ile hesaplanır. Bu kategoriler birbirini dışlayan değildir; bir mesaj birçok nedenden dolayı gecikebilir.
JSON gösterimi |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
Alanlar | |
---|---|
deliveredNoDelay | FCM sisteminden gecikme olmadan cihaza teslim edilen kabul edilen mesajların yüzdesi. |
delayedDeviceOffline | Gönderme sırasında hedef cihazın bağlı olmaması nedeniyle geciken kabul edilen mesajların yüzdesi. Bu mesajlar sonunda cihaz yeniden bağlandığında iletildi. |
delayedDeviceDoze | Cihazın uyku modunda olması nedeniyle geciken kabul edilen mesajların yüzdesi. Doze modu nedeniyle yalnızca normal öncelikli mesajlar ertelenmelidir. |
delayedMessageThrottled | Daraltılabilir mesaj azaltma veya maksimum mesaj hızı azaltma gibi mesaj kısıtlama nedeniyle geciken kabul edilen mesajların yüzdesi. |
delayedUserStopped | Gönderilme sırasında amaçlanan cihaz kullanıcı profilinin hedef cihazda durdurulması nedeniyle geciken kabul edilen mesajların yüzdesi. Mesajlar sonunda kullanıcı profili yeniden başlatıldığında teslim edildi. |
MesajInsightPercents
İleti teslimi hakkında ek bilgi. Tüm yüzdeler payda olarak countMessagesAccepted
ile hesaplanır.
JSON gösterimi |
---|
{ "priorityLowered": number } |
Alanlar | |
---|---|
priorityLowered | Önceliği yüksekten normale düşürülen kabul edilen mesajların yüzdesi. Mesaj önceliğini ayarlamak için belgelere bakın. |