Handbuch zur Problembehandlung für HTML und JavaScript

Artikel
07/13/2023

Warnung

Ab dem 1. Juni 2020 wird die Microsoft Ad Monetization Platform für Windows UWP-Apps heruntergefahren. Weitere Informationen

Dieses Thema enthält Lösungen für allgemeine Entwicklungsprobleme mit den Microsoft Advertising-Bibliotheken in JavaScript/HTML-Apps.

HTML
JavaScript

HTML

AdControl wird nicht angezeigt

Stellen Sie sicher, dass die Internet (Client)-Funktion in „Package.appxmanifest“ ausgewählt ist.
Stellen Sie sicher, dass der JavaScript-Verweis vorhanden ist. Ohne den Verweis ad.js im Abschnitt <head> (nach dem Verweis default.js) kann AdControl nicht angezeigt werden, und während der Erstellung tritt ein Fehler auf.
```
<head>
    ...
    <script src="//Microsoft.Advertising.JavaScript/ad.js"></script>
    ...
</head>
```

Überprüfen Sie die ID der Anwendung und der Anzeigeneinheit. Diese IDs müssen mit der Anwendungs-ID und der Anzeigeneinheits-ID übereinstimmen, die Sie in Partner Center erhalten haben. Weitere Informationen finden Sie unter Einrichten von Anzeigeneinheiten in der App.

<div id="myAd" style="position: absolute; top: 50px; left: 0px;
                      width: 250px; height: 250px; z-index: 1"
     data-win-control="MicrosoftNSJS.Advertising.AdControl"
     data-win-options="{applicationId: 'ApplicationID',
                        adUnitId: 'AdUnitID'}">
</div>

Überprüfen Sie die Eigenschaften height und width. Diese müssen auf eine der unterstützten Anzeigengrößen für Werbebanner festgelegt werden.

<div id="myAd" style="position: absolute; top: 50px; left: 0px;
                      width: 250px; height: 250px; z-index: 1"
     data-win-control="MicrosoftNSJS.Advertising.AdControl"
     data-win-options="{applicationId: 'ApplicationID',
                        adUnitId: 'AdUnitID'}">
</div>

Überprüfen Sie die Elementpositionierung. AdControl muss sich im sichtbaren Bereich befinden.

Überprüfen Sie die Sichtbarkeitseigenschaft . Diese Eigenschaft darf nicht auf reduziert oder ausgeblendet festgelegt sein. Diese Eigenschaft kann als Inlineeigenschaft (wie unten dargestellt) oder in einem externen Stylesheet festgelegt werden.

<div id="myAd" style="visibility: visible; position: absolute; top: 1025px;
                      left: 500px; width: 250px; height: 250px; z-index: 1"
     data-win-control="MicrosoftNSJS.Advertising.AdControl"
     data-win-options="{applicationId: 'ApplicationID',
                        adUnitId: 'AdUnitID'}">
</div>

Überprüfen Sie die Eigenschaft position. Die Eigenschaft „position“ muss auf einen geeigneten Wert abhängig von den anderen Eigenschaften des Elements festgelegt werden (beispielsweise Rändern im übergeordneten Element und z-index). Diese Eigenschaft kann als Inlineeigenschaft (wie unten dargestellt) oder in einem externen Stylesheet festgelegt werden.
```
<div id="myAd" style="visibility: visible; position: absolute; top: 1025px;
                      left: 500px; width: 250px; height: 250px; z-index: 1"
     data-win-control="MicrosoftNSJS.Advertising.AdControl"
     data-win-options="{applicationId: 'ApplicationID',
                        adUnitId: 'AdUnitID'}">
</div>
```

Überprüfen Sie die Eigenschaft z-index. Die Eigenschaft z-index muss hoch genug festgelegt werden, sodass AdControl stets oberhalb anderer Elemente angezeigt wird. Diese Eigenschaft kann als Inlineeigenschaft (wie unten dargestellt) oder in einem externen Stylesheet festgelegt werden.

<div id="myAd" style="visibility: visible; position: absolute; top: 1025px;
                      left: 500px; width: 250px; height: 250px; z-index: 1"
     data-win-control="MicrosoftNSJS.Advertising.AdControl"
     data-win-options="{applicationId: 'ApplicationID',
                        adUnitId: 'AdUnitID'}">
