다음을 통해 공유

Microsoft Advertising SDK 설치하기

  • 아티클

경고

2020년 6월 1일부로 Windows UWP 앱용 Microsoft 광고 수익 창출 플랫폼이 종료됩니다. 더 알아보기

Windows 10 및 Windows 11용 UWP 앱에 광고를 표시하려면 Microsoft Advertising SDK를 설치합니다. 이 SDK는 Visual Studio 2015 이상 버전에 대한 확장입니다.

참고

JavaScript/HTML UWP 앱을 개발하고 Windows 10 SDK 버전 10.0.14393(1주년 업데이트) 이상을 설치한 경우 WinJS 라이브러리도 설치해야 합니다. 이전 Windows 10 SDK 버전에는 이 라이브러리가 포함되어 있었지만, Windows 10 SDK 버전 10.0.14393(1주년 업데이트)부터는 라이브러리를 별도로 설치해야 합니다.

MSI를 통해 설치하기

MSI 설치 관리자를 통해 Microsoft Advertising SDK를 설치하려면 다음을 수행합니다.

  1. Visual Studio의 모든 인스턴스를 닫습니다.

  2. 이전에 이전 버전의 Microsoft Advertising SDK, Universal Ad Client SDK, Ad Mediator extension 또는 Microsoft Store Engagement and Monetization SDK를 설치한 경우 지금 이러한 SDK 버전을 제거합니다. 선택적으로 명령 프롬프트 창을 열고 다음의 명령을 실행하여 Visual Studio와 함께 설치되었을 수 있으나 컴퓨터에 설치된 프로그램 목록에 나타나지 않을 수 있는 이전 광고 SDK 버전을 모두 정리할 수 있습니다.

    MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}

  3. Microsoft Advertising SDK를 다운로드하여 설치합니다. 설치하는 데 몇 분 정도 걸릴 수 있습니다. 프로세스가 완료될 때까지 기다려야 합니다.

  4. Visual Studio를 다시 시작합니다.

  5. 이전 버전의 Microsoft Advertising SDK, Universal Ad Client SDK 또는 Microsoft Store Engagement and Monetization SDK에 있는 광고 라이브러리를 참조하는 기존 프로젝트가 있는 경우 Visual Studio에서 프로젝트를 열고 프로젝트를 정리한 후 다시 빌드합니다(솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭하고 정리를 선택한 다음 프로젝트 노드를 다시 마우스 오른쪽 단추로 클릭하고 다시 빌드 선택).

기타 프로젝트에서 처음 Microsoft Advertising SDK를 사용하는 경우에도, 이제 Microsoft Advertising SDK에 참조를 추가할 수 있습니다.

NuGet을 통해 설치하기

NuGet을 통해 특정 UWP 프로젝트에서 Microsoft Advertising SDK를 설치하려면 다음을 수행합니다.

  1. Visual Studio의 모든 인스턴스를 닫습니다.

  2. 이전에 이전 버전의 Microsoft Advertising SDK, Universal Ad Client SDK, Ad Mediator extension 또는 Microsoft Store Engagement and Monetization SDK를 설치한 경우 지금 이러한 SDK 버전을 제거합니다. 선택적으로 명령 프롬프트 창을 열고 다음의 명령을 실행하여 Visual Studio와 함께 설치되었을 수 있으나 컴퓨터에 설치된 프로그램 목록에 나타나지 않을 수 있는 이전 광고 SDK 버전을 모두 정리할 수 있습니다.

    MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}

  3. Visual Studio를 시작하고 Microsoft Advertising SDK 라이브러리를 사용하려는 프로젝트를 엽니다.

    참고

    프로젝트에 이 SDK의 이전 MSI 설치에 포함된 라이브러리 참조가 이미 들어 있으면 프로젝트에서 이러한 참조를 제거합니다. 참조하는 라이브러리가 이전 단계에서 제거되었으므로 이러한 참조 옆에 경고 아이콘이 있습니다.

  4. Visual Studio에서 프로젝트 및 NuGet 패키지 관리하기를 클릭합니다.

  5. 검색 상자에 Microsoft.Advertising.XAML(XAML 프로젝트의 경우) 또는 Microsoft.Advertising.JS(JavaScript/HTML 프로젝트의 경우)를 입력하고, 해당 패키지를 설치합니다. 패키지 설치가 완료되면 솔루션을 저장합니다.

    참고

    출력 창이 지정된 경로가 너무 길다는 것을 나타내는 Install-Package 오류를 보고하는 경우, 기본 위치보다 경로가 더 짧은 다른 위치로 패키지를 추출하도록 NuGet을 구성해야 할 수 있습니다. 이렇게 하려면 repositoryPath 값을 컴퓨터의 nuget.config 파일에 추가하고 NuGet 패키지를 추출할 수 있는 짧은 폴더 경로에 할당합니다. 자세한 내용은 NuGet 설명서에서 이 항목을 참조하세요. 또는 경로가 짧은 대체 폴더로 Visual Studio 프로젝트를 이동할 수 있습니다.

  6. 솔루션을 닫았다가 다시 엽니다.

  7. 프로젝트가 NuGet를 통해 설치된 이전 버전의 Microsoft Advertising SDK에 있는 라이브러리를 이미 참조하며 프로젝트를 최신 버전의 SDK로 업데이트한 경우 프로젝트를 정리한 후 다시 빌드하는 것이 좋습니다(솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭하고 정리를 선택한 다음 프로젝트 노드를 다시 마우스 오른쪽 단추로 클릭하고 다시 빌드 선택).

