Mit den IMA SDKs lassen sich Multimedia-Anzeigen ganz einfach in Ihre Websites und Apps einbinden. Mit IMA SDKs können Anzeigen von jedem VAST-konformen Ad-Server angefordert und die Anzeigenwiedergabe in Ihren Apps verwaltet werden. Mit IMA DAI SDKs senden Apps eine Streamanfrage für Anzeigen- und Content-Videos – entweder VOD- oder Liveinhalte. Das SDK gibt dann einen kombinierten Videostream zurück, sodass Sie das Umschalten zwischen Anzeigen- und Inhaltsvideo in Ihrer App nicht verwalten müssen.
Wählen Sie die DAI-Lösung aus, die Sie interessiert.
Komplettservice für die dynamische Anzeigenbereitstellung
In diesem Leitfaden wird die Integration des IMA DAI SDK in eine Videoplayer-App beschrieben. Wenn Sie sich eine vollständige Beispielintegration ansehen oder ihr folgen möchten, laden Sie BasicExample von GitHub herunter.
IMA DAI – Übersicht
Die Implementierung von IMA DAI umfasst vier Haupt-SDK-Komponenten, wie in diesem Leitfaden beschrieben:
IMAAdDisplayContainer: Ein Containerobjekt, das sich über dem Element für die Videowiedergabe befindet und die UI-Elemente der Anzeige enthält.IMAAdsLoader– Ein Objekt, das Streams anfordert und Ereignisse verarbeitet, die durch Antwortobjekte für Streamanfragen ausgelöst werden. Sie sollten nur einen Anzeigen-Loader instanziieren, der während der gesamten Lebensdauer der Anwendung wiederverwendet werden kann.IMAStreamRequest– entweder eineIMAVODStreamRequestoder eineIMALiveStreamRequest. Ein Objekt, das eine Streamanfrage definiert. Streamanfragen können entweder für Video-on-Demand- oder Livestreams erfolgen. In Livestream-Anfragen wird ein Asset-Schlüssel angegeben, in VOD-Anfragen eine CMS-ID und eine Video-ID. Beide Anfragetypen können optional einen API-Schlüssel enthalten, der für den Zugriff auf bestimmte Streams erforderlich ist, sowie einen Google Ad Manager-Netzwerkcode für das IMA SDK, damit Anzeigenkennungen gemäß den Google Ad Manager-Einstellungen verarbeitet werden.IMAStreamManager: Ein Objekt, das Streams für die dynamische Anzeigenbereitstellung und Interaktionen mit dem DAI-Backend verarbeitet. Der Stream-Manager verarbeitet auch Tracking-Pings und leitet Stream- und Anzeigenereignisse an den Publisher weiter.
Vorbereitung
Für den Start ist Folgendes erforderlich:
- Xcode 13 oder höher
- Methode zum Installieren des IMA SDK:
- Swift Package Manager (bevorzugt)
- Eine Downloadkopie des IMA SDK für iOS
Außerdem benötigen Sie die Parameter, um Ihren Stream über das IMA SDK anzufordern. Beispiele für Anfrageparameter finden Sie unter Beispielstreams.
| Livestream-Parameter | |
|---|---|
| Assetschlüssel |
Der Asset-Schlüssel, mit dem Ihr Livestream in Google Ad Manager identifiziert wird. Beispiel: c-rArva4ShKVIAkNfy6HUQ
|
| VOD-Streamparameter | |
| ID der Contentquelle |
Die Contentquellen-ID aus Google Ad Manager. Beispiel: 2548831
|
| Video-ID |
Die Video-ID aus Google Ad Manager. Beispiel: tears-of-steel
|
| Häufige Parameter (VOD und Livestream) | |
| Netzwerkcode |
Ihr Google Ad Manager-Netzwerkcode. Beispiel: 21775744923
|
Neues Xcode-Projekt erstellen
Erstellen Sie in Xcode ein neues iOS-Projekt mit Objective-C mit dem Namen „BasicExample“.
IMA DAI SDK zum Xcode-Projekt hinzufügen
Wählen Sie eine bevorzugte Methode aus, um das IMA SDK zu installieren.
Empfohlen: SDK mit Swift Package Manager installieren
Das Interactive Media Ads SDK unterstützt ab Version 3.18.4 den Swift Package Manager. So importieren Sie das Swift-Paket:
Installieren Sie in Xcode das IMA DAI SDK-Swift-Paket: Gehen Sie zu File > Add Packages.
Suchen Sie im angezeigten Prompt nach dem GitHub-Repository für das IMA DAI SDK Swift Package:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-iosWählen Sie die Version des IMA DAI SDK Swift Package aus, die Sie verwenden möchten. Verwenden Sie für neue Projekte die Option Bis zur nächsten Hauptversion.
Anschließend löst Xcode die Paketabhängigkeiten auf und lädt sie im Hintergrund herunter. Weitere Informationen zum Hinzufügen von Paketabhängigkeiten finden Sie in diesem Artikel von Apple.
SDK manuell herunterladen und installieren
Wenn Sie Swift Package Manager nicht verwenden möchten, laden Sie das IMA SDK herunter und fügen Sie es Ihrem Projekt manuell hinzu.
Videoplayer erstellen
Implementieren Sie einen Videoplayer in Ihrem Haupt-View-Controller. Umschließen Sie einen AV-Player mit einer UI-Ansicht. Das IMA SDK verwendet die UI-Ansicht, um UI-Elemente für Anzeigen zu rendern.
Objective-C
Swift
Anzeigenladeprogramm initialisieren
Importieren Sie das IMA SDK in Ihren View-Controller und übernehmen Sie die Protokolle IMAAdsLoaderDelegate und IMAStreamManagerDelegate, um Ereignisse des Anzeigenladers und des Stream-Managers zu verarbeiten.
Fügen Sie diese privaten Eigenschaften hinzu, um wichtige IMA SDK-Komponenten zu speichern:
IMAAdsLoader- Verwaltet Streamanfragen während der gesamten Lebensdauer Ihrer App.
IMAAdDisplayContainer- Verarbeitet das Einfügen und Verwalten von Benutzeroberflächenelementen für Anzeigen.
IMAAVPlayerVideoDisplay: Stellt die Kommunikation zwischen dem IMA SDK und Ihrem Media-Player her und verarbeitet zeitgesteuerte Metadaten.IMAStreamManager: Verwaltet die Streamwiedergabe und löst werbebezogene Ereignisse aus.
Initialisieren Sie das Anzeigenladeprogramm, den Anzeigen-Container und die Videoanzeige nach dem Laden der Ansicht.
Objective-C
Swift
Streaminganfrage stellen
Wenn ein Nutzer auf die Schaltfläche „Wiedergabe“ drückt, senden Sie eine neue Streamanfrage.
Verwende die Klasse IMALiveStreamRequest für Livestreams. Verwenden Sie für VOD-Streams die Klasse IMAVODStreamRequest.
Für die Streamanfrage sind Ihre Streamparameter sowie ein Verweis auf Ihren Anzeigencontainer und Ihre Videoanzeige erforderlich.
Objective-C
Swift
Auf Stream-Ladeereignisse warten
Die Klasse IMAAdsLoader ruft die Methoden IMAAdsLoaderDelegate auf, wenn die Streamanfrage erfolgreich initialisiert wird oder fehlschlägt.
Legen Sie in der Delegatenmethode adsLoadedWithData IMAStreamManagerDelegate fest.
Stream-Manager initialisieren Bei der Initialisierung startet der Streammanager die Wiedergabe.
Protokollieren Sie den Fehler in der Delegatenmethode failedWithErrorData. Optional: Spielen Sie den Backup-Stream ab. Best Practices für DAI
Objective-C
Swift
Auf Anzeigenereignisse warten
Mit IMAStreamManager werden die Methoden IMAStreamManagerDelegate aufgerufen, um Streamereignisse und ‑fehler an Ihre Anwendung zu übergeben.
In diesem Beispiel werden die primären Anzeigenereignisse in der Konsole protokolliert:
Objective-C
Swift
Führen Sie Ihre App aus. Wenn das funktioniert, fordern Sie Google-Streams für die dynamische Anzeigenbereitstellung mit dem IMA SDK an und spielen Sie sie ab. Weitere Informationen zu erweiterten SDK-Funktionen finden Sie in den anderen Anleitungen in der linken Seitenleiste oder in den Beispielen auf GitHub.