Partager via

Spots publicitaires

  • Article

Avertissement

Depuis le 1er juin 2020, la plateforme Microsoft Ad Monetization pour les applications Windows UWP sera arrêtée. En savoir plus

Cette procédure pas à pas montre comment inclure des publicités interstitielles dans les applications et jeux plateforme Windows universelle (UWP) pour Windows 10 et Windows 11. Pour obtenir des exemples de projets complets qui montrent comment ajouter des annonces publicitaires à des applications JavaScript/HTML et XAML à l’aide de C# et C++, consultez les exemples de publicité sur GitHub.

Qu’est-ce que les publicités interstitielles ?

Contrairement aux bannières standard, qui sont limitées à une partie d’une interface utilisateur dans une application ou un jeu, les publicités interstitielles sont affichées sur l’écran entier. Deux formes de base sont fréquemment utilisées dans les jeux.

  • Avec les publicités Paywall , l’utilisateur doit regarder une publicité à un intervalle régulier. Par exemple, entre les niveaux de jeu :

    whatisaninterstitial

  • Avec les publicités basées sur rewards, l’utilisateur recherche explicitement un avantage, tel qu’un indicateur ou un temps supplémentaire pour terminer le niveau, et initialise la publicité via l’interface utilisateur de l’application.

Nous fournissons deux types de publicités interstitiales à utiliser dans vos applications et jeux : publicités vidéo et bannières publicitaires interstitiales.

Remarque

L’API pour les publicités interstitielles ne gère aucune interface utilisateur, sauf au moment de la lecture vidéo. Reportez-vous aux meilleures pratiques d’interstitiel pour obtenir des instructions sur ce qu’il faut faire et éviter, car vous envisagez d’intégrer des publicités publicitaires dans votre application.

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 publicité interstitielle dans votre application

Pour afficher des publicités interstitielles dans votre application, suivez les instructions pour le type de projet :

XAML/.NET

Cette section fournit des exemples C#, mais Visual Basic et C++ sont également pris en charge pour les projets XAML/.NET. Pour obtenir un exemple de code C# complet, consultez l’exemple de code publicitaire Interstitial en C#.

  1. Ouvrez votre projet dans Visual Studio.

    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. Dans le fichier de code approprié dans votre application (par exemple, dans MainPage.xaml.cs ou un fichier de code pour une autre page), ajoutez la référence d’espace de noms suivante.

    using Microsoft.Advertising.WinRT.UI;

  5. Dans un emplacement approprié dans votre application (par exemple, dans MainPage ou une autre page), déclarez un objet InterstitialAd et plusieurs champs de chaîne qui représentent l’ID d’application et l’ID d’unité publicitaire de votre publicité. L’exemple de code suivant affecte les champs et myAdUnitId les myAppId valeurs de test pour les publicités interstitiales.

    Remarque

    Chaque InterstitialAd a une unité publicitaire correspondante utilisée par nos services pour servir 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.

    InterstitialAd myInterstitialAd = null;
string myAppId = "d25517cb-12d4-4699-8bdc-52040c712cab";
string myAdUnitId = "test";

  6. Dans le code qui s’exécute au démarrage (par exemple, dans le constructeur de la page), instanciez l’objet InterstitialAd et configurez les gestionnaires d’événements pour les événements de l’objet.

    myInterstitialAd = new InterstitialAd();
myInterstitialAd.AdReady += MyInterstitialAd_AdReady;
myInterstitialAd.ErrorOccurred += MyInterstitialAd_ErrorOccurred;
myInterstitialAd.Completed += MyInterstitialAd_Completed;
myInterstitialAd.Cancelled += MyInterstitialAd_Cancelled;

  7. Si vous souhaitez afficher une publicité vidéo interstitielle : Environ 30 à 60 secondes avant d’avoir besoin de la publicité, utilisez la méthode RequestAd pour pré-extraire la publicité. Cela permet de demander et de préparer la publicité avant qu’elle ne soit affichée. Veillez à spécifier AdType.Video pour le type de publicité.

    myInterstitialAd.RequestAd(AdType.Video, myAppId, myAdUnitId);

    Si vous souhaitez afficher une bannière publicitaire interstitielle : environ 5 à 8 secondes avant d’avoir besoin de la publicité, utilisez la méthode RequestAd pour pré-extraire la publicité. Cela permet de demander et de préparer la publicité avant qu’elle ne soit affichée. Veillez à spécifier AdType.Display pour le type de publicité.

    myInterstitialAd.RequestAd(AdType.Display, myAppId, myAdUnitId);

  8. À l’endroit où vous souhaitez afficher la vidéo ou la bannière interstitiale, vérifiez que l’application InterstitialAd est prête à être affichée, puis à l’afficher à l’aide de la méthode Show .

    if (InterstitialAdState.Ready == myInterstitialAd.State)
{
    myInterstitialAd.Show();
}

  9. Définissez les gestionnaires d’événements pour l’objet InterstitialAd .

    void MyInterstitialAd_AdReady(object sender, object e)
{
    // Your code goes here.
}

