google. ima. AdsRequest
Eine Klasse zum Angeben von Attributen der Anzeigenanfrage.
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