AdControl 클래스

정의

네임스페이스:

Microsoft.Advertising.WinRT.UI

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

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

상속

StackPanel

AdControl

특성

ActivatableAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute WebHostHiddenAttribute

구현

IClosable IDisposable

추가 기능 및 요구 사항

소프트웨어 개발 키트	Microsoft Advertising SDK
지원되는 최소 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	사용자가 배너 광고 클릭, 가리키기 또는 터치를 중지했을 때 발생합니다.

추가 정보

• XAML 및 .NET의 AdControl
• HTML 5 및 JavaScript의 AdControl
• GitHub의 광고 샘플