NativeAd

Kotlin |자바

public abstract class NativeAd

---

Google 네이티브 광고

요약

중첩된 유형
public abstract class NativeAd.AdChoicesInfo 저작자 표시 정보
public abstract class NativeAd.Image 네이티브 광고 이미지 확장 소재
public interface NativeAd.OnNativeAdLoadedListener 네이티브 광고가 정상적으로 로드되었을 때 호출되는 콜백의 인터페이스 정의입니다.
public interface NativeAd.UnconfirmedClickListener 앱이 광고 클릭 확인 기능을 사용할 때 확인되지 않은 클릭 이벤트를 수신하는 데 사용할 수 있는 리스너 인터페이스입니다.

공개 생성자
NativeAd()

공개 메서드
abstract void	cancelUnconfirmedClick() 이전에 광고에 대해 기록된 확인되지 않은 클릭을 취소합니다.
abstract void	destroy() 광고 객체를 소멸합니다.
abstract void	enableCustomClickGesture() 이 메서드는 지원 중단되었습니다. enableCustomClickGestureDirection을 사용합니다.
abstract @Nullable NativeAd.AdChoicesInfo	getAdChoicesInfo() AdChoices 기여 분석에 대한 정보를 반환합니다.
abstract @Nullable String	getAdvertiser() 광고주를 식별하는 텍스트를 반환합니다.
abstract @Nullable String	getBody() 본문 텍스트를 반환합니다.
abstract @Nullable String	getCallToAction() 광고의 클릭 유도 문구 (예: '구매' 또는 '설치')를 반환합니다.
abstract Bundle	getExtras() 네이티브 광고와 연결된 추가 애셋 번들을 반환합니다.
abstract @Nullable String	getHeadline() 기본 텍스트 광고 제목을 반환합니다.
abstract @Nullable NativeAd.Image	getIcon() 광고주를 식별하는 작은 이미지를 반환합니다.
abstract List<NativeAd.Image>	getImages() 대형 이미지 목록을 반환합니다.
abstract @Nullable MediaContent	getMediaContent() 이 광고와 연결된 MediaContent를 반환합니다.
abstract List<MuteThisAdReason>	getMuteThisAdReasons() 이 광고에 사용할 수 있는 '광고 끄기' 이유를 반환합니다.
abstract @Nullable String	getPrice() 앱에 관한 광고의 경우 앱 가격을 나타내는 문자열을 반환합니다.
abstract @Nullable ResponseInfo	getResponseInfo() 로드된 광고의 ResponseInfo 객체를 반환합니다.
abstract @Nullable Double	getStarRating() 앱에 대한 광고의 경우 앱을 제공하는 스토어에서 앱이 받은 별표 수를 나타내는 0~5의 별표 평점을 반환합니다.
abstract @Nullable String	getStore() 앱에 관한 광고의 경우 앱을 다운로드할 수 있는 스토어의 이름을 반환합니다.
abstract boolean	isCustomClickGestureEnabled() 이 메서드는 지원 중단되었습니다. enableCustomClickGestureDirection를 사용하여 광고를 로드하면 반환된 모든 광고에서 맞춤 클릭 동작을 지원합니다.
abstract boolean	isCustomMuteThisAdEnabled() 이 광고를 프로그래매틱 방식으로 음소거할 수 있는 경우 true을 반환합니다.
abstract void	muteThisAd(MuteThisAdReason muteThisAdReason) 프로그래매틱 방식으로 '광고 끄기'를 실행합니다.
abstract void	performClick(Bundle clickData) 사용자가 광고를 클릭할 때 호출해야 합니다.
abstract void	recordCustomClickGesture() 이 메서드는 지원 중단되었습니다. 이제 Google 모바일 광고 SDK는 enableCustomClickGestureDirection에서 요청된 클릭 동작 방향을 사용하여 맞춤 클릭 동작을 추적합니다.
abstract boolean	recordImpression(Bundle impressionData) 광고가 처음 표시될 때 호출해야 합니다.
abstract void	reportTouchEvent(Bundle touchEventData) 광고에서 터치 이벤트가 발생할 때 호출해야 합니다.
abstract void	setMuteThisAdListener(MuteThisAdListener listener) 광고의 MuteThisAdListener를 설정합니다.
abstract void	setOnPaidEventListener(@Nullable OnPaidEventListener listener) 이 광고에서 수익이 창출된 것으로 추정될 때 호출되는 콜백을 등록합니다.
abstract void	setUnconfirmedClickListener(     NativeAd.UnconfirmedClickListener listener ) 광고의 UnconfirmedClickListener를 설정합니다.

