Companion-Anzeigen

Dieser Leitfaden richtet sich an Publisher, die Companion-Anzeigen zu Ihrem ihre Android-IMA-Implementierung.

Vorbereitung

• Android-App mit integriertem IMA SDK Sehen Sie sich das BasicExample an, wenn Sie Sie haben noch keine App mit integriertem SDK.
• Ein Anzeigen-Tag, das so konfiguriert ist, dass eine Companion-Anzeige zurückgegeben wird.
  • Wenn Sie ein Beispiel benötigen, sehen Sie sich unsere FAQs an.

Hilfreiche Anleitungen

Wenn Sie das IMA SDK in Ihrer App implementieren müssen, lesen Sie unseren Artikel Startleitfaden.

Companion-Anzeigen zur App hinzufügen

ViewGroup für die Anzeige der Companion-Anzeige erstellen

Bevor Sie einen Companion anfordern können, müssen Sie in Ihrem Layout. Füge in der Layout-XML ein ViewGroup-Element hinzu. dies Im Beispiel wird LinearLayout verwendet. In einem späteren Schritt werden Sie eine Verweis auf dieses Element zu deinem AdDisplayContainer. Wenn Sie in die BasicExample-App integrieren, fügen Sie dies zu activity_my.xml unter com.google.android.exoplayer2.ui.PlayerView.

activity_my.xml

<LinearLayout
  android:id="@+id/companionAdSlot"
  android:layout_width="match_parent"
  android:layout_height="250dp"
  android:layout_gravity="center_horizontal"
  android:gravity="center"
  android:orientation="vertical"
  android:textAlignment="center" />

CompanionAdSlot erstellen

Im nächsten Schritt erstellen Sie ein CompanionAdSlot-Objekt, das und dann zu ArrayList<CompanionAdSlot> hinzugefügt. AdDisplayContainer erstellt eine Liste der Companion-Anzeigenflächen, damit Sie mehrere Companion-Anzeigen gleichzeitig auszuliefern. Sie müssen eine Instanz von ImaSdkFactory zum Erstellen der CompanionAdSlot.

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

Erstellen Sie eine Companion-Anzeigenfläche für jede Companion-Größe, die Sie in Ihrer App präsentieren möchten. Das IMA SDK füllt die Companion-Anzeigenfläche mit allen Companions aus der VAST-Antwort, die Abmessungen haben, die der Höhe und Breite der Ansicht entsprechen. Das IMA SDK unterstützt auch die Verwendung von Companions mit flexibler Größe. Nachdem Sie die companionAdSlots erstellt haben, mussten sie hinzugefügt werden zu: AdsLoader. Die folgenden Beispiele zeigen, wie Sie dies tun, je nachdem, ob Sie verwenden die IMA Android BasicExample verwendet die Methode Exoplayer-IMA-Erweiterung oder andere IMA-Implementierungen, bei denen die Erweiterung nicht verwendet wird.

BasicExample

adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();

Sonstige Implementierungen

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

Das ist keine Kunst! In Ihrer Anwendung werden jetzt Companion-Anzeigen angezeigt. Anzeigen.

Fließende Companion-Anzeigen präsentieren

IMA unterstützt jetzt flexible Companion-Anzeigen. Die Größe dieser Companion-Anzeigen kann an die Größe der Anzeige angepasst werden. Slot. Sie nehmen 100% der Breite der übergeordneten Ansicht ein und passen ihre Höhe dann an die Größe des Companion-Creatives an. Inhalte. Sie werden mit der Companion-Größe Fluid in Ad Manager festgelegt. Weitere Informationen finden Sie in der folgende Abbildung zeigt, wo dieser Wert festgelegt werden kann.

Android-Apps für flexible Companions aktualisieren

Sie können eine flexible Companion-Anzeigenfläche deklarieren, indem Sie das Feld CompanionAdSlot.setSize() für CompanionAdSlot.FLUID_SIZE als beide Parameter.

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

FAQ

Ich habe die Anleitung befolgt, sehe aber keine Companion-Anzeigen. Was soll ich tun?

Überprüfen Sie zuerst, ob Ihr Tag wirklich Companions zurückgibt. Aufgabe öffnen Sie das Tag in einem Webbrowser und suchen Sie nach einem CompanionAds-Tag. Wenn Sie Überprüfen Sie, ob die zurückgegebene Companion-Größe mit der als Maße verwenden, die Sie an die CompanionAdSlot übergeben.

Wie sieht meine Companion-Anzeigenfläche aus, wenn ich diesen Leitfaden befolge?

Das Bild unten wurde aus erstellt. BasicExample und das Contentvideo wird darüber zusammen mit der Companion-Anzeige unten wiedergegeben.