Companion-Anzeigen

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

Voraussetzungen

  • iOS-App mit integriertem IMA SDK
  • Ein Anzeigen-Tag, das so konfiguriert ist, dass eine Companion-Anzeige zurückgegeben wird.

Hilfreiche Primer

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

Companion-Anzeigen zur App hinzufügen

UIView für Ihre Companion-Anzeige erstellen

Bevor Sie eine Companion-Anzeige anfordern, müssen Sie in Ihrem Layout einen Bereich dafür erstellen. Ziehen Sie im Storyboard eine Ansicht per Drag-and-drop auf ViewController und passen Sie die Größe an Ihre Companion-Anzeige an. Stellen Sie dann sicher, dass Ihre Companion-Fläche in Ihrer Implementierung an eine Variable gebunden ist. In diesem Beispiel wird eine Variable namens „CompanionView“ verwendet. Im Screenshot unten ist die hellgraue Ansicht die Ansicht der Companion-Anzeige:

Bild, das zeigt, wie ein UIView-Element für die Companion-Anzeige erstellt wird.

IMACompanionAdSlot erstellen

Im nächsten Schritt erstellen Sie ein IMACompanionAdSlot-Objekt aus Ihrer Ansicht. Das IMA SDK füllt die Companion-Anzeigenfläche mit beliebigen 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.

ViewController.h
@property(nonatomic, weak) IBOutlet UIView *companionView;
ViewController.m
self.companionSlot =
    [[IMACompanionAdSlot alloc] initWithView:self.companionView
                                       width:self.companionView.frame.size.width
                                      height:self.companionView.frame.size.height];

Companion-Anzeigenfläche an den Anzeigencontainer übergeben

Abschließend müssen Sie dem SDK mitteilen, dass diese Companion-Fläche vorhanden ist. Dazu übergeben Sie ein Array Ihrer Companion-Flächen an den Konstruktor IMAAdDisplayContainer:

ViewController.m
return [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                           viewController:self
                                           companionSlots:@[ self.companionSlot ]];

Das ist keine Kunst! Ihre Anwendung zeigt jetzt Companion-Anzeigen an.

Companion-Anzeigen mit flexibler Größe schalten

IMA unterstützt jetzt flexible Companion-Anzeigen. Die Größe dieser Companion-Anzeigen kann an die Größe der Anzeigenfläche angepasst werden. Sie füllen 100% der Breite der übergeordneten Ansicht aus und passen dann die 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.

Bild mit den Einstellungen für Companion-Anzeigen in Ad Manager. Markiert die Option für Companion-Größen.

iOS-Apps für flexible Companions aktualisieren

Sie können einen Companion-Slot mit flexibler Größe angeben, indem Sie IMACompanionAdSlot nur mit dem Parameter view initiieren, mit Ausnahme von width und height.

ViewController.m
self.companionSlot =
      [[IMACompanionAdSlot alloc] initWithView:self.companionView];

Häufig gestellte Fragen

Ich habe die Anleitung befolgt, kann aber keine Companion-Anzeigen sehen. Was kann ich tun?
Überprüfen Sie zuerst, ob das Tag wirklich Companions zurückgibt. Öffnen Sie dazu das Tag in einem Webbrowser und suchen Sie nach einem CompanionAds-Tag. Wenn Sie dies sehen, überprüfen Sie, ob die Größe der zurückgegebenen Companion-Anzeige der Größe der UIView entspricht, in der Sie sie anzeigen möchten.