</div>

Überprüfen Sie die externen Stylesheets. Wenn im Element AdControl Eigenschaften über ein externes Stylesheet festgelegt werden, müssen alle oben genannten Eigenschaften ordnungsgemäß festgelegt worden sein.

<div id="myAd" style="visibility: visible; position: absolute; top: 1025px;
                      left: 500px; width: 250px; height: 250px; z-index: 1"
     data-win-control="MicrosoftNSJS.Advertising.AdControl"
     data-win-options="{applicationId: 'ApplicationID',
                        adUnitId: 'AdUnitID'}">
</div>

Überprüfen Sie das übergeordnete Element von AdControl. Wenn sich AdControl in einem übergeordneten Element befindet, muss das übergeordnete Element aktiv und sichtbar sein.

<div style="position: absolute; width: 500px; height: 500px;">
    <div id="myAd" style="position: relative; top: 0px; left: 100px;
                          width: 250px; height: 250px; z-index: 1"
         data-win-control="MicrosoftNSJS.Advertising.AdControl"
         data-win-options="{applicationId: 'ApplicationID',
                            adUnitId: 'AdUnitID'}">
    </div>
</div>

Stellen Sie sicher, dass AdControl im Viewport nicht ausgeblendet ist. AdControl muss sichtbar sein, damit Anzeigen ordnungsgemäß dargestellt werden.
Echte Werte für ApplicationId und AdUnitId sollten nicht im Emulator getestet werden. Verwenden Sie die Testwerte für ApplicationId und AdUnitId, um sicherzustellen, dass AdControl wie erwartet funktioniert.

Blackbox blinkt und wird ausgeblendet

Überprüfen Sie noch einmal alle Schritte im vorherigen Abschnitt AdControl wird nicht angezeigt.

Behandeln Sie das Ereignis onErrorOccurred, und bestimmen Sie anhand der an den Ereignishandler übergebenen Meldung, ob ein Fehler aufgetreten ist und welche Art von Fehler ausgelöst wurde. Weitere Informationen finden Sie in Exemplarische Vorgehensweise zur Fehlerbehandlung in JavaScript.

<div id="myAd" style="position: absolute; top: 0px; left: 0px;
                      width: 728px; height: 90px; z-index: 1"
     data-win-control="MicrosoftNSJS.Advertising.AdControl"
     data-win-options="{applicationId: 'ApplicationID',
                        adUnitId: 'AdUnitID',
                        onErrorOccurred: errorLogger}">
</div>
<div style="position:absolute; width:100%; height:130px; top:300px; left:0px">
    <b>Ad Events</b><br />
    <div id="adEvents" style="width:100%; height:110px; overflow:auto"></div>
</div>

Eine Blackbox wird am häufigsten dadurch verursacht, dass keine Anzeige verfügbar ist. Dieser Fehler bedeutet, dass durch die Anforderung keine Anzeige zurückgegeben werden kann.

AdControl verhält sich normal. AdControl wird standardmäßig reduziert, wenn keine Anzeige dargestellt werden kann. Wenn andere Elemente demselben übergeordneten Element untergeordnet sind, können sie verschoben werden, um den freien Platz des reduzierten AdControl-Elements zu füllen, und bei der nächsten Anforderung erweitert werden.

Anzeigen werden nicht aktualisiert

Überprüfen Sie die isAutoRefreshEnabled-Eigenschaft . Diese optionale Eigenschaft ist standardmäßig auf true festgelegt. Wenn dieser Wert auf false festgelegt ist, muss die Refresh-Methode verwendet werden, um eine andere Anzeige abzurufen.

<div id="myAd" style="position: absolute; top: 0px; left: 0px;
                      width: 250px; height: 250px; z-index: 1"
     data-win-control="MicrosoftNSJS.Advertising.AdControl"
     data-win-options="{ applicationId: 'ApplicationID',
                        adUnitId: 'AdUnitID',
                        onErrorOccurred: errorLogger,
                        isAutoRefreshEnabled: true}">
</div>

Überprüfen Sie Aufrufe der Methode refresh. Bei Verwendung der automatischen Aktualisierung kann die Aktualisierung nicht verwendet werden, um eine andere Anzeige abzurufen. Bei Verwendung der manuellen Aktualisierung sollte die Aktualisierung abhängig von der aktuellen Datenverbindung des Geräts nur nach mindestens 30 bis 60 Sekunden aufgerufen werden.

