Scopri l'architettura dell'SDK
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Seleziona la piattaforma:
HTML5
Android
iOS
tvOS
Questa guida fornisce una panoramica del ciclo di vita dell'SDK e delle interazioni
tra il video player, l'SDK IMA e un ad server.
Interazioni di base
Il seguente diagramma illustra e annota le interazioni tra
il tuo video player, l'SDK IMA e un ad server. Il server pubblicitario può utilizzare
Ad Manager, AdSense per i video (AFV) o Ad Exchange (AdX).
La pagina web o l'app carica l'SDK IMA utilizzando:
- un tag script incorporato per HTML5
- un'app per Android, Google Cast, iOS o tvOS
L'SDK IMA richiede una risposta VAST per l'unità pubblicitaria specifica sull'ad server. L'ad server chiamato, che può essere Ad Manager anziché AFV o
AdX, è determinato dall'URL del tag annuncio.
L'ad server seleziona l'annuncio migliore e invia una risposta VAST all'SDK IMA.
Gli annunci vengono selezionati utilizzando uno dei seguenti metodi:
- Filtri delle unità pubblicitarie di Ad Manager per i candidati agli elementi pubblicitari
- AdSense o Ad Exchange esegue un'asta
L'SDK IMA analizza la risposta VAST, determina il tipo di media corretto in base
all'ambiente e pubblica la creatività video in linea (e
gli annunci companion, se necessario) nella pagina web o nell'app.
Il video player negozia i dettagli di riproduzione con l'SDK IMA e riproduce
gli annunci.
L'SDK IMA attiva un ping di impressione e gli eventi di monitoraggio VAST, se necessario.
Lifecycle
Questo diagramma mostra l'intero ciclo di vita dell'SDK IMA. Le chiamate a costruttori e metodi
sono evidenziate in blu, gli eventi in rosso e le condizioni di errore
sono mostrate con connettori e testo rossi.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 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."]]
