다음을 통해 공유


AdControl 클래스

정의

앱에서 배너 광고를 표시하는 컨트롤을 나타냅니다.

public ref class AdControl sealed : StackPanel, IClosable
/// [Windows.Foundation.Metadata.Activatable(1)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Windows.Foundation.Metadata.WebHostHidden]
class AdControl final : StackPanel, IClosable
[Windows.Foundation.Metadata.Activatable(1)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Windows.Foundation.Metadata.WebHostHidden]
public sealed class AdControl : StackPanel, System.IDisposable
Public NotInheritable Class AdControl
Inherits StackPanel
Implements IDisposable
상속
AdControl
특성
구현

추가 기능 및 요구 사항

소프트웨어 개발 키트
지원되는 최소 OS
Windows 10 (10.0.10240.0)

설명

이 형식을 사용하는 방법을 보여 주는 연습 및 코드 예제는 XAML 및 .NET의 AdControl, HTML 5의 AdControl 및 GitHub의 JavaScript 및 Advertising 샘플을 참조하세요.

생성자

AdControl()

AdControl 클래스의 새 인스턴스를 초기화합니다.

속성

AdUnitId

AdControl 개체의 광고 단위 식별자를 가져오거나 설정합니다. 이 값은 파트너 센터에서 사용할 수 있습니다.

ApplicationId

AdControl 개체의 애플리케이션 ID를 가져오거나 설정합니다. 이 값은 파트너 센터에서 사용할 수 있습니다.

AutoRefreshIntervalInSeconds

AdControl이 현재 표시된 배너 광고(초)를 새로 고치는 간격을 가져오거나 설정합니다.

CountryOrRegion

사용자가 있는 두 글자 국가 또는 지역 코드를 가져오거나 설정합니다.

HasAd

AdControl이 현재 배너 광고 제공 중인지 여부를 나타내는 값을 가져옵니다.

IsAutoRefreshEnabled

배너 광고의 자동 회전이 사용되는지 여부를 나타내는 값을 가져오거나 설정합니다.

IsEngaged

사용자가 배너 광고와 상호 작용하고 있는지 여부를 나타내는 값을 가져옵니다.

IsSuspended

AdControl이 일시 중단된 상태인지 여부를 나타내는 값을 가져옵니다.

Keywords

광고 대상 그룹을 대상으로 하는 키워드를 가져오거나 설정합니다.

PostalCode

배너 광고의 대상으로 지정할 우편 번호를 가져오거나 설정합니다.

메서드

AddAdTag(String, String)

AdControl에 광고 태그를 추가합니다.

Close()

컨트롤에서 사용하는 연결된 시스템 리소스를 해제합니다.

Dispose()

관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.

Refresh()

자동 새로 고침을 사용하지 않도록 설정한 경우 새 광고의 사용 가능 상태가 되면 AdControl 에 다음 광고 표시를 지시합니다. 현재 렌더링된 광고의 경우 다음 광고 사용 가능 상태가 될 때까지 유지됩니다.

RemoveAdTag(String)

AdControl에서 광고 태그를 제거합니다.

Resume()

일시 중단을 호출한 후 배너 광고의 일반 표시를 다시 시작합니다.

Suspend()

현재 배너 광고 일시 중단 및 배너 광고의 현재 보기를 렌더링 중인 항목의 정적 스냅샷으로 바꿉니다.

이벤트

AdRefreshed

AdControl이 새 배너 광고 수신 시 발생합니다.

ErrorOccurred

AdControl에서 작동 오류가 발생할 때 발생합니다.

IsEngagedChanged

사용자가 배너 광고 를 클릭하고 앱이 아닌 상호 작용할 때 발생합니다.

OnManipulationStateChanged

AdControl이 배너 광고에서 조작 상태 변경 이벤트를 수신할 때 발생합니다.

OnMouseWheel

AdControl이 마우스 휠 이벤트를 수신할 때 발생합니다.

OnPointerDown

사용자가 배너 광고 클릭, 가리키기 또는 터치 시 발생합니다.

OnPointerMove

포인팅 디바이스를 이동할 때 발생합니다.

OnPointerUp

사용자가 배너 광고 클릭, 가리키기 또는 터치를 중지했을 때 발생합니다.

적용 대상

추가 정보