Native Anzeige ausliefern
Wenn eine native Anzeige geladen wird, ruft das Google Mobile Ads SDK den Listener für den das entsprechende Anzeigenformat. Ihre App ist dann für die Auslieferung der Anzeige verantwortlich, auch wenn dies nicht unbedingt sofort geschehen muss. Um die Darstellung von systemdefinierte Anzeigenformate vereinfacht, bietet das SDK einige nützliche Ressourcen, wie beschrieben.
Klasse NativeAdView
Für das NativeAd
-Format gibt es die entsprechende Klasse NativeAdView
. Dieser Kurs ist ein
ViewGroup
das Publisher als Stamm für NativeAd
verwenden sollten. A
einzelne NativeAdView
entspricht einer einzelnen nativen Anzeige.
Jede Ansicht, die zum Einblenden der Assets dieser Anzeige verwendet wird (die ImageView
, in der die
Screenshot-Asset) sollte ein untergeordnetes Element von NativeAdView
sein.
-Objekt enthält.
Die Ansichtshierarchie für eine native Anzeige, für die ein
LinearLayout
Asset-Ansichten anzuzeigen, könnte wie folgt aussehen:
<com.google.android.gms.ads.nativead.NativeAdView
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<LinearLayout
android:orientation="vertical"
... >
<LinearLayout
android:orientation="horizontal"
... >
<ImageView
android:id="@+id/ad_app_icon"
... />
<TextView
android:id="@+id/ad_headline"
... />
</LinearLayout>
// Other assets such as image or media view, call to action, etc follow.
...
</LinearLayout>
</com.google.android.gms.ads.nativead.NativeAdView>
Hier ist ein Beispiel, mit dem ein NativeAdView
und
füllt es mit einem NativeAd
:
Java
AdLoader.Builder builder = new AdLoader.Builder(this, "AD_UNIT_ID")
.forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
@Override
public void onNativeAdLoaded(NativeAd nativeAd) {
// Assumes you have a placeholder FrameLayout in your View layout
// (with id fl_adplaceholder) where the ad is to be placed.
FrameLayout frameLayout =
findViewById(R.id.fl_adplaceholder);
// Assumes that your ad layout is in a file call native_ad_layout.xml
// in the res/layout folder
NativeAdView adView = (NativeAdView) getLayoutInflater()
.inflate(R.layout.native_ad_layout, null);
// This method sets the text, images and the native ad, etc into the ad
// view.
populateNativeAdView(nativeAd, adView);
frameLayout.removeAllViews();
frameLayout.addView(adView);
}
});
Kotlin
val builder = AdLoader.Builder(this, "AD_UNIT_ID")
.forNativeAd { nativeAd ->
// Assumes that your ad layout is in a file call native_ad_layout.xml
// in the res/layout folder
val adView = layoutInflater
.inflate(R.layout.native_ad_layout, null) as NativeAdView
// This method sets the text, images and the native ad, etc into the ad
// view.
populateNativeAdView(nativeAd, adView)
// Assumes you have a placeholder FrameLayout in your View layout
// (with id ad_frame) where the ad is to be placed.
ad_frame.removeAllViews()
ad_frame.addView(adView)
}
Alle Assets für eine bestimmte native Anzeige müssen im
NativeAdView
-Layout. Das Google Mobile Ads SDK protokolliert eine Warnung, wenn
native Assets werden außerhalb des Ansichtslayouts einer nativen Anzeige gerendert.
Die Anzeigenansichtsklassen bieten auch Methoden zum Registrieren der Ansicht, die für jedes einzelne Asset verwendet wird, und eine zum Registrieren des NativeAd
-Objekts selbst.
Wenn die Ansichten auf diese Weise registriert werden, kann das SDK Aufgaben automatisch verarbeiten.
Beispiele:
- Klicks werden erfasst
- Impressionen erfassen, wenn das erste Pixel auf dem Bildschirm sichtbar ist
- Datenschutzinfo-Overlay anzeigen
Datenschutzinfo-Overlay
Jedem Anzeigenaufruf wird vom SDK ein Datenschutzinfo-Overlay hinzugefügt. Lassen Sie Platz in Ihrem Ecke Ihrer Website oder App native Anzeigenansicht für das automatisch eingefügte Datenschutzinfo-Logo. Außerdem ist es Es ist wichtig, dass das Datenschutzinfo-Overlay gut zu sehen ist. Wählen Sie daher Hintergrundfarben aus. und Bilder entsprechend anpassen. Weitere Informationen zur Darstellung und zum Feld für native Anzeigen Beschreibungen.
Anzeigenkennzeichnung
Sie müssen eine Anzeigenkennzeichnung einblenden, um darauf hinzuweisen, dass es sich bei dem Aufruf um Werbung handelt. Weitere Informationen finden Sie in unseren Richtlinien. .
Codebeispiel
So stellen Sie eine native Anzeige bereit:
- Erstellen Sie eine Instanz der Klasse
NativeAdView
. - Für jedes Anzeigen-Asset, das präsentiert werden soll:
- Fülle die Asset-Ansicht mit dem Asset im Anzeigenobjekt.
- Registrieren Sie die Assetansicht mit der Klasse
ViewGroup
.
- Registrieren Sie die
MediaView
Das Layout der nativen Anzeige umfasst ein großes Media-Asset. - Registrieren Sie das Anzeigenobjekt mit der Klasse
ViewGroup
.
Hier ist eine Beispielfunktion, die ein NativeAd
anzeigt:
Java
private void displayNativeAd(ViewGroup parent, NativeAd ad) {
// Inflate a layout and add it to the parent ViewGroup.
LayoutInflater inflater = (LayoutInflater) parent.getContext()
.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
NativeAdView adView = (NativeAdView) inflater
.inflate(R.layout.ad_layout_file, parent);
// Locate the view that will hold the headline, set its text, and call the
// NativeAdView's setHeadlineView method to register it.
TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline);
headlineView.setText(ad.getHeadline());
adView.setHeadlineView(headlineView);
...
// Repeat the above process for the other assets in the NativeAd
// using additional view objects (Buttons, ImageViews, etc).
...
// If the app is using a MediaView, it should be
// instantiated and passed to setMediaView. This view is a little different
// in that the asset is populated automatically, so there's one less step.
MediaView mediaView = (MediaView) adView.findViewById(R.id.ad_media);
adView.setMediaView(mediaView);
// Call the NativeAdView's setNativeAd method to register the
// NativeAdObject.
adView.setNativeAd(ad);
// Ensure that the parent view doesn't already contain an ad view.
parent.removeAllViews();
// Place the AdView into the parent.
parent.addView(adView);
}
Kotlin
fun displayNativeAd(parent: ViewGroup, ad: NativeAd) {
// Inflate a layout and add it to the parent ViewGroup.
val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE)
as LayoutInflater
val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView
// Locate the view that will hold the headline, set its text, and use the
// NativeAdView's headlineView property to register it.
val headlineView = adView.findViewById<TextView>(R.id.ad_headline)
headlineView.text = ad.headline
adView.headlineView = headlineView
...
// Repeat the above process for the other assets in the NativeAd using
// additional view objects (Buttons, ImageViews, etc).
...
val mediaView = adView.findViewById<MediaView>(R.id.ad_media)
adView.mediaView = mediaView
// Call the NativeAdView's setNativeAd method to register the
// NativeAdObject.
adView.setNativeAd(ad)
// Ensure that the parent view doesn't already contain an ad view.
parent.removeAllViews()
// Place the AdView into the parent.
parent.addView(adView)
}
Hier sind die einzelnen Aufgaben:
Layout vergrößern
Java
LayoutInflater inflater = (LayoutInflater) parent.getContext() .getSystemService(Context.LAYOUT_INFLATER_SERVICE); NativeAdView adView = (NativeAdView) inflater .inflate(R.layout.ad_layout_file, parent);
Kotlin
val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE) as LayoutInflater val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView
Dieser Code bläht ein XML-Layout auf, das Ansichten zum Anzeigen einer nativen Anzeige und finden dann einen Verweis auf
NativeAdView
. Sie können auch Sie können eine vorhandeneNativeAdView
wiederverwenden, wenn sie in Ihrem Fragment oder Ihrer Aktivität vorhanden ist, oder eine Instanz dynamisch ohne Verwendung einer Layoutdatei erstellen.Asset-Ansichten ausfüllen und registrieren
In diesem Codebeispiel wird die Ansicht gefunden, die zum Darstellen des Titels verwendet wird. Der Text wird dann mit dem String-Asset festgelegt, das vom Anzeigenobjekt bereitgestellt wird, und beim
NativeAdView
-Objekt registriert:Java
TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline); headlineView.setText(ad.getHeadline()); adView.setHeadlineView(headlineView);
Kotlin
val headlineView = adView.findViewById<TextView>(R.id.ad_headline) headlineView.text = ad.headline adView.headlineView = headlineView
Dieser Prozess des Suchens der Ansicht, Festlegen ihres Werts und Registrieren mit sollte die Anzeigenansichtsklasse für jedes der vom natives Anzeigenobjekt, das in der App zu sehen ist.
Umgang mit Klicks
Implementieren Sie keine benutzerdefinierten Klick-Handler bei Ansichten über oder innerhalb des Aufruf einer nativen Anzeige. Wenn Sie Klickereignisse selbst beobachten möchten, verwenden Sie die Anzeige Listener.
Klicks auf die Anzeigenaufruf-Assets werden vom SDK verarbeitet, sofern Sie Asset-Ansichten erstellen und registrieren, wie im vorherigen Abschnitt beschrieben.
Hier ein Beispiel, in dem ein Anzeigen-Listener verwendet wird, um Klickereignisse zu erfassen:
Java
AdLoader adLoader = new AdLoader.Builder(context, "ca-app-pub-3940256099942544/2247696110") ... .withAdListener(new AdListener() { @Override public void onAdFailedToLoad(LoadAdError adError) { // Handle the failure by logging, altering the UI, and so on. } @Override public void onAdClicked() { // Log the click event or other custom behavior. } }) .build();
Kotlin
val adLoader = AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110") ... .withAdListener(object : AdListener() { override fun onAdFailedToLoad(adError: LoadAdError) { // Handle the failure by logging, altering the UI, and so on. } }) .build()
MediaView registrieren
Sie müssen das
MediaView
Asset anstelle desImageView
-Asset, wenn Sie ein Haupt-Bild-Asset in das Layout für Ihre native Anzeige.Das
MediaView
ist ein speziellesView
-Element zum Anzeigen des primären Media-Assets, entweder ein Video oder ein Bild.MediaView
kann in einem XML-Layout definiert oder dynamisch konstruiert werden. Es sollte innerhalb der Ansichtshierarchie einesNativeAdView
platziert werden, andere Asset-Ansicht. Apps, dieMediaView
verwenden, müssen diese beimNativeAdView
:Java
MediaView mediaView = adView.findViewById(R.id.ad_media); adView.setMediaView(mediaView);
Kotlin
adView.mediaView = adView.findViewById<MediaView>(R.id.ad_media)
Wie bei allen Assetansichten muss auch bei der Mediaansicht der Inhalt dargestellt werden. Dies erfolgt mithilfe der
getMediaContent()
Medieninhalte abzurufen, die an einenMediaView
Hier sehen Sie ein Code-Snippet, mit dem die Medieninhalte für die Medien festgelegt werden. Ansicht:Java
mediaView.setMediaContent(nativeAd.getMediaContent());
Kotlin
mediaView.mediaContent = nativeAd.mediaContent
ImageScaleType
Die
MediaView
-Klasse hat beim Anzeigen einImageScaleType
-Attribut. Bilder. Wenn Sie ändern möchten, wie ein Bild imMediaView
skaliert wird, legen Sie Folgendes fest: Den entsprechendenImageView.ScaleType
unter Verwendung vonsetImageScaleType()
vonMediaView
:Java
mediaView.setImageScaleType(ImageView.ScaleType.CENTER_CROP);
Kotlin
mediaView.imageScaleType = ImageView.ScaleType.CENTER_CROP
MediaContent
Die Klasse
MediaContent
enthält die Daten zu den Medieninhalten der native Anzeige, die mithilfe der KlasseMediaView
ausgeliefert wird. Wenn der Parameter Das AttributMediaView
mediaContent
wird mit einerMediaContent
-Instanz festgelegt:Wenn ein Video-Asset verfügbar ist, wird es gepuffert und in der
MediaView
wiedergegeben. Sie können feststellen, ob ein Video-Asset verfügbar ist, indem SiehasVideoContent()
Wenn die Anzeige kein Video-Asset enthält, wird das
mainImage
-Asset heruntergeladen. und stattdessen imMediaView
platziert.
Standardmäßig ist
mainImage
das erste heruntergeladene Bild-Asset. WennsetReturnUrlsForImageAssets(true)
wird verwendet,mainImage
istnull
und Sie müssen Legen Sie für die EigenschaftmainImage
das manuell heruntergeladene Bild fest. Dieses Bild wird nur verwendet, wenn kein Video-Asset verfügbar ist.Natives Anzeigenobjekt registrieren
In diesem letzten Schritt wird das native Anzeigenobjekt in der Ansicht registriert, die für die Anzeige verantwortlich ist:
Java
adView.setNativeAd(ad);
Kotlin
adView.setNativeAd(ad)
Anzeige löschen
Wenn Sie die Auslieferung Ihrer nativen Anzeige beendet haben, sollten Sie sie löschen, damit sie ordnungsgemäß vom Garbage Collector erfasst wird.
Java
nativeAd.destroy();
Kotlin
nativeAd.destroy()
Beispiele auf GitHub
Vollständige Implementierung von nativen Anzeigen:
Nächste Schritte
Sehen Sie sich die folgenden Themen an: