NativeAdMapper

Kotlin |Java

public abstract class NativeAdMapper

---

Klasa mapowania reklam natywnych Google AdMob.

Adaptery zapośredniczenia, które wczytują reklamę natywną, muszą rozszerzać tę klasę, aby zapewnić mapowanie obiektu reklamy natywnej z sieci reklamowej na com.google.android.gms.ads.nativead.NativeAd.

Podsumowanie

Pola publiczne
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

Konstruktory publiczne
NativeAdMapper()

Metody publiczne
View	getAdChoicesContent() Zwraca widok używany jako treść AdChoices.
final String	getAdvertiser() Zwraca tekst, który identyfikuje reklamodawcę.
final String	getBody() Zwraca tekst główny.
final String	getCallToAction() Zwraca tekst zachęcający użytkownika do podjęcia działania związanego z reklamą.
float	getCurrentTime() Pobiera bieżący czas filmu.
float	getDuration() Pobiera czas trwania filmu.
final Bundle	getExtras() Zwraca pakiet dodatków przekazanych za pomocą metody setExtras.
final String	getHeadline() Zwraca główny tekst nagłówka.
final NativeAd.Image	getIcon() Zwraca mały obraz identyfikujący reklamodawcę.
final List<NativeAd.Image>	getImages() Zwraca listę dużych obrazów.
float	getMediaContentAspectRatio() Zwraca współczynnik proporcji mediów, które mają zostać wyrenderowane w MediaView.
final boolean	getOverrideClickHandling() Zwraca wartość „prawda”, jeśli sieć reklamowa samodzielnie obsługuje kliknięcia.
final boolean	getOverrideImpressionRecording() Zwraca wartość prawda, jeśli sieć reklamowa samodzielnie śledzi wyświetlenia.
final String	getPrice() W przypadku reklam dotyczących aplikacji zwraca ciąg znaków, który wskazuje cenę aplikacji.
final Double	getStarRating() W przypadku reklam aplikacji zwraca liczbę gwiazdek od 0 do 5, która odpowiada liczbie gwiazdek aplikacji w sklepie, w którym jest ona dostępna.
final String	getStore() W przypadku reklam dotyczących aplikacji zwraca nazwę sklepu, w którym można ją pobrać.
void	handleClick(View view) Podklasy powinny implementować tę metodę, jeśli sieć wymaga, aby deweloper wyraźnie obsługiwał zdarzenia kliknięcia widoków renderowanych na ekranie.
boolean	hasVideoContent() Zwraca wartość „prawda”, jeśli bieżąca reklama zawiera treści wideo.
void	recordImpression() Podklasy powinny implementować tę metodę, jeśli sieć wymaga, aby deweloper wyraźnie rejestrował wyświetlenia widoku wyrenderowanego na ekranie.
void	setAdChoicesContent(View adChoicesContent) Ustawia widok do użycia jako treść AdChoices.
final void	setAdvertiser(String advertiser) Ustawia tekst, który identyfikuje reklamodawcę.
final void	setBody(String body) Ustawia tekst główny.
final void	setCallToAction(String callToAction) Ustawia wezwanie do działania w reklamie (np. „Kup” lub „Zainstaluj”).
final void	setExtras(Bundle extras) Ustawia pakiet dodatkowych komponentów zawierających komponenty lub atrybuty, które nie są bezpośrednio mapowane na komponenty reklamy natywnej Google (nagłówek, tekst reklamy itp.).
void	setHasVideoContent(boolean hasVideoContent) Ustaw na wartość true (prawda), jeśli bieżąca reklama zawiera treści wideo.
final void	setHeadline(String headline) Ustawia główny tekst nagłówka.
final void	setIcon(NativeAd.Image icon) Ustawia mały obraz identyfikujący reklamodawcę.
final void	setImages(List<NativeAd.Image> images) Ustawia listę dużych obrazów.
void	setMediaContentAspectRatio(float mediaContentAspectRatio) Ustawia proporcje obrazu mediów, które mają być renderowane w elementach MediaView.
void	setMediaView(View mediaView) Ustawia widok pośredni, który wyświetla multimedia.
final void	setOverrideClickHandling(boolean overrideClickHandling) Ustaw na „PRAWDA”, jeśli sieć reklamowa sama obsługuje kliknięcia.
final void	setOverrideImpressionRecording(boolean overrideImpressionRecording) Ustaw na „PRAWDA”, jeśli sieć reklamowa samodzielnie śledzi wyświetlenia.
final void	setPrice(String price) W przypadku reklam dotyczących aplikacji ustawia ciąg znaków określający cenę aplikacji.
final void	setStarRating(Double starRating) W przypadku reklam aplikacji ustawia liczbę gwiazdek od 0 do 5, która odpowiada liczbie gwiazdek przyznanych aplikacji w sklepie.
final void	setStore(String store) W przypadku reklam aplikacji ustawia nazwę sklepu, w którym można pobrać aplikację.
void	trackViews(     View containerView,     Map<String, View> clickableAssetViews,     Map<String, View> nonclickableAssetViews ) Podklasy powinny implementować tę metodę, jeśli sieć wymaga, aby deweloper przygotował stan do rejestrowania wyświetlenia lub kliknięcia przed wyświetleniem widoku na ekranie.
void	untrackView(View view) Podklasy powinny implementować tę metodę, jeśli pakiet SDK sieci zapośredniczącej udostępnia sposób na zaprzestanie śledzenia wyświetlania reklamy natywnej w przypadku reklamy zmapowanej przez ten obiekt.

