Aracılığıyla paylaş

Uygulama yükleyin

Belirli bir tarih aralığı ve diğer isteğe bağlı filtreler sırasında bir uygulamanın toplu yükleme verilerini JSON biçiminde almak için Microsoft Store analiz API'sinde bu yöntemi kullanın. Bu bilgiler İş Ortağı Merkezi'ndeki Alımlar raporunda da bulunur.

Önkoşullar

Bu yöntemi kullanmak için önce aşağıdakileri yapmanız gerekir:

  • Henüz yapmadıysanız Microsoft Store analiz API'si için tüm önkoşulları tamamlayın.
  • Bu yöntemin istek üst bilgisinde kullanmak üzere bir Azure AD erişim belirteci alın. Erişim belirtecini aldıktan sonra süresi dolmadan önce kullanmak için 60 dakikanız olur. Belirtecin süresi dolduktan sonra yenisini alabilirsiniz.

İstek

İstek söz dizimi

Yöntem İstenilen URI
ELDE ET https://manage.devcenter.microsoft.com/v1.0/my/analytics/installs

İstek başlığı

Başlık Türü Açıklama
İzin String Gerekli. Azure AD erişim belirteci Bearer<token> biçimindedir.

İstek parametreleri

Parametre Türü Açıklama Gerekli
applicationId (Uygulama Kimliği) String Yükleme verilerini almak istediğiniz uygulamanın Store Kimliği. Evet
başlangıçTarihi tarih Yükleme verilerinin alınacağı tarih aralığındaki başlangıç tarihi. Varsayılan değer geçerli tarihtir. Hayı
Bitiş Tarihi tarih Alınacak yükleme verilerinin tarih aralığındaki bitiş tarihi. Varsayılan değer geçerli tarihtir. Hayı
Üst Int İstekte döndürülecek veri satırlarının sayısı. En büyük değer ve belirtilmezse varsayılan değer 10000'dir. Sorguda daha fazla satır varsa, yanıt gövdesi bir sonraki veri sayfasını istemek için kullanabileceğiniz bir sonraki bağlantı içerir. Hayı
geçmek Int Sorguda atlanacak satırların sayısı. Büyük veri kümelerini sayfalandırmak için bu parametreyi kullanın. Örneğin, top=10000 ve skip=0 ilk 10000 veri satırını alır; top=10000 ve skip=10000 sonraki 10000 veri satırını alır, vb. Hayı
filtre String Bir veya daha fazla ifade, yanıtın satırlarını filtreler. Her ifade, yanıt gövdesindeki eq veya ne operatörleriyle ilişkili bir alan adı ve değer içerir ve ifadeler ve veya veya kullanılarak birleştirilebilir. Dize değerleri, filtresinin parametresinde tek tırnakla çevrelenmelidir. Yanıt gövdesinden aşağıdaki alanları belirtebilirsiniz:

  • pazar
  • İşletim Sistemi Sürümü
  • cihaz türü
  • paketVersiyonu
 Hayı
birleştirme seviyesi String Toplama verilerinin alındığı zaman aralığını belirtir. Şu dizelerden biri olabilir: gün, hafta veya ay. Belirtilmezse varsayılan gün olur. Hayı
sıralama String Her yükleme için sonuç veri değerlerini sıralayan bir deyim. Sözdizimi orderby=field [order],field [order],...şeklindedir. alan parametresi, yanıt gövdesinden aşağıdaki alanlardan biri olabilir:

  • applicationName (Uygulama Adı)
  • tarih
  • cihaz türü
  • pazar
  • İşletim Sistemi Sürümü
  • paketVersiyonu
  • başarılıKurulumSayısı

Order parametresi isteğe bağlıdır ve her alan için artan veya azalan düzen belirtmek için asc veya desc olabilir. Varsayılan değer asc'dir.

Aşağıda örnek bir orderby dizesi verilmiştir: orderby=date,market

 Hayı
Gruplandırma ölçütü String Yalnızca belirtilen alanlara veri toplama uygulayan bir deyim. Yanıt gövdesinden aşağıdaki alanları belirtebilirsiniz:

  • applicationName (Uygulama Adı)
  • tarih
  • cihaz türü
  • pazar
  • İşletim Sistemi Sürümü
  • paketVersiyonu

