Configurer des unités publicitaires dans votre applicationSet up ad units in your app

Avertissement

Depuis le 1er juin 2020, la plateforme de monétisation Microsoft AD pour les applications Windows UWP sera arrêtée.As of June 1, 2020, the Microsoft Ad Monetization platform for Windows UWP apps will be shut down. En savoir plusLearn more

Chaque contrôle d’Active Directory de votre application plateforme Windows universelle (UWP) a une unité publicitaire correspondante qui est utilisée par nos services pour servir les publicités au contrôle.Every ad control in your Universal Windows Platform (UWP) app has a corresponding ad unit that is used by our services to serve ads to the control. Chaque unité ad se compose d’un ID d’unité Active Directory et d’un ID d’application que vous devez attribuer au code de votre application.Each ad unit consists of an ad unit ID and application ID that you must assign to code in your app.

Nous fournissons des valeurs d’unité ad de test que vous pouvez utiliser pendant le test pour confirmer que votre application affiche des publicités de test.We provide test ad unit values that you can use during testing to confirm that your app shows test ads. Ces valeurs de test ne peuvent être utilisées que dans une version test de votre application.These test values can only be used in a test version of your app. Si vous essayez d’utiliser des valeurs de test dans votre application après l’avoir publiée, votre application dynamique ne recevra pas de publicités.If you try to use test values in your app after you publish it, your live app not receive ads.

Une fois que vous avez terminé de tester votre application UWP et que vous êtes prêt à la soumettre à l’espace partenaires, vous devez créer une unité ad active à partir de la page ADS dans l’application dans l’espace partenaires, puis mettre à jour votre code d’application pour utiliser les valeurs ID d’application et ID d’unité Active Directory pour cette unité Active Directory.After you finish testing your UWP app and you are ready to submit it to Partner Center, you must create a live ad unit from the In-app ads page in Partner Center and update your app code to use the application ID and ad unit ID values for this ad unit.

Pour plus d’informations sur l’affectation de l’ID d’application et des valeurs d’ID d’unité ad dans le code de votre application, consultez les articles suivants :For more information about assigning the application ID and ad unit ID values in your app's code, see the following articles:

Unités AD de testTest ad units

Pendant le développement de votre application, utilisez les valeurs ID d’application de test et ID d’unité ad de cette section pour voir comment votre application affiche les publicités pendant le test.While you are developing your app, use the test application ID and ad unit ID values from this section to see how your app renders ads during testing.

  • ID de l’unité Active Directory : testAd unit ID: test

  • ID de l’application : 3f83fe91-d6be-434d-a0ae-7351c5a997f1Application ID: 3f83fe91-d6be-434d-a0ae-7351c5a997f1

    Important

    Pour un classe AdControl, la taille d’une publicité active est définie par les propriétés Width et Height .For an AdControl, the size of a live ad is defined by the Width and Height properties. Pour obtenir de meilleurs résultats, vérifiez que les propriétés Width et Height de votre code font partie des tailles de bannières publicitaires prises en charge.For best results, make sure that the Width and Height properties in your code are one of the supported ad sizes for banner ads. Les propriétés Width et Height ne changent pas en fonction de la taille d’une publicité dynamique.The Width and Height properties will not change based on the size of a live ad.

Publicités interstitielles et publicités nativesInterstitial ads and native ads

  • ID de l’unité Active Directory : testAd unit ID: test
  • ID de l’application : d25517cb-12d4-4699-8bdc-52040c712cabApplication ID: d25517cb-12d4-4699-8bdc-52040c712cab

Unités ad activesLive ad units

Pour obtenir une unité ad active de l’espace partenaires et l’utiliser dans votre application :To get a live ad unit from Partner Center and use it in your app:

  1. Créez une unité ad sur la page ADS dans l’application dans l’espace partenaires.Create an ad unit on the In-app ads page in Partner Center. Veillez à spécifier le type d’unité ad approprié pour le contrôle Active Directory que vous utilisez dans votre application.Be sure to specify the correct type of ad unit for the ad control you are using in your app.

    Notes

    Vous pouvez éventuellement activer la médiation AD pour votre unité ad en configurant les paramètres dans la section paramètres de médiation .You can optionally enable ad mediation for your ad unit by configuring the settings in the Mediation settings section. La médiation ad vous permet d’optimiser votre chiffre d’affaires et vos fonctionnalités de promotion d’applications en affichant les publicités de plusieurs réseaux Active Directory, y compris les publicités d’autres réseaux et publicités payants pour les campagnes de promotion des applications Microsoft.Ad mediation enables you to maximize your ad revenue and app promotion capabilities by displaying ads from multiple ad networks, including ads from other paid ad networks and ads for Microsoft app promotion campaigns. Par défaut, nous choisissons automatiquement les paramètres de médiation AD pour votre application à l’aide d’algorithmes d’apprentissage automatique pour vous aider à maximiser vos revenus de publicité sur les marchés pris en charge par votre application, mais vous pouvez éventuellement configurer vos paramètres de médiation manuellement.By default, we automatically choose the ad mediation settings for your app using machine-learning algorithms to help you maximize your ad revenue across the markets your app supports, but you can optionally manually configure your mediation settings.

  2. Une fois que vous avez créé la nouvelle unité ad, récupérez l’ID de l' application et l’ID de l' unité AD pour l’unité ad dans la table des unités ad disponibles dans la > page publicités dans l’application .After you create the new ad unit, retrieve the Application ID and Ad unit ID for the ad unit in the table of available ad units in the Monetize > In-app ads page.

    Notes

    Les valeurs d’ID d’application pour les unités AD de test et les unités ad UWP activent des formats différents.The application ID values for test ad units and live UWP ad units have different formats. Les valeurs d’ID d’application de test sont des GUID.Test application ID values are GUIDs. Lorsque vous créez une unité ad UWP en temps réel dans l’espace partenaires, la valeur de l’ID d’application pour l’unité ad correspond toujours à l’ID de magasin de votre application (un exemple de valeur d’ID de magasin ressemble à 9NBLGGH4R315).When you create a live UWP ad unit in Partner Center, the application ID value for the ad unit always matches the Store ID for your app (an example Store ID value looks like 9NBLGGH4R315).

  3. Affectez les valeurs ID d’application et ID d’unité ad dans le code de votre application.Assign the application ID and ad unit ID values in your app's code. Pour plus d’informations, consultez les articles suivants :For more information, see the following articles:

Gérer les unités AD pour plusieurs contrôles Active Directory dans votre applicationManage ad units for multiple ad controls in your app

Vous pouvez utiliser plusieurs commandes de bannière, interstitielles et natives Active Directory dans une même application.You can use multiple banner, interstitial, and native ad controls in a single app. Dans ce scénario, nous vous recommandons d’affecter une unité ad différente à chaque contrôle.In this scenario, we recommend that you assign a different ad unit to each control. L’utilisation de différentes unités AD pour chaque contrôle vous permet de configurer séparément les paramètres de médiation et d’obtenir des données de rapport discrètes pour chaque contrôle.Using different ad units for each control enables you to separately configure the mediation settings and get discrete reporting data for each control. Cela permet également à nos services de mieux optimiser les publicités que nous avons utilisées dans votre application.This also enables our services to better optimize the ads we serve to your app.

Important

Vous pouvez utiliser chaque unité ad dans une seule application.You can use each ad unit in only one app. Si vous utilisez une unité ad dans plusieurs applications, les publicités ne sont pas prises en charge pour cette unité Active Directory.If you use an ad unit in more than one app, ads will not be served for that ad unit.