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

Diese Anleitung richtet sich an Publisher, die ihrer Android-IMA-Implementierung Companion-Anzeigen hinzufügen 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 Hilfeartikel IMA SDK einrichten.
• Ein Anzeigen-Tag, das so konfiguriert ist, dass eine Companion-Anzeige zurückgegeben wird Ein Beispiel finden Sie in den FAQ.

App Companion-Anzeigen hinzufügen

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

`ViewGroup` zum Ausliefern des Companions erstellen

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

Wenn Sie die Integration in die BasicExample-App vornehmen, fügen Sie der activity_my.xml Datei unterhalb von videoPlayerContainer Folgendes 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 erstellen Sie ein CompanionAdSlot-Objekt, das dann einer ArrayList<CompanionAdSlot>-Instanz hinzugefügt wird. Die AdDisplayContainer-Schnittstelle verwendet eine Liste von Companion-Anzeigenplätzen, sodass Sie mehrere Companion-Anzeigen gleichzeitig ausliefern können. Sie müssen eine Instanz der Klasse ImaSdkFactory erstellen, um das CompanionAdSlot-Objekt 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 eine Companion-Anzeigenfläche für jede Größe des Companions, die in Ihrer App ausgeliefert werden soll. 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 dem 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, bei denen die Erweiterung nicht verwendet wird.

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

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

Ja, so einfach ist das! In Ihrer Anwendung werden jetzt Companion-Anzeigen ausgeliefert.

Companion-Anzeigen mit flexibler Größe ausliefern

IMA unterstützt Companion-Anzeigen mit flexibler Größe. Die Größe dieser Companion-Anzeigen kann an die Größe der Anzeigenfläche angepasst werden. Sie füllen die gesamte Breite der übergeordneten Ansicht 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. Auf der folgenden Abbildung sehen Sie, wo Sie diesen Wert festlegen können.

Android-Apps für Companion-Anzeigen mit flexibler Größe aktualisieren

Sie können einen Companion-Anzeigenplatz mit flexibler Größe deklarieren, indem Sie die CompanionAdSlot.setSize() Methode so aktualisieren, dass CompanionAdSlot.FLUID_SIZE als beide Parameter verwendet wird.

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

FAQ

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

Prüfen Sie zuerst, ob Ihr Tag wirklich Companions zurückgibt. Öffnen Sie dazu das Tag in einem Webbrowser und suchen Sie nach einem <CompanionAds>-Tag. Wenn Sie es finden, 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?

Die folgende Abbildung wurde aus dem BasicExample erstellt. Das Video mit den Inhalten wird oben und die Companion-Anzeige darunter ausgeliefert.