In diesem Beispiel wird die Verwendung der Methode refresh gezeigt. Der folgende HTML-Code zeigt ein Beispiel für die Instanziierung von AdControl, wenn isAutoRefreshEnabled auf false festgelegt ist.

<div id="myAd" style="position: absolute; top: 0px; left: 0px;
                      width: 250px; height: 250px; z-index: 1"
     data-win-control="MicrosoftNSJS.Advertising.AdControl"
     data-win-options="{ applicationId: 'ApplicationID',
                        adUnitId: 'AdUnitID',
                        onErrorOccurred: errorLogger,
                        isAutoRefreshEnabled: false}">
</div>

Dieses Beispiel zeigt die Verwendung der Funktion refresh.

args.setPromise(WinJS.UI.processAll()
    .then(function (args) {
        window.setInterval(function()
        {
            document.getElementById("myAd").winControl.refresh();
        }, 60000)
    })
);

AdControl verhält sich normal. In einigen Fällen wird dieselbe Anzeige mehrmals in Folge angezeigt, wodurch der Eindruck entsteht, dass Anzeigen nicht aktualisiert werden.

JavaScript

AdControl wird nicht angezeigt

Stellen Sie sicher, dass die Internet (Client)-Funktion in „Package.appxmanifest“ ausgewählt ist.

Stellen Sie sicher, dass AdControl instanziiert ist. Wenn AdControl nicht instanziiert ist, ist es nicht verfügbar.

Die folgenden Codeausschnitte zeigen ein Beispiel für die Instanziierung von AdControl. Dieser HTML-Code zeigt ein Beispiel für das Einrichten der Benutzeroberfläche für AdControl.

<div id="myAd" style="position: absolute; top: 0px; left: 0px;
                      width: 250px; height: 250px; z-index: 1"
     data-win-control="MicrosoftNSJS.Advertising.AdControl">
</div>

Der folgende JavaScript-Code zeigt ein Beispiel für die Instanziierung von AdControl.

app.onactivated = function (args) {
    if (args.detail.kind === activation.ActivationKind.launch) {
        if (args.detail.previousExecutionState !==
                activation.ApplicationExecutionState.terminated)
        {
            var adDiv = document.getElementById("myAd");
            var myAdControl = new MicrosoftNSJS.Advertising.AdControl(adDiv,
            {
                applicationId: "{ApplicationID}",
                adUnitId: "{AdUnitID}"
             });                
             myAdControl.onErrorOccurred = myAdError;
        } else {
            ...
        }
    }
}

Überprüfen Sie das übergeordnete Element. Das übergeordnete <div-Element> muss ordnungsgemäß zugewiesen, aktiv und sichtbar sein.

var adDiv = document.getElementById("myAd");
var myAdControl = new MicrosoftNSJS.Advertising.AdControl(adDiv, {
    applicationId: "{ApplicationID}",
    adUnitId: "{AdUnitID}"
});

Überprüfen Sie die ID der Anwendung und der Anzeigeneinheit. Diese IDs müssen mit der Anwendungs-ID und der Anzeigeneinheits-ID übereinstimmen, die Sie in Partner Center erhalten haben. Weitere Informationen finden Sie unter Einrichten von Anzeigeneinheiten in der App.
```
var myAdControl = new MicrosoftNSJS.Advertising.AdControl(adDiv, {
    applicationId: "{ApplicationID}",
    adUnitId: "{AdUnitID}"
});  
```
Überprüfen Sie das übergeordnete Element von AdControl. Das übergeordnete Element muss aktiv und sichtbar sein.
Echte Werte für ApplicationId und AdUnitId sollten nicht im Emulator getestet werden. Verwenden Sie die Testwerte für ApplicationId und AdUnitId, um sicherzustellen, dass AdControl wie erwartet funktioniert.

Blackbox blinkt und wird ausgeblendet

Überprüfen Sie noch einmal alle Schritte im Abschnitt AdControl wird nicht angezeigt.
Behandeln Sie das Ereignis onErrorOccurred, und bestimmen Sie anhand der an den Ereignishandler übergebenen Meldung, ob ein Fehler aufgetreten ist und welche Art von Fehler ausgelöst wurde. Weitere Informationen finden Sie in Exemplarische Vorgehensweise zur Fehlerbehandlung in JavaScript.

