AdControl en XAML et .NET

Cette procédure pas à pas montre comment utiliser la classe AdControl pour afficher des bannières publicitaires dans une application XAML plateforme Windows universelle (UWP) pour Windows 10 ou Windows 11 implémentée à l’aide de C#.

Prérequis

• Installez le SDK Microsoft Advertising avec Visual Studio 2015 ou une version ultérieure de Visual Studio. Pour obtenir des instructions d’installation, consultez cet article.

Intégrer une bannière publicitaire à votre application

1. Dans Visual Studio, ouvrez votre projet ou créez un projet.

   Remarque

   Si vous utilisez un projet existant, ouvrez le fichier Package.appxmanifest dans votre projet et vérifiez que la fonctionnalité Internet (client) est sélectionnée. Votre application a besoin de cette fonctionnalité pour recevoir des publicités de test et des publicités en direct.

2. Si votre projet cible n’importe quel processeur, mettez à jour votre projet pour utiliser une sortie de build spécifique à l’architecture (par exemple, x86). Si votre projet cible n’importe quel processeur, vous ne pourrez pas ajouter une référence à la bibliothèque de publicités Microsoft dans les étapes suivantes. Pour plus d’informations, consultez Les erreurs de référence provoquées par le ciblage de n’importe quel processeur dans votre projet.

3. Ajoutez une référence au SDK Microsoft Advertising dans votre projet :

   1. Dans la fenêtre Explorateur de solutions, cliquez avec le bouton droit sur Références, puis sélectionnez Ajouter une référence...
   2. Dans le Gestionnaire de références, développez Windows universel, cliquez sur Extensions, puis cochez la case en regard de SDK Microsoft Advertising pour XAML (version 10.0).
   3. Dans le Gestionnaire de références, cliquez sur OK.

4. Modifiez le code XAML de la page dans laquelle vous incorporez la publicité pour inclure l’espace de noms Microsoft.Advertising.WinRT.UI . Par exemple, dans l’exemple d’application par défaut généré par Visual Studio (nommé, dans cette application, MyAdFundedWindows10AppXAML), la page XAML est MainPage.XAML.

   La section Page du fichier MainPage.xaml généré par Visual Studio contient le code suivant.

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

   Ajoutez la référence d’espace de noms Microsoft.Advertising.WinRT.UI afin que la section Page du fichier MainPage.xaml possède le code suivant.

   <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. Dans la balise Grid , ajoutez le code pour AdControl. Affectez les propriétés AdUnitId et ApplicationId aux valeurs d’unité publicitaire de test. Ajustez également la hauteur et la largeur du contrôle afin qu’il s’agit de l’une des tailles de publicité prises en charge pour les bannières publicitaires.

   Remarque

   Chaque adControl a une unité publicitaire correspondante utilisée par nos services pour distribuer des publicités au contrôle, et chaque unité publicitaire se compose d’un ID d’unité publicitaire et d’un ID d’application. Dans ces étapes, vous affectez l’ID d’unité publicitaire de test et les valeurs d’ID d’application à votre contrôle. Ces valeurs de test ne peuvent être utilisées que dans une version de test de votre application. Avant de publier votre application dans le Windows Store, vous devez remplacer ces valeurs de test par des valeurs actives à partir de l’Espace partenaires.

   La balise Grid complète ressemble à ce code.

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

   Le code complet du fichier MainPage.xaml doit ressembler à ceci.

   <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. Compilez et exécutez l’application pour la voir avec une publicité.

Publier votre application avec des publicités en direct

1. Assurez-vous que votre utilisation de bannières publicitaires dans votre application suit nos instructions pour les bannières publicitaires.

2. Dans l’Espace partenaires, accédez à la page publicités dans l’application et créez une unité publicitaire. Pour le type d’unité publicitaire, spécifiez Bannière. Notez à la fois l’ID d’unité publicitaire et l’ID d’application.

   Remarque

   Les valeurs d’ID d’application pour les unités publicitaires de test et les unités publicitaires UWP actives ont des formats différents. Les valeurs d’ID d’application de test sont des GUID. Lorsque vous créez une unité publicitaire UWP active dans l’Espace partenaires, la valeur d’ID d’application de l’unité publicitaire correspond toujours à l’ID Store de votre application (un exemple de valeur d’ID store ressemble à 9NBLGGH4R315).

3. Vous pouvez éventuellement activer la médiation publicitaire pour AdControl en configurant les paramètres de la section Paramètres de médiation dans la page publicités dans l’application. La médiation publicitaire vous permet d’optimiser vos fonctionnalités de revenus publicitaires et de promotion des applications en affichant des publicités à partir de plusieurs réseaux publicitaires, y compris des publicités provenant d’autres réseaux publicitaires payants tels que Taboola et Smaato et les publicités pour les campagnes de promotion d’applications Microsoft.

4. Dans votre code, remplacez les valeurs d’unité publicitaire de test (ApplicationId et AdUnitId) par les valeurs actives que vous avez générées dans l’Espace partenaires.

5. Envoyez votre application au Windows Store à l’aide de l’Espace partenaires.

6. Passez en revue vos rapports de performances publicitaires dans l’Espace partenaires.

Gérer les unités publicitaires pour plusieurs contrôles publicitaires dans votre application

Vous pouvez utiliser plusieurs objets AdControl dans une application unique (par exemple, chaque page de votre application peut héberger un autre objet AdControl ). Dans ce scénario, nous vous recommandons d’attribuer une unité publicitaire différente à chaque contrôle. L’utilisation d’unités publicitaires différentes pour chaque contrôle vous permet de configurer séparément les paramètres de médiation et d’obtenir des données de création de rapports discrètes pour chaque contrôle. Cela permet également à nos services d’optimiser les publicités que nous servons à votre application.

Rubriques connexes

• Recommandations en matière de bannières publicitaires
• Gestion des erreurs dans la procédure pas à pas XAML/C#.
• Exemples de publicité sur GitHub
• Configurer des unités publicitaires pour votre application