Pola publiczne

adChoicesContent

public View adChoicesContent

reklamodawca

public String advertiser

treść

public String body

WezwanieDoDziałania

public String callToAction

dodatki

public Bundle extras

nagłówek

public String headline

ikona

public NativeAd.Image icon

zdjęcia

public List<NativeAd.Image> images

mediaContentAspectRatio

public float mediaContentAspectRatio

overrideClickHandling

public boolean overrideClickHandling

overrideImpressionRecording

public boolean overrideImpressionRecording

cena

public String price

starRating

public Double starRating

magazyn

public String store

Konstruktory publiczne

NativeAdMapper

public NativeAdMapper()

Metody publiczne

getAdChoicesContent

public View getAdChoicesContent()

Zwraca widok używany jako treść AdChoices.

getAdvertiser

public final String getAdvertiser()

Zwraca tekst, który identyfikuje reklamodawcę.

getBody

public final String getBody()

Zwraca tekst główny.

getCallToAction

public final String getCallToAction()

Zwraca tekst zachęcający użytkownika do podjęcia działania związanego z reklamą.

getCurrentTime

public float getCurrentTime()

Pobiera bieżący czas filmu. Domyślnie zwraca wartość 0. Podklasy powinny zastąpić tę metodę, aby zwracać niezerową aktualną godzinę dla reklam wideo.

getDuration

public float getDuration()

Pobiera czas trwania filmu. Domyślnie zwraca wartość 0. Podklasy powinny zastąpić tę metodę, aby zwracać niezerową długość reklam wideo.

getExtras

public final Bundle getExtras()

Zwraca pakiet dodatków przekazanych za pomocą metody setExtras.

getHeadline

public final String getHeadline()

Zwraca główny tekst nagłówka.

getIcon

public final NativeAd.Image getIcon()

Zwraca mały obraz identyfikujący reklamodawcę.

getImages

public final List<NativeAd.Image> getImages()

Zwraca listę dużych obrazów.

getMediaContentAspectRatio

public float getMediaContentAspectRatio()

Zwraca współczynnik proporcji mediów, które mają zostać wyrenderowane w MediaView. Jeśli format obrazu jest niedostępny, zwraca wartość 0.

getOverrideClickHandling

public final boolean getOverrideClickHandling()

Zwraca wartość „prawda”, jeśli sieć reklamowa samodzielnie obsługuje kliknięcia.

getOverrideImpressionRecording

public final boolean getOverrideImpressionRecording()

Zwraca wartość prawda, jeśli sieć reklamowa samodzielnie śledzi wyświetlenia.

getPrice

public final String getPrice()

W przypadku reklam dotyczących aplikacji zwraca ciąg znaków, który wskazuje cenę aplikacji.

getStarRating

public final Double getStarRating()

W przypadku reklam aplikacji zwraca liczbę gwiazdek od 0 do 5, która odpowiada liczbie gwiazdek aplikacji w sklepie, w którym jest ona dostępna.

getStore

public final String getStore()

W przypadku reklam dotyczących aplikacji zwraca nazwę sklepu, w którym można ją pobrać. Na przykład „Google Play”.

handleClick

public void handleClick(View view)

Podklasy powinny implementować tę metodę, jeśli sieć wymaga, aby deweloper wyraźnie obsługiwał zdarzenia kliknięcia widoków renderowanych na ekranie.

hasVideoContent

public boolean hasVideoContent()

Zwraca wartość „prawda”, jeśli bieżąca reklama zawiera treści wideo.

recordImpression

public void recordImpression()

Podklasy powinny implementować tę metodę, jeśli sieć wymaga, aby deweloper wyraźnie rejestrował wyświetlenia widoku wyrenderowanego na ekranie.

setAdChoicesContent

public void setAdChoicesContent(View adChoicesContent)

