google.
Diese Klasse stellt einen Container für die Anzeigenauslieferung dar. Das SDK erstellt automatisch Strukturen innerhalb des containerElement-Parameters für Video- und Overlay-Anzeigen.
Beim Erstellen einer Instanz dieser Klasse wird ein IFRAME im Containerelement erstellt und der SDK-Kern geladen. Dieser IFRAME muss aufbewahrt werden, damit das SDK ordnungsgemäß funktioniert. Sobald alle Anzeigen wiedergegeben wurden und das SDK nicht mehr benötigt wird, kannst du es mit der Methode destroy() entladen.
Der containerElement-Parameter muss ein Element sein, das Teil des DOMs ist. Das Container-Element muss richtig positioniert werden, damit die Anzeigen korrekt dargestellt werden. Es wird empfohlen, sie über dem Videoplayer zu platzieren und so zu skalieren, dass er den gesamten Videoplayer abdeckt. Details zu empfohlenen Implementierungen findest du in der SDK-Dokumentation.
Hinweis:Die Methode initialize() muss immer in einem Code aufgerufen werden, der direkt durch eine Nutzeraktion (z. B. Klicken oder Tippen) aufgerufen wurde.
Konstruktor
AdDisplay-Container
new AdDisplayContainer(containerElement, videoElement, clickTrackingElement)
Parameter |
|
|---|---|
|
containerElement |
Das Element, in dem die Anzeigen ausgeliefert werden sollen. Das Element muss in das DOM eingefügt werden, bevor AdDisplayContainer erstellt werden kann. Der Wert darf nicht null sein. |
|
videoElement |
Optional Gibt das Wiedergabeelement für alternative Videoanzeigen an. Wir empfehlen, den Content-Videoplayer immer einzufügen. Der Wert darf nicht null sein. |
|
clickTrackingElement |
Optional Gibt das Klickelement der alternativen Videoanzeige an. Lassen Sie diesen Wert leer, damit das SDK Klicks verarbeiten kann. Selbst wenn sie angegeben werden, verwendet das SDK das benutzerdefinierte Klick-Tracking-Element nur, wenn Nicht-AdSense-/AdX-Creatives in Umgebungen angezeigt werden, die keine UI-Elemente unterstützen, die einen Videoplayer überlagern (z. B. iPhone oder Android vor Version 4.0). Das benutzerdefinierte Klick-Tracking-Element sollte nie über dem Videoplayer gerendert werden, da damit Klicks auf UI-Elemente, die vom SDK gerendert werden, abgefangen werden können. Das SDK ändert die Sichtbarkeit des benutzerdefinierten Klick-Tracking-Elements nicht. Wenn also ein benutzerdefiniertes Klick-Tracking-Element angegeben wird, muss es bei der Wiedergabe der linearen Anzeige richtig angezeigt werden. Sie können ima.AdsManager.isCustomClickTrackingUsed überprüfen, wenn das Ereignis ima.AdEvent.Type.STARTED ausgelöst wird, um zu bestimmen, ob Ihr benutzerdefiniertes Klick-Tracking-Element angezeigt werden soll. Gegebenenfalls sollte das Klick-Tracking-Element ausgeblendet werden, wenn das Ereignis ima.AdEvent.Type.CONTENT_RESUME_REQUESTED ausgelöst wird. Der Wert darf nicht null sein. |
Methoden
destroy
destroy()
Zerstört internen Status und zuvor erstellte DOM-Elemente. Das IMA SDK wird entladen und es sollten keine weiteren Aufrufe an APIs gesendet werden.
initialize
Initial()
Initialisiert die internen Videoelemente für die Wiedergabe. Sie müssen diese Methode als direktes Ergebnis einer Nutzeraktion aufrufen, damit der Browser das Videoelement als vom Nutzer initiiert markieren kann.
Manche Browser erlauben die Wiedergabe von Videos ohne Nutzerinteraktionen, wenn das Video stummgeschaltet ist. Verwenden Sie für dieses Verhalten AdsRequest.setAdWillPlayMuted(true) und rufen Sie diese Methode vor AdsManager.start() auf.