Dapatkan akuisisi aplikasi

Gunakan metode ini di API analitik Microsoft Store untuk mendapatkan data akuisisi agregat dalam format JSON untuk aplikasi selama rentang tanggal tertentu dan filter opsional lainnya. Informasi ini juga tersedia dalam laporan Akuisisi di Pusat Mitra.

Prasyarat

Untuk menggunakan metode ini, Anda harus terlebih dahulu melakukan hal berikut:

  • Jika Anda belum melakukannya, selesaikan semua prasyarat untuk API analitik Microsoft Store.
  • Dapatkan token akses Azure AD untuk digunakan di header permintaan untuk metode ini. Setelah mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakannya sebelum masa berlakunya habis. Setelah token kedaluwarsa, Anda bisa mendapatkan yang baru.

Minta

Minta sintaks

Metode URI Permintaan
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions

Header permintaan

Header Jenis Deskripsi
Authorization string Wajib diisi. Token akses Azure AD dalam bentuk Bearertoken<>.

Parameter permintaan

Parameter Jenis Deskripsi Diperlukan
applicationId string ID Toko aplikasi tempat Anda ingin mengambil data akuisisi. Ya
startDate tanggal Tanggal mulai dalam rentang tanggal data akuisisi untuk diambil. Defaultnya adalah tanggal saat ini. Tidak
endDate tanggal Tanggal akhir dalam rentang tanggal data akuisisi untuk diambil. Defaultnya adalah tanggal saat ini. Tidak
top int Jumlah baris data yang akan dikembalikan dalam permintaan. Nilai maksimum dan nilai default jika tidak ditentukan adalah 10000. Jika ada lebih banyak baris dalam kueri, badan respons menyertakan tautan berikutnya yang dapat Anda gunakan untuk meminta halaman data berikutnya. Tidak
skip int Jumlah baris yang akan dilewati dalam kueri. Gunakan parameter ini untuk halaman melalui kumpulan data besar. Misalnya, top=10000 dan skip=0 mengambil 10000 baris data pertama, top=10000 dan skip=10000 mengambil 10000 baris data berikutnya, dan seterusnya. Tidak
filter string Satu atau beberapa pernyataan yang memfilter baris dalam respons. Setiap pernyataan berisi nama bidang dari badan respons dan nilai yang terkait dengan operator eq atau ne , dan pernyataan dapat digabungkan menggunakan dan atau atau atau. Nilai string harus dikelilingi oleh tanda kutip tunggal dalam parameter filter . Misalnya, filter=market eq 'US' dan gender eq 'm'.

Anda dapat menentukan bidang berikut dari badan respons:

  • acquisitionType
  • ageGroup
  • storeClient
  • jenis kelamin
  • pasar
  • osVersion
  • deviceType
  • orderName
Tidak
tingkat agregasi string Menentukan rentang waktu untuk mengambil data agregat. Bisa menjadi salah satu string berikut: hari, minggu, atau bulan. Jika tidak ditentukan, default adalah hari. Tidak
orderby string Pernyataan yang memerintahkan nilai data hasil untuk setiap akuisisi. Sintaksnya adalah orderby=field [order],field [order],.... Parameter bidang dapat menjadi salah satu string berikut:
  • date
  • acquisitionType
  • ageGroup
  • storeClient
  • jenis kelamin
  • pasar
  • osVersion
  • deviceType
  • orderName

Parameter urutan bersifat opsional, dan dapat asc atau desc untuk menentukan urutan naik atau turun untuk setiap bidang. Defaultnya adalah ASC.

Berikut adalah contoh string orderby : orderby=date,market

Tidak
groupby string Pernyataan yang menerapkan agregasi data hanya ke bidang yang ditentukan. Anda dapat menentukan bidang berikut:
  • date
  • applicationName
  • acquisitionType
  • ageGroup
  • storeClient
  • jenis kelamin
  • pasar
  • osVersion
  • deviceType
  • orderName

Baris data yang dikembalikan akan berisi bidang yang ditentukan dalam parameter groupby serta yang berikut:

  • date
  • applicationId
  • akuisisiQuantity

Parameter groupby dapat digunakan dengan parameter aggregationLevel . Misalnya: &groupby=ageGroup,marketaggregationLevel&=week

Tidak

Contoh permintaan