Ustawia widok do użycia jako treść AdChoices.

setAdvertiser

public final void setAdvertiser(String advertiser)

Ustawia tekst, który identyfikuje reklamodawcę. Aplikacje nie muszą wyświetlać tego zasobu, ale jest to zalecane.

Parametry
String advertiser	Tekst do ustawienia

setBody

public final void setBody(String body)

Ustawia tekst główny. Aplikacje nie muszą wyświetlać tego zasobu, ale jest to zalecane.

Parametry
String body	Opis do ustawienia

setCallToAction

public final void setCallToAction(String callToAction)

Ustawia wezwanie do działania w reklamie (np. „Kup” lub „Zainstaluj”). Aplikacje nie muszą wyświetlać tego zasobu, ale jest to zalecane.

Parametry
String callToAction	Tekst do ustawienia

setExtras

public final void setExtras(Bundle extras)

Ustawia pakiet dodatkowych komponentów zawierających komponenty lub atrybuty, które nie są bezpośrednio mapowane na komponenty reklamy natywnej Google (nagłówek, tekst reklamy itp.).

setHasVideoContent

public void setHasVideoContent(boolean hasVideoContent)

Ustaw na wartość true (prawda), jeśli bieżąca reklama zawiera treści wideo.

setHeadline

public final void setHeadline(String headline)

Ustawia główny tekst nagłówka. Aplikacje muszą wyświetlać ten zasób.

setIcon

public final void setIcon(NativeAd.Image icon)

Ustawia mały obraz identyfikujący reklamodawcę. Aplikacje nie muszą wyświetlać tego zasobu, ale jest to zalecane.

setImages

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

Ustawia listę dużych obrazów. Aplikacje nie muszą wyświetlać tego zasobu, ale jest to zalecane.

setMediaContentAspectRatio

public void setMediaContentAspectRatio(float mediaContentAspectRatio)

Ustawia proporcje obrazu mediów, które mają być renderowane w elementach MediaView.

Parametry
float mediaContentAspectRatio	format obrazu do ustawienia.

setMediaView

public void setMediaView(View mediaView)

Ustawia widok pośredni, który wyświetla multimedia. Jest to zwykle widok udostępniany przez pośredniczący pakiet SDK do wyświetlania treści wideo reklamy, ale jeśli nie ma filmu, powinien wyświetlić komponent graficzny. Adaptery powinny ustawiać widok tej usługi dla każdej reklamy.

setOverrideClickHandling

public final void setOverrideClickHandling(boolean overrideClickHandling)

Ustaw na „PRAWDA”, jeśli sieć reklamowa sama obsługuje kliknięcia.

setOverrideImpressionRecording

public final void setOverrideImpressionRecording(boolean overrideImpressionRecording)

Ustaw na „PRAWDA”, jeśli sieć reklamowa samodzielnie śledzi wyświetlenia.

setPrice

public final void setPrice(String price)

W przypadku reklam dotyczących aplikacji ustawia ciąg znaków określający cenę aplikacji. Aplikacje nie muszą wyświetlać tego zasobu, ale jest to zalecane.

Parametry
String price	Ciąg znaków określający cenę aplikacji.

setStarRating

public final void setStarRating(Double starRating)

W przypadku reklam aplikacji ustawia liczbę gwiazdek od 0 do 5, która odpowiada liczbie gwiazdek przyznanych aplikacji w sklepie. Aplikacje nie muszą wyświetlać tego zasobu, ale jest to zalecane.

setStore

public final void setStore(String store)

W przypadku reklam aplikacji ustawia nazwę sklepu, w którym można pobrać aplikację. Na przykład „Google Play”. Aplikacje nie muszą wyświetlać tego zasobu, ale jest to zalecane.

Parametry
String store	nazwę sklepu z aplikacjami, który chcesz ustawić.

trackViews

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

Podklasy powinny implementować tę metodę, jeśli sieć wymaga, aby deweloper przygotował stan do rejestrowania wyświetlenia lub kliknięcia przed wyświetleniem widoku na ekranie. Znajdź nazwy komponentów w sekcji NativeAdAssetNames.

Parametry
View containerView	Kontener View reklamy.
Map<String, View> clickableAssetViews	Map klikalnych nazw zasobów do odpowiednich
Map<String, View> nonclickableAssetViews	Map nazw zasobów, których nie można kliknąć, do odpowiadających im View.

untrackView

public void untrackView(View view)

Podklasy powinny implementować tę metodę, jeśli pakiet SDK sieci zapośredniczącej udostępnia sposób na zaprzestanie śledzenia wyświetlania reklamy natywnej w przypadku reklamy zmapowanej przez ten obiekt.