NativeAdMapper

Kotlin |자바

public abstract class NativeAdMapper

---

Google AdMob 네이티브 광고의 매핑 클래스입니다.

네이티브 광고를 로드하는 미디에이션 어댑터는 이 클래스를 확장하여 미디에이션된 광고 네트워크의 네이티브 광고 객체를 com.google.android.gms.ads.nativead.NativeAd에 매핑해야 합니다.

요약

공개 필드
View	adChoicesContent
String	advertiser
String	body
String	callToAction
Bundle	extras
String	headline
NativeAd.Image	icon
List<NativeAd.Image>	images
float	mediaContentAspectRatio
boolean	overrideClickHandling
boolean	overrideImpressionRecording
String	price
Double	starRating
String	store

공개 생성자
NativeAdMapper()

공개 메서드
View	getAdChoicesContent() AdChoices 콘텐츠로 사용 중인 뷰를 반환합니다.
final String	getAdvertiser() 광고주를 식별하는 텍스트를 반환합니다.
final String	getBody() 본문 텍스트를 반환합니다.
final String	getCallToAction() 사용자가 광고와 관련된 액션을 취하도록 유도하는 텍스트를 반환합니다.
float	getCurrentTime() 동영상의 현재 시간을 가져옵니다.
float	getDuration() 동영상 길이를 가져옵니다.
final Bundle	getExtras() setExtras 메서드를 통해 전달된 추가 항목 번들을 반환합니다.
final String	getHeadline() 기본 텍스트 광고 제목을 반환합니다.
final NativeAd.Image	getIcon() 광고주를 식별하는 작은 이미지를 반환합니다.
final List<NativeAd.Image>	getImages() 대형 이미지 목록을 반환합니다.
float	getMediaContentAspectRatio() MediaView에서 렌더링할 미디어의 가로세로 비율을 반환합니다.
final boolean	getOverrideClickHandling() 광고 네트워크에서 자체적으로 클릭 처리를 실행하는 경우 true를 반환합니다.
final boolean	getOverrideImpressionRecording() 광고 네트워크에서 자체적으로 노출 추적을 실행하는 경우 true를 반환합니다.
final String	getPrice() 앱에 관한 광고의 경우 앱 가격을 나타내는 문자열을 반환합니다.
final Double	getStarRating() 앱에 대한 광고의 경우 앱을 제공하는 스토어에서 앱이 받은 별표 수를 나타내는 0~5의 별표 평점을 반환합니다.
final String	getStore() 앱에 관한 광고의 경우 앱을 다운로드할 수 있는 스토어의 이름을 반환합니다.
void	handleClick(View view) 네트워크에서 개발자가 화면에 렌더링된 뷰의 클릭 이벤트를 명시적으로 처리하도록 요구하는 경우 서브클래스는 이 메서드를 구현해야 합니다.
boolean	hasVideoContent() 현재 광고에 동영상 콘텐츠가 있으면 true를 반환합니다.
void	recordImpression() 네트워크에서 개발자가 화면에 렌더링된 뷰의 노출을 명시적으로 기록하도록 요구하는 경우 서브클래스는 이 메서드를 구현해야 합니다.
void	setAdChoicesContent(View adChoicesContent) AdChoices 콘텐츠로 사용될 뷰를 설정합니다.
final void	setAdvertiser(String advertiser) 광고주를 식별하는 텍스트를 설정합니다.
final void	setBody(String body) 본문 텍스트를 설정합니다.
final void	setCallToAction(String callToAction) 광고의 클릭 유도 문구 (예: '구매' 또는 '설치')를 설정합니다.
final void	setExtras(Bundle extras) Google 네이티브 광고 객체 (광고 제목, 본문 등)에 예상되는 확장 소재 또는 속성에 직접 매핑되지 않는 확장 소재 번들을 설정합니다.
void	setHasVideoContent(boolean hasVideoContent) 현재 광고에 동영상 콘텐츠가 있는 경우 true로 설정합니다.
final void	setHeadline(String headline) 기본 텍스트 광고 제목을 설정합니다.
final void	setIcon(NativeAd.Image icon) 광고주를 식별하는 작은 이미지를 설정합니다.
final void	setImages(List<NativeAd.Image> images) 대형 이미지 목록을 설정합니다.
void	setMediaContentAspectRatio(float mediaContentAspectRatio) MediaView에서 렌더링할 미디어의 가로세로 비율을 설정합니다.
void	setMediaView(View mediaView) 미디어를 표시하는 미디에이션된 뷰를 설정합니다.
final void	setOverrideClickHandling(boolean overrideClickHandling) 광고 네트워크에서 자체적으로 클릭 처리를 하는 경우 true로 설정합니다.
final void	setOverrideImpressionRecording(boolean overrideImpressionRecording) 광고 네트워크에서 자체적으로 노출 추적을 실행하는 경우 true로 설정합니다.
final void	setPrice(String price) 앱에 관한 광고의 경우 앱 가격을 나타내는 문자열을 설정합니다.
final void	setStarRating(Double starRating) 앱에 대한 광고의 경우 앱을 제공하는 스토어에서 앱이 받은 별점을 나타내는 0~5점의 별표 평점을 설정합니다.
final void	setStore(String store) 앱에 대한 광고의 경우 앱을 다운로드할 수 있는 스토어의 이름을 설정합니다.
void	trackViews(     View containerView,     Map<String, View> clickableAssetViews,     Map<String, View> nonclickableAssetViews ) 네트워크에서 개발자가 뷰가 화면에 렌더링되기 전에 노출 또는 클릭을 기록하기 위한 상태를 준비해야 하는 경우 서브클래스는 이 메서드를 구현해야 합니다.
void	untrackView(View view) 미디에이션된 네트워크의 SDK에서 이 객체에 매핑된 광고의 네이티브 광고 뷰 추적을 중지하는 방법을 제공하는 경우 하위 클래스는 이 메서드를 구현해야 합니다.