공개 생성자

NativeAd

public NativeAd()

공개 메서드

cancelUnconfirmedClick

public abstract void cancelUnconfirmedClick()

이전에 광고에 대해 기록된 확인되지 않은 클릭을 취소합니다.

소멸

public abstract void destroy()

광고 객체를 소멸합니다. destroy가 호출된 후에는 광고 객체에서 다른 메서드를 호출하면 안 됩니다.

enableCustomClickGesture

public abstract void enableCustomClickGesture()

이 메서드는 지원 중단되었습니다.

enableCustomClickGestureDirection을 사용합니다.

이 NativeAd에 맞춤 동작을 사용하여 클릭을 보고하는 게시자를 사용 설정합니다. 이 메서드를 사용하려면 광고 단위가 허용 목록에 있어야 합니다.

기본적으로 SDK는 애셋 보기의 클릭을 추적합니다. 이 메서드가 호출되면 SDK는 더 이상 이 NativeAd의 클릭수를 추적하지 않습니다. 광고를 표시하기 전에 호출해야 합니다.

getAdChoicesInfo

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

AdChoices 기여 분석에 대한 정보를 반환합니다.

getAdvertiser

public abstract @Nullable String getAdvertiser()

광고주를 식별하는 텍스트를 반환합니다. 앱은 이 애셋을 표시할 필요는 없지만 표시하는 것이 좋습니다.

getBody

public abstract @Nullable String getBody()

본문 텍스트를 반환합니다. 앱은 이 애셋을 표시해야 합니다.

getCallToAction

public abstract @Nullable String getCallToAction()

광고의 클릭 유도 문구 (예: '구매' 또는 '설치')를 반환합니다. 앱은 이 애셋을 표시할 필요는 없지만 표시하는 것이 좋습니다.

getExtras

public abstract Bundle getExtras()

네이티브 광고와 연결된 추가 애셋 번들을 반환합니다. 미디에이션 파트너의 광고에 표준 확장 소재 (가격, 매장 등) 외에 확장 소재가 있는 경우 setExtras의 메서드를 호출하여 설정할 수 있으며 이 메서드를 통해 검색할 수 있습니다. 미디에이션되지 않은 흐름의 경우 빈 번들을 반환합니다.

getHeadline

public abstract @Nullable String getHeadline()

기본 텍스트 광고 제목을 반환합니다. 앱은 이 애셋을 표시해야 합니다.

getIcon

public abstract @Nullable NativeAd.Image getIcon()

광고주를 식별하는 작은 이미지를 반환합니다. 앱은 이 애셋을 표시할 필요는 없지만 표시하는 것이 좋습니다.

getImages

public abstract List<NativeAd.Image> getImages()

대형 이미지 목록을 반환합니다. 앱은 이 애셋을 표시할 필요는 없지만 표시하는 것이 좋습니다.

getMediaContent

public abstract @Nullable MediaContent getMediaContent()

이 광고와 연결된 MediaContent를 반환합니다.

getMuteThisAdReasons

public abstract List<MuteThisAdReason> getMuteThisAdReasons()

이 광고에 사용할 수 있는 '광고 끄기' 이유를 반환합니다. 사용자에게 표시할 때 클래스의 텍스트 설명을 사용합니다.

getPrice

public abstract @Nullable String getPrice()

앱에 관한 광고의 경우 앱 가격을 나타내는 문자열을 반환합니다. 앱은 이 애셋을 표시할 필요는 없지만 표시하는 것이 좋습니다.

getResponseInfo

public abstract @Nullable ResponseInfo getResponseInfo()

로드된 광고의 ResponseInfo 객체를 반환합니다. 광고가 로드될 때까지 null을 반환합니다.

getStarRating

public abstract @Nullable Double getStarRating()

앱에 대한 광고의 경우 앱을 제공하는 스토어에서 앱이 받은 별표 수를 나타내는 0~5의 별표 평점을 반환합니다. 앱은 이 애셋을 표시할 필요는 없지만 표시하는 것이 좋습니다.

