Melibatkan pelanggan dengan Microsoft Store Services SDK

  • Artikel

Microsoft Store Services SDK menyediakan fitur yang membantu Anda berinteraksi dengan pelanggan di aplikasi Platform Windows Universal (UWP), seperti mengirim pemberitahuan yang ditargetkan ke aplikasi Anda dan menjalankan eksperimen A/B di aplikasi Anda. SDK ini adalah ekstensi untuk Visual Studio 2015 dan versi Visual Studio yang lebih baru.

Catatan

Untuk menampilkan iklan di aplikasi UWP Anda, gunakan Microsoft Advertising SDK alih-alih Microsoft Store Services SDK. Pustaka iklan telah dipindahkan dari Microsoft Store Services SDK ke Microsoft Advertising SDK. Untuk informasi selengkapnya, lihat Menampilkan iklan di aplikasi Anda.

Skenario yang didukung oleh Microsoft Store Services SDK

Microsoft Store Services SDK saat ini mendukung skenario berikut untuk aplikasi UWP. Untuk dokumentasi referensi API, lihat Referensi MICROSOFT Store Services SDK API.

Skenario Deskripsi
Menjalankan eksperimen di aplikasi UWP Anda dengan pengujian A/B Jalankan pengujian A/B di aplikasi Platform Windows Universal (UWP) Anda untuk mengukur efektivitas fitur pada beberapa pelanggan sebelum Anda merilis fitur kepada semua orang. Setelah Anda menentukan eksperimen di Pusat Mitra, gunakan kelas StoreServicesExperimentVariation untuk mendapatkan variasi untuk eksperimen Anda di aplikasi Anda, gunakan data ini untuk memodifikasi perilaku fitur yang Anda uji, lalu gunakan metode LogForVariation untuk mengirim peristiwa tampilan dan konversi ke Pusat Mitra. Terakhir, gunakan Pusat Mitra untuk melihat hasilnya dan mengelola eksperimen.
Luncurkan Hub Umpan Balik dari aplikasi UWP Anda Gunakan kelas StoreServicesFeedbackLauncher di aplikasi UWP Anda untuk mengarahkan pelanggan Windows 10 dan Windows 11 Anda ke Feedback Hub, tempat mereka dapat mengirimkan masalah, saran, dan upvot. Kemudian, kelola umpan balik ini dalam laporan Umpan Balik di Pusat Mitra.
Mengonfigurasi aplikasi UWP Anda untuk menerima pemberitahuan push Pusat Mitra Gunakan kelas StoreServicesEngagementManager di aplikasi UWP Anda untuk mendaftarkan aplikasi Anda guna menerima pemberitahuan push yang ditargetkan yang Anda kirimkan kepada pelanggan menggunakan Pusat Mitra.
Mencatat peristiwa kustom di aplikasi UWP Anda untuk laporan Penggunaan di Pusat Mitra Gunakan kelas StoreServicesCustomEventLogger di aplikasi UWP Anda untuk mencatat peristiwa kustom yang terkait dengan aplikasi Anda di Pusat Mitra. Kemudian, tinjau total kemunculan untuk peristiwa kustom Anda di bagian Peristiwa kustom dari laporan Penggunaan di Pusat Mitra.

Prasyarat

Microsoft Store Services SDK memerlukan:

  • Visual Studio 2015 atau versi yang lebih baru.
  • Alat Visual Studio untuk Aplikasi Windows Universal terinstal dengan versi Visual Studio Anda.

Pemasangan SDK

Ada dua opsi untuk menginstal Microsoft Store Services SDK di komputer pengembangan Anda:

  • Alat penginstal MSI Anda dapat menginstal SDK melalui alat penginstal MSI yang tersedia di sini.
  • Paket NuGet Anda dapat menginstal SDK sebagai paket NuGet.

Microsoft secara berkala merilis versi baru Microsoft Store Services SDK dengan peningkatan performa dan fitur baru. Jika Anda memiliki proyek yang sudah ada yang menggunakan SDK dan ingin menggunakan versi terbaru, unduh dan instal versi terbaru SDK di komputer pengembangan Anda.

Menginstal melalui MSI

Untuk menginstal Microsoft Store Services SDK melalui alat penginstal MSI:

  1. Tutup semua instans Visual Studio.

  2. Jika sebelumnya Anda menginstal ekstensi Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK, atau Ad Mediator, hapus instalan SDK ini sekarang. Secara opsional, buka jendela Prompt Perintah dan jalankan perintah ini untuk membersihkan versi SDK lama yang mungkin telah diinstal dengan Visual Studio, tetapi yang mungkin tidak muncul dalam daftar program yang diinstal di komputer Anda:

    MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}

  3. Unduh dan instal Microsoft Store Services SDK. Mungkin perlu waktu beberapa menit untuk menginstal. Pastikan dan tunggu hingga proses selesai.

  4. Mulai Visual Studio.

  5. Jika Anda memiliki proyek yang sudah ada yang mereferensikan pustaka dari versi SDK Microsoft Store Services yang lebih lama, Microsoft Advertising SDK, Universal Ad Client SDK, atau Microsoft Store Engagement and Monetization SDK, kami sarankan Anda membuka proyek Anda di Visual Studio dan membersihkan dan membangun kembali proyek Anda (di Penjelajah Solusi, klik kanan simpul proyek Anda dan pilih Bersihkan, lalu klik kanan simpul proyek Anda lagi dan pilih Bangun kembali).