공개 필드

adChoicesContent

public View adChoicesContent

광고주

public String advertiser

본문

public String body

클릭 유도문안

public String callToAction

Extras

public Bundle extras

광고 제목

public String headline

아이콘

public NativeAd.Image icon

이미지

public List<NativeAd.Image> images

mediaContentAspectRatio

public float mediaContentAspectRatio

overrideClickHandling

public boolean overrideClickHandling

overrideImpressionRecording

public boolean overrideImpressionRecording

가격

public String price

starRating

public Double starRating

스토어

public String store

공개 생성자

NativeAdMapper

public NativeAdMapper()

공개 메서드

getAdChoicesContent

public View getAdChoicesContent()

AdChoices 콘텐츠로 사용 중인 뷰를 반환합니다.

getAdvertiser

public final String getAdvertiser()

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

getBody

public final String getBody()

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

getCallToAction

public final String getCallToAction()

사용자가 광고와 관련된 액션을 취하도록 유도하는 텍스트를 반환합니다.

getCurrentTime

public float getCurrentTime()

동영상의 현재 시간을 가져옵니다. 기본적으로 0을 반환합니다. 서브클래스는 이 메서드를 재정의하여 동영상 광고의 현재 시간을 0이 아닌 값으로 반환해야 합니다.

getDuration

public float getDuration()

동영상 길이를 가져옵니다. 기본적으로 0을 반환합니다. 서브클래스는 이 메서드를 재정의하여 동영상 광고의 길이가 0이 아닌 값을 반환해야 합니다.

getExtras

public final Bundle getExtras()

setExtras 메서드를 통해 전달된 추가 항목 번들을 반환합니다.

getHeadline

public final String getHeadline()

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

getIcon

public final NativeAd.Image getIcon()

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

getImages

public final List<NativeAd.Image> getImages()

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

getMediaContentAspectRatio

public float getMediaContentAspectRatio()

MediaView에서 렌더링할 미디어의 가로세로 비율을 반환합니다. 가로세로 비율을 사용할 수 없는 경우 0을 반환합니다.

getOverrideClickHandling

public final boolean getOverrideClickHandling()

광고 네트워크에서 자체적으로 클릭 처리를 실행하는 경우 true를 반환합니다.

getOverrideImpressionRecording

public final boolean getOverrideImpressionRecording()

광고 네트워크에서 자체적으로 노출 추적을 실행하는 경우 true를 반환합니다.

getPrice

public final String getPrice()

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

getStarRating

public final Double getStarRating()

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

getStore

public final String getStore()

앱에 관한 광고의 경우 앱을 다운로드할 수 있는 스토어의 이름을 반환합니다. 예: 'Google Play'