Döndürülen veri satırları groupby parametresinde belirtilen alanları ve aşağıdakileri içerir:

  • tarih
  • applicationId (Uygulama Kimliği)
  • başarılıKurulumSayısı

groupby parametresi aggregationLevel parametresiyle kullanılabilir. Örneğin: &groupby=ageGroup,market&aggregationLevel=week

 Hayı

 

Örnek talep

Aşağıdaki örnekte uygulama yükleme verilerini almaya yönelik çeşitli istekler gösterilmektedir. applicationId değerini uygulamanızın Mağaza Kimliği ile değiştirin.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/installs?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/installs?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

Yanıt

Yanıtın içeriği

Değer Türü Açıklama
Değer dizi Toplu yükleme verilerini içeren bir nesne dizisi. Her nesnedeki veriler hakkında daha fazla bilgi için aşağıdaki tabloya bakın.
@nextLink String Ek veri sayfaları varsa, bu dize sonraki veri sayfasını istemek için kullanabileceğiniz bir URI içerir. Örneğin, isteğin üst parametresi 10000 olarak ayarlanmışsa ancak sorgu için 10000'den fazla yükleme veri satırı varsa bu değer döndürülür.
ToplamSayı Int Sorgunun veri sonucundaki toplam satır sayısı.

Değer dizisindeki öğeler aşağıdaki değerleri içerir.

Değer Türü Açıklama
tarih String Yükleme verilerinin tarih aralığındaki ilk tarih. İstek tek bir gün belirttiyse, bu değer bu tarihtir. İstek bir hafta, ay veya başka bir tarih aralığı belirttiyse, bu değer bu tarih aralığındaki ilk tarihtir.
applicationId (Uygulama Kimliği) String Yükleme verilerini almakta olduğunuz uygulamanın Mağaza Kimliği.
uygulama adı String Uygulamanın ekran adı.
cihazTürü String Yüklemeyi tamamlayan cihaz türünü belirten aşağıdaki dizelerden biri:

  • Kişisel bilgisayar
  • Telefon
  • Konsol-Xbox One
  • Konsol-Xbox Serisi X
  • Çok
  • Holografik
  • Bilinmiyor
paket sürümü String Yüklenen paketin sürümü.
işletim sistemiSürümü String Yüklemenin gerçekleştiği işletim sistemi sürümünü belirten aşağıdaki dizelerden biri:

  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • pencereler 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Bilinmiyor
pazar String Yüklemenin gerçekleştiği pazarın ISO 3166 ülke kodu.
başarılıYüklemeSayısı Numara Belirtilen toplama düzeyi sırasında gerçekleşen başarılı yüklemelerin sayısı.

İstek ve Yanıt örneği

Aşağıdaki kod parçacıkları, bu istek için bazı örnek istek ve JSON yanıt gövdesini gösterir.

Örnek İstek

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/installs?applicationId=9WZDNCRFJB4P
HTTP/1.1
Authorization: Bearer <your access token>

Örnek Yanıt

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "successfulInstallCount": 100053
        }
    ],
    "TotalCount": 1
}

Örnek İstek

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/installs?applicationId=9NBLGGGZ5QDR&aggregationLevel=day&startDate=06/19/2022&endDate=07/21/2022&top=10&skip=0&groupby=applicationName,date,deviceType,market,osVersion,packageVersion&orderby=date desc
HTTP/1.1
Authorization: Bearer <your access token>

Örnek Yanıt

{
    "Value": [
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "AR",
            "osVersion": "Windows 10",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "AU",
            "osVersion": "Windows 10",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "BD",
            "osVersion": "Windows 10",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "BG",
            "osVersion": "Windows 11",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "BO",
            "osVersion": "Windows 10",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "BR",
            "osVersion": "Windows 10",
            "successfulInstallCount": 6
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "BR",
            "osVersion": "Windows 11",
            "successfulInstallCount": 3
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "CA",
            "osVersion": "Windows 11",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "CN",
            "osVersion": "Windows 11",
            "successfulInstallCount": 1
        },
        {
            "date": "2022-07-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "packageVersion": "2013.1206.10.2936",
            "deviceType": "PC",
            "market": "MX",
            "osVersion": "Windows 10",
            "successfulInstallCount": 1
        }
    ],
    "TotalCount": 10
}
  • Raporu yükler
  • Microsoft Store hizmetlerini kullanarak analiz verilerine erişme