AdControl в XAML и .NET AdControl in XAML and .NET
Начиная с 1 июня 2020 г. платформа Microsoft AD монетизацию для приложений Windows UWP будет выключена. As of June 1, 2020, the Microsoft Ad Monetization platform for Windows UWP apps will be shut down. Дополнительные сведения Learn more
В этом пошаговом руководстве рассказывается, как использовать класс AdControl для показа баннерной рекламы в приложении UWP на XAML для Windows 10, реализованном с использованием C#. This walkthrough shows how to use the AdControl class to display banner ads in a Universal Windows Platform (UWP) XAML app for Windows 10 that is implemented using C#.
Microsoft Advertising SDK также поддерживает приложения XAML, которые реализуются с использованием C++. The Microsoft Advertising SDK also supports XAML apps that are implemented using C++. Полный пример с проектом см. в разделе примеры рекламы на GitHub. For a complete sample project, see the advertising samples on GitHub.
Предварительные требования Prerequisites
- Установка Microsoft Advertising SDK с помощью Visual Studio 2015 или более поздней версии Visual Studio. Install the Microsoft Advertising SDK with Visual Studio 2015 or a later release of Visual Studio. Инструкции по установке см. в этой статье. For installation instructions, see this article.
Интеграция собственного баннера в приложение Integrate a banner ad into your app
В Visual Studio откройте свой проект либо создайте новый. In Visual Studio, open your project or create a new project.
Если вы используете существующий проект, откройте файл Package.appxmanifest в проекте и убедитесь, что возможность Интернет (клиент) выбрана. If you’re using an existing project, open the Package.appxmanifest file in your project and ensure that the Internet (Client) capability is selected. Вашему приложению эта возможность требуется для получения тестовых объявлений и настоящей рекламы. Your app needs this capability to receive test ads and live ads.
Если ваш проект направлен на работу на Любом ЦП, обновите его, чтобы он использовал результаты сборки, предназначенные для определенной архитектуры (например, x86). If your project targets Any CPU, update your project to use an architecture-specific build output (for example, x86). Если ваш проект направлен на работу на Любом ЦП, вам не удастся надлежащим образом добавить ссылку на Microsoft Advertising в приведенных ниже шагах. If your project targets Any CPU, you will not be able to successfully add a reference to the Microsoft advertising library in the following steps. Дополнительные сведения см. в разделе Ошибки, вызванные указанием варианта «Любой ЦП» как целевого в вашем проекте. For more information, see Reference errors caused by targeting Any CPU in your project.
Добавьте ссылку на Microsoft Advertising SDK в свой проект. Add a reference to the Microsoft Advertising SDK in your project:
- В Обозревателе решений щелкните правой кнопкой мыши элемент Ссылки и выберите Добавить ссылку. . From the Solution Explorer window, right click References, and select Add Reference…
- В Диспетчере ссылок разверните раздел Универсальная платформа Windows, нажмите Расширения и выберите флажок рядом с SDK Microsoft Advertising для XAML (версия 10.0). In Reference Manager, expand Universal Windows, click Extensions, and then select the check box next to Microsoft Advertising SDK for XAML (Version 10.0).
- В диспетчере ссылок нажмите «ОК». In Reference Manager, click OK.
Измените код XAML для страницы, где вы размещаете рекламу, для включения пространства имен Microsoft.Advertising.WinRT.UI. Modify the XAML for the page where you are embedding advertising to include the Microsoft.Advertising.WinRT.UI namespace. Например, в образце приложения по умолчанию, созданного Visual Studio (с названием MyAdFundedWindows10AppXAML в этом приложении), страницей XAML является MainPage.xaml. For example, in the default sample app generated by Visual Studio (named, in this app, MyAdFundedWindows10AppXAML), the XAML page is MainPage.XAML.
Раздел Page файла MainPage.xaml, созданного Visual Studio, содержит следующий код. The Page section of the MainPage.xaml file generated by Visual Studio has the following code.
Добавьте ссылку на пространство имен Microsoft.Advertising.WinRT.UI, чтобы раздел Page файла MainPage.xaml содержал следующий код. Add the namespace reference Microsoft.Advertising.WinRT.UI so the Page section of the MainPage.xaml file has the following code.
В раздел под тегом Grid добавьте код для AdControl. In the Grid tag, add the code for the AdControl. Назначьте свойствам ApplicationId и AdUnitId значения тестовой группы объявлений. Assign the AdUnitId and ApplicationId properties to the test ad unit values. Также настройте высоту и ширину элемента управления, чтобы он был одним из поддерживаемых размеров рекламы для баннеров. Also adjust the Height and Width of the control so it is one of the supported ad sizes for banner ads.
Каждый элемент AdControl имеет соответствующую группу объявлений, используемую нашими службами для передачи рекламы этому элементу управления, и каждая группа объявлений состоит из идентификатора группы объявлений и идентификатора приложения. Every AdControl has a corresponding ad unit that is used by our services to serve ads to the control, and every ad unit consists of an ad unit ID and application ID. На этих этапах вы задаете тестовые значения идентификатора группы объявлений и идентификатора приложения для своего элемента управления. In these steps, you assign test ad unit ID and application ID values to your control. Эти тестовые значения можно использовать только в тестовой версии приложения. These test values can only be used in a test version of your app. Перед публикацией приложения в хранилище эти тестовые значения необходимо заменить на значения в реальном времени из центра партнеров. Before you publish your app to the Store, you must replace these test values with live values from Partner Center.
Полностью код раздела под тегом Grid выглядит следующим образом. The complete Grid tag looks like this code.
Полный код для файла MainPage.xaml должен выглядеть так. The complete code for the MainPage.xaml file should look like this.
Скомпилируйте и запустите приложение, чтобы увидеть его с объявлением. Compile and run the app to see it with an ad.
Выпуск приложения с реальной рекламой Release your app with live ads
Убедитесь, что использование вами рекламных баннеров в своем приложении соответствует нашим рекомендациям для рекламных баннеров. Make sure your use of banner ads in your app follows our guidelines for banner ads.
В центре партнеров перейдите на страницу рекламных объявлений в приложении и Создайте модуль AD. In Partner Center, go to the In-app ads page and create an ad unit. В качестве типа группы объявлений укажите Баннер. For the ad unit type, specify Banner. Запомните идентификатор группы объявлений и идентификатор приложения. Make note of both the ad unit ID and the application ID.
Значения идентификатора приложения для тестовых рекламных блоков и реальных рекламных блоков UWP имеют разные форматы. The application ID values for test ad units and live UWP ad units have different formats. Тестовые значения идентификатора приложения представляют собой элементы GUID. Test application ID values are GUIDs. При создании активной единицы AD UWP в центре партнеров значение идентификатора приложения для единицы AD всегда совпадает с ИДЕНТИФИКАТОРом магазина для вашего приложения (пример значения идентификатора магазина выглядит как 9NBLGGH4R315). When you create a live UWP ad unit in Partner Center, the application ID value for the ad unit always matches the Store ID for your app (an example Store ID value looks like 9NBLGGH4R315).
Вы можете при необходимости включить рекламный посредник для AdControl, настроив параметры в разделе Параметры посредника на странице Реклама в приложении. You can optionally enable ad mediation for the AdControl by configuring the settings in the Mediation settings section on the In-app ads page. С помощью рекламного посредника можно максимально увеличить выручку от рекламы и возможности ее продвижения, отображая рекламу от нескольких рекламных сетей, в том числе других платных рекламных сетей, например Taboola и Smaato, и рекламных объявлений для кампаний по продвижению приложения Microsoft. Ad mediation enables you to maximize your ad revenue and app promotion capabilities by displaying ads from multiple ad networks, including ads from other paid ad networks such as Taboola and Smaato and ads for Microsoft app promotion campaigns.
В коде замените значения тестовых единиц AD (applicationId и адунитид) на значения в реальном времени, созданные в центре партнеров. In your code, replace the test ad unit values (ApplicationId and AdUnitId) with the live values you generated in Partner Center.
Отправьте приложение в магазин с помощью центра партнеров. Submit your app to the Store using Partner Center.
Управление группами объявлений для нескольких элементов управления рекламой в приложении Manage ad units for multiple ad controls in your app
Вы можете использовать несколько объектов AdControl в одном приложении (например, каждая страница в вашем приложении может содержать свой объект AdControl). You can use multiple AdControl objects in a single app (for example, each page in your app might host a different AdControl object). В этом случае рекомендуется назначить каждому элементу управления свою группу объявлений. In this scenario, we recommend that you assign a different ad unit to each control. Использование различных групп объявлений для каждого элемента управления позволяет по отдельности настраивать параметры посредника и получать раздельные данные отчетности для каждого элемента управления. Using different ad units for each control enables you to separately configure the mediation settings and get discrete reporting data for each control. Это также позволяет нашим службам лучше оптимизировать рекламные объявления, которые мы передаем вашему приложению. This also enables our services to better optimize the ads we serve to your app.
Одну группу объявлений можно использовать только в одном приложении. You can use each ad unit in only one app. Если использовать одну группу объявлений в нескольких приложениях, объявления для этой группы объявлений предоставляться не будут. If you use an ad unit in more than one app, ads will not be served for that ad unit.
Показ рекламы в приложении с помощью Microsoft Advertising SDK Display ads in your app with the Microsoft Advertising SDK
Начиная с 1 июня 2020 г. платформа Microsoft AD монетизацию для приложений Windows UWP будет выключена. As of June 1, 2020, the Microsoft Ad Monetization platform for Windows UWP apps will be shut down. Дополнительные сведения Learn more
Увеличьте свою прибыль, размещая рекламу в своих приложениях универсальной платформы Windows (UWP) для Windows 10 с помощью Microsoft Advertising SDK. Increase your revenue opportunities by putting ads in your Universal Windows Platform (UWP) app for Windows 10 by using the Microsoft Advertising SDK. Наша платформа AD монетизацию предлагает разнообразные форматы рекламы, которые можно легко интегрировать в свои приложения и поддерживать множество популярных сетей ad. Our ad monetization platform offers a variety of ad formats that can be seamlessly integrated into your apps and supports mediation with many popular ad networks. Наша платформа соответствует стандартам OpenRTB, VAST 2.x, MRAID 2 и VPAID 3, а также MOAT и IAS. Our platform is compliant with the OpenRTB, VAST 2.x, MRAID 2, and VPAID 3 standards and is compatible with MOAT and IAS.
 | Начало работы Get started Установка пакета SDK для Microsoft Advertising Install the Microsoft Advertising SDK |  | Руководства для разработчиков Developer guides Баннерные объявления Banner ads |  | Другие ресурсы Other resources Этап 1. Установите Microsoft Advertising SDK Step 1: Install the Microsoft Advertising SDKЧтобы начать работу, установите Microsoft Advertising SDK на компьютере разработчика, который вы используете для создания приложения. To get started, install the Microsoft Advertising SDK on the development computer you use to build your app. Инструкции по установке см. в этой статье. For installation instructions, see this article. Этап 2. Реализация рекламы в приложении Step 2: Implement ads in your appMicrosoft Advertising SDK предоставляет несколько различных типов элементов управления рекламой, которые можно использовать в приложении. The Microsoft Advertising SDK provides several different types of ad controls you can use in your app. Выберите, какие типы рекламы лучше всего подходят для вашей ситуации, и затем добавьте код в свое приложение для отображения таких объявлений. Choose which types of ads are best for your scenario and then add code to your app to display those ads. На этом шаге будет использоваться тестовая группа объявлений, чтобы вы могли видеть, как отображается реклама в приложении во время тестирования. During this step, you will use a test ad unit so you can see how your app renders ads during testing. Рекламные баннеры Banner adsЭто статические рекламные изображения, которые размещаются в прямоугольном сегменте страницы в приложении, чтобы отображать рекламное содержимое. These are static display ads that utilize a rectangular portion of a page in your app to display promotional content. Эти объявления можно автоматически обновлять с регулярным интервалом. These ads can refresh automatically at regular intervals. Это хорошая возможность для начала работы, если вы еще не размещали рекламу в своем приложении. This is a good place to start if you are new to advertising in your app. Инструкции и примеры кода см. в этой статье. For instructions and code examples, see this article. Межстраничные баннеры и видеореклама Interstitial video and interstitial banner adsМежстраничные объявления — полноэкранные рекламные материалы, которые обычно вынуждают пользователя просмотреть видео или требуют нажать на них, чтобы продолжить использовать приложение или игру. These are full-screen ads that typically require the user to watch a video or click through them to continue in the app or game. Мы поддерживаем два типа межстраничных объявлений: видеоролики и баннеры. We support two types of interstitial ads: video and banner. Инструкции и примеры кода см. в этой статье. For instructions and code examples, see this article.