getStore

public abstract @Nullable String getStore()

앱에 관한 광고의 경우 앱을 다운로드할 수 있는 스토어의 이름을 반환합니다. 예: 'Google Play' 앱은 이 애셋을 표시할 필요는 없지만 표시하는 것이 좋습니다.

isCustomClickGestureEnabled

public abstract boolean isCustomClickGestureEnabled()

이 메서드는 지원 중단되었습니다.

enableCustomClickGestureDirection를 사용하여 광고를 로드하면 반환된 모든 광고에서 맞춤 클릭 동작을 지원합니다. 계정이 이 기능의 허용 목록에 없으면 광고 요청이 채워지지 않습니다.

맞춤 클릭 동작을 사용하여 클릭을 보고할 수 있는지 여부를 나타냅니다. 이 기능을 위해 광고 단위를 허용 목록에 추가하려면 계정 관리자에게 문의하세요.

isCustomMuteThisAdEnabled

public abstract boolean isCustomMuteThisAdEnabled()

이 광고를 프로그래매틱 방식으로 음소거할 수 있는 경우 true을 반환합니다. setRequestCustomMuteThisAd를 사용하여 '이 광고 끄기'의 맞춤 구현을 요청합니다.

muteThisAd

public abstract void muteThisAd(MuteThisAdReason muteThisAdReason)

프로그래매틱 방식으로 '광고 끄기'를 실행합니다.

매개변수
MuteThisAdReason muteThisAdReason	사용자가 선택한 음소거 이유입니다. getMuteThisAdReasons에서 음소거 이유를 가져옵니다. null를 사용하여 기본 이유로 '광고 끄기'를 실행합니다.

performClick

public abstract void performClick(Bundle clickData)

사용자가 광고를 클릭할 때 호출해야 합니다. 이 API를 사용하려면 광고 단위가 허용 목록에 있어야 합니다. 이 메서드는 Unity 플러그인 게시자만 사용해야 합니다.

매개변수
Bundle clickData	클릭이 발생할 때 앱 환경의 번들입니다. 클릭 데이터 Bundle를 구성하는 방법에 관한 자세한 내용은 NativeAdConstants를 참고하세요.

recordCustomClickGesture

public abstract void recordCustomClickGesture()

이 메서드는 지원 중단되었습니다.

이제 Google 모바일 광고 SDK는 enableCustomClickGestureDirection에서 요청된 클릭 동작 방향을 사용하여 맞춤 클릭 동작을 추적합니다.

맞춤 클릭 동작을 사용하여 이 NativeAd의 클릭을 보고합니다. 이 메서드를 사용하려면 광고 단위가 허용 목록에 있어야 합니다.

이 메서드를 호출하기 전에 enableCustomClickGesture를 호출해야 합니다.

recordImpression

public abstract boolean recordImpression(Bundle impressionData)

광고가 처음 표시될 때 호출해야 합니다. 이 API를 사용하려면 광고 단위가 허용 목록에 있어야 합니다.

매개변수
Bundle impressionData	노출이 발생할 때 앱 환경의 번들입니다. 클릭 데이터 Bundle를 구성하는 방법에 관한 자세한 내용은 NativeAdConstants를 참고하세요.

반환 값
boolean	노출이 성공적으로 기록된 경우 true

reportTouchEvent

public abstract void reportTouchEvent(Bundle touchEventData)

광고에서 터치 이벤트가 발생할 때 호출해야 합니다. 이 API를 사용하려면 광고 단위가 허용 목록에 있어야 합니다. 이 기능을 사용하고 싶다면 계정 관리자에게 문의하세요.

매개변수
Bundle touchEventData	터치 이벤트 좌표 및 시간의 번들입니다. touchEventData 번들의 JSON 표현 예시: { "x": "100", // The x-coordinate of the touch event relative to the window. "y": "50", // The y-coordinate of the touch event relative to the window. "duration_millis": "500", // The amount of milliseconds the user pressed on the asset. }

setMuteThisAdListener

public abstract void setMuteThisAdListener(MuteThisAdListener listener)

광고의 MuteThisAdListener를 설정합니다.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

이 광고에서 수익이 창출된 것으로 추정될 때 호출할 콜백을 등록합니다.

setUnconfirmedClickListener

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

광고의 UnconfirmedClickListener를 설정합니다.