Gérer des erreurs dans les publicités

Avertissement

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

Les classes AdControl, InterstitialAd et NativeAdsManagerV2 ont chacune un événement ErrorOccurred qui est déclenché si une erreur liée à la publicité se produit. Votre code d’application peut gérer cet événement et examiner les propriétés ErrorCode et ErrorMessage de l’objet event args pour aider à déterminer la cause de l’erreur.

Applications XAML

Pour gérer les erreurs liées à la publicité dans une application XAML :

1. Attribuez l’événement ErrorOccurred de votre objet AdControl, InterstitialAd ou NativeAdsManagerV2 au nom d’un délégué de gestionnaire d’événements.

2. Codez le délégué de gestion des événements d’erreur afin qu’il prenne deux paramètres : un Object pour l’expéditeur et un objet AdErrorEventArgs.

Voici un exemple qui affecte un délégué nommé OnAdError à l’événement ErrorOccurred d’un objet AdControl nommé myBannerAdControl.

myBannerAdControl.ErrorOccurred = OnAdError;

Voici un exemple de définition du délégué OnAdError qui écrit des informations d’erreur dans la fenêtre Sortie de Visual Studio.

private void OnAdError(object sender, AdErrorEventArgs e)
{
    System.Diagnostics.Debug.WriteLine("AdControl error (" + ((AdControl)sender).Name + "): " + e.Error +
        " ErrorCode: " + e.ErrorCode.ToString());
}

Voir Gestion des erreurs dans la procédure pas à pas pour XAML/C# pour consulter une procédure pas à pas montrant la gestion des erreurs AdControl en XAML et C#.

Applications JavaScript/HTML

Pour gérer les erreurs ErrorOccur dans une application JavaScript :

1. Affectez l’événement onErrorOccurred à un gestionnaire d’événements.

2. Codez le gestionnaire d’événements.

Voici un exemple qui affecte un gestionnaire d’événements nommé errorLogger à l’événement ErrorOccurred d’un objet AdControl .

<div id="myAd" style="position: absolute; top: 53px; left: 0px; width: 250px; height: 250px; z-index: 1"
     data-win-control="MicrosoftNSJS.Advertising.AdControl"
     data-win-options="{applicationId: '3f83fe91-d6be-434d-a0ae-7351c5a997f1', adUnitId: 'test', onErrorOccurred: errorLogger}">
</div>

La fonction de gestion des erreurs est déclarative et doit être incorporée à la fonction markSupportedForProcessing.

Le gestionnaire d’erreurs intercepte l’objet d’erreur JavaScript lorsqu’une erreur se produit. Cet objet fournit deux arguments au gestionnaire d’erreurs.

Voici un exemple de fonction de gestion des erreurs nommé errorLogger qui gère l’événement onErrorOccurred.

WinJS.Utilities.markSupportedForProcessing(
window.errorLogger = function (sender, evt) {
    console.log(new Date()).toLocaleTimeString() + ": " + sender.element.id + " error: " + evt.errorMessage +
    " error code: " + evt.errorCode + \n");
});

Voir Gestion des erreurs dans la procédure pas à pas pour JavaScript pour consulter une procédure pas à pas montrant la gestion des erreurs AdControl en JavaScript.