Condividi tramite

Gestire gli errori negli annunci

  • Articolo

Avviso

A partire dal 1° giugno 2020, la piattaforma Microsoft Ad Monetization per le app Windows UWP verrà arrestata. Ulteriori informazioni

Ognuna delle classi AdControl, InterstitialAd e NativeAdsManagerV2 ha un evento ErrorOccurred che viene generato se si verifica un errore relativo a un annuncio. Il codice dell'app può gestire questo evento ed esaminare le proprietà ErrorCode ed ErrorMessage dell'oggetto degli argomenti dell'evento per determinare la causa dell'errore.

App XAML

Per gestire gli errori relativi a un'app XAML:

  1. Assegnare l'evento ErrorOccurred dell'oggetto AdControl, InterstitialAd o NativeAdsManagerV2 al nome di un delegato del gestore eventi.

  2. Scrivere il codice del delegato di gestione eventi in modo che accetti due parametri: un oggetto Object per il mittente e un oggetto AdErrorEventArgs.

Di seguito è riportato un esempio che assegna un delegato denominato OnAdError all'evento ErrorOccurred di un oggetto AdControl denominato myBannerAdControl.

myBannerAdControl.ErrorOccurred = OnAdError;

La seguente è una definizione di esempio del delegato OnAdError che scrive le informazioni sull'errore nella finestra di output in Visual Studio.

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

Vedere Procedura dettagliata sulla gestione degli errori in XAML/C# per una procedura dettagliata che illustra la gestione degli errori relativi ad AdControl in XAML e C#.

App JavaScript/HTML

Per gestire gli errori ErrorOccur in un'app JavaScript:

  1. Assegnare l'evento onErrorOccurred a un gestore eventi.

  2. Scrivere il codice del gestore eventi.

Di seguito è riportato un esempio che assegna un gestore eventi denominato errorLogger all'evento ErrorOccurred di un oggetto 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 funzione di gestione degli errori è dichiarativa e deve essere racchiusa nella funzione markSupportedForProcessing.

Il gestore errori rileva l'oggetto errore JavaScript quando si verifica un errore. L'oggetto dell'errore fornisce due argomenti al gestore errori.

Di seguito è riportata una funzione di gestione errori denominata errorLogger che gestisce l'evento 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");
});

Vedere Procedura dettagliata di gestione degli errori in JavaScript per una procedura dettagliata che illustra come gestire l'errore AdControl in JavaScript.