Freigeben über

„AdControl“ in XAML und .NET

  • Artikel

Warnung

Ab dem 1. Juni 2020 wird die Microsoft Ad Monetization-Plattform für Windows UWP-Apps abgeschaltet. Weitere Informationen

In dieser exemplarischen Vorgehensweise wird gezeigt, wie Sie die AdControl-Klasse zum Anzeigen von Banneranzeigen in einer XAML-App für Universelle Windows-Plattform (UWP) für Windows 10 oder Windows 11 verwenden, die mit C# implementiert wird.

Hinweis

Die Microsoft Advertising-SDK unterstützt auch XAML-Apps, die mit C++ implementiert werden. Ein vollständiges Beispielprojekt finden Sie in den Werbebeispielen auf GitHub.

Voraussetzungen

Integrieren einer Banneranzeige in Ihre App

  1. Öffnen Sie in Visual Studio Ihr Projekt, oder erstellen Sie ein neues Projekt.

    Hinweis

    Wenn Sie ein vorhandenes Projekt verwenden, öffnen Sie die Datei "Package.appxmanifest" in Ihrem Projekt, und stellen Sie sicher, dass die Internetfunktion (Client) ausgewählt ist. Ihre App benötigt diese Funktion, um Testanzeigen und Liveanzeigen zu erhalten.

  2. Wenn Ihr Projekt auf eine beliebige CPU ausgerichtet ist, aktualisieren Sie Ihr Projekt so, dass eine architekturspezifische Buildausgabe verwendet wird (z. B. x86). Wenn Ihr Projekt auf "Any CPU" ausgerichtet ist, können Sie in den folgenden Schritten keinen Verweis auf die Microsoft Advertising-Bibliothek hinzufügen. Weitere Informationen finden Sie unter Referenzfehler, die durch die Ausrichtung von Any CPU in Ihrem Projekt verursacht werden.

  3. Fügen Sie einen Verweis auf die Microsoft Advertising-SDK in Ihrem Projekt hinzu:

    1. Klicken Sie im fenster Projektmappen-Explorer mit der rechten Maustaste auf "Verweise", und wählen Sie "Verweis hinzufügen" aus...
    2. Erweitern Sie im Verweis-Manager universelles Windows, klicken Sie auf Erweiterungen, und aktivieren Sie dann das Kontrollkästchen neben Microsoft Advertising-SDK für XAML (Version 10.0).
    3. Klicken Sie im Verweis-Manager auf "OK".

  4. Ändern Sie den XAML-Code für die Seite, auf der Sie Werbung einbetten, um den Namespace "Microsoft.Advertising.WinRT.UI " einzuschließen. In der standardbeispiel-App, die von Visual Studio generiert wird (in dieser App "MyAdFundedWindows10AppXAML"), lautet die XAML-Seite "MainPage.XAML".

    Der Von Visual Studio generierte Abschnitt "Page " der Datei "MainPage.xaml" weist den folgenden Code auf.

    <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>

    Fügen Sie den Namespaceverweis "Microsoft.Advertising.WinRT.UI" hinzu, damit der Abschnitt "Page " der Datei "MainPage.xaml" den folgenden Code aufweist.

    <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. Fügen Sie im Grid-Tag den Code für adControl hinzu. Weisen Sie die AdUnitId - und ApplicationId-Eigenschaften den Werten der Testanzeigeeinheit zu. Passen Sie auch die Höhe und Breite des Steuerelements an, sodass es eine der unterstützten Anzeigengrößen für Banneranzeigen ist.

    Hinweis

    Jedes AdControl verfügt über eine entsprechende Anzeigeneinheit , die von unseren Diensten verwendet wird, um Anzeigen an das Steuerelement zu stellen, und jede Anzeigeneinheit besteht aus einer Anzeigeneinheits-ID und Anwendungs-ID. In diesen Schritten weisen Sie Ihrem Steuerelement Testanzeigeneinheits-ID und Anwendungs-ID-Werte zu. Diese Testwerte können nur in einer Testversion Ihrer App verwendet werden. Bevor Sie Ihre App im Store veröffentlichen, müssen Sie diese Testwerte durch Livewerte aus Partner Center ersetzen.

    Das vollständige Grid-Tag sieht wie dieser Code aus.

    <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
    <UI:AdControl ApplicationId="00001111-aaaa-2222-bbbb-3333cccc4444"
        AdUnitId="test"
        HorizontalAlignment="Left"
        Height="250"
        VerticalAlignment="Top"
        Width="300"/>
