google. ima. AdsManager
Stellt die äußere öffentliche API für den Publisher bereit und kommuniziert mit der inneren Instanz von Ad Manager.
Methoden
minimieren
collapse()
Aktuelle Anzeige minimieren. Das funktioniert im HTML5 SDK nicht.
adsAdsManager konfigurieren
configureAdsManager(content, adsRenderingSettings)
Legt die erforderlichen Parameter fest, um über das Ereignis „AdsManagerLoaded“ einen Verweis auf dieses AdManager abzurufen.
Parameter |
|
---|---|
Inhalte |
Objekt Objekt, das die Inhalte des Publishers wiedergibt. Der Wert darf nicht null sein. |
Einstellungen für die Anzeigendarstellung |
Optional Einstellungen für das Anzeigen-Rendering Optionale Einstellungen zur Steuerung des Renderings von Anzeigen. Wert kann null sein. |
destroy
destroy()
Entfernt während der Laufzeit geladene Anzeigen-Assets, die ordnungsgemäß entfernt werden müssen, wenn die Anzeige vollständig wiedergegeben wurde. Die Anzeige und das gesamte Tracking werden dann gestoppt.
AdBreak verwerfen
adBreak() verwerfen
Wenn eine Werbeunterbrechung gerade wiedergegeben wird, verwerfen Sie sie und setzen Sie den Inhalt fort. Andernfalls kannst du die nächste geplante Werbeunterbrechung ignorieren. Dies kann beispielsweise direkt nach dem Laden des Anzeigenmanagers aufgerufen werden, um ein Pre-Roll zu ignorieren, ohne dass es in Zukunft Mid-Rolls oder Post-Rolls verlieren wird. Dies ist nur dann möglich, wenn für die Anzeigenanfrage eine Playlist oder eine VMAP-Antwort zurückgegeben wurde.
maximieren
expand()
Maximieren Sie die aktuelle Anzeige. Das funktioniert im HTML5 SDK nicht.
Konzentration
Fokus()
Verschiebt den Fokus auf die Schaltfläche zum Überspringen, falls vorhanden Falls nicht vorhanden, legen Sie den Schwerpunkt auf interaktive Elemente wie Symbole oder interaktive Creatives.
getAdskippableState
getAdskippableState() gibt einen booleschen Wert zurück
Gibt „true“ zurück, wenn die Anzeige derzeit übersprungen werden kann. Wenn sich dieser Wert ändert, löst AdsManager
ein AdEvent.SKIPPABLE_STATE_CHANGED
-Ereignis aus.
- Gibt Folgendes zurück:
-
boolean
Wahr, wenn die Anzeige derzeit übersprungen werden kann, andernfalls False.
getCuePoints
getCuePoints() gibt ein Array von Zahlen zurück
Gibt ein Array von Offsets in Sekunden an, das angibt, wann eine geplante Werbeunterbrechung wiedergegeben wird. Eine Pre-Roll wird durch 0 und eine Post-Roll durch -1 dargestellt. Ein leeres Array bedeutet, dass die Anzeige oder der Anzeigen-Pod keinen Zeitplan hat und jederzeit abgespielt werden kann.
- Gibt Folgendes zurück:
-
non-null Array of number
Liste der Zeitverschiebungen in Sekunden.
getRemainingTime
getVerbleibendeZeit() Nummer zurückgeben
Die verbleibende Zeit der aktuellen Anzeige abrufen Wenn die Anzeige noch nicht geladen ist oder die Wiedergabe beendet ist, gibt die API „-1“ zurück.
- Gibt Folgendes zurück:
-
number
Gibt die verbleibende Zeit für die aktuelle Anzeige zurück. Wenn die verbleibende Zeit für die aktuelle Anzeige nicht definiert ist (z. B. benutzerdefinierte Anzeigen), wird als Wert -1 zurückgegeben.
getVolume
getVolume() gibt Nummer zurück
Rufen Sie das Volumen für die aktuelle Anzeige ab.
- Gibt Folgendes zurück:
-
number
Die Lautstärke der aktuellen Anzeige, von 0 (stummgeschaltet) bis 1 (am weitesten).
init
init(width, height, viewMode, videoElement)
Rufen Sie init auf, um die Nutzerfreundlichkeit von Werbeanzeigen im Anzeigenmanager zu initialisieren.
Parameter |
|
---|---|
width |
Zahl Die ausgewählte Breite der Anzeige. |
height |
Zahl Die ausgewählte Höhe der Anzeige. |
Ansichtsmodus |
Ansichtsmodus Der ausgewählte Ansichtsmodus. Der Wert darf nicht null sein. |
videoElement |
Optional HTMLVideoElement Das Videoelement für die benutzerdefinierte Wiedergabe. Dieses Videoelement überschreibt das im AdDisplayContainer-Konstruktor bereitgestellte Videoelement. Verwende diese Property nur, wenn es unbedingt erforderlich ist. Andernfalls empfehlen wir, dieses Videoelement beim Erstellen des AdDisplayContainer-Elements anzugeben. Wert kann null sein. |
isCustomClickTrackingUsed
isCustomClickTrackingUsed() gibt boolesche Werte zurück
Gibt „true“ zurück, wenn ein benutzerdefiniertes Klick-Tracking-Element für die Klick-Tracking-Funktion in der aktuellen Anzeige verwendet wird. Benutzerdefiniertes Klick-Tracking wird nur verwendet, wenn ein optionales Klick-Tracking-Element für AdDisplayContainer
bereitgestellt wird, eine benutzerdefinierte Wiedergabe verwendet wird und die aktuelle Anzeige keine AdSense/AdX-Anzeige ist.
- Gibt Folgendes zurück:
-
boolean
Gibt an, ob benutzerdefiniertes Klick-Tracking verwendet wird.
isCustomPlaybackUsed verwendet
isCustomPlaybackUsed() gibt einen booleschen Wert zurück.
Gibt „true“ zurück, wenn ein benutzerdefiniertes Videoelement zum Abspielen der aktuellen Anzeige verwendet wird. Die benutzerdefinierte Wiedergabe erfolgt, wenn ein optionales Videoelement für AdDisplayContainer
auf Plattformen bereitgestellt wird, auf denen ein benutzerdefiniertes Videoelement eine nahtlosere Wiedergabe ermöglichen würde.
- Gibt Folgendes zurück:
-
boolean
Gibt an, ob die benutzerdefinierte Wiedergabe verwendet wird.
Pausieren
Pause()
Pausiert die aktuelle Anzeige, die gerade läuft. Diese Funktion funktioniert nicht, wenn ein statisches Overlay angezeigt wird oder die Anzeige noch nicht geladen wurde oder die Wiedergabe beendet ist.
resize
Größe ändern(Breite, Höhe, Ansichtsmodus)
Ändert die Größe der aktuellen Anzeige.
Parameter |
|
---|---|
width |
Zahl Neue Breite der Anzeigenfläche. |
height |
Zahl Neue Höhe der Anzeigenfläche. |
Ansichtsmodus |
Ansichtsmodus Der neue Ansichtsmodus Der Wert darf nicht null sein. |
Fortsetzen
Fortfahren()
Die aktuelle Anzeige, die geladen und pausiert wurde, wird fortgesetzt. Diese Funktion ist nicht verfügbar, wenn ein statisches Overlay angezeigt oder die Anzeige noch nicht geladen wurde oder die Wiedergabe beendet ist.
setVolume
setVolume(Volumen)
Legen Sie die Lautstärke für die aktuelle Anzeige fest.
Parameter |
|
---|---|
Volumen |
Zahl Die einzustellende Lautstärke, von 0 (stummgeschaltet) bis 1 (größte Lautstärke). |
überspringen
überspringbare()
Überspringt die aktuelle Anzeige, wenn AdsManager.getAdSkippableState()
wahr ist. Unter anderen Umständen hat das Überspringen keine Auswirkungen. Nachdem der Schritt zum Überspringen abgeschlossen ist, löst AdsManager
ein AdEvent.SKIPPED
-Ereignis aus.
(Start)
start()
Starten Sie die Wiedergabe der Anzeigen.
Entwickler müssen zuerst AdDisplayContainer.initialize()
aufrufen.
stoppen
stop()
Beenden Sie die Wiedergabe der Anzeigen. Dadurch wird der Publisher zum Content zurückgeleitet.
updateAdsRenderingSettings
updateAdsRenderingSettings(adsRenderingSettings)
Aktualisiert die Einstellungen für das Rendering von Anzeigen. Diese Option sollte insbesondere für VMAP-Anwendungsfälle zwischen Werbeunterbrechungen verwendet werden, wenn Einstellungen für das Rendering von Anzeigen wie die Bitrate aktualisiert werden müssen.
Parameter |
|
---|---|
Einstellungen für die Anzeigendarstellung |
Einstellungen für das Anzeigen-Rendering Die aktualisierten Einstellungen für das Rendering von Anzeigen Der Wert darf nicht null sein. |