void MyInterstitialAd_ErrorOccurred(object sender, AdErrorEventArgs e)
{
    // Your code goes here.
}

void MyInterstitialAd_Completed(object sender, object e)
{
    // Your code goes here.
}

void MyInterstitialAd_Cancelled(object sender, object e)
{
    // Your code goes here.
}

  10. Générez et testez votre application pour confirmer qu’elle affiche des publicités de test.

HTML/JavaScript

Les instructions suivantes supposent que vous avez créé un projet Windows universel pour JavaScript dans Visual Studio et que vous ciblez un processeur spécifique. Pour obtenir un exemple de code complet, consultez l’exemple de code publicitaire Interstitial dans JavaScript.

  1. Ouvrez votre projet dans Visual Studio.

  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 JavaScript (version 10.0).
    3. Dans le Gestionnaire de références, cliquez sur OK.

  4. Dans la <section en tête> du fichier HTML dans le projet, après les références JavaScript du projet de default.css et de default.js, ajoutez la référence à ad.js.

    <script src="//Microsoft.Advertising.JavaScript/ad.js"></script>

  5. Dans un fichier .js dans votre projet, déclarez un objet InterstitialAd et plusieurs champs qui contiennent l’ID d’application et l’ID d’unité publicitaire de votre publicité. L’exemple de code suivant affecte les champs et adUnitId les applicationId valeurs de test pour les publicités interstitiales.

    Remarque

    Chaque InterstitialAd a une unité publicitaire correspondante utilisée par nos services pour servir 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.

    var interstitialAd = null;
var applicationId = "d25517cb-12d4-4699-8bdc-52040c712cab";
var adUnitId = "test";

  6. Dans le code qui s’exécute au démarrage (par exemple, dans le constructeur de la page), instanciez l’objet InterstitialAd et reliez les gestionnaires d’événements pour l’objet.

    interstitialAd = new MicrosoftNSJS.Advertising.InterstitialAd();
interstitialAd.onErrorOccurred = errorOccurredHandler;
interstitialAd.onAdReady = adReadyHandler;
interstitialAd.onCancelled = cancelledHandler;
interstitialAd.onCompleted = completedHandler;

  7. Si vous souhaitez afficher une publicité vidéo interstitielle : Environ 30 à 60 secondes avant d’avoir besoin de la publicité, utilisez la méthode RequestAd pour pré-extraire la publicité. Cela permet de demander et de préparer la publicité avant qu’elle ne soit affichée. Veillez à spécifier InterstitialAdType.video pour le type de publicité.

    if (interstitialAd) {
    interstitialAd.requestAd(MicrosoftNSJS.Advertising.InterstitialAdType.video, applicationId, adUnitId);
}

    Si vous souhaitez afficher une bannière publicitaire interstitielle : environ 5 à 8 secondes avant d’avoir besoin de la publicité, utilisez la méthode RequestAd pour pré-extraire la publicité. Cela permet de demander et de préparer la publicité avant qu’elle ne soit affichée. Veillez à spécifier InterstitialAdType.display pour le type de publicité.

    if (interstitialAd) {
    interstitialAd.requestAd(MicrosoftNSJS.Advertising.InterstitialAdType.display, applicationId, adUnitId);
}

  8. À l’endroit où vous souhaitez afficher la publicité, vérifiez que l’InterstitialAd est prêt à être affiché, puis affichez-le à l’aide de la méthode Show.

    if (interstitialAd && interstitialAd.state === MicrosoftNSJS.Advertising.InterstitialAdState.ready) {
    interstitialAd.show();
}

  9. Définissez les gestionnaires d’événements pour l’objet InterstitialAd .

    function adReadyHandler(sender) {
  // Your code goes here.
}

function errorOccurredHandler(sender, args) {
  // Your code goes here.
}

function completedHandler(sender) {
  // Your code goes here.
}

function cancelledHandler(sender) {
  // Your code goes here.
}

  10. Générez et testez votre application pour confirmer qu’elle affiche des publicités de test.

C++ (DirectX Interop)

Cet exemple suppose que vous avez créé un projet DirectX C++ et XAML App (Windows universel) dans Visual Studio et cible une architecture de processeur spécifique.  

  1. Ouvrez votre projet dans Visual Studio.

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

  3. Dans un fichier d’en-tête approprié pour votre application (par exemple, DirectXPage.xaml.h), déclarez un objet InterstitialAd et des méthodes de gestionnaire d’événements associées.

    Microsoft::Advertising::WinRT::UI::InterstitialAd^ m_interstitialAd;