</Grid>

    Der vollständige Code für die Datei "MainPage.xaml" sollte wie folgt aussehen.

    <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="00001111-aaaa-2222-bbbb-3333cccc4444"
              AdUnitId="test"
              HorizontalAlignment="Left"
              Height="250"
              VerticalAlignment="Top"
              Width="300"/>
  </Grid>
</Page>

  6. Kompilieren Sie die App, und führen Sie sie aus, um sie mit einer Anzeige anzuzeigen.

Veröffentlichen Ihrer App mit Liveanzeigen

  1. Stellen Sie sicher, dass Ihre Verwendung von Banneranzeigen in Ihrer App unsere Richtlinien für Banneranzeigen befolgt.

  2. Wechseln Sie im Partner Center zur Seite "In-App-Anzeigen ", und erstellen Sie eine Anzeigeneinheit. Geben Sie für den Anzeigeneinheitstyp Banner an. Notieren Sie sich sowohl die Anzeigeneinheits-ID als auch die Anwendungs-ID.

    Hinweis

    Die Anwendungs-ID-Werte für Testanzeigeeinheiten und Live-UWP-Anzeigeneinheiten weisen unterschiedliche Formate auf. Testanwendungs-ID-Werte sind GUIDs. Wenn Sie eine Live-UWP-Anzeigeneinheit im Partner Center erstellen, entspricht der Anwendungs-ID-Wert für die Anzeigeneinheit immer der Store-ID für Ihre App (ein Beispiel für den Store-ID-Wert sieht wie 9NBLGGH4R315 aus).

  3. Sie können optional die Anzeigenvermittlung für adControl aktivieren, indem Sie die Einstellungen im Abschnitt "Vermittlungseinstellungen" auf der Seite "In-App-Anzeigen" konfigurieren. Mit der Anzeigenvermittlung können Sie Ihre Werbeeinnahmen und App-Werbungsfunktionen maximieren, indem Sie Anzeigen aus mehreren Anzeigennetzwerken anzeigen, einschließlich Anzeigen aus anderen kostenpflichtigen Anzeigennetzwerken wie Taboola und Smaato und Anzeigen für Microsoft-App-Werbekampagnen.

  4. Ersetzen Sie in Ihrem Code die Testanzeigeneinheitswerte (ApplicationId und AdUnitId) durch die Livewerte, die Sie im Partner Center generiert haben.

  5. Übermitteln Sie Ihre App über das Partner Center an den Store.

  6. Überprüfen Sie Ihre Anzeigenleistungsberichte im Partner Center.

Verwalten von Anzeigeneinheiten für mehrere Anzeigensteuerelemente in Ihrer App

Sie können mehrere AdControl-Objekte in einer einzelnen App verwenden (beispielsweise kann jede Seite in Ihrer App ein anderes AdControl-Objekt hosten). In diesem Szenario wird empfohlen, jedem Steuerelement eine andere Anzeigeneinheit zuzuweisen. Durch die Verwendung unterschiedlicher Anzeigeneinheiten für jedes Steuerelement können Sie die Vermittlungseinstellungen separat konfigurieren und diskrete Berichtsdaten für jedes Steuerelement abrufen. Dies ermöglicht es unseren Diensten auch, die Werbung, die wir ihrer App anbieten, besser zu optimieren.

Wichtig

Sie können jede Anzeigeneinheit nur in einer App verwenden. Wenn Sie eine Anzeigeneinheit in mehr als einer App verwenden, werden Anzeigen für diese Anzeigeneinheit nicht bereitgestellt.