handleClick

public void handleClick(View view)

네트워크에서 개발자가 화면에 렌더링된 뷰의 클릭 이벤트를 명시적으로 처리하도록 요구하는 경우 서브클래스는 이 메서드를 구현해야 합니다.

hasVideoContent

public boolean hasVideoContent()

현재 광고에 동영상 콘텐츠가 있으면 true를 반환합니다.

recordImpression

public void recordImpression()

네트워크에서 개발자가 화면에 렌더링된 뷰의 노출을 명시적으로 기록하도록 요구하는 경우 서브클래스는 이 메서드를 구현해야 합니다.

setAdChoicesContent

public void setAdChoicesContent(View adChoicesContent)

AdChoices 콘텐츠로 사용될 뷰를 설정합니다.

setAdvertiser

public final void setAdvertiser(String advertiser)

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

매개변수
String advertiser	설정할 텍스트

setBody

public final void setBody(String body)

본문 텍스트를 설정합니다. 앱은 이 애셋을 표시할 필요는 없지만 표시하는 것이 좋습니다.

매개변수
String body	설정할 설명

setCallToAction

public final void setCallToAction(String callToAction)

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

매개변수
String callToAction	설정할 텍스트

setExtras

public final void setExtras(Bundle extras)

Google 네이티브 광고 객체 (광고 제목, 본문 등)에 예상되는 확장 소재 또는 속성에 직접 매핑되지 않는 확장 소재 번들을 설정합니다.

setHasVideoContent

public void setHasVideoContent(boolean hasVideoContent)

현재 광고에 동영상 콘텐츠가 있는 경우 true로 설정합니다.

setHeadline

public final void setHeadline(String headline)

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

setIcon

public final void setIcon(NativeAd.Image icon)

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

setImages

public final void setImages(List<NativeAd.Image> images)

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

setMediaContentAspectRatio

public void setMediaContentAspectRatio(float mediaContentAspectRatio)

MediaView에서 렌더링할 미디어의 가로세로 비율을 설정합니다.

매개변수
float mediaContentAspectRatio	설정할 가로세로 비율

setMediaView

public void setMediaView(View mediaView)

미디어를 표시하는 미디에이션된 뷰를 설정합니다. 이는 일반적으로 광고의 동영상 콘텐츠를 표시하기 위해 미디에이션된 SDK에서 제공하는 뷰이지만 동영상이 없는 경우에는 이미지 애셋을 표시해야 합니다. 어댑터는 모든 광고에 이 속성의 뷰를 설정해야 합니다.

setOverrideClickHandling

public final void setOverrideClickHandling(boolean overrideClickHandling)

광고 네트워크에서 자체적으로 클릭 처리를 하는 경우 true로 설정합니다.

setOverrideImpressionRecording

public final void setOverrideImpressionRecording(boolean overrideImpressionRecording)

광고 네트워크에서 자체적으로 노출 추적을 실행하는 경우 true로 설정합니다.

setPrice

public final void setPrice(String price)

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

매개변수
String price	앱 가격을 나타내는 문자열입니다.

setStarRating

public final void setStarRating(Double starRating)

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

setStore

public final void setStore(String store)

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

매개변수
String store	설정할 앱 스토어의 이름

trackViews

public void trackViews(
    View containerView,
    Map<String, View> clickableAssetViews,
    Map<String, View> nonclickableAssetViews
)

네트워크에서 개발자가 뷰가 화면에 렌더링되기 전에 노출 또는 클릭을 기록하기 위한 상태를 준비해야 하는 경우 서브클래스는 이 메서드를 구현해야 합니다. NativeAdAssetNames에서 애셋 이름을 찾습니다.

매개변수
View containerView	광고의 컨테이너 View입니다.
Map<String, View> clickableAssetViews	클릭 가능한 저작물 이름의 Map에 해당하는 .
Map<String, View> nonclickableAssetViews	클릭할 수 없는 저작물 이름의 Map를 해당 View에 연결합니다.

untrackView

public void untrackView(View view)

미디에이션된 네트워크의 SDK에서 이 객체에 매핑된 광고의 네이티브 광고 뷰 추적을 중지하는 방법을 제공하는 경우 하위 클래스는 이 메서드를 구현해야 합니다.