void OnAdReady(Object^ sender, Object^ args);
void OnAdCompleted(Object^ sender, Object^ args);
void OnAdCancelled(Object^ sender, Object^ args);
void OnAdError(Object^ sender, Microsoft::Advertising::WinRT::UI::AdErrorEventArgs^ args);

  4. Dans le même fichier d’en-tête, déclarez plusieurs champs de chaîne qui représentent l’ID d’application et l’ID d’unité publicitaire pour votre publicité interstitiale. L’exemple de code suivant affecte les champs et myAdUnitId les myAppId valeurs de test pour les publicités interstitiales.

    Remarque

    Chaque InterstitialAd a une unité publicitaire correspondante utilisée par nos services pour servir 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.

    Platform::String^ myAppId = L"d25517cb-12d4-4699-8bdc-52040c712cab";
Platform::String^ myAdUnitId = L"test";

  5. Dans le fichier .cpp où vous souhaitez ajouter du code pour afficher une publicité interstitiale, ajoutez la référence d’espace de noms suivante. Les exemples suivants supposent que vous ajoutez le code à DirectXPage.xaml.cpp fichier dans votre application.

    using namespace Microsoft::Advertising::WinRT::UI;

  6. Dans le code qui s’exécute au démarrage (par exemple, dans le constructeur de la page), instanciez l’objet InterstitialAd et configurez les gestionnaires d’événements pour les événements de l’objet. Dans l’exemple suivant, InterstitialAdSamplesCpp est l’espace de noms de votre projet ; modifiez ce nom si nécessaire pour votre code.

    m_interstitialAd = ref new InterstitialAd();         
m_interstitialAd->AdReady += ref new Windows::Foundation::EventHandler<Platform::Object ^>
    (this, &InterstitialAdSamplesCpp::DirectXPage::OnAdReady);
m_interstitialAd->Completed += ref new Windows::Foundation::EventHandler<Platform::Object ^>
    (this, &InterstitialAdSamplesCpp::DirectXPage::OnAdCompleted);
m_interstitialAd->Cancelled += ref new Windows::Foundation::EventHandler<Platform::Object ^>
    (this, &InterstitialAdSamplesCpp::DirectXPage::OnAdCancelled);
m_interstitialAd->ErrorOccurred += ref new
    Windows::Foundation::EventHandler<Microsoft::Advertising::WinRT::UI::AdErrorEventArgs ^>
    (this, &InterstitialAdSamplesCpp::DirectXPage::OnAdError);

  7. Si vous souhaitez afficher une publicité vidéo d’interstitiel : Environ 30 à 60 secondes avant d’avoir besoin de la publicité interstitiale, utilisez la méthode RequestAd pour pré-extraire la publicité. Cela permet de demander et de préparer la publicité avant qu’elle ne soit affichée. Veillez à spécifier AdType ::Video pour le type de publicité.

    m_interstitialAd->RequestAd(AdType::Video, myAppId, myAdUnitId);

    Si vous souhaitez afficher une bannière publicitaire interstitielle : environ 5 à 8 secondes avant d’avoir besoin de la publicité, utilisez la méthode RequestAd pour pré-extraire la publicité. Cela permet de demander et de préparer la publicité avant qu’elle ne soit affichée. Veillez à spécifier AdType ::D isplay pour le type de publicité.

    m_interstitialAd->RequestAd(AdType::Display, myAppId, myAdUnitId);

  8. À l’endroit où vous souhaitez afficher la publicité, vérifiez que l’InterstitialAd est prêt à être affiché, puis affichez-le à l’aide de la méthode Show.

    if ((InterstitialAdState::Ready == m_interstitialAd->State))
{
    m_interstitialAd->Show();
}

  9. Définissez les gestionnaires d’événements pour l’objet InterstitialAd .

    void DirectXPage::OnAdReady(Object^ sender, Object^ args)
{
    // Your code goes here.
}


void DirectXPage::OnAdCompleted(Object^ sender, Object^ args)
{
    // Your code goes here.
}

void DirectXPage::OnAdCancelled(Object^ sender, Object^ args)
{
    // Your code goes here.
}

void DirectXPage::OnAdError(Object^ sender, Microsoft::Advertising::WinRT::UI::AdErrorEventArgs^ args)
{
    // Your code goes here.
}

  10. Générez et testez votre application pour confirmer qu’elle affiche des publicités de test.

Publier votre application avec des publicités en direct

  1. Assurez-vous que votre utilisation des publicités interstitielles dans votre application suit nos instructions pour les publicités d’interstitiel.

  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, choisissez Interstitiel vidéo ou Bannière interstitiel, en fonction du type d’annonces publicitaires que vous affichez. 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 InterstitialAd 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 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 interstitiaux dans votre application

Vous pouvez utiliser plusieurs contrôles InterstitialAd dans une seule application. 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.

Important

Vous pouvez utiliser chaque unité publicitaire dans une seule application. Si vous utilisez une unité publicitaire dans plusieurs applications, les publicités ne seront pas servies pour cette unité publicitaire.