Руководство по устранению неполадок для HTML и JavaScript
Предупреждение
С 1 июня 2020 г. платформа монетизации Microsoft Ad для приложений UWP для Windows будет отключена. Подробнее
В этом разделе содержится описание решений для распространенных проблем разработки, связанных с библиотеками Microsoft Advertising в приложениях JavaScript и HTML.
HTML
Элемент AdControl не отображается
Убедитесь, что в файле Package.appxmanifest выбрана возможность Интернет (клиент).
Убедитесь в наличии ссылки JavaScript. При отсутствии ссылки ad.js в разделе <head> (после ссылки default.js) элемент AdControl не будет отображаться и в ходе сборки произойдет ошибка.
<head> ... <script src="//Microsoft.Advertising.JavaScript/ad.js"></script> ... </head>Проверьте идентификаторы приложения и рекламного блока. Эти идентификаторы должны совпадать с идентификатором приложения и идентификатором рекламного блока, полученным в Центре партнеров. Дополнительные сведения см. в разделе Настройка блоков рекламы в приложении.
<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>Проверьте свойства высоты и ширины . Для них должен быть установлен один из поддерживаемых размеров рекламы для баннеров.
<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>Проверьте расположение элемента. Элемент AdControl должен находиться в пределах видимой области.
Проверьте свойство видимости . Это свойство не должно быть свернуто или скрыто. Это свойство может быть задано в одной строке (как показано ниже) или во внешней таблице стилей.
<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>Проверьте свойство position. Свойству "position" необходимо задать соответствующее значение в зависимости от других свойств элемента (например, свойства "margins" в родительском элементе и свойства "z-index"). Это свойство может быть задано в одной строке (как показано ниже) или во внешней таблице стилей.
<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>Проверьте свойство z-index. Свойству z-index должно быть задано достаточно высокое значение, чтобы элемент AdControl всегда отображался поверх других элементов. Это свойство может быть задано в одной строке (как показано ниже) или во внешней таблице стилей.
<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>Проверьте внешние таблицы стилей. При задании свойств элемента AdControl с помощью внешней таблицы стилей, убедитесь, что все указанные выше свойства установлены правильно.
<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>Проверьте родительский элемент элемента AdControl. Если элемент AdControl помещен в родительский элемент, то родительский элемент должен быть активным и видимым.
<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>Убедитесь, что элемент AdControl отображается в окне просмотра. Для правильного отображения элемента AdControl он должен быть видимым для рекламы.
Динамические значения ApplicationId и AdUnitId не следует проверять в эмуляторе. Чтобы проверить, правильно ли работает элемент AdControl, используйте тестовые значения для ApplicationId и AdUnitId.
«Черный ящик» моргает и исчезает
Тщательно проверьте все действия, выполненные в предыдущем разделе Элемент AdControl не отображается.
Обработайте событие onErrorOccurred и используйте сообщение, которое передается в обработчик событий, чтобы определить, произошла ли ошибка и какой тип ошибки будет игнорироваться. Дополнительные сведения см. в разделе Обработка ошибок в пошаговом руководстве по 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>Наиболее распространенная ошибка, в следствие которой появляется «черный ящик», это — «Реклама недоступна». Эта ошибка означает, что для возврата по запросу реклама недоступна.
Элемент AdControl работает нормально. По умолчанию AdControl сворачивается, если он не может отобразить рекламу. Если другие элементы являются дочерними по отношению к одному и тому же родительскому элементу, их можно использовать для заполнения пустого пространства, образовавшегося в результате сворачивания элемента AdControl, и они будут развернуты при отправке следующего запроса.
Реклама не обновляется
Проверьте свойство isAutoRefreshEnabled. По умолчанию этому необязательному свойству задано значение "true". Если задано значение false, метод обновления должен использоваться для получения другого объявления.
<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>Проверьте работоспособность вызовов метода refresh. При использовании автоматического обновления обновление нельзя использовать для получения другого объявления. При использовании обновления вручную обновление должно вызываться только через 30–60 секунд в зависимости от текущего подключения к данным устройства.
В этом примере демонстрируется использование метода refresh. В следующем HTML-коде приведен пример создания экземпляра элемента AdControl, когда свойству isAutoRefreshEnabled задано значение "false".
<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>В этом примере демонстрируется использование функции refresh.
args.setPromise(WinJS.UI.processAll() .then(function (args) { window.setInterval(function() { document.getElementById("myAd").winControl.refresh(); }, 60000) }) );Элемент AdControl работает нормально. Иногда одна и та же реклама может отображаться несколько раз подряд, в результате чего может показаться, что рекламные блоки не обновляются.
JavaScript
Элемент AdControl не отображается
Убедитесь, что в файле Package.appxmanifest выбрана возможность Интернет (клиент).
Убедитесь, что создан экземпляр элемента AdControl. Если экземпляр элемента AdControl не создан, он будет недоступен.
Следующие фрагменты содержат пример создания экземпляра элемента AdControl. Этот HTML-код показывает пример настройки пользовательского интерфейса для элемента 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>В следующем коде JavaScript демонстрируется пример создания экземпляра элемента 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 { ... } } }Проверьте родительский элемент. Родительский <div> должен быть правильно назначен, активен и видим.
var adDiv = document.getElementById("myAd"); var myAdControl = new MicrosoftNSJS.Advertising.AdControl(adDiv, { applicationId: "{ApplicationID}", adUnitId: "{AdUnitID}" });Проверьте идентификаторы приложения и рекламного блока. Эти идентификаторы должны совпадать с идентификатором приложения и идентификатором рекламного блока, полученным в Центре партнеров. Дополнительные сведения см. в разделе Настройка блоков рекламы в приложении.
var myAdControl = new MicrosoftNSJS.Advertising.AdControl(adDiv, { applicationId: "{ApplicationID}", adUnitId: "{AdUnitID}" });Проверьте родительский элемент элемента AdControl. Родительский элемент должен быть активным и видимым.
Динамические значения ApplicationId и AdUnitId не следует проверять в эмуляторе. Чтобы проверить, правильно ли работает элемент AdControl, используйте тестовые значения для ApplicationId и AdUnitId.
«Черный ящик» моргает и исчезает
Тщательно проверьте все действия, выполненные в разделе Элемент AdControl не отображается.
Обработайте событие onErrorOccurred и используйте сообщение, которое передается в обработчик событий, чтобы определить, произошла ли ошибка и какой тип ошибки будет игнорироваться. Дополнительные сведения см. в разделе Обработка ошибок в пошаговом руководстве по JavaScript.
В этом примере показано описана процедура внедрения обработчика ошибок, передающего сообщения об ошибках. Этот фрагмент HTML-кода содержит пример настройки пользовательского интерфейса для отображения сообщений об ошибках.
<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>В этом примере показано, как создать экземпляр элемента AdControl. Эта функция будет добавлена в файл app.onactivated.
var myAdControl = new MicrosoftNSJS.Advertising.AdControl(adDiv, { applicationId: "{ApplicationID}", adUnitId: "{AdUnitID}" }); myAdControl.onErrorOccurred = myAdError;Этот пример показывает, как сообщать об ошибках. Эта функция будет добавлена под самовыполняющуюся функцию в файле default.js.
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; } );Наиболее распространенная ошибка, в следствие которой появляется «черный ящик», это — «Реклама недоступна». Эта ошибка означает, что для возврата по запросу реклама недоступна.
Элемент AdControl работает нормально. Иногда одна и та же реклама может отображаться несколько раз подряд, в результате чего может показаться, что рекламные блоки не обновляются.
Реклама не обновляется
Проверьте, задано ли для свойства IsAutoRefreshEnabled вашего элемента AdControl значение false. По умолчанию этому необязательному свойству присвоено значение true. Если установлено значение false, для извлечения другой рекламы необходимо использовать метод Refresh.
Проверьте вызовы метода Refresh . При использовании автоматического обновления (для свойства IsAutoRefreshEnabled задано значение true) применять метод Refresh для извлечения другой рекламы нельзя. При обновлении вручную (для свойства IsAutoRefreshEnabled задано значение false) метод Refresh следует вызывать только по истечении не менее 30–60 секунд в зависимости от текущего типа подключения для передачи данных, настроенного на устройстве.
В этом примере показано, как создать класс div для элемента 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>В этом примере продемонстрировано использование функции Refresh
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 работает нормально. Иногда одна и та же реклама может отображаться несколько раз подряд, в результате чего может показаться, что рекламные блоки не обновляются.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по