Собственные объявления Native adsЭто рекламные объявления на основе компонентов. These are component-based ads. Каждый компонент рекламного объявления (например, заголовок, изображение, описание, текст с призывом к действию) передается вашему приложению в виде отдельного элемента, который можно интегрировать в приложение с использованием собственных шрифтов, цветов и других компонентов пользовательского интерфейса. Each piece of the ad creative (such as the title, image, description, and call-to-action text) is delivered to your app as an individual element that you can integrate into your app using your own fonts, colors, and other UI components. Инструкции и примеры кода см. в этой статье. For instructions and code examples, see this article.
Этап 3. Создание группы объявлений и настройка рекламного посредника Step 3: Create an ad unit and configure mediationПосле завершения тестирования приложения и готовности его отправить в магазин создайте модуль AD на странице рекламных объявлений в приложении в центре партнеров. After you finish testing your app and you are ready to submit it to the Store, create an ad unit on the In-app ads page in Partner Center. Обновите код приложения для использования этой группы объявлений, чтобы ваше приложение получало реальные объявления. Then, update your app code to use this ad unit so that your app will receive live ads. Дополнительные сведения см. в разделе Настройка блоков рекламы в приложении. For more information, see Set up ad units in your app. По умолчанию приложение будет отображать рекламу из сети платной рекламы корпорации Майкрософт. By default, your app will show ads from Microsoft’s network for paid ads. Чтобы максимально увеличить доход от рекламы, можно использовать рекламный посредник для группы объявлений в целях показа рекламы из дополнительных платных рекламных сетей, таких как Taboola и Smaato. To maximize your ad revenue, you can enable ad mediation for your ad unit to display ads from additional paid ad networks such as Taboola and Smaato. Также можно расширить возможности продвижения вашего приложения путем показа объявлений из кампаний по продвижению приложений корпорации Майкрософт. You can also increase your app promotion capabilities by serving ads from Microsoft app promotion campaigns. Чтобы начать использовать рекламный посредник в своем приложении UWP, настройте параметры рекламного посредника для своей группы объявлений. To start using ad mediation in your UWP app, configure ad mediation settings for your ad unit. По умолчанию мы автоматически настраиваем параметры посредника с помощью алгоритмов машинного обучения, чтобы помочь вам получить максимальную выручку от рекламы на рынках, поддерживаемых вашим приложением. By default, we automatically configure the mediation settings using machine-learning algorithms to help you maximize your ad revenue across the markets your app supports. Однако используемые сети можно выбирать и вручную. However, you also have the option to manually choose the networks you want to use. В любом случае параметры посредника полностью настроены на наших серверах. Вам не нужно менять код в вашем приложении. Either way, the mediation settings are configured entirely on our servers; you do not need to make any code changes in your app. Этап 4. Отправка приложения и проверка результатов Step 4: Submit your app and review performanceПосле завершения разработки приложения с помощью рекламных объявлений вы можете отправить обновленное приложение в центре партнеров, чтобы оно было доступно в магазине. After you finish developing your app with ads, you can submit your updated app in Partner Center to make it available in the Store. Приложения, отображающие рекламу, должны отвечать дополнительным требованиям, изложенным в разделе 10.10 Политики Microsoft Store и приложении E к Соглашению с разработчиком приложений. Apps that display ads must meet the additional requirements that are specified in section 10.10 of the Microsoft Store Policies and Exhibit E of the App Developer Agreement. После публикации и доступности приложения в магазине вы можете просматривать отчеты о производительности рекламы в центре партнеров и продолжать вносить изменения в Параметры исправлений, чтобы оптимизировать производительность ваших рекламных объявлений. After your app is published and available in the Store, you can review your advertising performance reports in Partner Center and continue to make changes to your mediation settings to optimize the performance of your ads. Доход от рекламы входит в состав вашей Сводки по выплатам. Your advertising revenue is included in your payout summary. Дополнительная справка Additional helpДополнительные сведения по использованию Microsoft Advertising SDK можно найти на следующих ресурсах. For additional help using the Microsoft Advertising SDK, use the following resources.
Приложения для Windows 8.1 и Windows Phone 8.x Windows 8.1 and Windows Phone 8.x appsДля приложений для Windows 8.1 и Windows Phone 8.x предусмотрен Microsoft Advertising SDK для Windows и Windows Phone 8.x. For Windows 8.1 and Windows Phone 8.x apps, we provide the Microsoft Advertising SDK for Windows and Windows Phone 8.x. Дополнительные сведения об использовании этого SDK для показа рекламы в приложениях для Windows 8.1 и Windows Phone 8.x см. в этой статье. For more information about using this SDK to show ads in Windows 8.1 and Windows Phone 8.x apps, see this article. |
