Unterstützung für Companion-Anzeigen hinzufügen

Plattform auswählen: HTML5 Android iOS

Dieser Leitfaden richtet sich an Publisher, die Companion-Anzeigen in ihre Android-IMA-Implementierung einbinden möchten.

Vorbereitung

• Android-App mit integriertem IMA SDK Wenn Sie noch keine App mit integriertem SDK haben, sehen Sie sich das BasicExample an. Wenn Sie Hilfe bei der Implementierung des IMA SDK in Ihrer App benötigen, lesen Sie den Artikel IMA SDK einrichten.
• 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.

Companion-Anzeigen in Ihre App einfügen

Folgen Sie der Anleitung, um eine Companion-Anzeigenfläche hinzuzufügen und Companion-Anzeigen in Ihrer App zu präsentieren.

ViewGroup zum Anzeigen des Companions erstellen

Bevor Sie eine Companion-Anzeige anfordern, müssen Sie in Ihrem Layout einen Platz dafür erstellen. Fügen Sie in der Layout-XML ein ViewGroup-Element hinzu. In diesem Beispiel wird ein LinearLayout verwendet. In einem späteren Schritt übergeben Sie einen Verweis auf dieses Element an Ihre AdDisplayContainer.

Wenn Sie die Integration in die BasicExample-App vornehmen, fügen Sie dies der Datei activity_my.xml unter videoPlayerContainer hinzu.

<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" />
companion_ad_slot_snippet.xml

CompanionAdSlot erstellen

Im nächsten Schritt wird ein CompanionAdSlot-Objekt erstellt, das dann einer ArrayList<CompanionAdSlot>-Instanz hinzugefügt wird. Die AdDisplayContainer-Schnittstelle verwendet eine Liste von Companion-Anzeigenflächen, sodass Sie mehrere Companion-Anzeigen gleichzeitig präsentieren können. Sie müssen eine Instanz der Klasse ImaSdkFactory erstellen, um das Objekt CompanionAdSlot zu erstellen.

public void createCompanionAdSlot(ViewGroup companionViewGroup) {
  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);
}
CompanionAdSnippets.java

Erstellen Sie für jede Companion-Größe, die Sie in Ihrer App präsentieren möchten, eine Companion-Anzeigenfläche. Das IMA SDK füllt die Companion-Anzeigenfläche mit allen Companions aus der VAST-Antwort, deren Abmessungen 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, fügen Sie sie der AdsLoader hinzu. In den folgenden Beispielen wird gezeigt, wie Sie dies tun, je nachdem, ob Sie die Exoplayer-IMA-Erweiterung oder andere IMA-Implementierungen verwenden, die die Erweiterung nicht verwenden.

Exoplayer-IMA-Erweiterung

public void setCompanionAdSlotExoPlayer(
    Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
  ImaAdsLoader adsLoader =
      new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}
CompanionAdSnippets.java

Sonstige Implementierungen

public void setCompanionAdSlot(
    AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
  adDisplayContainer.setCompanionSlots(companionAdSlots);
}
CompanionAdSnippets.java

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

Flexible Companion-Anzeigen einblenden

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

Android-Apps für flüssige Begleiter aktualisieren

Sie können eine flexible Companion-Anzeigenfläche deklarieren, indem Sie die Methode CompanionAdSlot.setSize() so aktualisieren, dass beide Parameter CompanionAdSlot.FLUID_SIZE sind.

companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
CompanionAdSnippets.java

FAQ

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

Prüfen Sie zuerst, ob Ihr Tag wirklich Companion-Anzeigen zurückgibt. Öffnen Sie dazu das Tag in einem Webbrowser und suchen Sie nach einem <CompanionAds>-Tag. Wenn Sie das sehen, prüfen Sie, ob die Größe des zurückgegebenen Companions mit den Abmessungen übereinstimmt, die Sie an das CompanionAdSlot-Objekt übergeben.

Wie sieht meine Companion-Anzeigenfläche aus, wenn ich dieser Anleitung folge?

Das folgende Bild wurde aus dem BasicExample erstellt. Oben wird das Contentvideo abgespielt und darunter ist die Companion-Anzeige zu sehen.