Bagikan melalui

AdControl di XAML dan .NET

  • Artikel

Peringatan

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

Panduan ini menunjukkan cara menggunakan kelas AdControl untuk menampilkan iklan banner di aplikasi XAML Platform Windows Universal (UWP) untuk Windows 10 atau Windows 11 yang diimplementasikan menggunakan C#.

Catatan

Microsoft Advertising SDK juga mendukung aplikasi XAML yang diimplementasikan menggunakan C++. Untuk proyek sampel lengkap, lihat sampel iklan di GitHub.

Prasyarat

Mengintegrasikan iklan banner ke dalam aplikasi Anda

  1. Di Visual Studio, buka proyek Anda atau buat proyek baru.

    Catatan

    Jika Anda menggunakan proyek yang sudah ada, buka file Package.appxmanifest di proyek Anda dan pastikan bahwa kemampuan Internet (Klien) dipilih. Aplikasi Anda memerlukan kemampuan ini untuk menerima iklan pengujian dan iklan langsung.

  2. 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 pustaka iklan Microsoft dalam langkah-langkah berikut. Untuk informasi selengkapnya, lihat Kesalahan referensi yang disebabkan oleh menargetkan CPU apa pun dalam proyek Anda.

  3. Tambahkan referensi ke Microsoft Advertising SDK di proyek Anda:

    1. Dari jendela Penjelajah Solusi, klik kanan Referensi, dan pilih Tambahkan Referensi...
    2. Di Pengelola Referensi, perluas Universal Windows, klik Ekstensi, lalu pilih kotak centang di samping Microsoft Advertising SDK untuk XAML (Versi 10.0).
    3. Di Manajer Referensi, klik OK.

  4. Ubah XAML untuk halaman tempat Anda menyematkan iklan untuk menyertakan namespace Microsoft.Advertising.WinRT.UI . Misalnya, dalam aplikasi sampel default yang dihasilkan oleh Visual Studio (bernama, dalam aplikasi ini, MyAdFundedWindows10AppXAML), halaman XAML adalah MainPage.XAML.

    Bagian Halaman dari file MainPage.xaml yang dihasilkan oleh Visual Studio memiliki kode berikut.

    <Page
  x:Class="MyAdFundedWindows10AppXAML.MainPage"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:local="using:MyAdFundedWindows10AppXAML"
  xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  mc:Ignorable="d">
  <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
  </Grid>
</Page>

    Tambahkan referensi namespace Microsoft.Advertising.WinRT.UI sehingga bagian Halaman dari file MainPage.xaml memiliki kode berikut.

    <Page
  x:Class="MyAdFundedWindows10AppXAML.MainPage"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:local="using:MyAdFundedWindows10AppXAML"
  xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  xmlns:UI="using:Microsoft.Advertising.WinRT.UI"
  mc:Ignorable="d">
  <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
  </Grid>
</Page>

  5. Di tag Grid, tambahkan kode untuk AdControl. Tetapkan properti AdUnitId dan ApplicationId ke nilai unit iklan pengujian. Sesuaikan juga Tinggi dan Lebar kontrol sehingga merupakan salah satu ukuran iklan yang didukung untuk iklan banner.

    Catatan

    Setiap AdControl memiliki unit iklan terkait yang digunakan oleh layanan kami untuk menayangkan iklan ke kontrol, dan setiap unit iklan terdiri dari ID unit iklan dan ID aplikasi. Dalam langkah-langkah ini, Anda menetapkan nilai ID unit iklan pengujian dan ID aplikasi ke kontrol Anda. Nilai pengujian ini hanya dapat digunakan dalam versi pengujian aplikasi Anda. Sebelum memublikasikan aplikasi ke Store, Anda harus mengganti nilai pengujian ini dengan nilai langsung dari Pusat Mitra.

    Tag Grid lengkap terlihat seperti kode ini.

    <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
    <UI:AdControl ApplicationId="3f83fe91-d6be-434d-a0ae-7351c5a997f1"
        AdUnitId="test"
        HorizontalAlignment="Left"
        Height="250"
        VerticalAlignment="Top"
        Width="300"/>
</Grid>

    Kode lengkap untuk file MainPage.xaml akan terlihat seperti ini.

    <Page
  x:Class="MyAdFundedWindows10AppXAML.MainPage"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:local="using:MyAdFundedWindows10AppXAML"
  xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  xmlns:UI="using:Microsoft.Advertising.WinRT.UI"
  mc:Ignorable="d">
  <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
        <UI:AdControl ApplicationId="3f83fe91-d6be-434d-a0ae-7351c5a997f1"
              AdUnitId="test"
              HorizontalAlignment="Left"
              Height="250"
              VerticalAlignment="Top"
              Width="300"/>
  </Grid>
</Page>

  6. Kompilasi dan jalankan aplikasi untuk melihatnya dengan iklan.

Merilis aplikasi Anda dengan iklan langsung

  1. Pastikan penggunaan iklan banner di aplikasi Anda mengikuti panduan kami untuk iklan banner.

  2. Di Pusat Mitra, buka halaman Iklan dalam aplikasi dan buat unit iklan. Untuk jenis unit iklan, tentukan Banner. Catat ID unit iklan dan ID aplikasi.

    Catatan

    Nilai ID aplikasi untuk unit iklan pengujian dan unit iklan UWP langsung memiliki format yang berbeda. Nilai ID aplikasi pengujian adalah GUID. Saat Anda membuat unit iklan UWP langsung di Pusat Mitra, nilai ID aplikasi untuk unit iklan selalu cocok dengan ID Toko untuk aplikasi Anda (contoh nilai ID Toko terlihat seperti 9NBLGGH4R315).

  3. Anda dapat mengaktifkan mediasi iklan secara opsional untuk AdControl dengan mengonfigurasi pengaturan di bagian Pengaturan mediasi di halaman Iklan dalam aplikasi. Mediasi iklan memungkinkan Anda memaksimalkan kemampuan pendapatan iklan dan promosi aplikasi dengan menampilkan iklan dari beberapa jaringan iklan, termasuk iklan dari jaringan iklan berbayar lainnya seperti Taboola dan Smaato dan iklan untuk kampanye promosi aplikasi Microsoft.

  4. Dalam kode Anda, ganti nilai unit iklan pengujian (ApplicationId dan AdUnitId) dengan nilai langsung yang Anda buat di Pusat Mitra.

  5. Kirimkan aplikasi Anda ke Toko menggunakan Pusat Mitra.

  6. Tinjau laporan performa iklan Anda di Pusat Mitra.

Mengelola unit iklan untuk beberapa kontrol iklan di aplikasi Anda

Anda dapat menggunakan beberapa objek AdControl dalam satu aplikasi (misalnya, setiap halaman di aplikasi Anda mungkin menghosting objek AdControl yang berbeda). Dalam skenario ini, kami sarankan Anda menetapkan unit iklan yang berbeda untuk setiap kontrol. Menggunakan unit iklan yang berbeda untuk setiap kontrol memungkinkan Anda mengonfigurasi pengaturan mediasi secara terpisah dan mendapatkan data pelaporan diskrit untuk setiap kontrol. Ini juga memungkinkan layanan kami untuk mengoptimalkan iklan yang kami sajikan dengan lebih baik ke aplikasi Anda.

Penting

Anda hanya dapat menggunakan setiap unit iklan dalam satu aplikasi. Jika Anda menggunakan unit iklan di lebih dari satu aplikasi, iklan tidak akan ditayangkan untuk unit iklan tersebut.