기타 프로젝트에서 처음 SDK를 사용하는 경우에도, 이제 Microsoft Advertising SDK에 참조를 추가할 수 있습니다.

Microsoft Advertising SDK에 참조 추가하기

Microsoft Advertising SDK를 설치한 뒤, 해당 지침에 따라 광고 API를 사용하도록 프로젝트에서 SDK를 참조시킵니다.

  1. Visual Studio에서 새 프로젝트를 엽니다.

    참고

    프로젝트가 모든 CPU를 대상으로 하는 경우 아키텍처별 빌드 출력(예: x86)을 사용하도록 프로젝트를 업데이트합니다. 프로젝트의 대상이 모든 CPU인 경우, Microsoft Advertising SDK에 대한 참조를 다음의 단계에 따라 성공적으로 추가하지 못할 수 있습니다. 자세한 정보는 프로젝트의 CPU를 대상으로 지정하여 발생한 참조 오류를 참조하세요.

  2. 솔루션 탐색기에서 참조를 마우스 우클릭하고, 참조 추가...를 선택합니다.

  3. 참조 관리자에서 유니버설 Windows를 확장하고, 확장을 클릭한 다음 Microsoft Advertising SDK for XAML (XAML 앱인 경우) 또는 Microsoft Advertising SDK for JavaScript(JavaScript 및 HTML을 사용하여 빌드되는 앱인 경우) 옆에 있는 확인란을 선택합니다.

  4. 참조 관리자에서 확인을 클릭합니다.

광고 API 시작 방법을 보여 주는 연습을 보려면 다음의 문서를 참조하세요.

Microsoft Advertising SDK의 프레임워크 패키지 이해하기

Microsoft Advertising SDK(UWP 앱의 경우)의 Microsoft.Advertising.dll 라이브러리는 프레임워크 패키지로 구성됩니다. 이 라이브러리는 Microsoft.Advertising 및 Microsoft.Advertising.WinRT.UI 네임스페이스의 광고 API를 포함합니다.

이 라이브러리는 프레임워크 패키지입니다. 다시 말해서 사용자가 이 라이브러리를 사용하는 앱 버전을 설치하면 수정 및 성능 향상이 포함된 새 버전의 라이브러리가 게시될 때마다 Windows 업데이트를 통해 사용자 디바이스의 라이브러리가 자동으로 업데이트됩니다. 따라서 고객의 디바이스에 항상 사용 가능한 최신 버전의 라이브러리가 설치됩니다.

이 라이브러리에 새로운 API 또는 기능을 도입하는 새 버전의 SDK를 릴리스하는 경우 이러한 기능을 사용하려면 최신 버전의 SDK를 설치해야 합니다. 이 시나리오에서는 업데이트된 앱을 Store에 게시해야 합니다.