- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek gövdesi
- Yanıt gövdesi
- Yetkilendirme kapsamları
- AndroidDeliveryData
- Tarih
- Veriler
- MessageResultPercents (Mesaj Sonucu Yüzdeleri)
- DeliveryPerformancePercents
- MessageInsightPercent'lar:
- Proxy NotificationInsightPercent
- Deneyin
Belirli bir Android uygulaması için toplu teslim verilerini listeleme.
HTTP isteği
GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
parent |
Zorunlu. Teslim verilerinin listeleneceği uygulama. Biçim: |
Sorgu parametreleri
Parametreler | |
---|---|
pageSize |
Döndürülecek maksimum giriş sayısı. Hizmet bu değerden daha az bir değer döndürebilir. Belirtilmezse en fazla 1.000 giriş döndürülür. Maksimum değer 10.000'dir; 10.000'in üzerindeki değerler 10.000 ile sınırlanır. Bu varsayılan ayar zaman içinde değişebilir. |
pageToken |
Önceki |
İstek içeriği
İsteğin gövdesi boş olmalıdır.
Yanıt gövdesi
deliveryData.list için yanıt mesajı.
Başarılı olursa yanıt gövdesi aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"androidDeliveryData": [
{
object ( |
Alanlar | |
---|---|
androidDeliveryData[] |
Sağlanan uygulama için yayınlanma verileri. Her uygulama, tarih ve analiz etiketi kombinasyonu için bir giriş olur. |
nextPageToken |
Sonraki sayfayı almak için |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/cloud-platform
AndroidTeslimat Verileri
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 iletilerle ilişkili analiz etiketi. Analytics etiketi olmadan gönderilen tüm iletiler tek bir girişte gruplandırılır. |
data |
Belirtilen |
Tarih
Takvimin tamamını veya bir kısmını temsil eder (ör. doğum günü). Günün saati ve saat dilimi başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:
- Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih.
- Bir ay ve gün ile sıfır yıl (örneğin, bir yıl dönümü).
- Tek başına bir yıl, sıfır ay ve sıfır gün.
- Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartı 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ı. 1 ile 9999 arasında veya yıl içermeyen bir tarihi belirtmek için 0 arasında olmalıdır. |
month |
Bir yılın ayı. 1 ile 12 arasında veya ay ve gün içermeyen bir yılı belirtmek için 0 arasında olmalıdır. |
day |
Ayın günü. 1 ile 31 arasında bir değer olmalı ve yıl ve ay için geçerlidir. Yalnızca yılı belirtmek için 0 değerini veya günün önemli olmadığı bir yılı ve ayı belirtmek için 0 değerini girin. |
Veriler
Mesaj teslimini ayrıntılarıyla gösteren veriler
JSON gösterimi |
---|
{ "countMessagesAccepted": string, "countNotificationsAccepted": string, "messageOutcomePercents": { object ( |
Alanlar | |
---|---|
countMessagesAccepted |
FCM tarafından kabul edilen Android cihazlara yönelik mesajların sayısı. Hedeflenen cihazda, kullanım ve teşhis bilgilerinin toplanması özelliği etkinleştirilmiş olmalıdır. |
countNotificationsAccepted |
FCM tarafından kabul edilen Android cihazlara yönelik bildirimlerin sayısı. Hedeflenen cihazda, kullanım ve teşhis bilgilerinin toplanması özelliği etkinleştirilmiş olmalıdır. |
messageOutcomePercents |
İleti teslimi sonuçlarının ayrı ayrı dökümü. |
deliveryPerformancePercents |
Başarıyla teslim edilen iletilerin teslim performansı hakkında ek bilgi. |
messageInsightPercents |
İleti teslimi hakkında ek genel bilgiler. |
proxyNotificationInsightPercents |
Proxy bildirim teslimi hakkında ek bilgiler. |
Mesaj Sonucu Yüzdeleri
İleti teslimi sonuçlarının yüzde dökümü. Bu kategoriler birlikte kullanılamaz. Tüm yüzdeler payda olarak countMessagesAccepted
ile hesaplanır. Bu kategoriler tüm ileti sonuçlarını kapsamayabilir.
JSON gösterimi |
---|
{ "delivered": number, "pending": number, "collapsed": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number, "droppedTtlExpired": number } |
Alanlar | |
---|---|
delivered |
Kabul edilen ve cihaza başarıyla teslim edilen tüm mesajların yüzdesi. |
pending |
Cihazın bağlantısı kesildiği için bu gün kabul edilen ancak gönderilmeyen ve teslim edilmeyen mesajların yüzdesi (mesajın FCM'ye gönderildiği Amerika/Los_Angeles gününün sonu itibarıyla). Bu mesajların bir kısmı, ertesi gün cihaz bağlandığında teslim edilir, ancak bazıları daha sonra hiç yeniden bağlanmayan cihazlara gitmeyi tercih edebilir. |
collapsed |
Kabul edilen ve başka bir ileti tarafından daraltılan iletilerin yüzdesi. |
droppedTooManyPendingMessages |
Teslim edilmeyen çok sayıda daraltılamayan ileti nedeniyle atlanan kabul edilmiş iletilerin yüzdesi. Daha açık belirtmek gerekirse, bağlantısı kesilen bir cihaz için her uygulama örneğinin sunucularımızda yalnızca 100 bekleyen mesajı olabilir. Söz konusu cihaz yeniden bağlandığında bu mesajlar teslim edilir. Bekleyen maksimum mesaj sayısından daha fazla mesaj varsa mesajları iletmek yerine SDK'mızda On deletedMessages() çağrısını yaparız. |
droppedAppForceStopped |
Teslim sırasında uygulamanın cihazda zorla durdurulması ve yeniden denemelerin başarısız olması nedeniyle bırakılan kabul edilmiş mesajların yüzdesi. |
droppedDeviceInactive |
Hedef cihaz etkin olmadığı için kaldırılan, kabul edilmiş mesajların yüzdesi. Sunucularımız hedef cihazın etkin olmadığını belirlerse FCM, mesajları kaldırır. Bir cihaz yeniden bağlanırsa mesajları iletmek yerine SDK'mızda On deletedMessages() çağrısını yaparız. |
droppedTtlExpired |
Hedef cihaz yeniden bağlanmadan önce Geçerlilik Süresi (TTL) geçen kabul edilen mesajların yüzdesi. |
DeliveryPerformancePercents
Başarıyla teslim edilen iletilerin teslim performansına genel bakış. Tüm yüzdeler payda olarak countMessagesAccepted
ile hesaplanır. Bu kategoriler aynı anda kullanılabilir; bir ileti birçok nedenden dolayı gecikebilir.
JSON gösterimi |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
Alanlar | |
---|---|
deliveredNoDelay |
FCM sisteminden cihaza gecikme olmadan teslim edilen kabul edilmiş mesajların yüzdesi. |
delayedDeviceOffline |
Gönderildiği sırada hedef cihaz bağlı olmadığı için geciken kabul edilen mesajların yüzdesi. Bu mesajlar sonunda cihaz yeniden bağlandığında teslim edildi. |
delayedDeviceDoze |
Cihaz doz modunda olduğu için geciken kabul edilen mesajların yüzdesi. Doz modu nedeniyle yalnızca normal öncelikli mesajlar gecikmelidir. |
delayedMessageThrottled |
Daraltılabilir ileti kısıtlama veya maksimum ileti hızı kısıtlama gibi ileti kısıtlama nedeniyle geciken kabul edilen iletilerin yüzdesi. |
delayedUserStopped |
Hedeflenen cihaz kullanıcı profili gönderme sırasında hedef cihazda durdurulduğu için geciken kabul edilmiş mesajların yüzdesi. Mesajlar sonuçta kullanıcı profili yeniden başlatıldığında teslim edilmiştir. |
Mesaj Analizi Yüzdeleri
İleti teslimi hakkında ek bilgiler. Tüm yüzdeler payda olarak countMessagesAccepted
ile hesaplanır.
JSON gösterimi |
---|
{ "priorityLowered": number } |
Alanlar | |
---|---|
priorityLowered |
Kabul edilmiş, öncelik düzeyi yüksekten normale düşürülmüş iletilerin yüzdesi. İleti önceliğini ayarlamayla ilgili dokümanlara göz atın. |
ProxyBildirimInsightYüzdeleri
Proxy bildiriminin gönderilmesi hakkında ek bilgi. Tüm yüzdeler payda olarak countNotificationsAccepted
ile hesaplanır.
JSON gösterimi |
---|
{ "proxied": number, "failed": number, "skippedUnsupported": number, "skippedNotThrottled": number, "skippedUnconfigured": number, "skippedOptedOut": number } |
Alanlar | |
---|---|
proxied |
Google Play hizmetleri tarafından başarıyla proxy'den alınan kabul edilen bildirimlerin yüzdesi. |
failed |
Kabul edilen ve proxy kullanılamayan bildirimlerin yüzdesi. Bu durum genellikle notifyAsPackage çağrılırken oluşan istisnalardan kaynaklanır. |
skippedUnsupported |
Alıcı için proxy bildirimi desteklenmediğinden atlanan, kabul edilen bildirimlerin yüzdesi. |
skippedNotThrottled |
Mesajlar kısıtlanmadığı için atlanan kabul edilen bildirimlerin yüzdesi. |
skippedUnconfigured |
Bildirimlerin proxy tarafından kullanılması için gereken yapılandırmalar eksik olduğundan atlanan kabul edilen bildirimlerin yüzdesi. |
skippedOptedOut |
Uygulama, bu mesajlarda proxy kullanılmasına izin vermediği için atlanan kabul edilen bildirimlerin yüzdesi. |