- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- AndroidDeliveryData
- Tarih
- Veri
- MessageResultPercents
- DeliveryPerformancePercents
- MessageInsightPercents
- ProxyNotificationInsightPercents
- Deneyin
Belirli bir Android uygulaması için toplu yayınlama 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. İletim verilerinin listeleneceği uygulama. Biçim: |
Sorgu parametreleri
Parametreler | |
---|---|
pageSize |
Döndürülecek maksimum giriş sayısı. Hizmet bu değerden daha az sonuç döndürebilir. Belirtilmemesi durumunda en fazla 1.000 giriş döndürülür. Maksimum değer 10.000'dir; 10.000'den büyük değerler 10.000 ile sınırlanır. Bu varsayılan ayar zamanla 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 gönderim verileri. Her uygulama, tarih ve analiz etiketi kombinasyonu için bir giriş olacaktır. |
nextPageToken |
Sonraki sayfayı almak için |
Yetkilendirme 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 ileti teslimi 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 analytics etiketi. Analytics etiketi olmadan gönderilen tüm iletiler tek bir girişte gruplandırılı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 başka bir yerde belirtilmiş veya önemsiz. Tarih, Miladi Takvim ile görelidir. Bu, aşağıdakilerden birini temsil edebilir:
- Sıfır olmayan yıl, ay ve gün değerleriyle 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 olmak üzere tek başına bir yıl.
- 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 tarih belirtmek için 0 olmalıdır. |
month |
Yılın ayı. 1 ile 12 arasında veya ay ve gün içermeyen bir yılı belirtmek için 0 olmalıdır. |
day |
Ayın günü. 1 ile 31 arasında olup yıl ve ay için geçerli olmalıdır. Yılın tek başına olduğu yıl ya da günün önemli olmadığı yıl ve ay belirtilmelidir. |
Veriler
Mesajlaşmayı ayrıntılı olarak açıklayan veriler
JSON gösterimi |
---|
{ "countMessagesAccepted": string, "countNotificationsAccepted": string, "messageOutcomePercents": { object ( |
Alanlar | |
---|---|
countMessagesAccepted |
FCM tarafından Android cihazlara yönelik olarak kabul edilen iletilerin sayısı. Hedeflenen cihaz, kullanım ve teşhis bilgilerinin toplanmasını etkinleştirmiş olmalıdır. |
countNotificationsAccepted |
FCM tarafından Android cihazlar için kabul edilen bildirimlerin sayısı. Hedeflenen cihaz, kullanım ve teşhis bilgilerinin toplanmasını etkinleştirmiş olmalıdır. |
messageOutcomePercents |
İleti teslimi sonuçlarının karşılıklı olarak hariç tutulduğu 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 Sonuçları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 mesaj sonuçlarını kapsamayabilir.
JSON gösterimi |
---|
{ "delivered": number, "pending": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number } |
Alanlar | |
---|---|
delivered |
Kabul edilen ve cihaza başarıyla teslim edilen tüm iletilerin yüzdesi. |
pending |
Söz konusu günde kabul edilen ancak cihazın bağlantısının kesildiği için iptal edilmeyen ve teslim edilmeyen iletilerin yüzdesi (iletinin FCM'ye gönderildiği Amerika/Los_Angeles gününün sonu itibarıyla). Bu mesajların bir kısmı, cihaz bağlandığında ertesi gün teslim edilir. Diğerleri ise nihayetinde hiçbir zaman yeniden bağlanmayan cihazlara gönderilmiş olabilir. |
droppedTooManyPendingMessages |
Teslim edilmeyen çok fazla daraltılamayan ileti nedeniyle bırakılan, kabul edilen iletilerin yüzdesi. Daha açık belirtecek olursak, bağlantısı kesilen bir cihaz için her uygulama örneğinin sunucularımızda depolanan 100 bekleyen mesajı olabilir. Cihaz yeniden bağlandığında bu mesajlar teslim edilir. Bekleyen mesaj sayısı üst sınırından fazla olduğunda, SDK'mızda mesajları iletmek yerine OnDeletedMessages() yöntemini çağırırız. |
droppedAppForceStopped |
Teslim sırasında uygulama cihazda zorla durdurulduğu ve yeniden denemeler başarısız olduğu için bırakılan, kabul edilen iletilerin yüzdesi. |
droppedDeviceInactive |
Kabul edilen ve hedef cihaz etkin olmadığı için bırakılan mesajların yüzdesi. Hedef cihazın sunucularımız tarafından etkin olmadığı kabul edilirse FCM, mesajları bırakır. Bir cihaz yeniden bağlanırsa mesajları iletmek yerine SDK'mızda On deletedMessages() yöntemini çağırırız. |
DeliveryPerformancePercents
Başarıyla teslim edilen iletilerin teslim performansına genel bakış. Tüm yüzdeler, payda olarak countMessagesAccepted
ile hesaplanır. Bu kategoriler birlikte kullanılamaz. Bir iletide birden çok nedenden dolayı gecikme yaşanabilir.
JSON gösterimi |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
Alanlar | |
---|---|
deliveredNoDelay |
FCM sisteminden gecikme olmadan cihaza teslim edilen, kabul edilmiş iletilerin yüzdesi. |
delayedDeviceOffline |
Gönderme sırasında hedef cihaz bağlı olmadığı için geciken, kabul edilmiş iletilerin yüzdesi. Bu mesajlar, cihaz yeniden bağlandığında sonunda teslim edildi. |
delayedDeviceDoze |
Kabul edilen ve cihaz doz modunda olduğu için geciken mesajların yüzdesi. Doz modu nedeniyle yalnızca normal öncelikli iletiler gecikmelidir. |
delayedMessageThrottled |
Kabul edilen ve ileti kısıtlama (ör. daraltılabilir ileti kısıtlama veya maksimum ileti hızı kısıtlama) nedeniyle geciken iletilerin yüzdesi. |
delayedUserStopped |
Gönderme sırasında, hedeflenen cihaz kullanıcı profili hedef cihazda durdurulduğu için geciken, kabul edilen iletilerin yüzdesi. İletiler, kullanıcı profili yeniden başlatıldığında sonunda teslim edildi. |
Mesaj AnaliziYüzdeleri
İleti teslimi hakkında ek bilgi. Tüm yüzdeler, payda olarak countMessagesAccepted
ile hesaplanır.
JSON gösterimi |
---|
{ "priorityLowered": number } |
Alanlar | |
---|---|
priorityLowered |
Kabul edilmiş ve önceliği yüksekten normale düşmüş olan iletilerin yüzdesi. İleti önceliğini ayarlama dokümanlarına bakın. |
ProxyBildirimiYüzdeleri
Proxy bildirim teslimi 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 kullanılarak gönderilen, kabul edilen bildirimlerin yüzdesi. |
failed |
Proxy kullanılamayan, kabul edilen 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 kabul edilen ve atlanan bildirimlerin yüzdesi. |
skippedNotThrottled |
İletiler kısıtlanmadığı için atlanan, kabul edilmiş bildirimlerin yüzdesi. |
skippedUnconfigured |
Bildirimlerin proxy kullanılarak kullanılabilmesi için gereken yapılandırmalar eksik olduğundan atlanan, kabul edilen bildirimlerin yüzdesi. |
skippedOptedOut |
Uygulama bu iletilere proxy kullanılmasına izin vermediği için atlanan, kabul edilen bildirimlerin yüzdesi. |