Bagikan melalui

Menginstal Microsoft Advertising SDK

  • Artikel

Peringatan

Mulai 1 Juni 2020, platform Monetisasi Microsoft Ad untuk aplikasi Windows UWP akan dimatikan. Pelajari lebih lanjut

Untuk menampilkan iklan di aplikasi UWP Anda untuk Windows 10 dan Windows 11, instal Microsoft Advertising SDK. SDK ini adalah ekstensi untuk Visual Studio 2015 dan versi yang lebih baru.

Catatan

Jika Anda mengembangkan aplikasi UWP JavaScript/HTML dan telah menginstal Windows 10 SDK versi 10.0.14393 (Pembaruan Hari Jadi) atau yang lebih baru, Anda juga harus menginstal pustaka WinJS . Pustaka ini digunakan untuk disertakan dalam versi Windows 10 SDK sebelumnya, tetapi dimulai dengan Windows 10 SDK versi 10.0.14393 (Pembaruan Peringatan) pustaka ini harus diinstal secara terpisah.

Menginstal melalui MSI

Untuk menginstal Microsoft Advertising SDK melalui alat penginstal MSI:

  1. Tutup semua instans Visual Studio.

  2. Jika sebelumnya Anda menginstal versi Microsoft Advertising SDK, Universal Ad Client SDK, ekstensi Ad Mediator, atau Microsoft Store Engagement and Monetization SDK sebelumnya, hapus instalan versi SDK ini sekarang. Secara opsional, buka jendela Prompt Perintah dan jalankan perintah ini untuk membersihkan versi SDK iklan 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 Advertising SDK. Mungkin perlu 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 iklan dari versi Microsoft Advertising SDK sebelumnya, 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 (dalam 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 Microsoft Advertising SDK untuk pertama kalinya dalam proyek Anda, Anda sekarang siap untuk menambahkan referensi ke Microsoft Advertising SDK.

Menginstal melalui NuGet

Untuk menginstal Microsoft Advertising SDK dalam proyek UWP tertentu melalui NuGet:

  1. Tutup semua instans Visual Studio.

  2. Jika sebelumnya Anda menginstal versi Microsoft Advertising SDK, Universal Ad Client SDK, ekstensi Ad Mediator, atau Microsoft Store Engagement and Monetization SDK sebelumnya, hapus instalan versi SDK ini sekarang. Secara opsional, buka jendela Prompt Perintah dan jalankan perintah ini untuk membersihkan versi SDK iklan 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 Advertising 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.Advertising.XAML (untuk proyek XAML) atau Microsoft.Advertising.JS (untuk proyek JavaScript/HTML) dan instal paket yang sesuai. 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 pendek tempat paket NuGet dapat diekstrak. Untuk informasi selengkapnya, lihat artikel ini dalam dokumentasi NuGet. Atau, Anda dapat mencoba memindahkan proyek Visual Studio ke folder alternatif dengan jalur yang lebih pendek.

  6. Tutup solusi Anda lalu buka kembali.

  7. Jika proyek Anda sudah mereferensikan pustaka dari versi Microsoft Advertising SDK sebelumnya 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 (dalam 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 sekarang siap untuk menambahkan referensi ke Microsoft Advertising SDK.

Menambahkan referensi ke Microsoft Advertising SDK

Setelah Menginstal Microsoft Advertising SDK, ikuti petunjuk berikut untuk mereferensikan SDK di proyek Anda sehingga Anda dapat menggunakan API iklan.

  1. Buka proyek Anda di Visual Studio.

    Catatan

    Jika proyek Anda menargetkan CPU Apa pun, perbarui proyek Anda untuk menggunakan output build khusus arsitektur (misalnya, x86). Jika proyek Anda menargetkan CPU Apa pun, Anda tidak akan berhasil menambahkan referensi ke Microsoft Advertising SDK dalam langkah-langkah berikut. Untuk informasi selengkapnya, lihat Kesalahan referensi yang disebabkan oleh menargetkan CPU apa pun dalam proyek Anda.

  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 Advertising SDK untuk XAML (untuk aplikasi XAML) atau Microsoft Advertising SDK for JavaScript (untuk aplikasi yang dibuat menggunakan JavaScript dan HTML).

  4. Di Manajer Referensi, klik OK.

Untuk panduan yang menunjukkan cara mulai menggunakan API iklan, lihat artikel berikut ini:

Memahami paket kerangka kerja di Microsoft Advertising SDK

Pustaka Microsoft.Advertising.dll di Microsoft Advertising SDK (untuk aplikasi UWP) dikonfigurasi sebagai paket kerangka kerja. Pustaka ini berisi API iklan di namespace Microsoft.Advertising dan Microsoft.Advertising.WinRT.UI .

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 terinstal 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 menerbitkan aplikasi yang diperbarui ke Store.