다음을 통해 공유

XAML 및 .NET의 AdControl

  • 아티클

경고

2020년 6월 1일부터 Windows UWP 앱용 Microsoft Ad 수익 창출 플랫폼이 종료됩니다. 자세한 알아보기

이 연습에서는 AdControl 클래스를 사용하여 C#을 사용하여 구현된 Windows 10 또는 Windows 11용 UWP(유니버설 Windows 플랫폼) XAML 앱에 배너 광고를 표시하는 방법을 보여 줍니다.

메모

Microsoft Advertising SDK는 C++를 사용하여 구현되는 XAML 앱도 지원합니다. 전체 샘플 프로젝트는 GitHub 광고 샘플을 참조하세요.

필수 구성 요소

  • Visual Studio 2015 이상 릴리스에서 Microsoft Advertising SDK 설치합니다. 설치 지침은 이 문서 참조하세요.

앱에 배너 광고 통합

  1. Visual Studio에서 프로젝트를 열거나 새 프로젝트를 만듭니다.

    메모

    기존 프로젝트를 사용하는 경우 프로젝트에서 Package.appxmanifest 파일을 열고 인터넷(클라이언트) 기능이 선택되어 있는지 확인합니다. 테스트 광고 및 라이브 광고를 받으려면 앱에 이 기능이 필요합니다.

  2. 프로젝트가 CPU 대상으로 하는 경우 아키텍처별 빌드 출력(예: x86 )을 사용하도록 프로젝트를 업데이트합니다. 프로젝트가 Any CPU를 대상으로 하는 경우, 다음 단계에서 Microsoft 광고 라이브러리에 대한 참조를 성공적으로 추가할 수 없습니다. 프로젝트에서 Any CPU를 대상으로 지정하여 발생한 참조 오류 에 대한 자세한 내용은을 참조하세요.

  3. 프로젝트에서 Microsoft Advertising SDK에 대한 참조를 추가합니다.

    1. 솔루션 탐색기 창에서 참조항목을 오른쪽 클릭한 후 참조 추가...를 선택하십시오.
    2. 참조 관리자에서 유니버설 Windows을 확장하고, 확장을 클릭한 다음, XAML용 Microsoft Advertising SDK (버전 10.0) 옆의 확인란을 선택합니다.
    3. 참조 관리자에서 확인 버튼을 클릭합니다.

  4. 광고를 포함하는 페이지의 XAML을 수정하여 Microsoft.Advertising.WinRT.UI 네임스페이스를 포함합니다. 예를 들어 Visual Studio에서 생성된 기본 샘플 앱(이 앱에서 MyAdFundedWindows10AppXAML)의 XAML 페이지는MainPage.XAML입니다.

    Visual Studio에서 생성된 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"
  mc:Ignorable="d">
  <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
  </Grid>
</Page>

    MainPage.xaml 파일의 Page 섹션에 다음 코드가 있도록 Microsoft.Advertising.WinRT.UI 네임스페이스 참조를 추가합니다.

    <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 속성을 테스트 광고 단위 값에 할당합니다. 또한 컨트롤의 Height 및 Width를 조정하여 배너 광고 에 대해 지원되는 광고 크기중 하나가 되도록 하십시오.

    메모

    모든 AdControl에는 서비스가 컨트롤에 광고를 제공하기 위해 사용하는 해당 광고 단위가 있으며, 각 광고 단위는 광고 단위 ID와 애플리케이션 ID로 구성됩니다. 이 단계에서는 테스트 광고 단위 ID 및 애플리케이션 ID 값을 컨트롤에 할당합니다. 이러한 테스트 값은 앱의 테스트 버전에서만 사용할 수 있습니다. 스토어에 앱을 게시하기 전에 파트너 센터에서 이러한 테스트 값을 라이브 값으로 바꿔야 합니다.

    전체 Grid 태그는 이 코드와 같습니다.

    <Grid Background="{StaticResource ApplicationPageBackgroundThemeBrush}">
    <UI:AdControl ApplicationId="00001111-aaaa-2222-bbbb-3333cccc4444"
        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="00001111-aaaa-2222-bbbb-3333cccc4444"
              AdUnitId="test"
              HorizontalAlignment="Left"
              Height="250"
              VerticalAlignment="Top"
              Width="300"/>
  </Grid>
</Page>

  6. 앱을 컴파일하고 실행하여 광고가 표시되는 것을 확인하세요.

라이브 광고로 앱 릴리스

  1. 앱에서 배너 광고를 사용할 때, 반드시 배너 광고 의지침을 따르도록 하십시오.

  2. 파트너 센터에서 앱 내 광고 페이지로 이동하고 광고 단위만듭니다. 광고 단위 유형의 경우 배너지정합니다. 광고 단위 ID와 애플리케이션 ID를 모두 기록해 둡니다.

    메모

    테스트 광고 단위 및 라이브 UWP 광고 단위의 애플리케이션 ID 값은 형식이 다릅니다. 테스트 애플리케이션 ID 값은 GUID입니다. 파트너 센터에서 라이브 UWP 광고 단위를 만들 때 광고 단위의 애플리케이션 ID 값은 항상 앱의 스토어 ID와 일치합니다(예: 스토어 ID 값은 9NBLGGH4R315처럼 표시됨).

  3. 선택적으로 앱 내 광고 페이지의 중재 설정 섹션에서 설정을 구성하여 AdControl에 대한 광고 중재를 활성화할 수 있습니다. 광고 중재를 사용하면 Taboola, Smaato와 같은 다른 유료 광고 네트워크의 광고와 Microsoft 앱 프로모션 캠페인 광고를 포함하여 여러 광고 네트워크의 광고를 표시하여 광고 수익 및 앱 프로모션 기능을 최대화할 수 있습니다.

  4. 코드에서 테스트 광고 단위 값(ApplicationId 및 AdUnitId)을 파트너 센터에서 생성한 라이브 값으로 바꿉니다.

  5. 파트너 센터를 사용하여 스토어에 앱 제출합니다.

  6. 파트너 센터에서 광고 성과 보고서를 검토하십시오.

앱에서 여러 광고 컨트롤에 대한 광고 단위를 관리하기

단일 앱에서 여러 AdControl 개체를 사용할 수 있습니다(예를 들어 앱의 각 페이지에서 다른 AdControl 개체를 호스트할 수 있습니다). 이 시나리오에서는 각 컨트롤에 다른 광고 단위를 할당하는 것이 좋습니다. 각 컨트롤에 서로 다른 광고 단위를 사용하면 조정 설정 별도로 구성하고 각 컨트롤에 대한 개별 보고 데이터 가져올 수 있습니다. 또한 서비스를 통해 앱에 제공하는 광고를 더 잘 최적화할 수 있습니다.

중요하다

각 광고 단위는 하나의 앱에서만 사용할 수 있습니다. 둘 이상의 앱에서 광고 단위를 사용하는 경우 해당 광고 단위에 대한 광고가 제공되지 않습니다.