Klasse: AdsRequest

Konstruktor

Anzeigenanfrage

neue AdsRequest()

Implementiert
google.ima.AdsRequestInterface

Attribute

Anzeigen-Tag-URL

String

Gibt die Anzeigen-Tag-URL an, die vom Ad-Server angefordert wird. Weitere Informationen zum Erstellen der Anzeigen-Tag-URL finden Sie in diesem Artikel.

Das ist ein erforderlicher Parameter.

Anzeigenantwort

(Null-, String- oder Nicht-Null-Dokument)

Gibt ein VAST 2.0-Dokument für die Anzeigenantwort an, statt eine Anfrage über eine Anzeigen-Tag-URL zu stellen. Dies kann bei der Fehlerbehebung und in anderen Situationen nützlich sein, in denen bereits eine VAST-Antwort verfügbar ist.

Dieser Parameter ist optional.

Inhaltsdauer

(null oder Zahl)

Gibt die Dauer des angezeigten Inhalts in Sekunden an. Er wird in 2 Fällen verwendet: 1) bei der AdX-Anzeigenausrichtung und 2) bei der Entscheidung, wann VMAP-Post-Rolls vorab geladen werden.

Dieser Parameter ist optional.

Inhalts-Keywords

(Null- oder Nicht-Null-Array des Strings)

Keywords, mit denen der angezeigte Content beschrieben wird Wird in AdX-Anfragen verwendet.

Dieser Parameter ist optional.

Inhaltstitel

(null oder String)

Gibt den Titel des anzuzeigenden Inhalts an. Wird in AdX-Anfragen verwendet.

Dieser Parameter ist optional.

forceNonLinearFullSlot

boolean

Erzwingt das Rendern nicht linearer AdSense-Anzeigen als lineares Full Full Slot. Wenn die Richtlinie konfiguriert ist, wird das Contentvideo pausiert und die nicht lineare Text- oder Bildanzeige wird als Full-Slot-Anzeige gerendert. Das Video wird fortgesetzt, sobald die Anzeige übersprungen oder geschlossen wurde.

LinearAdSlotHeight

Zahl

Gibt die Höhe des rechteckigen Bereichs an, in dem die lineare Anzeige eingeblendet wird. Dieser Wert wird als Kriterium für die Anzeigenauswahl verwendet. Dieser Wert muss nicht mit der Höhe der tatsächlichen Anzeige übereinstimmen.

Dieser Parameter ist erforderlich.

"LinearAdSlotWidth"

Zahl

Gibt die Breite des rechteckigen Bereichs an, in dem die lineare Anzeige eingeblendet wird. Dieser Wert wird als Kriterium für die Anzeigenauswahl verwendet. Dieser Wert muss nicht mit der Breite der tatsächlichen Anzeige übereinstimmen.

Das ist ein erforderlicher Parameter.

LiveStreamPrefetchSekunden

Zahl

Gibt die maximale Wartezeit in Sekunden nach dem Aufruf von requestAds an, bevor die URL des Anzeigen-Tags angefordert wird. Dies kann verwendet werden, um Anfragen während eines Livestreamereignisses zeitlich zu begrenzen und so Spitzen bei der Anzahl von Anfragen zu minimieren.

NichtLinearAdSlotHöhe

Zahl

Gibt die Höhe des rechteckigen Bereichs an, in dem eine nicht lineare Anzeige ausgeliefert wird. Dieser Wert wird als Kriterium für die Anzeigenauswahl verwendet. Dieser Wert muss nicht mit der Höhe der tatsächlichen Anzeige übereinstimmen.

Dieser Parameter ist erforderlich.

Breite der nicht linearen Anzeigenfläche

Zahl

Gibt die Breite des rechteckigen Bereichs an, in dem eine nicht lineare Anzeige ausgeliefert wird. Dieser Wert wird als Kriterium für die Anzeigenauswahl verwendet. Dieser Wert muss nicht mit der Breite der tatsächlichen Anzeige übereinstimmen.

