SDK-Architektur
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Plattform auswählen:
HTML5
Android
iOS
tvOS
In dieser Anleitung finden Sie einen Überblick über den SDK-Lebenszyklus und die Interaktionen zwischen Ihrem Videoplayer, dem IMA SDK und einem Ad-Server.
Einfache Interaktionen
Das folgende Diagramm veranschaulicht die Interaktionen zwischen Ihrem Videoplayer, dem IMA SDK und einem Ad-Server. Der Ad-Server kann Ad Manager, AdSense für Videos (AFV) oder Ad Exchange (AdX) verwenden.
Die Webseite oder App lädt das IMA SDK mit:
- ein eingebettetes Script-Tag für HTML5
- eine App für Android, Google Cast, iOS oder tvOS
Das IMA SDK fordert eine VAST-Antwort für den jeweiligen Anzeigenblock auf dem Ad-Server an. Der aufgerufene Ad-Server, der entweder Ad Manager im Vergleich zu AFV oder AdX sein kann, wird durch die Anzeigen-Tag-URL bestimmt.
Der Ad-Server wählt die beste Anzeige aus und sendet eine VAST-Antwort an das IMA SDK.
Anzeigen werden mit einer der folgenden Methoden ausgewählt:
- Anzeigenblockfilter in Ad Manager für Werbebuchungskandidaten
- AdSense oder Ad Exchange führt eine Auktion durch
Das IMA SDK parst die VAST-Antwort, ermittelt den richtigen Medientyp basierend auf der Umgebung und liefert das Inline-Video-Creative (und bei Bedarf Companion-Anzeigen) an die Webseite oder App.
Der Videoplayer handelt die Wiedergabedetails mit dem IMA SDK aus und spielt die Anzeigen ab.
Das IMA SDK löst bei Bedarf einen Impressions-Ping und VAST-Tracking-Ereignisse aus.
Lifecycle
In diesem Diagramm wird der vollständige Lebenszyklus des IMA SDK dargestellt. Konstruktor- und Methodenaufrufe werden blau hervorgehoben, Ereignisse rot und Fehlerbedingungen mit roten Verbindungen und rotem Text dargestellt.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-31 (UTC)."],[[["\u003cp\u003eThis guide explains the lifecycle of the Interactive Media Ads (IMA) SDK and how it facilitates communication between your video player, the SDK, and an ad server (Ad Manager, AdSense for Video, or Ad Exchange).\u003c/p\u003e\n"],["\u003cp\u003eThe process involves the IMA SDK requesting ads from the ad server based on the provided ad tag URL, the ad server selecting and sending a VAST response, and the SDK parsing this response to deliver ads to the video player.\u003c/p\u003e\n"],["\u003cp\u003eThe video player then handles ad playback while the IMA SDK manages tracking events like impressions and VAST events for reporting purposes.\u003c/p\u003e\n"],["\u003cp\u003eThis guide also visually illustrates the entire IMA SDK lifecycle including constructor calls, method calls, events, and potential errors.\u003c/p\u003e\n"]]],[],null,["Select platform: [HTML5](/interactive-media-ads/docs/sdks/html5/client-side/architecture \"View this page for the HTML5 platform docs.\") [Android](/interactive-media-ads/docs/sdks/android/client-side/architecture \"View this page for the Android platform docs.\") [iOS](/interactive-media-ads/docs/sdks/ios/client-side/architecture \"View this page for the iOS platform docs.\") [tvOS](/interactive-media-ads/docs/sdks/tvos/client-side/architecture \"View this page for the tvOS platform docs.\")\n\n\u003cbr /\u003e\n\nThis guide provides an overview of the SDK lifecycle and the interactions\nbetween your video player, the IMA SDK, and an ad server.\n\nBasic interactions\n\nThe following diagram illustrates and annotates the interactions between\nyour video player, the IMA SDK, and an ad server. The ad server can use\nAd Manager, AdSense for Video (AFV), or Ad Exchange (AdX).\n\n1. The web page or app loads the IMA SDK using:\n\n - an embedded script tag for HTML5\n - an app for Android, Google Cast, iOS, or tvOS\n2. The IMA SDK requests a VAST Response for the specific Ad Unit on the ad\n server. The ad server called, which can be either Ad Manager versus AFV or\n AdX, is determined by the ad tag URL.\n\n3. The ad server selects the best ad and sends a VAST response to the IMA SDK.\n Ads are selected using one of the following methods:\n\n - Ad Manager Ad Unit filters Line Item candidates\n - AdSense or Ad Exchange runs an auction\n4. The IMA SDK parses the VAST response, determines the correct media type based\n on environment, and delivers the inline video creative (and\n companion ads if needed) to the web page or app.\n\n5. The video player negotiates the playback details with the IMA SDK and plays\n the ads.\n\n6. The IMA SDK fires an impression ping and VAST tracking events, as needed.\n\nLifecycle\n\nThis diagram shows the full lifecycle of the IMA SDK. Constructor and method\ncalls are highlighted in blue, events are highlighted in red, and error\nconditions are shown with red connectors and red text."]]
