AdControl в XAML и .NET

Предупреждение

По состоянию на 1 июня 2020 г. платформа Монетизации Microsoft Ad для приложений Windows UWP будет закрыта. Подробнее

В этом пошаговом руководстве показано, как использовать класс AdControl для отображения рекламных баннеров в приложении XAML универсальная платформа Windows (UWP) для Windows 10 или Windows 11, реализуемого с помощью C#.

Примечание.

Пакет SDK Microsoft Advertising также поддерживает приложения XAML, реализованные с помощью C++. Полный пример проекта см. в примерах рекламы на сайте GitHub.

Необходимые компоненты

• Установите пакет SDK Microsoft Advertising с Visual Studio 2015 или более поздней версией Visual Studio. Инструкции по установке см . в этой статье.

Интеграция баннерного объявления в приложение

1. В Visual Studio откройте проект или создайте новый проект.

   Примечание.

   Если вы используете существующий проект, откройте файл Package.appxmanifest в проекте и убедитесь, что выбрана возможность Интернета (клиента ). Вашему приложению нужна эта возможность для получения тестовой рекламы и живой рекламы.

2. Если проект предназначен для любого ЦП, обновите проект, чтобы использовать выходные данные сборки для конкретной архитектуры (например, x86). Если проект предназначен для любого ЦП, вы не сможете успешно добавить ссылку на библиотеку Microsoft Advertising в следующих шагах. Дополнительные сведения см. в статье Об ошибках ссылок, вызванных назначением любого ЦП в проекте.

3. Добавьте ссылку на пакет SDK Microsoft Advertising в проекте:

   1. В окне Обозреватель решений щелкните правой кнопкой мыши ссылки и выберите "Добавить ссылку...
   2. В диспетчере ссылок разверните универсальные окна, щелкните расширения и установите флажок рядом с пакетом SDK Microsoft Advertising для XAML (версия 10.0).
   3. В диспетчере ссылок нажмите кнопку "ОК".

4. Измените XAML для страницы, в которой вы внедряете рекламу, чтобы включить пространство имен Microsoft.Advertising.WinRT.UI . Например, в примере приложения по умолчанию, созданного Visual Studio (с именем, в этом приложении MyAdFundedWindows10AppXAML), страница XAML — MainPage.XAML.

   Раздел страницы файла MainPage.xaml, созданного Visual Studio, содержит следующий код.

   <Page
     x:Class="MyAdFundedWindows10AppXAML.MainPage"
     xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
     xmlns:local="using:MyAdFundedWindows10AppXAML"
     xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
     xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
     mc:Ignorable="d">
     <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
     </Grid>
   </Page>
   

   Добавьте ссылку на пространство имен Microsoft.Advertising.WinRT.UI , чтобы раздел страницы файла MainPage.xaml содержит следующий код.

   <Page
     x:Class="MyAdFundedWindows10AppXAML.MainPage"
     xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
     xmlns:local="using:MyAdFundedWindows10AppXAML"
     xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
     xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
     xmlns:UI="using:Microsoft.Advertising.WinRT.UI"
     mc:Ignorable="d">
     <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
     </Grid>
   </Page>
   

5. В теге Grid добавьте код для AdControl. Назначьте свойства AdUnitId и ApplicationId тестовой единице объявлений. Также настройте высоту и ширину элемента управления, чтобы он был одним из поддерживаемых размеров рекламы для баннеров.

   Примечание.

   Каждый adControl имеет соответствующий рекламный блок, используемый нашими службами для обслуживания рекламы в элементе управления, и каждый рекламный блок состоит из идентификатора и идентификатора приложения. В этих шагах вы назначите тестовый идентификатор и значения идентификатора приложения элементу управления. Эти значения теста можно использовать только в тестовой версии приложения. Перед публикацией приложения в Магазине необходимо заменить эти тестовые значения динамическими значениями из Центра партнеров.

   Полный тег Grid выглядит следующим образом.

   <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
       <UI:AdControl ApplicationId="3f83fe91-d6be-434d-a0ae-7351c5a997f1"
           AdUnitId="test"
           HorizontalAlignment="Left"
           Height="250"
           VerticalAlignment="Top"
           Width="300"/>
   </Grid>
   

   Полный код файла MainPage.xaml должен выглядеть следующим образом.

   <Page
     x:Class="MyAdFundedWindows10AppXAML.MainPage"
     xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
     xmlns:local="using:MyAdFundedWindows10AppXAML"
     xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
     xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
     xmlns:UI="using:Microsoft.Advertising.WinRT.UI"
     mc:Ignorable="d">
     <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
           <UI:AdControl ApplicationId="3f83fe91-d6be-434d-a0ae-7351c5a997f1"
                 AdUnitId="test"
                 HorizontalAlignment="Left"
                 Height="250"
                 VerticalAlignment="Top"
                 Width="300"/>
     </Grid>
   </Page>
   

6. Скомпилируйте и запустите приложение, чтобы увидеть его с рекламой.

Выпуск приложения с помощью динамических объявлений

1. Убедитесь, что вы используете баннерную рекламу в приложении, следуя нашим рекомендациям по рекламным баннерам.

2. В Центре партнеров перейдите на страницу рекламы в приложении и создайте рекламный блок. Для типа рекламного блока укажите Баннер. Запишите идентификатор рекламного блока и идентификатор приложения.

   Примечание.

   Значения идентификатора приложения для тестовых рекламных единиц и динамических рекламных единиц UWP имеют разные форматы. Тестовые значения идентификаторов приложения — это идентификаторы GUID. При создании динамического рекламного блока UWP в Центре партнеров значение идентификатора приложения для рекламного блока всегда совпадает с идентификатором Магазина для вашего приложения (например, значение идентификатора магазина выглядит как 9NBLGGH4R315).

3. При необходимости можно включить рекламное посреднико для AdControl, настроив параметры в разделе "Параметры посредника" на странице рекламы в приложении. Рекламный посредник позволяет максимально увеличить доход от рекламы и возможности продвижения приложений, отображая рекламу из нескольких рекламных сетей, включая рекламу из других платных рекламных сетей, таких как Taboola и Smaato, а также объявления для рекламных кампаний по продвижению приложений Майкрософт.

4. В коде замените тестовые значения единиц рекламы (ApplicationId и AdUnitId) динамическими значениями, созданными в Центре партнеров.

5. Отправьте приложение в Магазин с помощью Центра партнеров.

6. Просмотрите отчеты о производительности рекламы в Центре партнеров.

Управление рекламными единицами для нескольких элементов управления рекламой в приложении

Можно использовать несколько объектов AdControl в одном приложении (например, каждая страница в приложении может размещать другой объект AdControl ). В этом сценарии рекомендуется назначить каждому элементу управления разные рекламные блоки. Использование разных рекламных блоков для каждого элемента управления позволяет отдельно настроить параметры посредника и получить дискретные данные отчетов для каждого элемента управления. Это также позволяет нашим службам лучше оптимизировать рекламу, которая мы обслуживаем вашему приложению.

Внимание

Каждый рекламный блок можно использовать только в одном приложении. Если вы используете рекламный блок в нескольких приложениях, объявления не будут обслуживаться для этого рекламного блока.

См. также

• Рекомендации по рекламным баннерам
• Пошаговое руководство по обработке ошибок в XAML/C#.
• Рекламные примеры на GitHub
• Настройка рекламных блоков для приложения