Contoh berikut menunjukkan beberapa permintaan untuk mendapatkan data akuisisi aplikasi. Ganti nilai applicationId dengan ID Toko untuk aplikasi Anda.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?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/appacquisitions?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and gender eq 'm'  HTTP/1.1
Authorization: Bearer <your access token>

Respons

Isi respons

Nilai Jenis Deskripsi
Nilai array Array objek yang berisi data akuisisi agregat untuk aplikasi. Untuk informasi selengkapnya tentang data di setiap objek, lihat bagian nilai akuisisi di bawah ini.
@nextLink string Jika ada halaman data tambahan, string ini berisi URI yang dapat Anda gunakan untuk meminta halaman data berikutnya. Misalnya, nilai ini dikembalikan jika parameter teratas permintaan diatur ke 10000 tetapi ada lebih dari 10000 baris data akuisisi untuk kueri.
Jumlah Total int Jumlah total baris dalam hasil data untuk kueri.

Nilai akuisisi

Elemen dalam array Nilai berisi nilai berikut.

Nilai Jenis Deskripsi
tanggal string Tanggal pertama dalam rentang tanggal untuk data akuisisi. Jika permintaan ditentukan satu hari, nilai ini adalah tanggal tersebut. Jika permintaan ditentukan dalam rentang minggu, bulan, atau tanggal lainnya, nilai ini adalah tanggal pertama dalam rentang tanggal tersebut.
applicationId string ID Toko aplikasi tempat Anda mengambil data akuisisi.
applicationName string Nama tampilan aplikasi.
deviceType string Salah satu string berikut yang menentukan jenis perangkat tempat akuisisi terjadi:
  • PC
  • Telepon
  • Xbox One Konsol
  • Xbox Series X Konsol
  • IoT
  • Holografik
  • Tidak dikenal
orderName string Nama pesanan.
storeClient string Salah satu string berikut yang menunjukkan versi Store tempat akuisisi terjadi:
  • Toko Windows Phone (klien)
  • Microsoft Store (klien) (atau Windows Store (klien) jika meminta data sebelum 23 Maret 2018)
  • Microsoft Store (web) (atau Windows Store (web) jika meminta data sebelum 23 Maret 2018)
  • Pembelian volume oleh organisasi
  • Lainnya
osVersion string Salah satu string berikut yang menentukan versi OS tempat akuisisi terjadi:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Tidak dikenal
market string Kode negara ISO 3166 dari pasar tempat akuisisi terjadi.
jenis kelamin string Salah satu string berikut yang menentukan jenis kelamin pengguna yang melakukan akuisisi:
  • m
  • f
  • Tidak dikenal
ageGroup string Salah satu string berikut yang menentukan kelompok usia pengguna yang melakukan akuisisi:
  • Kurang dari 13
  • 13-17
  • 18-24
  • 25-34
  • 35-44
  • 44-55
  • Lebih besar dari 55
  • Tidak dikenal
acquisitionType string Salah satu string berikut yang menunjukkan jenis akuisisi:
  • Gratis
  • Percobaan
  • Berbayar
  • Kode promosi
  • Iap
  • Iap Berlangganan
  • Audiens Pribadi
  • Pre-order
  • Xbox Game Pass (atau Game Pass jika meminta data sebelum 23 Maret 2018)
  • Disk
  • Kode Prabayar
akuisisiQuantity number Jumlah akuisisi yang terjadi selama tingkat agregasi yang ditentukan.

Contoh respons

Contoh berikut menunjukkan contoh badan respons JSON untuk permintaan ini.

{
  "Value": [
    {
      "date": "2016-02-01",
      "applicationId": "9NBLGGGZ5QDR",
      "applicationName": "Contoso Demo",
      "deviceType": "Phone",
      "orderName": "",
      "storeClient": "Windows Phone Store (client)",
      "osVersion": "Windows Phone 8.1",
      "market": "IT",
      "gender": "m",
      "ageGroup": "0-17",
      "acquisitionType": "Free",
      "acquisitionQuantity": 1
    }
  ],
  "@nextLink": "appacquisitions?applicationId=9NBLGGGZ5QDR&aggregationLevel=day&startDate=2015/01/01&endDate=2016/02/01&top=1&skip=1&orderby=date desc",
  "TotalCount": 466766
}