Bagikan melalui

Mendapatkan data corong akuisisi aplikasi

  • Artikel

Gunakan metode ini di API analitik Microsoft Store untuk mendapatkan data corong akuisisi 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 ACTIVE Directory untuk digunakan di header permintaan untuk metode ini. Setelah mendapatkan token akses, Anda memiliki waktu 60 menit untuk menggunakan token akses sebelum masa berlakunya habis. Setelah token kedaluwarsa, Anda dapat memperoleh yang baru.

Minta

Minta sintaks

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

Header permintaan

Header Tipe Deskripsi
Authorization string Harus diisi. Token akses Microsoft Azure ACTIVE Directory dalam bentuk token> Pembawa<.

Parameter permintaan

Parameter Jenis Deskripsi Wajib diisi
applicationId string ID Toko aplikasi yang ingin Anda ambil data corong akuisisinya. Contoh ID Penyimpanan adalah 9WZDNCRFJ3Q8. Ya
startDate date Tanggal mulai dalam rentang tanggal data corong akuisisi untuk diambil. Defaultnya adalah tanggal saat ini. No
endDate date Tanggal akhir dalam rentang tanggal data corong akuisisi untuk diambil. Defaultnya adalah tanggal saat ini. No
filter string Satu atau beberapa pernyataan yang memfilter baris dalam respons. Untuk informasi selengkapnya, lihat bagian bidang filter di bawah ini. No

 

Memfilter bidang

Parameter filter permintaan berisi satu atau beberapa pernyataan yang memfilter baris dalam respons. Setiap pernyataan berisi bidang dan nilai yang terkait dengan operator eq atau ne , dan pernyataan dapat digabungkan menggunakan dan atau atau.

Bidang filter berikut ini didukung. Nilai string harus dikelilingi oleh tanda kutip tunggal dalam parameter filter .

Bidang Deskripsi
campaignId String ID untuk kampanye promosi aplikasi kustom yang terkait dengan akuisisi.
market String yang berisi kode negara ISO 3166 dari pasar tempat akuisisi terjadi.
deviceType Salah satu string berikut yang menentukan jenis perangkat tempat akuisisi terjadi:
  • Komputer mikro
  • Nomor
  • Console-Xbox One
  • Console-Xbox Series X
  • IoT
  • Holografik
  • Tidak diketahui
ageGroup Salah satu string berikut yang menentukan kelompok usia pengguna yang menyelesaikan akuisisi:
  • 0 – 17
  • 18 – 24
  • 25 – 34
  • 35 – 49
  • 50 atau lebih
  • Tidak diketahui
gender Salah satu string berikut yang menentukan jenis kelamin pengguna yang menyelesaikan akuisisi:
  • M
  • F
  • Tidak diketahui

Contoh permintaan

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

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

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

Respons

Isi respons

Nilai Tipe Deskripsi
Nilai array Array objek yang berisi data corong akuisisi untuk aplikasi. Untuk informasi selengkapnya tentang data di setiap objek, lihat bagian nilai corong di bawah ini.
TotalCount int Jumlah total objek dalam array Nilai .

Nilai corong

Objek dalam array Nilai berisi nilai berikut.

Nilai Tipe Deskripsi
MetricType string Salah satu string berikut yang menentukan jenis data corong yang disertakan dalam objek ini:
  • Tampilan Halaman
  • Akuisisi
  • Pemasangan
  • Penggunaan
UserCount string Jumlah pengguna yang melakukan langkah corong yang ditentukan oleh nilai MetricType .

Contoh Permintaan dan Respons

Cuplikan kode berikut menunjukkan beberapa contoh permintaan dan isi respons JSON untuk permintaan tersebut.

Permintaan Sampel

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

Respons Sampel

{
    "Value": [
        {
            "MetricType": "PageView",
            "UserCount": 6214
        },
        {
            "MetricType": "Acquisition",
            "UserCount": 1502
        },
        {
            "MetricType": "Usage",
            "UserCount": 606
        },
        {
            "MetricType": "Install",
            "UserCount": 977
        }
    ],
    "TotalCount": 4
}

Permintaan Sampel

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=12/19/2021&endDate=12/21/2021&filter=market eq 'US' and gender eq 'm'
HTTP/1.1
Authorization: Bearer <your access token>

Respons Sampel

{
    "Value": [
        {
            "MetricType": "PageView",
            "UserCount": 10
        },
        {
            "MetricType": "Acquisition",
            "UserCount": 8
        },
        {
            "MetricType": "Usage",
            "UserCount": 5
        },
        {
            "MetricType": "Install",
            "UserCount": 3
        }
    ],
    "TotalCount": 4
}