Jika tidak, jika Anda menggunakan SDK untuk pertama kalinya dalam proyek Anda, Anda sekarang siap untuk menambahkan referensi perakitan ke proyek Anda.

Instal melalui NuGet

Untuk menginstal pustaka Microsoft Store Services SDK melalui NuGet:

  1. Tutup semua instans Visual Studio.

  2. Jika sebelumnya Anda menginstal ekstensi Microsoft Store Engagement and Monetization SDK, Universal Ad Client SDK, atau Ad Mediator, hapus instalan SDK ini sekarang. Secara opsional, buka jendela Prompt Perintah dan jalankan perintah ini untuk membersihkan versi SDK lama yang mungkin telah diinstal dengan Visual Studio, tetapi yang mungkin tidak muncul dalam daftar program yang diinstal di komputer Anda:

    MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}

  3. Mulai Visual Studio dan buka proyek tempat Anda ingin menggunakan Microsoft Store Services SDK.

    Catatan

    Jika proyek Anda sudah menyertakan referensi pustaka dari penginstalan MSI SDK sebelumnya, hapus referensi ini dari proyek Anda. Referensi ini akan memiliki ikon peringatan di sampingnya karena pustaka yang mereka referensikan dihapus di langkah-langkah sebelumnya.

  4. Di Visual Studio, klik Proyek dan Kelola Paket NuGet.

  5. Dalam kotak pencarian, ketik Microsoft.Services.Store.Engagement dan instal paket Microsoft.Services.Store.Engagement. Ketika paket selesai diinstal, simpan solusi Anda.

    Catatan

    Jika jendela Output melaporkan kesalahan Install-Package yang menunjukkan jalur yang ditentukan terlalu panjang, Anda mungkin perlu mengonfigurasi NuGet untuk mengekstrak paket ke lokasi alternatif dengan jalur yang lebih pendek daripada lokasi default. Untuk melakukan ini, tambahkan repositoryPath nilai ke file nuget.config di komputer Anda dan tetapkan ke jalur folder singkat tempat paket NuGet dapat diekstrak. Untuk informasi selengkapnya, lihat artikel ini di dokumentasi NuGet. Atau, Anda dapat mencoba memindahkan proyek Visual Studio ke folder alternatif dengan jalur yang lebih pendek. Masalahnya juga dapat disebabkan oleh jalur paket global Anda terlalu panjang. Dalam hal ini, tambahkan nilai ke globalPackagesFolder dalam file nuget.config Anda.

  6. Tutup solusi Visual Studio yang berisi proyek Anda lalu buka kembali solusinya.

  7. Jika proyek Anda sudah mereferensikan pustaka dari versi SDK Microsoft Store Services yang lebih lama yang diinstal melalui NuGet dan Anda telah memperbarui proyek Anda ke rilis SDK yang lebih baru, kami sarankan Anda membersihkan dan membangun kembali proyek Anda (di Penjelajah Solusi, klik kanan simpul proyek Anda dan pilih Bersihkan, lalu klik kanan simpul proyek Anda lagi dan pilih Bangun kembali).

Jika tidak, jika Anda menggunakan SDK untuk pertama kalinya dalam proyek Anda, Anda sekarang siap untuk menambahkan referensi perakitan ke proyek Anda.

Menambahkan referensi perakitan ke proyek Anda

Setelah Anda menginstal Microsoft Store Services SDK melalui alat penginstal MSI atau NuGet, ikuti instruksi ini untuk mereferensikan rakitan SDK di proyek UWP Anda.

  1. Buka proyek Anda di Visual Studio.

    Catatan

    Jika proyek Anda adalah aplikasi JavaScript yang menargetkan CPU apa pun, perbarui proyek Anda untuk menggunakan output build khusus arsitektur (misalnya, x86).

  2. Di Penjelajah Solusi, klik kanan Referensi dan pilih Tambahkan Referensi...

  3. Di Pengelola Referensi, perluas Universal Windows, klik Ekstensi, lalu pilih kotak centang di samping Microsoft Engagement Framework. Ini memungkinkan Anda menggunakan API di namespace Microsoft.Services.Store.Engagement .

  4. Klik OK.

Catatan

Jika Anda menginstal pustaka SDK melalui NuGet, proyek Anda akan berisi referensi Microsoft.Services.Store.Engagement . Referensi Microsoft.Services.Store.Engagement mewakili paket NuGet (bukan pustaka di dalamnya), dan Anda dapat mengabaikannya.

Memahami paket kerangka kerja di SDK

Pustaka Microsoft.Services.Store.Engagement.dll di Microsoft Store Services SDK dikonfigurasi sebagai paket kerangka kerja. Pustaka ini berisi API di namespace Microsoft.Services.Store.Engagement .

Karena pustaka ini adalah paket kerangka kerja, ini berarti bahwa setelah pengguna menginstal versi aplikasi Anda yang menggunakan pustaka ini, pustaka ini secara otomatis diperbarui di perangkat mereka melalui Windows Update setiap kali kami menerbitkan versi baru pustaka dengan perbaikan dan peningkatan performa. Ini membantu memastikan bahwa pelanggan Anda selalu memiliki versi pustaka terbaru yang tersedia yang diinstal di perangkat mereka.

Jika kami merilis versi baru SDK yang memperkenalkan API atau fitur baru di pustaka ini, Anda harus menginstal versi terbaru SDK untuk menggunakan fitur tersebut. Dalam skenario ini, Anda juga perlu memublikasikan aplikasi yang diperbarui ke Store.