Dieser Parameter ist erforderlich.

omidAccessModeRule

Nicht-Null-Objekt mit Stringeigenschaften

Einstellungsobjekt zum Zuordnen von Verifikationsanbietern zu OMID-Zugriffsmodi. Die Schlüssel müssen Werte in „google.ima.OmidVerificationVendor“ und die Werte in „google.ima.OmidAccessMode“ sein.

Überprüfungsskript-URLs werden intern mit vom Anbieter bereitgestellten regulären Ausdrücken abgeglichen, um sie in einen OmidVerificationVendor-Schlüssel aufzulösen. IMA nutzt dann dieses Objekt, um den Zugriffsmodus für den jeweiligen Anbieter zu suchen.

Bei Skript-URLs, die nicht zu einem bekannten Anbieter aufgelöst werden oder bei denen der aufgelöste OmidVerificationVendor in diesem Objekt nicht angegeben wird, verwendet IMA den Zugriffsmodus für OmidVerificationVendor.OTHER Wenn OmidVerificationVendor.OTHER nicht angegeben ist, wird der Modus LIMITED verwendet.

Seiten-URL

(null oder String)

Gibt die vollständige URL der Seite an, die zu Targeting-Zwecken in die Google-Anzeigenanfrage aufgenommen wird. Die URL muss gültig sein. Wenn er angegeben ist, wird dieser Wert für das VAST-Makro [PAGEURL] verwendet.

Dieser Parameter ist optional.

VASTLoadTimeout

Zahl

Überschreibung für das Standard-VAST-Zeitlimit in Millisekunden für einen einzelnen Wrapper. Das Standardzeitlimit beträgt 5.000 ms.

Dieser Parameter ist optional.

Methoden

Anzeigen-Test automatisch festlegen

setAdWillAutoPlay(autoPlay) gibt ungültige

Das SDK wird benachrichtigt, ob der Player plant, den Inhalt und die Anzeige als Reaktion auf eine Nutzeraktion zu starten oder ob es automatisch abgespielt wird. Eine Änderung dieser Einstellung hat keine Auswirkungen auf die Anzeigenwiedergabe.

Parameter

AutoPlay

boolean

Gibt an, ob der Inhalt und die Anzeige automatisch wiedergegeben werden oder ob sie durch eine Nutzeraktion gestartet wird.

Gibt Folgendes zurück:

void 

Eingeblendetes AnzeigenTest

„setAdWillPlayStummschaltend(stumm)“ wird nicht ausgeliefert.

Das SDK wird benachrichtigt, ob der Player versucht, die Anzeige zu schalten, wenn es stummgeschaltet ist. Eine Änderung dieser Einstellung wirkt sich nicht auf die Anzeigenwiedergabe aus, sendet jedoch das entsprechende Signal in der Anzeigenanfrage, damit Käufer auf stummgeschaltetes Inventar bieten können.

Parameter

stummgeschaltet

boolean

Gibt an, ob die Anzeige bei Stummschaltung wiedergegeben wird.

Gibt Folgendes zurück:

void 

Kontinuierliche Wiedergabe festlegen

setKontinuierliche Wiedergabe(kontinuierliche Wiedergabe) gibt ungültige Werte zurück

Das SDK wird benachrichtigt, ob der Player versucht, die Inhaltsvideos nacheinander ähnlich wie bei der Fernsehübertragung abzuspielen. Eine Änderung dieser Einstellung wirkt sich nicht auf die Wiedergabe der Anzeige aus, sendet jedoch das entsprechende Signal in dieser Anzeigenanfrage, damit Käufer auf die Art des Anzeigeninventars bieten können.

Parameter

kontinuierliche Wiedergabe

boolean

Gibt an, ob das Video regelmäßig nacheinander abgespielt wird.

Gibt Folgendes zurück:

void