Companion-Anzeigen

Dieser Leitfaden richtet sich an Publisher, die ihrer Android-IMA-Implementierung Companion-Anzeigen hinzufügen möchten.

Vorbereitung

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

Hilfreiche Einführungen

Wenn du das IMA SDK noch in deiner App implementieren musst, lies den Einstiegsleitfaden.

Ihrer App Companion-Anzeigen hinzufügen

ViewGroup zum Darstellen des Companion-Videos erstellen

Bevor Sie einen Companion anfordern, müssen Sie in Ihrem Layout einen Bereich dafür erstellen. Fügen Sie Ihrem Layout-XML-Code ein ViewGroup-Element hinzu. In diesem Beispiel wird ein LinearLayout verwendet. In einem späteren Schritt übergeben Sie eine Referenz auf dieses Element an AdDisplayContainer. Wenn Sie die Integration in die BasicExample-App vornehmen, fügen Sie diesen Code unter videoPlayerContainer in activity_my.xml ein.

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 dann einem ArrayList<CompanionAdSlot> hinzugefügt wird. Für AdDisplayContainer wird eine Liste mit Companion-Anzeigen-Slots verwendet, damit mehrere Companion-Anzeigen gleichzeitig ausgeliefert werden können. Sie müssen eine Instanz von ImaSdkFactory erstellen, um CompanionAdSlot zu erstellen.

  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 Anzeigenfläche für Anzeigen mit Zusatzinformationen für jede Größe, die Sie in Ihrer App präsentieren möchten. Im IMA SDK wird die Anzeigenfläche für Anzeigen mit Zusatzinformationen mit allen Anzeigen aus der VAST-Antwort ausgefüllt, deren Abmessungen der Höhe und Breite des Ansichtsbereichs entsprechen. Das IMA SDK unterstützt auch die Verwendung von flexiblen Companions. Nachdem Sie die companionAdSlots erstellt haben, müssen sie der AdsLoader hinzugefügt werden. In den folgenden Beispielen wird gezeigt, wie du vorgehen musst, je nachdem, ob du das IMA Android BasicExample verwendest, das die Exoplayer-IMA-Erweiterung verwendet, oder andere IMA-Implementierungen, die die Erweiterung nicht verwenden.

BasicExample

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

Sonstige Implementierungen

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

Das ist keine Kunst! In Ihrer App werden jetzt Companion-Anzeigen ausgeliefert.

Fluide Companion-Anzeigen ausliefern

IMA unterstützt jetzt flexible Companion-Anzeigen. Die Größe dieser Anzeigen kann an die Größe der Anzeigenfläche angepasst werden. Sie füllen 100% der Breite der übergeordneten Ansicht aus und passen dann ihre Höhe an den Inhalt des Companion-Widgets an. Sie werden in Ad Manager mit der Companion-Größe Fluid festgelegt. In der folgenden Abbildung sehen Sie, wo Sie diesen Wert festlegen.

Android-Apps für flüssige Companion-Apps aktualisieren

Du kannst einen flexiblen Companion-Slot deklarieren, indem du die Methode CompanionAdSlot.setSize() so aktualisierst, dass sie CompanionAdSlot.FLUID_SIZE als beide Parameter annimmt.

  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 der Anleitung gefolgt, aber Companion-Anzeigen werden nicht ausgeliefert. Was soll ich tun?

Prüfen Sie zuerst, ob Ihr Tag tatsächlich Begleiter zurückgibt. Öffnen Sie dazu das Tag in einem Webbrowser und suchen Sie nach einem CompanionAds-Tag. Prüfe in diesem Fall, ob die Größe des zurückgegebenen Companion mit den Abmessungen übereinstimmt, die du an das CompanionAdSlot-Objekt übergibst.

Wie sieht mein Anzeigenblock für Companion-Anzeigen aus, wenn ich diesen Leitfaden befolge?

Das Bild unten wurde aus dem BasicExample erstellt. Das Video mit den Inhalten wird oben und die Companion-Anzeige unten wiedergegeben.