NativeAd

abstract class NativeAd


Google 네이티브 광고입니다.

요약

중첩된 유형

abstract class NativeAd.AdChoicesInfo

저작자 표시 정보입니다.

abstract class NativeAd.Image

네이티브 광고 이미지 확장 소재입니다.

네이티브 광고가 정상적으로 로드되었을 때 호출되는 콜백의 인터페이스 정의입니다.

앱이 광고 클릭 확인 기능을 사용할 때 확인되지 않은 클릭 이벤트를 수신하는 데 사용할 수 있는 리스너 인터페이스입니다.

공개 생성자

공개 함수

abstract Unit

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

abstract Unit

광고 객체를 소멸시킵니다.

abstract Unit

이 함수는 지원 중단되었습니다.

enableCustomClickGestureDirection을 사용합니다.

abstract NativeAd.AdChoicesInfo?

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

abstract String?

광고주를 식별하는 텍스트를 반환합니다.

abstract String?

본문 텍스트를 반환합니다.

abstract String?

광고의 클릭 유도 문구 (예: '구매' 또는 '설치')를 반환합니다.

abstract Bundle!

네이티브 광고와 연결된 추가 애셋 번들을 반환합니다.

abstract String?

기본 텍스트 광고 제목을 반환합니다.

abstract NativeAd.Image?

광고주를 식별하는 작은 이미지를 반환합니다.

abstract (Mutable)List<NativeAd.Image!>!

큰 이미지 목록을 반환합니다.

abstract MediaContent?

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

abstract (Mutable)List<MuteThisAdReason!>!

이 광고에 사용할 수 있는 '광고 끄기' 이유를 반환합니다.

abstract Long

NativeAd의 게재위치 ID를 반환합니다.

abstract String?

앱에 관한 광고의 경우 앱 비용을 나타내는 문자열을 반환합니다.

abstract ResponseInfo?

로드된 광고의 ResponseInfo 객체를 반환합니다.

abstract Double?

앱에 관한 광고의 경우 앱을 제공하는 스토어에서 앱이 받은 별점을 나타내는 0~5점의 별점을 반환합니다.

abstract String?

앱에 관한 광고의 경우 다운로드용 앱을 제공하는 스토어의 이름을 반환합니다.

abstract Boolean

이 함수는 지원 중단되었습니다.

enableCustomClickGestureDirection를 사용하여 광고를 로드하면 반환된 모든 광고가 맞춤 클릭 동작을 지원합니다.

abstract Boolean

이 광고를 프로그래매틱 방식으로 음소거할 수 있으면 true를 반환합니다.

abstract Unit
muteThisAd(muteThisAdReason: MuteThisAdReason!)

프로그래매틱 방식으로 광고를 끕니다.

abstract Unit
performClick(clickData: Bundle!)

사용자가 광고를 클릭했을 때 호출해야 합니다.

abstract Unit

이 함수는 지원 중단되었습니다.

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

abstract Boolean
recordImpression(impressionData: Bundle!)

광고가 처음 표시될 때 호출해야 합니다.

abstract Unit
reportTouchEvent(touchEventData: Bundle!)

광고에서 터치 이벤트가 발생할 때 호출해야 합니다.

abstract Unit

광고의 MuteThisAdListener를 설정합니다.

abstract Unit

이 광고가 수익을 창출한 것으로 추정될 때 호출되는 콜백을 등록합니다.

abstract Unit
setPlacementId(placementId: Long)

네이티브 광고의 게재위치 ID를 설정합니다.

abstract Unit

광고의 UnconfirmedClickListener를 설정합니다.

공개 생성자

NativeAd

NativeAd()

공개 함수

cancelUnconfirmedClick

abstract fun cancelUnconfirmedClick(): Unit

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

소멸

abstract fun destroy(): Unit

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

enableCustomClickGesture

abstract fun enableCustomClickGesture(): Unit

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

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

getAdChoicesInfo

abstract fun getAdChoicesInfo(): NativeAd.AdChoicesInfo?

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

getAdvertiser

abstract fun getAdvertiser(): String?

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

getBody

abstract fun getBody(): String?

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

getCallToAction

abstract fun getCallToAction(): String?

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

getExtras

abstract fun getExtras(): Bundle!

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

getHeadline

abstract fun getHeadline(): String?

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

getIcon

abstract fun getIcon(): NativeAd.Image?

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

getImages

abstract fun getImages(): (Mutable)List<NativeAd.Image!>!

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

getMediaContent

abstract fun getMediaContent(): MediaContent?

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

getMuteThisAdReasons

abstract fun getMuteThisAdReasons(): (Mutable)List<MuteThisAdReason!>!

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

getPlacementId

abstract fun getPlacementId(): Long

NativeAd의 게재위치 ID를 반환합니다.

getPrice

abstract fun getPrice(): String?

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

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo?

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

getStarRating

abstract fun getStarRating(): Double?

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

getStore

abstract fun getStore(): String?

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

isCustomClickGestureEnabled

abstract fun isCustomClickGestureEnabled(): Boolean

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

isCustomMuteThisAdEnabled

abstract fun isCustomMuteThisAdEnabled(): Boolean

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

muteThisAd

abstract fun muteThisAd(muteThisAdReason: MuteThisAdReason!): Unit

프로그래매틱 방식으로 광고를 끕니다.

매개변수
muteThisAdReason: MuteThisAdReason!

사용자가 선택한 음소거 이유입니다. getMuteThisAdReasons에서 숨김 이유를 가져옵니다. null를 사용하여 기본 이유로 광고를 끕니다.

performClick

abstract fun performClick(clickData: Bundle!): Unit

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

매개변수
clickData: Bundle!

클릭이 발생할 때 앱 환경의 번들입니다. 클릭 데이터 Bundle를 구성하는 자세한 내용은 NativeAdConstants를 참고하세요.

recordCustomClickGesture

abstract fun recordCustomClickGesture(): Unit

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

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

recordImpression

abstract fun recordImpression(impressionData: Bundle!): Boolean

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

매개변수
impressionData: Bundle!

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

반환 값
Boolean

노출이 성공적으로 기록되면 true

reportTouchEvent

abstract fun reportTouchEvent(touchEventData: Bundle!): Unit

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

매개변수
touchEventData: Bundle!

터치 이벤트 좌표와 지속 시간의 번들입니다.

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

abstract fun setMuteThisAdListener(listener: MuteThisAdListener!): Unit

광고의 MuteThisAdListener를 설정합니다.

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

이 광고가 수익을 창출한 것으로 추정될 때 호출되는 콜백을 등록합니다.

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

네이티브 광고의 게재위치 ID를 설정합니다.

이 게재위치 ID가 보고에 포함되도록 하려면 광고를 NativeAdView와 연결하기 전에 이 메서드를 호출하세요.

매개변수
placementId: Long

구성된 게재위치에 대해 AdMob UI에서 제공하는 긴 정수입니다.

setUnconfirmedClickListener

abstract fun setUnconfirmedClickListener(
    listener: NativeAd.UnconfirmedClickListener!
): Unit

광고의 UnconfirmedClickListener를 설정합니다.