In diesem Beispiel wird die Implementierung eines Fehlerhandlers gezeigt, der Fehlermeldungen meldet. Der folgende HTML-Codeausschnitt enthält ein Beispiel für das Einrichten der Benutzeroberfläche zum Anzeigen von Fehlermeldungen.
```
<div style="position:absolute; width:100%; height:130px; top:300px">
    <b>Ad Events</b><br />
    <div id="adEvents" style="width:100%; height:110px; overflow:auto"></div>
</div>
```
In diesem Beispiel wird die Instanziierung von AdControl gezeigt. Diese Funktion würde in der Datei app.onactivated eingefügt werden.
```
var myAdControl = new MicrosoftNSJS.Advertising.AdControl(adDiv,
{
    applicationId: "{ApplicationID}",
    adUnitId: "{AdUnitID}"
});                
myAdControl.onErrorOccurred = myAdError;
```
In diesem Beispiel wird die Meldung von Fehlern gezeigt. Diese Funktion würde unterhalb der selbstausführenden Funktion in der Datei default.js eingefügt werden.
```
WinJS.Utilities.markSupportedForProcessing
(
    window.errorLogger = function (sender, evt)
    {
        adEvents.innerHTML = (new Date()).toLocaleTimeString() + ": " +
        sender.element.id + " error: " + evt.errorMessage + " error code: " +
        evt.errorCode + "<br>" + adEvents.innerHTML;
    }
);
```
Eine Blackbox wird am häufigsten dadurch verursacht, dass keine Anzeige verfügbar ist. Dieser Fehler bedeutet, dass durch die Anforderung keine Anzeige zurückgegeben werden kann.
AdControl verhält sich normal. In einigen Fällen wird dieselbe Anzeige mehrmals in Folge angezeigt, wodurch der Eindruck entsteht, dass Anzeigen nicht aktualisiert werden.

Anzeigen werden nicht aktualisiert

Überprüfen Sie, ob in der IsAutoRefreshEnabled-Eigenschaft AdControl auf „false“ festgelegt ist. Standardmäßig ist diese optionale Eigenschaft auf true festgelegt. Wenn sie auf false festgelegt ist, muss die Refresh-Methode verwendet werden, um eine andere Anzeige abzurufen.

Überprüfen Sie Aufrufe der Refresh-Methode . Bei Verwendung der automatischen Aktualisierung ((IsAutoRefreshEnabled ist true)) kann Refresh nicht verwendet werden, um eine weitere Anzeige abzurufen. Bei Verwendung der manuellen Aktualisierung (IsAutoRefreshEnabled ist false) sollte Refresh abhängig von der aktuellen Datenverbindung des Geräts erst nach mindestens 30 bis 60 Sekunden aufgerufen werden.

Dieses Beispiel zeigt das Erstellen von div für AdControl.

<div id="myAd" style="position: absolute; top: 0px; left: 0px;
                      width: 250px; height: 250px; z-index: 1"
     data-win-control="MicrosoftNSJS.Advertising.AdControl">
</div>

In diesem Beispiel wird die Verwendung der Refresh-Funktion gezeigt.

var myAdControl = new MicrosoftNSJS.Advertising.AdControl(adDiv,
{
  applicationId: "{ApplicationID}",
  adUnitId: "{AdUnitID}",
  isAutoRefreshEnabled: false
});
...
args.setPromise(WinJS.UI.processAll()
    .then(function (args) {
        window.setInterval(function()
        {
            document.getElementById("myAd").winControl.refresh();
        }, 60000)
    })
);

AdControl verhält sich normal. In einigen Fällen wird dieselbe Anzeige mehrmals in Folge angezeigt, wodurch der Eindruck entsteht, dass Anzeigen nicht aktualisiert werden.

Handbuch zur Problembehandlung für HTML und JavaScript

HTML

AdControl wird nicht angezeigt

Blackbox blinkt und wird ausgeblendet

Anzeigen werden nicht aktualisiert

JavaScript

AdControl wird nicht angezeigt

Blackbox blinkt und wird ausgeblendet

Anzeigen werden nicht aktualisiert

Feedback

Feedback

Zusätzliche Ressourcen