Mendapatkan konversi aplikasi menurut saluran

  • Artikel

Gunakan metode ini di API analitik Microsoft Store untuk mendapatkan konversi agregat berdasarkan saluran untuk aplikasi selama rentang tanggal tertentu dan filter opsional lainnya.

  • Konversi berarti bahwa pelanggan (masuk dengan akun Microsoft) baru saja mendapatkan lisensi ke aplikasi Anda (baik Anda menagih uang atau Anda telah menawarkannya secara gratis).
  • Saluran adalah metode di mana pelanggan tiba di halaman daftar aplikasi Anda (misalnya, melalui Toko atau kampanye promosi aplikasi kustom).

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.

Permintaan

Minta sintaks

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

Header permintaan

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

Parameter permintaan

Parameter Jenis Deskripsi Wajib diisi
applicationId string ID Penyimpanan aplikasi yang ingin Anda ambil data konversinya. Contoh ID Penyimpanan adalah 9WZDNCRFJ3Q8. Ya
startDate date Tanggal mulai dalam rentang tanggal data konversi untuk diambil. Defaultnya adalah 1/1/2016. No
endDate date Tanggal akhir dalam rentang tanggal data konversi yang akan diambil. Defaultnya adalah tanggal saat ini. No
atas 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, isi respons menyertakan tautan berikutnya yang bisa Anda gunakan untuk meminta halaman data berikutnya. No
skip int Jumlah baris yang akan dilewati dalam kueri. Gunakan parameter ini untuk halaman melalui himpunan data besar. Misalnya, top=10000 dan skip=0 mengambil 10000 baris data pertama, top=10000 dan skip=10000 mengambil 10000 baris data berikutnya, dan sebagainya. No
filter string Satu atau beberapa pernyataan yang memfilter isi respons. Setiap pernyataan dapat menggunakan operator eq atau ne , dan pernyataan dapat digabungkan menggunakan dan atau atau. Anda dapat menentukan string berikut dalam pernyataan filter. Untuk deskripsi, lihat bagian nilai konversi di artikel ini.
  • applicationName
  • appType
  • customCampaignId
  • refererUriDomain
  • channelType
  • storeClient
  • deviceType
  • Pasar

Berikut adalah contoh parameter filter : filter=deviceType eq 'PC'.

 No
agregasiLevel string Menentukan rentang waktu untuk mengambil data agregat. Dapat berupa salah satu string berikut: hari, minggu, atau bulan. Jika tidak ditentukan, defaultnya adalah hari. No
urut berdasarkan string Pernyataan yang mengurutkan nilai data hasil untuk setiap konversi. Sintaksnya adalah orderby=field [order],field [order],.... Parameter bidang dapat berupa salah satu string berikut:
  • date
  • applicationName
  • appType
  • customCampaignId
  • refererUriDomain
  • channelType
  • storeClient
  • deviceType
  • Pasar

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

Berikut adalah contoh string orderby : orderby=date,market

 No
groupby string Pernyataan yang menerapkan agregasi data hanya ke bidang yang ditentukan. Anda dapat menentukan bidang berikut:
  • date
  • applicationName
  • appType
  • customCampaignId
  • refererUriDomain
  • channelType
  • storeClient
  • deviceType
  • Pasar

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

  • date
  • applicationId
  • conversionCount
  • klikCount

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

 No

Contoh permintaan

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

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

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

Respons

Isi respons

Value Jenis Deskripsi
Value array Array objek yang berisi data konversi agregat untuk aplikasi. Untuk informasi selengkapnya tentang data di setiap objek, lihat bagian nilai konversi 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 10 tetapi ada lebih dari 10 baris data konversi untuk kueri.
TotalCount int Jumlah total baris dalam hasil data untuk kueri.

Nilai konversi

Objek dalam array Nilai berisi nilai berikut.

Value Jenis Deskripsi
date string Tanggal pertama dalam rentang tanggal untuk data konversi. Jika permintaan menentukan satu hari, nilai ini adalah tanggal tersebut. Jika permintaan yang ditentukan minggu, bulan, atau rentang tanggal lainnya, nilai ini adalah tanggal pertama dalam rentang tanggal tersebut.
applicationId string ID Penyimpanan aplikasi tempat Anda mengambil data konversi.
applicationName string Nama tampilan aplikasi tempat Anda mengambil data konversi.
appType string Jenis produk yang Anda ambil data konversinya. Untuk metode ini, satu-satunya nilai yang didukung adalah Aplikasi.
customCampaignId string String ID untuk kampanye promosi aplikasi kustom yang terkait dengan aplikasi.
refererUriDomain string Menentukan domain tempat daftar aplikasi dengan ID kampanye promosi aplikasi kustom diaktifkan.
channelType string Salah satu string berikut yang menentukan saluran untuk konversi:
  • CustomCampaignId
  • Menyimpan Lalu Lintas
  • Lainnya
storeClient string Versi Penyimpanan tempat konversi terjadi. Saat ini, satu-satunya nilai yang didukung adalah SFC.
deviceType string Salah satu string berikut:
  • PC
  • Nomor
  • Console-Xbox One
  • Console-Xbox Series X
  • IoT
  • Holografik
  • Tidak diketahui
market string Kode negara ISO 3166 dari pasar tempat konversi terjadi.
klikCount number Jumlah klik pelanggan pada tautan daftar aplikasi Anda.
conversionCount number Jumlah konversi pelanggan.

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/appchannelconversions?applicationId=9NBLGGGZ5QDR&startDate=06/23/2022&endDate=07/21/2022&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

Respons Sampel

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "clickCount": 3089,
            "conversionCount": 14
        }
    ],
    "@nextLink": "",
    "TotalCount": 1
}

Permintaan Sampel

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appchannelconversions?applicationId=9NBLGGGZ5QDR&startDate=06/19/2022&endDate=07/21/2022&skip=0&groupby=date,applicationName,customCampaignId,referrerUriDomain,channelType,storeClient,deviceType,market&filter=market eq 'US'
HTTP/1.1
Authorization: Bearer <your access token>

Respons Sampel

{
    "Value": [
        {
            "date": "2022-06-19",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "",
            "referrerUriDomain": "Universal Client Store",
            "channelType": "Store Traffic",
            "storeClient": "SFC",
            "deviceType": "PC",
            "market": "US",
            "clickCount": 13,
            "conversionCount": 0
        },
        {
            "date": "2022-06-20",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "",
            "referrerUriDomain": "Universal Client Store",
            "channelType": "Store Traffic",
            "storeClient": "SFC",
            "deviceType": "PC",
            "market": "US",
            "clickCount": 6,
            "conversionCount": 0
        },
        {
            "date": "2022-06-21",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "",
            "referrerUriDomain": "Universal Client Store",
            "channelType": "Store Traffic",
            "storeClient": "SFC",
            "deviceType": "PC",
            "market": "US",
            "clickCount": 4,
            "conversionCount": 0
        },
        {
            "date": "2022-06-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "",
            "referrerUriDomain": "Universal Client Store",
            "channelType": "Store Traffic",
            "storeClient": "SFC",
            "deviceType": "PC",
            "market": "US",
            "clickCount": 4,
            "conversionCount": 0
        },
    ],
    "@nextLink": "",
    "TotalCount": 4
}