In diesem Artikel finden Sie eine vollständige Liste der Parameter, die in einem VAST-Anzeigen-Tag verwendet werden können. Sie kann hilfreich sein, wenn Sie mehr über einen bestimmten Parameter erfahren möchten.
Klickbarer alphabetischer Index aller ParameterThemen in diesem Hilfeartikel
- Für die Anzeigenbereitstellung erforderliche Parameter
- Für programmatische Anzeigen erforderliche Parameter
- Für programmatische Anzeigen empfohlene Parameter
- Andere Parameter
false/true, empfehlen aber 0/1 für boolesche Parameter (z. B. vpmute, wta, ad_rule, gdpr usw.).Parameterlisten nach Implementierungstyp
Wenn Sie eine bestimmte Implementierung verwenden, können Sie benutzerdefinierte Parameterlisten nutzen, in denen die Verwendung und Anforderungen für diese Implementierung beschrieben werden. Die Liste der benutzerdefinierten Parameter kann für Folgendes verwendet werden:
Web Mobile App Internetfähige Fernseher Audio Digitale Außenwerbung
Alle Parameter
Alle maximieren Alle minimieren
Für die Anzeigenbereitstellung erforderliche Parameter
Diese Parameter sind in der Regel für die Anzeigenbereitstellung bei den meisten Implementierungen erforderlich. Es kann jedoch Fälle geben, in denen sie nicht erforderlich sind. Die genaueste Liste erhalten Sie, wenn Sie die Parameterliste für Ihren spezifischen Implementierungstyp verwenden.
correlator (Korrelator)
Beschreibung
Für den Parameter „Korrelator“ (correlator) kann ein variabler Wert verwendet werden, der von mehreren Anfragen im selben Seitenaufruf verwendet wird. Er dient zur Implementierung von Konkurrenzausschlüssen, auch in Umgebungen ohne Cookies.
Verwendungsbeispiele
correlator=4345645667
Anforderungen und Empfehlungen
Dieser Parameter ist erforderlich, um die Anzeigenbereitstellung im Web, in mobilen Apps, auf internetfähigen Fernsehern, in Audio und in digitaler Außenwerbung zu implementieren.
SDK-Nutzung
- Wenn Sie das IMA SDK verwenden, wird der Korrelatorwert automatisch festgelegt. Falls der Player versucht, diesen Wert festzulegen, überschreibt das SDK ihn durch einen eigenen Wert.
- Wenn Sie kein IMA SDK einsetzen, müssen Sie für diesen Wert eine positive, ganze Zufallszahl festlegen, die nicht von mehreren Seitenaufrufen wiederverwendet wird.
description_url (Beschreibungs-URL)
Beschreibung
Für den Parameter „Beschreibungs-URL“ (description_url) kann ein variabler Wert verwendet werden, mit dem das Video beschrieben werden sollte, das auf der Seite wiedergegeben wird.
Die Beschreibungs-URL sollte sich auf die Videos beziehen, die auf einer bestimmten Seite einer Webanwendung, einer mobilen App oder einer TV-App wiedergegeben werden. Sie sollte nicht die Top-Level-Domain für alle Videos oder alle Anzeigenanfragen sein. Wenn Sie beispielsweise die Seite https://www.sample.com/golf.html für Videos zum Thema Golf verwenden, setzen Sie sie als Wert für description_url.
Verwendungsbeispiele
Der Wert für description_url muss bei Webseiten mit Videos und auf CTV-/OTT-Geräten URL-codiert sein. Der Wert für description_url darf für mobile Apps jedoch nicht codiert sein.
Mit URL-Codierung:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html
Ohne URL-Codierung:
description_url=
https://www.sample.com/golf.html
Anforderungen und Empfehlungen
Dieser Parameter ist erforderlich, um die Anzeigenbereitstellung im Web und in mobilen Apps zu implementieren. Er ist auch erforderlich, wenn Sie Ad Exchange oder AdSense für die dynamische Zuordnung verwenden.
Dieser Parameter wird für die programmatische Monetarisierung empfohlen.
SDK-Nutzung
Der Parameter wird nicht automatisch über das IMA SDK festgelegt. Er muss manuell angegeben werden.
Weitere Informationen finden Sie in den IMA SDK-Anleitungen für Ihre Plattform.
env (Umgebung)
Beschreibung
Für den Umgebungsparameter (env) kann ein konstanter Wert verwendet werden, der angibt, ob es eine In-Stream-Anfrage ist oder ob die Anfrage von einem Videoplayer stammt.
Mögliche Werte sind instream für Video- und Audioanzeigen oder vp für Videoanzeigen.
Verwendungsbeispiele
Video- und/oder Audioanzeige:
env=instream
Nur Videoanzeige:
env=vp
Anforderungen und Empfehlungen
Dieser Parameter ist erforderlich, um die Anzeigenbereitstellung im Web, in mobilen Apps, auf internetfähigen Fernsehern, in Audio und in digitaler Außenwerbung zu implementieren.
Dieser Parameter ist erforderlich, um genaue Berichte zum Anfragetyp aufgeschlüsselt nach „Video-Tag“ zu erstellen.
gdfp_req (Schema-Anzeige)
Beschreibung
Für den Parameter „Schemakennung von Google Ad Manager“ (gdfp_req) kann ein konstanter Wert verwendet werden, um anzugeben, dass die Anzeigenanfrage sich auf Google Ad Manager-Inventar bezieht.
Verwendungsbeispiele
gdfp_req=1
Anforderungen und Empfehlungen
Dieser Parameter ist erforderlich, um die Anzeigenbereitstellung im Web, in mobilen Apps, auf internetfähigen Fernsehern, in Audio und in digitaler Außenwerbung zu implementieren.
iu (Anzeigenblock)
Beschreibung
Für den Parameter „Anzeigenblock“ (iu) kann ein variabler Wert verwendet werden, der auf den aktuellen Anzeigenblock festgelegt werden sollte, und zwar in diesem Format: /network_code/.../ad_unit.
Verwendungsbeispiele
iu=/6062/videodemo
Anforderungen und Empfehlungen
Dieser Parameter ist erforderlich, um die Anzeigenbereitstellung im Web, in mobilen Apps, auf internetfähigen Fernsehern, in Audio und in digitaler Außenwerbung zu implementieren.
output (Ausgabe)
Beschreibung
Für den Parameter "Ausgabeformat" (output) kann ein konstanter Wert verwendet werden, mit dem das Ausgabeformat der Anzeige festgelegt wird.
Verwendungsbeispiele
Verwenden Sie die VAST-Standardversion Ihres Netzwerks:
output=vast
Verwenden Sie VAST 4 (Sie können bestimmte Versionen für bestimmte Tags festlegen):
output=xml_vast4
Verwenden Sie die VMAP-Standardeinstellung Ihres Netzwerks:
output=vmap
Verwenden Sie MAP 1:
output=xml_vmap1
VMAP 1 mit Rückgabe von VAST 4 verwenden (wenn Sie VAST in VMAP zurückgeben):
output=xml_vmap1_vast4
Anforderungen und Empfehlungen
Dieser Parameter ist erforderlich, um die Anzeigenbereitstellung im Web, in mobilen Apps, auf internetfähigen Fernsehern, in Audio und in digitaler Außenwerbung zu implementieren. Es ist erforderlich, das richtige Antwortformat für die Anzeigenbereitstellung auszugeben.
SDK-Nutzung
Für VAST gilt: Wenn Ihr Videoplayer das IMA SDK verwendet, wird der Ausgabeparameter für eine Videoanzeigenanfrage immer auf output=xml_vast4 festgelegt. Die Zuverlässigkeit bleibt unverändert, weil das SDK abwärtskompatibel zu allen VAST-Versionen eines beliebigen Ad-Servers eines Drittanbieters ist.
sz (Größe)
Beschreibung
Für den Parameter „Größe“ (sz) kann ein variabler Wert verwendet werden, der auf die Größe der Anzeigenfläche für das Mastervideo festgelegt werden sollte.
Mehrere Größen sollten durch einen senkrechten Strich (|) getrennt werden.
Geben Sie hinter der Größe nicht "v" an.
Verwendungsbeispiele
Einzelgröße:sz=400x300
Mehrere Größen:sz=300x250|400x300
Anforderungen und Empfehlungen
Dieser Parameter ist erforderlich, um die Anzeigenbereitstellung im Web, in mobilen Apps, auf internetfähigen Fernsehern und in digitaler Außenwerbung zu implementieren.
Dieser Parameter ist optional, wenn nur ad_type=audio angefordert wird.
unviewed_position_start (verzögerte Impressionen)
Beschreibung
Für den Parameter „verzögerte Impressionen“ (unviewed_position_start) kann ein konstanter Wert verwendet werden, um verzögerte Impressionen für das Video anzugeben.
Verwendungsbeispiele
unviewed_position_start=1
Anforderungen und Empfehlungen
Dieser Parameter ist erforderlich, um die Anzeigenbereitstellung im Web und in mobilen Apps zu implementieren, wenn es eine Möglichkeit für eine verzögerte Impression gibt.
Für programmatische Anzeigen erforderliche Parameter
ott_placement (OTT-Placement)
Beschreibung
Für den OTT-Placement-Parameter (ott_placement) kann ein konstanter Wert verwendet werden, der eine Anfrage für einen bestimmten Placement-Typ angibt.
Placement-Definitionen für die folgenden Beispiele:
- Pausieren: Out-Stream-Format, das als Overlay über Videocontent eingeblendet wird, wenn ein Nutzer die Wiedergabe des Inhalts pausiert.
- Startbildschirm: Anzeige, die auf dem Startbildschirm eines CTV-Geräts oder einer OTT-App erscheint. Dazu gehören Masthead-, Banner- und Kachelimplementierungen auf einem Startbildschirm.
- Bild im Bild: In-Stream-Videoanzeige, die in einem separaten Videoplayer neben dem Videocontent wiedergegeben wird. In der Regel ist es erforderlich, den Videocontent zu verkleinern und einen zweiten Videoplayer zu laden.
- L-Banner: In-Stream-Displayanzeige, bei der Videocontent verkleinert und eine Anzeige um das Video herum erstellt wird. In der Regel, aber nicht notwendigerweise, ein L-förmiges Feld für Anzeigeninhalte.
- Overlay: Ein In-Stream-Anzeigenformat, das über Videoinhalten eingeblendet wird, aber nicht den gesamten Bildschirm einnimmt. Kann eine Display- oder Videoanzeige sein.
Verwendungsbeispiele
Unterstützte Formate und ihre entsprechenden Werte:
Pausieren:
ott_placement=1
Startbildschirm:
ott_placement=2
Bild im Bild:
ott_placement=3
L-Banner:
ott_placement=4
Overlay:
ott_placement=5
Benutzerdefiniert/Sonstiges:
ott_placement=99
Anforderungen und Empfehlungen
Dieser Parameter ist nur für die programmatische Monetarisierung im Web, in mobilen Apps und auf internetfähigen Fernsehern für Publisher erforderlich, die nicht standardmäßige Placements in OTT-Streamingumgebungen monetarisieren.
plcmt (Placement)
Beschreibung
Für den Parameter "Placement" (plcmt) kann ein konstanter Wert verwendet werden, um anzugeben, ob das In-Stream-Inventar gemäß den IAB-Spezifikationen als „In-Stream“ oder „Begleitender Videocontent“ deklariert ist.
Bei Anfragen von Videoanzeigen, die nicht In-Stream ausgeliefert werden, wird dies automatisch für Käufer auf der Grundlage des deklarierten Inventarformats ausgefüllt, das jede In-Stream- oder Begleitdeklaration außer Kraft setzt.
Verwendungsbeispiele
In-Stream-Anfrage:
plcmt=1
Anfrage zu begleitendem Videocontent:
plcmt=2
Anforderungen und Empfehlungen
Dieser Parameter ist für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern, bei Audioinhalten und bei digitaler Außenwerbung erforderlich.
url (URL)
Beschreibung
Für den URL-Parameter (url) kann ein variabler Wert verwendet werden, der auf die vollständige URL festgelegt werden sollte, von der die Anzeigenanfrage gesendet wird. Über den Wert erhält der Käufer Informationen zum Kontext, aus dem die Anfrage stammt. Der Wert sollte in der Anzeigenanfrage soweit möglich dynamisch gefüllt werden.
- Im Web ist dies die URL der Seite, auf der der Videoplayer angezeigt wird.
- In anderen Umgebungen sollte als Wert eine URL angegeben werden, die das zu monetarisierende Video- oder Audioinventar möglichst genau widerspiegelt. Das ist etwa hilfreich, wenn sich der Nutzer ein Video in einer mobilen App ansieht, das auch unter einer entsprechenden URL für Computer zur Verfügung steht.*
Hinweis: url unterscheidet sich von description_url dadurch, dass url sich auf den Ort bezieht, von dem aus eine Anzeigenanfrage gestellt wurde, während description_url eine durch Webcrawling erfassbare Seite ist, die den Videoinhalt beschreibt.
Der Wert dieses Parameters muss codiert sein.
Verwendungsbeispiele
url=https%3A%2F%2Fwww.example.com%2Fvideo.html
* Falls sich der Parameter für Apps nicht auf einen variablen URL-Wert festlegen lässt, empfehlen wir, einen Wert mit folgendem Muster zu nutzen: url=https%3A%2F%2F<app/bundleid>.example.com
Anforderungen und Empfehlungen
Dieser Parameter ist für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern, bei Audioinhalten und bei digitaler Außenwerbung erforderlich.
SDK-Nutzung
Wenn Sie das IMA SDK verwenden, wird damit der URL-Wert automatisch festgelegt. Falls der Wert durch den Player definiert wird, wird er im IMA SDK berücksichtigt.
venuetype (Veranstaltungsortstyp)
Beschreibung
Mit dem Parameter „Venue-Typ“ (venuetype) wird der Typ des Veranstaltungsortes angegeben. Zulässig sind die ganzzahligen Aufzählungs-IDs, die von der IAB OpenOOH Veranstaltungsort Typ 1.1 Taxonomie unterstützt werden.
Verwendungsbeispiele
Hotelzimmer:
venuetype=80703
Tablet im Rücksitz eines Taxis:
venuetype=103
Anforderungen und Empfehlungen
Dieser Parameter ist für die programmatische Monetarisierung bei digitaler Außenwerbung erforderlich.
vpa (automatische Videowiedergabe)
Beschreibung
Für den Parameter für die automatische Videowiedergabe (vpa) kann ein konstanter Wert verwendet werden, der angibt, ob der Videoinhalt in einer Anzeige durch Autoplay oder per Klick gestartet wird.
Mögliche Werte sind click, wenn eine Nutzeraktion erforderlich ist, oder auto, wenn das Video automatisch abgespielt wird. Dieser Parameter ändert nicht den Status des Videoplayers. Das Wiedergabeverhalten muss direkt vom Videoplayer verwaltet werden.
Verwendungsbeispiele
Automatisch:
vpa=auto
Click‑to‑Play:
vpa=click
Dieser Parameter sollte nicht festgelegt werden, wenn er nicht bekannt ist.
Anforderungen und Empfehlungen
Dieser Parameter ist für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern und bei Audio erforderlich.
Dieser Parameter wird auch gemäß den Richtlinien zur Videomessung des Media Rating Council (MRC) empfohlen.
vpmute (Videowiedergabe stummschalten)
Beschreibung
Für den Parameter „Videowiedergabe“ stummschalten (vpmute) kann ein konstanter Wert verwendet werden, der angibt, ob die Anzeige abgespielt wird, während der Videoplayer stummgeschaltet ist. Dieser Parameter ändert nicht den Status des Videoplayers. Das Wiedergabeverhalten muss direkt vom Videoplayer verwaltet werden.
Verwendungsbeispiele
Wiedergabe beginnt mit Stummschaltung:
vpmute=1
Wiedergabe beginnt ohne Stummschaltung:
vpmute=0
Anforderungen und Empfehlungen
Dieser Parameter ist für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern, bei Audio und bei digitaler Außenwerbung erforderlich.
Dieser Parameter wird auch gemäß den Richtlinien zur Videomessung des Media Rating Council (MRC) empfohlen.
Für programmatische Anzeigen empfohlene Parameter
aconp (kontinuierliche Audiowiedergabe)
Beschreibung
Für den Parameter „kontinuierliche Audiowiedergabe“ (aconp) kann ein konstanter Wert verwendet werden, der angibt, ob über den Player kontinuierlich Audiocontent wiedergegeben werden soll. So können in Google Ad Manager die für die Nutzerfreundlichkeit am besten geeigneten Anzeigen ausgewählt werden.
Verwendungsbeispiele
Kontinuierliche Wiedergabe aktiviert:
aconp=2
Kontinuierliche Wiedergabe deaktiviert:
aconp=1
Wenn Sie nicht wissen, ob Audio kontinuierlich wiedergegeben wird, sollte dieser Parameter nicht festgelegt oder auf aconp=0 gesetzt werden.
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern, in Audio und in digitaler Außenwerbung empfohlen.
Dieser Parameter wird auch gemäß den Richtlinien zur Audiomessung des Media Rating Council (MRC) empfohlen.
an (App-Name)
Beschreibung
Die Parameter "App-ID" (msid) und "App-Name" (an) können variable Werte sein, die von mobilen Apps und internetfähigen Geräten gesendet werden. Bei den meisten programmatischen Videoanzeigen ist das der Fall.
Der Name der App sollte menschenlesbar sein. Im Fall von iOS und tvOS kann das SDK allerdings nicht auf die App-ID zugreifen. In diesen Fällen wird der Parameter msid nicht gesendet und das SDK gibt das App Bundle über den Parameter an weiter.
Verwendungsbeispiele
msid=com.package.publisher&an=sample%20app
App-IDs haben je nach App-Shop unterschiedliche Bezeichnungen und Formate. Weitere Informationen finden Sie in den IAB-Richtlinien zur App-Identifizierung und in den Beispielen für gängige eindeutige IDs.
Bei Plattformen, für die es keinen App-Shop gibt, empfiehlt der IAB den Publishern das folgende Format für Shop-IDs: com.publisher.deviceplatform
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung in mobilen Apps, internetfähigen Fernsehern, Audio und digitaler Außenwerbung empfohlen.
Aus Gründen der Markensicherheit und für mehr Transparenz für Käufer wird dringend empfohlen, die App-Informationen anzugeben.
SDK-Nutzung
Über das IMA SDK werden beide Parameter automatisch ausgefüllt. In Umgebungen ohne SDK, etwa bei direkten VAST-Aufrufen, oder bei Verwendung der Programmatic Access Library (PAL) oder bei Verwendung von Publisher Authenticated Inventory (PAI) müssen sie jedoch manuell angegeben werden.
Hinweis: Wenn HTML5 IMA SDK verwendet wird, werden keine App-Informationen verwendet.
dth (Hinweis zum Gerätetyp)
Beschreibung
Für den Parameter für den Gerätetyphinweis (dth) kann ein konstanter Wert verwendet werden, der dazu beiträgt, Fehlklassifizierungen von Geräten zu reduzieren, insbesondere in Umgebungen mit internetfähigen Fernsehern und Set-Top-Boxen.
Eine falsche Geräteklassifizierung kann auf unbeabsichtigte Fehler des Publishers oder des Herstellers des internetfähigen Fernsehers zurückzuführen sein. Dieser Parameter wird in Verbindung mit anderen Signalen verwendet, damit Google automatisch Fälle kennzeichnen kann, in denen Inventar für internetfähige Fernseher neu klassifiziert werden kann.
Verwendungsbeispiele
Anfragen von:
- Feature-Phone:
dth=1 - Smartphone:
dth=2 - Computer:
dth=3 - Tablet:
dth=4 - Internetfähiger Fernseher:
dth=5 - Spielekonsole:
dth=6 - Set-Top-Box:
dth=7
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern, in Audio und in digitaler Außenwerbung empfohlen.
SDK-Nutzung
Dieser Parameter wird für PAL- und PAI-Implementierungen (ohne SDK) empfohlen. Für das IMA SDK oder DAI SDK ist er nicht erforderlich.
givn (Video-Nonce)
Beschreibung
Bei Integrationen, für die die Programmatic Access Library (PAL) verwendet wird, kann für den Parameter Video Nonce ein variabler String-Wert verwendet werden.
Nonce ist URL-sicher und muss nicht URL-codiert werden.
Hinweis: Wenn Sie zuvor Nonce mit dem bisherigen Parameter paln angegeben haben, sollten Sie dringend zum Parameter givn migrieren und paln nicht mehr senden. Verwenden Sie nicht beide Parameter.
Verwendungsbeispiele
Weitere Informationen zu den Werten, die an diesen Parameter übergeben werden, finden Sie in den Startleitfäden zu PAL.
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern, in Audio und bei digitaler Außenwerbung empfohlen.
hl (Sprache)
Beschreibung
Für den Sprachparameter (hl) kann ein konstanter Wert verwendet werden. Damit lässt sich angeben, in welcher Sprache Anzeigen angefordert werden sollen und in welcher Sprache bei der dynamischen Zuordnung zum Video in Ad Exchange oder in AdSense für Videos Anzeigen ausgewählt und Videoanzeigen gerendert werden.
Verwendungsbeispiele
Anzeigen auf Italienisch anfordern:
hl=it
Der Parameterwert kann gemäß ISO 639-1 (zwei Buchstaben) oder ISO 639-2 (drei Buchstaben) angegeben werden. Liste gültiger Codes
Wenn er nicht angegeben wird, wird standardmäßig das Anzeigen-Targeting nach Sprache in Ad Exchange verwendet.
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern, in Audio und in digitaler Außenwerbung empfohlen.
msid (App-ID)
Beschreibung
Die Parameter "App-ID" (msid) und "App-Name" (an) können variable Werte sein, die von mobilen Apps und internetfähigen Geräten gesendet werden. Bei den meisten programmatischen Videoanzeigen ist das der Fall.
Der Name der App sollte menschenlesbar sein. Im Fall von iOS und tvOS kann das SDK allerdings nicht auf die App-ID zugreifen. In diesen Fällen wird der Parameter msid nicht gesendet und das SDK gibt das App Bundle über den Parameter an weiter.
Verwendungsbeispiele
msid=com.package.publisher&an=sample%20app
App-IDs haben je nach App-Shop unterschiedliche Bezeichnungen und Formate. Weitere Informationen finden Sie in den IAB-Richtlinien zur App-Identifizierung und in den Beispielen für gängige eindeutige IDs.
Bei Plattformen, für die es keinen App-Shop gibt, empfiehlt der IAB den Publishern das folgende Format für Shop-IDs: com.publisher.deviceplatform
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung in mobilen Apps, internetfähigen Fernsehern, Audio und digitaler Außenwerbung empfohlen.
Aus Gründen der Markensicherheit und für mehr Transparenz für Käufer wird dringend empfohlen, die App-Informationen anzugeben.
SDK-Nutzung
Über das IMA SDK werden beide Parameter automatisch ausgefüllt. In Umgebungen ohne SDK, etwa bei direkten VAST-Aufrufen, oder bei Verwendung der Programmatic Access Library (PAL) oder bei Verwendung von Publisher Authenticated Inventory (PAI) müssen sie jedoch manuell angegeben werden.
Hinweis: Wenn HTML5 IMA SDK verwendet wird, werden keine App-Informationen verwendet.
omid_p (Name des OMID-Partners)
Beschreibung
Für den Parameter "Name des OMID-Partners" (omid_p) ist ein variabler Wert zulässig, der den Namen des Partners, der die OMID-Messung integriert, sowie die Partnerversion angibt.
Für den Parameter "unterstützte SDK APIs" (sdk_apis) können variable Werte verwendet werden. Das kann entweder eine einzelne oder eine durch Kommas getrennte Liste unterstützter APIs sein.
Diese Parameter sind Teil eines Parametersatzes, der für die Sichtbarkeit und Anzeigenüberprüfung verwendet wird.
Verwendungsbeispiele
Bei Nichtverwendung von PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Liste der möglichen API-Framework-Werte
Bei Verwendung von PAL:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern, in Audio und in digitaler Außenwerbung empfohlen.
SDK-Nutzung
- Dieser Parameter ist nur für Publisher relevant, die die Active View-Messung nutzen möchten, wenn sie das Open Measurement SDK (OM SDK) verwenden.
- Um bei der Nutzung der Programmatic Access Library (PAL) die OMID-Unterstützung anzugeben, müssen Sie über die APIs
omidPartnerNameundomidPartnerVersionden Namen und die Version des Partners festlegen. Wenn Sie weder PAL- noch IMA SDK verwenden, müssen Sie die Parameteromid_pundsdk_apisfestlegen. - Dies sollte bei Verwendung des IMA SDKs nicht verwendet werden, da er automatisch festgelegt wird.
rdid (rücksetzbare Geräte-ID)
Beschreibung
Für die Parameter für rücksetzbare Geräte-IDs (rdid, idtype, is_lat) können variable Werte verwendet werden. Dieser Wert wird auch als Identifier for Advertising (IFA) bezeichnet.
Bei mobilen Anwendungen, die das IMA SDK für Android oder iOS verwenden, werden über das IMA SDK mit Parametern für rdid, idtype und is_lat die rücksetzbaren Geräte-IDs für das Targeting auf Nutzer in Ihre Streamanfragen übergeben.
Wenn das IMA SDK nicht verwendet wird oder serverseitiges Beaconing (SSB) verwendet wird, müssen Sie diese als explizite Parameter übergeben. Weitere Informationen zu Geräte-IDs
Diese Werte müssen bei fast allen programmatischen Videoanzeigen vorhanden sein.
|
Seit iOS 14.5 wird das |
Verwendungsbeispiele
Detaillierte Beispiele für rücksetzbare Gerätekennungen
Anforderungen und Empfehlungen
Diese Parameter sind zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, aber für die programmatische Monetarisierung in mobilen Apps, internetfähigen Fernsehern, Audio und digitalen Außenwerbeflächen.
Bei Webimplementierungen werden keine rücksetzbaren Geräte-IDs verwendet.
SDK-Nutzung
Bei Verwendung des IMA SDKs wird das Feld automatisch übergeben. Wenn der Publisher das PAL SDK verwendet, müssen die entsprechenden Parameter manuell übergeben werden.
sid (Sitzungs-ID)
Beschreibung
Für den Parameter „Session ID“ (sid) kann ein variabler Wert verwendet werden, der eine datenschutzfreundliche Werbe-ID ist, die nur für das Frequency Capping verwendet wird.
Die Sitzungs-ID wird für In-Stream-Videoanfragen von internetfähigen Fernsehern und für In-Stream-Videoinventar von mobilen Apps unterstützt. Sie wird derzeit nicht für das Web unterstützt.
Wenn Sie nicht möchten, dass die Sitzungs-ID weitergegeben wird, legen Sie sid=0 fest.
Verwendungsbeispiele
sid=123e4567-e89b-12d3-a456-426614174000
Gemäß den Richtlinien zur Analyse des eingehenden Feeds (IFA) des IAB muss dieser Parameter im UUID-Format angegeben werden. Weitere Informationen zu rücksetzbaren Geräte-IDs für das Nutzer-Targeting
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, aber für die programmatische Monetarisierung bei digitaler Außenwerbung.
Dieser Parameter wird für die programmatische Monetarisierung in mobilen Apps, internetfähigen Fernsehern und Audio empfohlen.
SDK-Nutzung
Dieser Parameter wird automatisch über das IMA SDK gesendet.
vconp (kontinuierliche Videowiedergabe)
Beschreibung
Für den Parameter „Video kontinuierliche Wiedergabe“ (vconp) kann ein konstanter Wert verwendet werden, der angibt, ob über den Player kontinuierlich ein Video nach dem anderen abgespielt werden soll, ähnlich wie bei einer TV-Übertragung.
Verwendungsbeispiele
Kontinuierliche Wiedergabe aktiviert:
vconp=2
Kontinuierliche Wiedergabe deaktiviert:
vconp=1
Dieser Parameter sollte nicht festgelegt werden, wenn er nicht bekannt ist.
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern und in Audio empfohlen.
Dieser Parameter wird auch gemäß den Richtlinien zur Videomessung des Media Rating Council (MRC) empfohlen.
vid_d (Videodauer)
Beschreibung
Für den Parameter „Videodauer“ (vid_d) kann ein variabler Wert verwendet werden, der die Dauer des Contents in Sekunden angibt.
- Die Parameter
vid_dundallcueswerden verwendet, um Mid-Roll-Anzeigen ohne Contentaufnahme auszuliefern. - Die Verwendung von Anzeigenregeln ist erforderlich, um Mid-Rolls zurückzugeben. Wenn in Ihren Anzeigenregeln zeitbasierte Cue-Punkte (beispielsweise „Alle n Sekunden“ oder „Zu festen Zeiten“) festgelegt sind, werden diese verwendet. Die im Parameter
allcuesübergebenen Cue-Punkte werden ignoriert. Für Mid-Roll-Anzeigen muss noch eine Dauer festgelegt werden. Daher mussvid_dnoch übergeben werden.
Verwendungsbeispiele
Dauer des Videocontents von 90.000 Sekunden (25 Stunden):
vid_d=90000
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung im Web, in mobilen Apps und auf internetfähigen Fernsehern empfohlen.
vpos (Videoposition)
Beschreibung
Für den Parameter „Videoposition“ (vpos) kann ein konstanter Wert verwendet werden, der angibt, ob die Anzeigenanfrage von Pre-Roll, Mid-Roll oder Post-Roll gesendet wird.
Verwendungsbeispiele
Pre-Roll:
vpos=preroll
Mid-Roll:
vpos=midroll
Post-Roll:
vpos=postroll
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern und in Audio empfohlen.
Wenn Anzeigenregeln verwendet werden, ist dieser Parameter nicht erforderlich, da er automatisch vom Ad-Server hinzugefügt wird.
wta (Warum sehe ich diese Werbung?)
Beschreibung
Der Parameter „Warum sehe ich diese Werbung?“ (wta) akzeptiert einen konstanten Wert, der angibt, ob der Videoplayer das Rendern von Anzeigenkennzeichnungen unterstützt.
Verwendungsbeispiele
Wenn der Player das in der VAST-Antwort angegebene Datenschutzinfo-Symbol rendern soll, verwenden Sie Folgendes:
wta=1(oder den Parameterwtaweglassen oderwtaohne festgelegten Wert übergeben)Bei Audioanfragen sollte
wta=1verwendet werden, wenn das in der VAST-Antwort angegebene Datenschutzinfo-Symbol in Companion-Anzeigen gerendert oder dem Nutzer anderweitig bereitgestellt wird.
Wenn das Datenschutzinfo-Symbol in der VAST-Antwort nicht vom Player gerendert werden soll, verwenden Sie Folgendes:
wta=0
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für einen bestimmten Implementierungstyp zu liefern, wird aber für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern und bei Audioinhalten empfohlen.
Wenn der Parameter verwendet wird:
- Anfragen mit
&wta=0sind für bestimmte Typen von Google-Nachfrage nicht aktiv. - Bei Zugriffen aus dem EWR können Anfragen mit
&wta=0nicht für Creatives mit aktivierter Anzeigenkennzeichnung in Reservierungs- und vom Publisher verwalteten programmatisch garantierten Werbebuchungen verwendet werden.
Anzeigen müssen den anwendbaren behördlichen Vorschriften für Anzeigen entsprechen, die im Europäischen Wirtschaftsraum (EWR) ausgeliefert werden. Dazu gehört auch eine Funktion, über die Nutzer illegale Inhalte melden können. Wenn illegale Inhalte gemeldet werden, müssen Publisher Google darüber mithilfe des Formulars Inhalte bei Google melden informieren.
SDK-Nutzung
Die Funktion zur Anzeigenkennzeichnung wird automatisch unterstützt, wenn das IMA SDK verwendet wird. Wenn das IMA SDK nicht eingesetzt wird, muss in Videoplayern eine Unterstützung für dasIcon für VAST und IconClickFallbackImage implementiert werden. Im VAST-Standard des IAB ist die entsprechende Vorgehensweise dokumentiert.Andere Parameter
Im Allgemeinen sind diese Parameter nicht ausdrücklich erforderlich, um Anzeigen auszuliefern. Sie können jedoch für die Verwendung bestimmter Funktionen oder für bestimmte Implementierungstypen erforderlich sein.
ad_rule (Anzeigenregel)
Beschreibung
Für den Parameter „Anzeigenregel“ (ad_rule) kann ein konstanter Wert verwendet werden, der angibt, ob ein VAST-Creative oder eine Anzeigenregel als Antwort zurückgegeben wird.
Die standardmäßige Einstellung für Anzeigenregeln hängt von einer Einstellung für das Google Ad Manager-Netzwerk ab, die es ermöglicht, dass alle Anfragen Anzeigenregelanfragen sind. Wenn die Netzwerkeinstellung verwendet wird, muss ad_rule nicht im Anzeigen-Tag festgelegt werden. Wenn Sie sie auf Anzeigenanfragebasis deaktivieren möchten, können Sie ad_rule=0 übergeben, um die Netzwerkeinstellung zu überschreiben. Wenn Anzeigenregeln nicht standardmäßig aktiviert sind, können Sie sie mit den Parametern ad_rule=1 und ad_rule=0 aktivieren bzw. deaktivieren.
Verwendungsbeispiele
Wenn die Einstellung für Anzeigenregeln deaktiviert ist:
- Anfrage für VAST-Creative:
ad_rule=0oder nicht festlegen
Wenn die Einstellung für Anzeigenregeln aktiviert ist:
- Anfrage für VAST-Creative:
ad_rule=0 - Anfrage für Anzeigenregeln (VMAP):
ad_rule=1oder nicht festlegen
Wenn Sie keine Anzeigenregeln verwenden, können Sie mit den Anzeigen-Tag-Parametern pmnd, pmxd und pmad die Werbeunterbrechung und die Pod-Dauer für Ihre VAST-Tags angeben.
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für einen bestimmten Implementierungstyp auszuliefern, aber für die korrekte Verwendung von Regeln für Videoanzeigen.
addtl_consent (zusätzliche Einwilligung)
Beschreibung
Für den Parameter „Zusätzliche Einwilligung“ (addtl_consent) sind variable Werte zulässig. Er wird von Publishern verwendet, die Version 2.0 des IAB TCF integrieren möchten und mit einem Anbieter zusammenarbeiten, der noch nicht auf der IAB Europe Global Vendor List registriert, aber Teil der Liste der Anbieter von Anzeigentechnologien von Google ist.
Weitere Informationen zu den Werten, die an diesen Parameter übergeben werden, finden Sie in der technischen Spezifikation zum Modus für zusätzliche Einwilligung.
Verwendungsbeispiel
addtl_consent=1~1.35.41.101
adtest (Ad Test)
Beschreibung
Mit dem Parameter „Anzeigentest“ (adtest) kann sichergestellt werden, dass Abfragen, die zum Testen von Backfill-Inventar (nicht garantiertes Inventar) verwendet werden, nicht als ungültiger Traffic erkannt werden und keine Auswirkungen auf den Umsatz haben.
Legen Sie beim Testen des Backfills diesen Parameter auf on fest, damit während des Tests keine Impressionen oder Klicks für Anzeigen erfasst werden. In Nicht-Testumgebungen sollte der Parameter auf off festgelegt werden, um Abrechnungen normal durchzuführen. Wenn dieser Parameter nicht festgelegt ist, wird standardmäßig off verwendet.
Hinweis: Wenn Sie direktverkaufte Werbebuchungen testen, sollten Sie stattdessen Testwerbebuchungen ohne Umsatzauswirkung verwenden.
Verwendungsbeispiele
On:
adtest=on
Off:
adtest=off
ad_type (Anzeigentyp)
Beschreibung
Für den Parameter „Anzeigentyp“ (ad_type) kann ein konstanter Wert verwendet werden, der angibt, welche Anzeigentypen für die Anfrage zurückgegeben werden sollen.
Wann ad_type auf audio oder audio_video gesetzt ist, müssen die vpmute-Parameter auf 0 gesetzt sein.
Verwendungsbeispiele
Nur Audioanzeigen sind zulässig:
ad_type=audio
Sowohl überspringbare als auch nicht überspringbare Videoanzeigen sind zulässig:
ad_type=video
Sowohl Audio- als auch Videoanzeigen sind zulässig:
ad_type=audio_video
Bei diesem Wert
audio_videokönnen beide Formate konkurrieren, es wird jedoch nur eines ausgeliefert. Er ist nur zur Auslieferung von Video-Creatives in Audioinhalten vorgesehen, die die Wiedergabe von Videoanzeigen unterstützen, oder von Audio-Creatives in In-Stream-Videoplayern für „anhörbare“ Inhalte wie Sportstreams, Videocasts oder Nachrichten. Weitere Informationen zu Audio in Videoinhalten.
Nur überspringbare Videoanzeigen sind zulässig:
ad_type=skippablevideo
Nur nicht überspringbare Videoanzeigen sind zulässig:
ad_type=standardvideo
Anforderungen und Empfehlungen
- Wenn Ihre App Videoinhalte enthält, setzen Sie diesen Parameter auf
video,audio_videooder lassen Sie ihn deaktiviert. - Wenn Ihre App nur Audioinhalte enthält (z. B. eine Radio- oder Sprach-App), müssen Sie diesen Parameter auf
audiofestlegen. Wenn Sie diesen Parameter nicht festlegen, werden keine Audioanzeigen zurückgegeben.
afvsz (Größen nicht linearer Anzeigen)
Beschreibung
Für den Parameter „Größen nicht linearer Anzeigen“ (afvsz) können konstante Werte verwendet werden, die eine durch Kommas getrennte Liste mit Größen nicht linearer Anzeigen angeben, die auf der Anzeigenfläche für Videos dargestellt werden können.
Folgende Größen werden unterstützt:
200 x 200250 x 250300 x 250336 x 280450x50468 x 60480x90729x90
Wenn Sie das IMA SDK verwenden, wird das Feld überschrieben und mit allen unterstützten Größen gefüllt, die zwischen nonLinearAdSlotWidth und nonLinearAdSlotHeight liegen.
Dieser Parameter kann weggelassen werden oder leer sein, wenn keine Größen nicht linearer Anzeigen unterstützt werden.
Verwendungsbeispiele
Alle Größen werden unterstützt:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90
Die maximale Breite ist 250:
afvsz=200x200,250x250
Die maximale Höhe ist 60:
afvsz=450x50,468x60
Die maximale Breite ist 100:
//empty; no values supported
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung oder einen bestimmten Transaktionstyp auszuliefern, aber für die Auslieferung von nicht linearen Videoanzeigen, wenn das IMA SDK nicht verwendet wird.
allcues (Alle Cues)
Beschreibung
Für den Parameter „all cues“ (allcues) können variable Werte verwendet werden, die eine durch Kommas getrennte Liste von Cue-Punkten (in Millisekunden) darstellen. Für jeden Wert wird über Google Ad Manager eine Werbeunterbrechung zurückgegeben.
- Die Parameter
vid_dundallcueswerden verwendet, um Mid-Roll-Anzeigen ohne Contentaufnahme auszuliefern. - Auch Anzeigenregeln sind erforderlich, um Mid-Rolls zurückzugeben. Wenn in Ihren Anzeigenregeln zeitbasierte Cue-Punkte (beispielsweise „Alle n Sekunden“ oder „Zu festen Zeiten“) festgelegt sind, werden diese verwendet. Die im Parameter
allcuesübergebenen Cue-Punkte werden ignoriert. Für Mid-Roll-Anzeigen muss noch eine Dauer festgelegt werden. Daher mussvid_dnoch übergeben werden.
Verwendungsbeispiele
Cue-Punkte bei 10 und 20 Sekunden:
allcues=10000,20000
ciu_szs (Companion-Größen)
Beschreibung
Für den Parameter „Companion-Größen“ (ciu_szs) können variable Werte verwendet werden, die eine durch Kommas getrennte Liste von Companion-Größen darstellen.
Werte, die durch einen senkrechten Strich (|) getrennt sind, geben eine Anzeigenfläche mit mehreren Größen an.
Verwendungsbeispiele
ciu_szs=728x90,300x250
Größen mit einer Anzeigenfläche mit mehreren Größen:
ciu_szs=728x90,300x200|300x250
cmsid (ID der Contentquelle)
Beschreibung
Für die Parameter „ID der Contentquelle“ (cmsid) und „Video-ID“ (vid) können variable Werte verwendet werden.
Wenn Sie Anzeigen auf Videocontent ausrichten, muss das Master-Video-Tag beide Parameter enthalten.
cmsidist eine eindeutige Zahl für jede Contentquelle. Sie lässt sich in Google Ad Manager ermitteln, indem Sie auf Video, dann auf Contentquellen und dann auf den Namen der Quelle klicken.vidist ein String oder eine Zahl, die ein bestimmtes Video identifiziert. Diese ID wird vom CMS zugewiesen, das Ihren Content hostet. Sie lässt sich in Google Ad Manager ermitteln, indem Sie auf Video, dann auf Content und dann auf den gewünschten Videocontent klicken.
Verwendungsbeispiele
cmsid=[value]&vid=[value]
Wenn Sie ein Tag für Video-on-Demand mit dynamischer Anzeigenbereitstellung erstellen möchten, sollten Sie die Makros verwenden, die dynamisch die richtige Contentquelle und Video-ID einfügen.
Beispiel: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Anforderungen und Empfehlungen
Diese Parameter sind zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung oder einen bestimmten Transaktionstyp auszuliefern, sie sind jedoch für das Targeting auf Videocontent erforderlich.
cust_params (benutzerdefinierte Parameter)
Beschreibung
Für den benutzerdefinierten Parameter (cust_params) können variable Werte verwendet werden, die Schlüssel/Wert-Paare sind. Damit können Sie ein spezielles Targeting vornehmen, etwa auf bestimmte demografische Merkmale, bestimmte Positionen auf einer Webseite oder bestimmte Seiten.
Verwendungsbeispiele
Beispiele dafür, wie Sie Schlüssel/Wert-Paare hinzufügen
excl_cat (Ausschlusskategorie)
Beschreibung
Für den Parameter „Ausschluss“ (excl_cat) können variable Werte angegeben werden. Er wird verwendet, um alle Werbebuchungen mit dem entsprechenden Ausschlusslabel in der Anzeigenanfrage zu blockieren. Verwenden Sie den Parameter cust_params, um die Ausschlusskategorie und die Ausschlusslabels festzulegen.
Verwendungsbeispiele
Wenn Sie die Ausschlusskategorie für zwei Ausschlusslabels (airline_excl_label und train_excl_label) festlegen möchten, verwenden Sie ein Pipe-Zeichen (|), um die Labels zu trennen:
excl_cat=airline_excl_label%7Ctrain_excl_label
Wenden Sie dann die URL-Codierung an und verwenden Sie den codierten String in cust_params:
&cust_params=excl_cat%3Dairline_excl_label%7Ctrain_excl_label
gdpr (DSGVO)
Beschreibung
Für den DSGVO-Parameter (gdpr) sind konstante Werte zulässig. Er wird von Publishern verwendet, die Version 2.0 des IAB TCF integrieren möchten. Bei direkten VAST-Anfragen werden die Werte zwar nicht automatisch gelesen, sie werden aber akzeptiert, wenn sie Teil eines Anzeigen-Tags sind.
Nur 0 und 1 sind gültige Werte für diesen Parameter. 0 bedeutet, dass die DSGVO nicht gilt, und 1, dass die DSGVO gilt. Wenn die DSGVO gilt, müssen Sie außerdem mit dem Parameter gdpr_consent einen gültigen TC-String angeben.
Weitere Informationen zu den Werten, die an diesen Parameter übergeben werden, finden Sie in der allgemeinen Anleitung zur Implementierung des Frameworks oder in den Spezifikationen für Version 2.0 des IAB TCF im Bereich TC-String.
Verwendungsbeispiele
Die DSGVO gilt:
gdpr=1
Die DSGVO gilt nicht:
gdpr=0
gdpr_consent (DSGVO-Einwilligung)
Beschreibung
Für den Parameter für die DSGVO-Einwilligung (gdpr_consent) sind variable Werte zulässig. Er wird von Publishern verwendet, die Version 2.0 des IAB TCF integrieren möchten. Bei direkten VAST-Anfragen werden die Werte zwar nicht automatisch gelesen, sie werden aber akzeptiert, wenn sie Teil eines Anzeigen-Tags sind.
Weitere Informationen zu den Werten, die an diesen Parameter übergeben werden, finden Sie in der allgemeinen Anleitung zur Implementierung des Frameworks oder in den Spezifikationen für Version 2.0 des IAB TCF im Bereich TC-String.
Verwendungsbeispiele
gdpr_consent=GDPR_CONSENT_123
iabexcl (IAB-Ausschluss-URL)
Beschreibung
Für den URL-Parameter „IAB-Ausschluss“ (iabexcl) können variable Werte verwendet werden, die eine durch Kommas getrennte Liste von Kategorien darstellen.
Verwendungsbeispiele
iabexcl=3,14,527 schließt „Gewerbliche LKWs“, „Geländefahrzeuge“ und „Rugby“ aus.
Sie können eine Liste der Kategorien der IAB-Taxonomie für Inhalte und ihre IDs herunterladen.
idtype (Gerätetyp)
Beschreibung
Für die Parameter für rücksetzbare Geräte-IDs (rdid, idtype, is_lat) können variable Werte verwendet werden. Dieser Wert wird auch als Identifier for Advertising (IFA) bezeichnet.
Bei mobilen Anwendungen, die das IMA SDK für Android oder iOS verwenden, werden über das IMA SDK mit Parametern für rdid, idtype und is_lat die rücksetzbaren Geräte-IDs für das Targeting auf Nutzer in Ihre Streamanfragen übergeben.
Wenn das IMA SDK nicht verwendet wird oder serverseitiges Beaconing (SSB) verwendet wird, müssen Sie diese als explizite Parameter übergeben. Weitere Informationen zu Geräte-IDs
Diese Werte müssen bei fast allen programmatischen Videoanzeigen vorhanden sein.
|
Seit iOS 14.5 wird das |
Verwendungsbeispiele
Detaillierte Beispiele für rücksetzbare Gerätekennungen
Anforderungen und Empfehlungen
Diese Parameter sind zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, aber für die programmatische Monetarisierung in mobilen Apps, internetfähigen Fernsehern, Audio und digitalen Außenwerbeflächen.
Bei Webimplementierungen werden keine rücksetzbaren Geräte-IDs verwendet.
SDK-Nutzung
Bei Verwendung des IMA SDKs wird das Feld automatisch übergeben. Wenn der Publisher das PAL SDK verwendet, müssen die entsprechenden Parameter manuell übergeben werden.
ipd (Partnerdomain-Inventar)
Beschreibung
Für den Parameter für die Inventarpartnerdomain (ipd) können variable Werte verwendet werden, die auf die inventorypartnerdomain-Deklarationen in der app-ads.txt- oder der ads.txt gesetzt werden sollten.
Der Parameter inventorypartnerdomainist eine IAB-Spezifikation, mit der Publisher eine Domain eines Partners für die Inventarfreigabe zur Validierung von ads.txt/app-ads.txt angeben können.
Die IPD-Deklaration ist besonders wichtig bei Anwendungsfällen mit Inventarfreigabe, bei denen das Anzeigeninventar, aus dem eine Anfrage stammt, möglicherweise einem anderen Partner (dem Partner für die Inventarfreigabe) gehört.
Weitere Informationen zu „ads.txt“/„app-ads.txt“ und Partnern, die mit Inventarfreigabe arbeiten.
Verwendungsbeispiele
Dieinventorypartnerdomain befindet sich in der app-ads.txt-Datei, die auf die .txt-Datei des Partners verweist, über die das Inventar monetarisiert werden kann. Der Wert im Parameter ipd muss mit einem Wert in der app-ads.txt-Datei unter einem der Elemente inventorypartnerdomain übereinstimmen.Anforderungen und Empfehlungen
Dieser Parameter ist für Publisher erforderlich, die Inventar monetarisieren, das nicht ihnen gehört.
ipe (Impression Ping Entität)
Beschreibung
Für den Parameter für Impressions-Pings (ipe) kann ein konstanterWert verwendet werden, über den Impressions-Pings und Conversions angegeben werden, die von einem Server und nicht von einem Client stammen.
Die Impressions-Ping-Entität wird verwendet, wenn ein Server Impressions-Pings/-Beacons vom Server sendet.
Verwendungsbeispiele
Serverseitiges Beaconing (SSB):
ipe=ssb
is_lat (eingeschränktes Anzeigen-Targeting)
Beschreibung
Für die Parameter für rücksetzbare Geräte-IDs (rdid, idtype, is_lat) können variable Werte verwendet werden. Dieser Wert wird auch als Identifier for Advertising (IFA) bezeichnet.
Bei mobilen Anwendungen, die das IMA SDK für Android oder iOS verwenden, werden über das IMA SDK mit Parametern für rdid, idtype und is_lat die rücksetzbaren Geräte-IDs für das Targeting auf Nutzer in Ihre Streamanfragen übergeben.
Wenn das IMA SDK nicht verwendet wird oder serverseitiges Beaconing (SSB) verwendet wird, müssen Sie diese als explizite Parameter übergeben. Weitere Informationen zu Geräte-IDs
Diese Werte müssen bei fast allen programmatischen Videoanzeigen vorhanden sein.
|
Seit iOS 14.5 wird das |
Verwendungsbeispiele
Detaillierte Beispiele für rücksetzbare Gerätekennungen
Anforderungen und Empfehlungen
Diese Parameter sind zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, aber für die programmatische Monetarisierung in mobilen Apps, internetfähigen Fernsehern, Audio und digitalen Außenwerbeflächen.
Bei Webimplementierungen werden keine rücksetzbaren Geräte-IDs verwendet.
SDK-Nutzung
Bei Verwendung des IMA SDKs wird das Feld automatisch übergeben. Wenn der Publisher das PAL SDK verwendet, müssen die entsprechenden Parameter manuell übergeben werden.
lip (letzte Position im Pod)
Beschreibung
Der Parameter "letzte Position in Pod" (lip) kann ein konstanter Wert sein, mit dem eine Anfrage von der letzten Position in einem Pod für Targeting oder Berichte angegeben wird.
Hinweis: Dieser Parameter gilt nicht für optimierte Pods und wird bei Verwendung ignoriert.
Verwendungsbeispiele
lip=1
ltd (eingeschränktes Anzeigen-Targeting)
Beschreibung
Für den Parameter "eingeschränktes Anzeigen-Targeting" (ltd) kann ein konstanter Wert verwendet werden, um anzugeben, ob Anzeigen eingeschränkt ausgeliefert werden, wenn sie keine Einwilligung für die Verwendung von Cookies oder anderen lokalen Kennungen erhalten haben. Publisher können diesen Parameter manuell hinzufügen. Google versucht dann, unabhängig vom Standort des Nutzers eine geeignete Anzeige mit eingeschränktem Targeting zu präsentieren.
Mit diesem Parameter wird eine Anfrage für eingeschränktes Anzeigen-Targeting angegeben. Er unterscheidet sich vom Parameter is_lat. Hierdurch werden die Personalisierung und die Verwendung von IDs für solche Zwecke deaktiviert.
ltd=1 angewiesen, die Anfrage so zu behandeln, als enthielte sie keine ID. In diesem Fall ist keine Speicherung möglich.Wenn eine Anzeigenanfrage
ltd=1 enthält (d. h. eine Anfrage für eingeschränktes Anzeigen-Targeting), wird die Domain bei Verwendung von SDKs zu pagead2.googlesyndication.com umgestellt. Bei SDK-losen Integrationen müssen Publisher die Domain manuell in pagead2.googlesyndication.com ändern.Verwendungsbeispiele
ltd=1
max_ad_duration (maximale Anzeigendauer)
Beschreibung
Für die Parameter "Mindestdauer der Anzeige" (min_ad_duration) und "Maximale Dauer der Anzeige" (max_ad_duration) können variable Werte angegeben werden, die zusammen den Bereich für die Dauer in Millisekunden angeben, dem eine Anzeige entsprechen muss.
Mit diesem Parameter können Creatives auf eine im Anzeigen-Tag für einzelne Anzeigen oder in optimierten Pod-Anfragen erforderliche Dauer beschränkt werden.
Verwendungsbeispiele
min_ad_duration=15000&max_ad_duration=30000
min_ad_duration (minimale Anzeigendauer)
Beschreibung
Für die Parameter "Mindestdauer der Anzeige" (min_ad_duration) und "Maximale Dauer der Anzeige" (max_ad_duration) können variable Werte angegeben werden, die zusammen den Bereich für die Dauer in Millisekunden angeben, dem eine Anzeige entsprechen muss.
Mit diesem Parameter können Creatives auf eine im Anzeigen-Tag für einzelne Anzeigen oder in optimierten Pod-Anfragen erforderliche Dauer beschränkt werden.
Verwendungsbeispiele
min_ad_duration=15000&max_ad_duration=30000
mridx (Mid-Roll-Zahl)
Beschreibung
Für den Parameter "Zahl Mid-Roll" (mridx) kann ein variabler Wert verwendet werden, der die Ordnungszahl des Mid-Rolls angibt (z. B. Mid-Roll 1, Mid-Roll 2 usw.).
Verwendungsbeispiele
mridx=2
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung oder einen bestimmten Transaktionstyp auszuliefern, aber für die Ausrichtung auf eine bestimmte Mid-Roll, die Meldung zu einer Mid-Roll und die Prognose für eine Mid-Roll.
nofb (kein Fallback)
Beschreibung
Für den Parameter "kein Fallback" (nofb) kann ein konstanter Wert verwendet werden, um anzugeben, dass für die Anzeigenanfrage keine Playlist mit Video-Fallback-Anzeigen zurückgegeben werden soll.
Verwendungsbeispiele
Fallback deaktiviert:
nofb=1
Der Fallback für einzelne Anzeigen und eigenständige Fallback-Anzeigen für optimierte Pods können pro Anzeigenanfrage deaktiviert werden, indem nofb=1 übergeben wird.
npa (nicht personalisierte Anzeige)
Beschreibung
Für den Parameter "nicht personalisierte Werbung" (npa) kann ein konstanter Wert verwendet werden, der angibt, dass die Anzeigenanfrage als nicht personalisiert behandelt werden sollte.
Sie müssen entweder speziell npa=1 festlegen oder einfach npa einfügen (ohne einen Wert anzugeben), um die Anzeigenanfrage als nicht personalisiert zu markieren. Bei Anzeigenanfragen, bei denen dieser Parameter fehlt oder auf npa=0 festgelegt ist, werden standardmäßig personalisierte Anzeigen verwendet.
Verwendungsbeispiele
Nicht personalisierte Werbung:
npa=1
Anforderungen und Empfehlungen
Dieser Parameter ist nur erforderlich, wenn der Nutzer die Personalisierung deaktiviert. Publisher müssen dafür sorgen, dass der Nutzerstatus korrekt ist, wenn sie ihn steuern.
paln (Nonce der Programmatic Access Library – veraltet)
Beschreibung
Bei Integrationen, für die die Programmatic Access Library (PAL) verwendet wird, kann für den Parameter Video Nonce ein variabler String-Wert verwendet werden.
Nonce ist URL-sicher und muss nicht URL-codiert werden.
Hinweis: Wenn Sie zuvor Nonce mit dem bisherigen Parameter paln angegeben haben, sollten Sie dringend zum Parameter givn migrieren und paln nicht mehr senden. Verwenden Sie nicht beide Parameter.
Verwendungsbeispiele
Weitere Informationen zu den Werten, die an diesen Parameter übergeben werden, finden Sie in den Startleitfäden zu PAL.
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung im Web, in mobilen Apps, auf internetfähigen Fernsehern, in Audio und bei digitaler Außenwerbung empfohlen.
pmad (maximale Anzahl von Anzeigen im Pod)
Beschreibung
Der Parameter "maximale Anzeigen Pod" (pmad) kann ein variabler Wert sein, der die maximale Anzahl von Anzeigen in einem Pod angibt.
Mit diesem Parameter wird die Gesamtzahl der Anzeigen in einem optimierten Pod begrenzt. Diese Funktion ist für Publisher mit einem erweiterten Videopaket verfügbar.
Dieser Parameter sollte nicht für VMAP verwendet werden (wenn ad_rule=1).
Verwendungsbeispiele
pmad=4
pmnd (minimale Pod-Dauer)
Beschreibung
Für die Parameter "Pod-Mindestdauer" (pmnd) und "Pod-Höchstdauer" (pmxd) können variable Werte angegeben werden, die zusammen den Bereich für die Dauer in Millisekunden angeben, dem ein Pod entsprechen muss.
Diese Parameter werden zum Anfordern mehrerer Anzeigen in einem optimierten Pod verwendet. Diese Funktion steht Publishern mit erweiterten Videofunktionen zur Verfügung. Wenn Anzeigenregeln verwendet werden, werden diese Informationen automatisch in Google Ad Manager hinzugefügt.
Dieser Parameter sollte nicht für VMAP verwendet werden (wenn ad_rule=1).
Verwendungsbeispiele
pmnd=0&pmxd=60000
pmxd (maximale Pod-Dauer)
Beschreibung
Für die Parameter "Pod-Mindestdauer" (pmnd) und "Pod-Höchstdauer" (pmxd) können variable Werte angegeben werden, die zusammen den Bereich für die Dauer in Millisekunden angeben, dem ein Pod entsprechen muss.
Diese Parameter werden zum Anfordern mehrerer Anzeigen in einem optimierten Pod verwendet. Diese Funktion steht Publishern mit erweiterten Videofunktionen zur Verfügung. Wenn Anzeigenregeln verwendet werden, werden diese Informationen automatisch in Google Ad Manager hinzugefügt.
Dieser Parameter sollte nicht für VMAP verwendet werden (wenn ad_rule=1).
Verwendungsbeispiele
pmnd=0&pmxd=60000
pmxfwt (maximale erzwungene Wiedergabezeit von Pods)
Beschreibung
Für den Parameter für die maximale erzwungene Wiedergabezeit von Pods (pmxfwt) kann ein variabler Wert verwendet werden, der die maximale Dauer nicht überspringbarer Inhalte eines Pods in Millisekunden angibt.
Wenn Sie Pods mit einer Mischung aus nicht überspringbaren und überspringbaren Videoanzeigen unterstützen und die Werbezeit für Nutzer begrenzen möchten, können Sie mit diesem Parameter die maximale Dauer für nicht überspringbare Anzeigen festlegen, die ein Nutzer sich ansehen muss.
Hinweis: Der Parameter „max. Dauer des Pods“ (pmxd) ersetzt diesen Parameter bei der Definition der maximalen Gesamtdauer des Pods (einschließlich der vollständigen Dauer für überspringbare Anzeigen).
Verwendungsbeispiel
pmxfwt=30000
pod (Pod-Nummer)
Beschreibung
Der Parameter "Pod-Zahl" (pod) kann ein variabler Wert sein, der die Ordnungszahl des Pods in einem Video darstellt (z. B. Pod 1, Pod 2 usw.).
Verwendungsbeispiele
pod=3
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung oder einen bestimmten Transaktionstyp auszuliefern, aber er ist erforderlich, damit dieselbe Anzeige in verschiedenen Pods ausgeliefert werden kann und Competitive Exclusions, Frequency Capping und ähnliche Funktionen richtig verwendet werden können.
pp (Creative-Profil)
Beschreibung
Der Parameter "Creative-Profil" (pp) kann ein variabler Wert sein, mit dem über die Konfiguration eines Video- und Audio-Creative-Profils vorgegeben wird, welche Creatives ausgeliefert werden dürfen.
Verwendungsbeispiele
pp=creative_profile
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, aber er ist erforderlich, um Mediendateien für von Google Ad Manager gehostete Creatives mit Video- und Audio-Creative-Profilen einzuschränken. Bei Weiterleitungen oder programmatischen Anzeigen wird so sichergestellt, dass die Anforderung erfüllt ist. Die Mediadateien werden jedoch nicht auf die im Creative-Profil ausgewählten beschränkt.
ppt (Publisher Privacy Treatment)
Beschreibung
Für den Parameter "Publisher Privacy Treatment" (ppt) kann ein konstanter Wert verwendet werden, um anzugeben, ob personalisierte Anzeigen für die Anzeigenanfrage deaktiviert werden sollen.
Mit diesem Parameter können nicht personalisierte Anzeigen erzwungen werden, die sich von npa=1 und rdp=1 unterscheiden. Dies wirkt sich sowohl auf Reservierungen als auch auf die programmatische Nachfrage aus.
Weitere Informationen zu Publisher Privacy Treatment
Verwendungsbeispiele
Personalisierte Werbung deaktivieren:
ppt=1
ppid (vom Publisher bereitgestellte Kennung)
Beschreibung
Der Parameter "vom Publisher bereitgestellte Kennung" (ppid) akzeptiert einen variablen Wert der Kennung und wird für Frequency Capping, Zielgruppensegmentierung, Targeting, sequenzielle Anzeigenrotation und andere zielgruppenbasierte Einstellungen der Anzeigenauslieferung auf verschiedenen Geräten verwendet.
Weitere Informationen zu vom Publisher bereitgestellten Kennungen
Verwendungsbeispiele
ppid=12JD92JD8078S8J29SDOAKC0EF230337
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung oder einen bestimmten Transaktionstyp auszuliefern, aber es ist erforderlich, eine einheitliche plattformübergreifende Kennung zu verwenden. Sie kann verwendet werden, wenn keine anderen Kennungen vorhanden sind und sie Käufern zur Verfügung gestellt werden kann.
ppos (Position im Pod)
Beschreibung
Für den Parameter "Positionierung in Pod" (ppos) kann ein variabler Wert verwendet werden, der die Position in einem Pod darstellt (z. B. Position 1, Position 2 usw.).
Dieser Parameter gilt nur für Standard-Pods und ist für die AutoFill-Funktion von Companion-Anzeigen erforderlich. Wenn Anzeigenregeln verwendet werden, werden diese Informationen automatisch in Google Ad Manager hinzugefügt.
Verwendungsbeispiele
ppos=2
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung oder einen bestimmten Transaktionstyp zu schalten, aber für Standard-Pods, wenn eine Ausrichtung auf eine Position erforderlich ist, sowie für Prognosen und Berichte zu Standard-Pods. Außerdem müssen Competitive Exclusions, Frequency Capping und ähnliche Funktionen richtig verwendet werden.
ppsj (vom Publisher bereitgestellte Signale, JSON)
Beschreibung
Der Parameter "JSON" für vom Publisher bereitgestellte Signale (ppsj) akzeptiert einen variablen Wert, also ein base64-codiertes JSON-Objekt mit Zielgruppen- und Kontextdaten, die vom Publisher bereitgestellt werden, um die programmatische Monetarisierung zu verbessern.
Mit diesem Parameter können bestimmte Signale an Käufer/Bieter gesendet werden.
Weitere Informationen zu vom Publisher bereitgestellten Signalen und unterstützten Taxonomien
Verwendungsbeispiele
JSON-Objekt:
{
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["6", "284"]
}]
}
Base64-codierten Wert anwenden:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2l
nbmFscyI6W3sidGF4b25vbXkiOiJJQUJfQVVESUVOQ0V
fMV8xIiwidmFsdWVzIjpbIjEiLCIyODQiXX1dfQ
Weitere Informationen zu gültigen JSON-Schlüssel/Wert-Paaren finden Sie im
Beispiel für HTML5 IMA SDK.
ptpl (ID der Vorlage für eine Werbeunterbrechung)
Beschreibung
Für den Parameter "ID der Vorlage für eine Werbeunterbrechung" (ptpl) und den Parameter "Name der Vorlage für eine Werbeunterbrechung" (ptpln) können variable Werte verwendet werden, um anzugeben, welche Vorlage für eine Werbeunterbrechung auf die Anfrage für einen optimierten Pod angewendet werden soll.
Mit Vorlagen für eine Werbeunterbrechung lässt sich konfigurieren, welche Werbespots oder benutzerdefinierten Werbespots eine Werbeunterbrechung enthalten soll und in welcher Reihenfolge sie ausgeliefert werden sollen.
Zum Anfordern einer Vorlage für eine Werbeunterbrechung ist nur einer dieser Parameter erforderlich.
Verwendungsbeispiele
Weitere Informationen zum Einrichten und Anfordern von Vorlagen für Werbeunterbrechungen
Anforderungen und Empfehlungen
Diese Parameter sind nur bei direkter Anforderung für eine Vorlage für eine Werbeunterbrechung erforderlich.
ptpln (Name der Vorlage für eine Werbeunterbrechung)
Beschreibung
Für den Parameter "ID der Vorlage für eine Werbeunterbrechung" (ptpl) und den Parameter "Name der Vorlage für eine Werbeunterbrechung" (ptpln) können variable Werte verwendet werden, um anzugeben, welche Vorlage für eine Werbeunterbrechung auf die Anfrage für einen optimierten Pod angewendet werden soll.
Mit Vorlagen für eine Werbeunterbrechung lässt sich konfigurieren, welche Werbespots oder benutzerdefinierten Werbespots eine Werbeunterbrechung enthalten soll und in welcher Reihenfolge sie ausgeliefert werden sollen.
Zum Anfordern einer Vorlage für eine Werbeunterbrechung ist nur einer dieser Parameter erforderlich.
Verwendungsbeispiele
Weitere Informationen zum Einrichten und Anfordern von Vorlagen für Werbeunterbrechungen
Anforderungen und Empfehlungen
Diese Parameter sind nur bei direkter Anforderung für eine Vorlage für eine Werbeunterbrechung erforderlich.
pubf (Öffentliche Mindestpreise in Ad Exchange-Tags)
Beschreibung
Der Parameter "Öffentlicher Mindestpreis für Ad Exchange" (pubf) und der Parameter "Privater Mindestpreis für Ad Exchange" (pvtf) akzeptieren variable Werte, mit denen Mindestpreise in Ad Exchange-Tags eingefügt werden.
Diese Parameter entsprechen google_ad_public_floor und google_ad_private_floor.
Verwendungsbeispiele
Öffentlicher Mindestpreis:
pubf=123
Privater Mindestpreis:
pvtf=123
Anforderungen und Empfehlungen
Diese Parameter sind nur für Publisher im Europäischen Wirtschaftsraum (EWR) oder in der Schweiz verfügbar, die die Verwendung der Funktion „Mindestpreis“ genehmigt haben.
Weitere Informationen zum Einreichen einer Anfrage
pvid (App-Set-ID)
Beschreibung
Für den Parameter "App-Set-ID" (pvid) wird ein variabler Wert verwendet, der der Android-App-Set-ID entspricht. Für den Parameter "App-Set-Bereich" (pvid_s) ist ein konstanter Wert zulässig, der den Bereich der App-Set-ID darstellt (entweder scope_app oder scope_developer).
Weitere Informationen finden Sie in der Android-Dokumentation zum Abrufen der App-Set-ID.
Verwendungsbeispiele
pvid=[AppSetID_value]
pvid_s=scope_app
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung in mobilen Apps auf Android-Geräten empfohlen, einschließlich appbasierter internetfähiger Fernseher (Android TV).
SDK-Nutzung
Bei Verwendung des IMA/PAL SDKs wird das Feld automatisch übergeben. Wenn der Publisher kein SDK implementiert hat, muss er das App Set SDK aufrufen und die entsprechenden Parameter manuell in der Anzeigenanfrage weitergeben.
pvid_s (App-Set-Bereich)
Beschreibung
Für den Parameter "App-Set-ID" (pvid) wird ein variabler Wert verwendet, der der Android-App-Set-ID entspricht. Für den Parameter "App-Set-Bereich" (pvid_s) ist ein konstanter Wert zulässig, der den Bereich der App-Set-ID darstellt (entweder scope_app oder scope_developer).
Weitere Informationen finden Sie in der Android-Dokumentation zum Abrufen der App-Set-ID.
Verwendungsbeispiele
pvid=[AppSetID_value]
pvid_s=scope_app
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung auszuliefern, wird aber für die programmatische Monetarisierung in mobilen Apps auf Android-Geräten empfohlen, einschließlich appbasierter internetfähiger Fernseher (Android TV).
SDK-Nutzung
Bei Verwendung des IMA/PAL SDKs wird das Feld automatisch übergeben. Wenn der Publisher kein SDK implementiert hat, muss er das App Set SDK aufrufen und die entsprechenden Parameter manuell in der Anzeigenanfrage weitergeben.
pvtf (Private Mindestpreise in Ad Exchange-Tags)
Beschreibung
Der Parameter "Öffentlicher Mindestpreis für Ad Exchange" (pubf) und der Parameter "Privater Mindestpreis für Ad Exchange" (pvtf) akzeptieren variable Werte, mit denen Mindestpreise in Ad Exchange-Tags eingefügt werden.
Diese Parameter entsprechen google_ad_public_floor und google_ad_private_floor.
Verwendungsbeispiele
Öffentlicher Mindestpreis:
pubf=123
Privater Mindestpreis:
pvtf=123
Anforderungen und Empfehlungen
Diese Parameter sind nur für Publisher im Europäischen Wirtschaftsraum (EWR) oder in der Schweiz verfügbar, die die Verwendung der Funktion „Mindestpreis“ genehmigt haben.
Weitere Informationen zum Einreichen einer Anfrage
rdp (eingeschränkte Datenverarbeitung)
Beschreibung
Für den Parameter „eingeschränkte Datenverarbeitung“ (rdp) kann ein konstanter Wert verwendet werden, der angibt, dass die Datenverarbeitung in der Anzeigenanfrage beschränkt werden soll.
Sie können die Datenverarbeitung auf Netzwerkebene einschränken, indem Sie die Netzwerkeinstellung Datenverarbeitung einschränken aktivieren.
Verwendungsbeispiele
Datenverarbeitung einschränken:
rdp=1 oder rdp (ohne festgelegten Wert)
Datenverarbeitung nicht einschränken:
rdp=0
scor (Stream-Korrelator)
Beschreibung
Für den Parameter „Stream Correlator“ (scor) kann ein variabler Wert verwendet werden, der eine für jeden Videostream generierte Ganzzahl ist.
Die scor und correlator-Parameter müssen nicht denselben Ganzzahlwert haben. Sie sollten jedoch während der gesamten Wiedergabe des Videostreams ihre jeweiligen Werte beibehalten, um eine eindeutige Wiedergabesitzung zu identifizieren.
Verwendungsbeispiele
scor=17
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung oder einen bestimmten Transaktionstyp auszuliefern, wird aber für die Anzeigenbereitstellung im Web, in mobilen Apps, auf internetfähigen Fernsehern, in Audio und in digitaler Außenwerbung empfohlen.
Dieser Parameter wird für Mitbewerberausschlüsse, Frequency Capping und ähnliche Funktionen verwendet, wenn sich ein Nutzer auf einer Seite mehrere Videos ansieht.
sdk_apis (SDK API-Framework)
Beschreibung
Für den Parameter „SDK API-Framework“ (sdk_apis) kann eine durch Kommas getrennte Liste von konstanten Ganzzahlwerten verwendet werden, die alle API-Frameworks angeben, die vom Player unterstützt werden.
Anforderungen und Empfehlungen
SDK-Nutzung
Dieser Parameter wird von Publishern verwendet, die Programmatic Access Library (PAL) verwenden. Wenn Sie versuchen, Werte für diesen Parameter festzulegen, während Sie das IMA SDK verwenden, werden die Werte mit den vom IMA SDK unterstützten Werten überschrieben.
sdmax (max. Dauer überspringbarer Anzeigen)
Beschreibung
Für den Parameter „max. Dauer überspringbarer Anzeigen“ (sdmax) kann ein variabler Wert verwendet werden, mit dem Publisher die gewünschte maximale Dauer überspringbarer Anzeigen angeben können.
Es wird eine Dauer in Millisekunden angegeben, die die Obergrenze für die Dauer überspringbarer Video-/Audio-Creatives für diese bestimmte Anzeigenanfrage darstellt.
Verwenden Sie sdmax unabhängig für überspringbare Anzeigen oder in Kombination mit dem vorhandenen Parameter max_ad_duration, um eine unterschiedliche maximale Dauer für überspringbare und nicht überspringbare Anzeigen anzugeben.
Verwendungsbeispiele
Einstellungen:
max_ad_duration= 15000 (15 Sekunden)sdmax= 45000 (45 Sekunden)
Für die folgenden Creatives:
- Creative A: nicht überspringbar; 30 s
- Creative B: überspringbar; 30 s
Ergebnisse:
- Creative A wird herausgefiltert, weil es nicht überspringbar ist und seine Dauer die maximale (nicht überspringbare) Dauer überschreitet.
- Creative B wird nicht herausgefiltert, weil seine Dauer zwar den Wert
max_ad_durationüberschreitet, es aber überspringbar ist und seine Dauer nicht die max. Dauer überspringbarer Anzeigen überschreitet.
ssss (serverseitige Stitching-Quelle)
Beschreibung
Für den Parameter für die serverseitige Stitching-Quelle (ssss) muss ein konstanter Wert angegeben werden, der auf einen bekannten, von Google bereitgestellten Wert für Ihren Anbieter für Video-Stitching-Technologie gesetzt werden sollte.
Anbieter für Video-Stitching-Technologie, die eine Server-zu-Server-Integration mit Google nutzen, erhalten den entsprechenden Wert von Google und können ihn dann an Sie weitergeben. Wenden Sie sich an Ihren Google Account Manager, wenn Sie Fragen zum Wert für diesen Parameter haben.
Verwendungsbeispiele
ssss=mystitcher
Anforderungen und Empfehlungen
Dieser Parameter ist zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung oder einen bestimmten Transaktionstyp auszuliefern, aber für serverseitige Implementierungen.
tfcd (Tag für auf Kinder ausgerichtete Inhalte)
Beschreibung
Für den Parameter „für Kinder ausgerichtet“ (tfcd) kann ein konstanter Wert verwendet werden, der angibt, dass die Anfrage als für Kinder behandelt werden soll.
Verwendungsbeispiele
tfcd=1
trt (Traffic-Typ)
Beschreibung
Für den Parameter „Traffic-Typ“ (trt) kann ein konstanter Wert verwendet werden, über den entweder gekaufter oder organischer Traffic angefordert wird.
Verwendungsbeispiele
Anfrage für gekauften Traffic:
trt=1
Anfrage für organischen Traffic:
trt=2
Anforderungen und Empfehlungen
SDK-Nutzung
Wenn eine Anfrage keinen Traffic-Typ-Parameter enthält, wird über das IMA SDK kein Standardwert eingegeben. In einem solchen Fall legt der Server den Standardwert 0 fest (nicht definierter Traffic).
us_privacy (IAB US Privatsphäre)
Beschreibung
Der Stringus_national wurde vom IAB zugunsten der GPP eingestellt. Der String wird jedoch weiterhin von Ad Manager gelesen und berücksichtigt, wenn er aus Gründen der Abwärtskompatibilität übergeben wird. Publishern wird empfohlen, die GPP oder andere Datenschutzeinstellungen zu prüfen und us_national zu migrieren.
vad_type (Videoanzeigentyp)
Beschreibung
Der Parameter „Videoanzeigentyp“ (vad_type) kann ein konstanter Wert verwendet werden, der angibt, ob eine lineare oder nicht lineare Anzeige zurückgegeben werden soll.
Verwendungsbeispiele
Lineare Anzeige zurückgeben:
vad_type=linear
Nicht lineare Anzeige zurückgeben:
vad_type=nonlinear
vid (Video-ID)
Beschreibung
Für die Parameter „ID der Contentquelle“ (cmsid) und „Video-ID“ (vid) können variable Werte verwendet werden.
Wenn Sie Anzeigen auf Videocontent ausrichten, muss das Master-Video-Tag beide Parameter enthalten.
cmsidist eine eindeutige Zahl für jede Contentquelle. Sie lässt sich in Google Ad Manager ermitteln, indem Sie auf Video, dann auf Contentquellen und dann auf den Namen der Quelle klicken.vidist ein String oder eine Zahl, die ein bestimmtes Video identifiziert. Diese ID wird vom CMS zugewiesen, das Ihren Content hostet. Sie lässt sich in Google Ad Manager ermitteln, indem Sie auf Video, dann auf Content und dann auf den gewünschten Videocontent klicken.
Verwendungsbeispiele
cmsid=[value]&vid=[value]
Wenn Sie ein Tag für Video-on-Demand mit dynamischer Anzeigenbereitstellung erstellen möchten, sollten Sie die Makros verwenden, die dynamisch die richtige Contentquelle und Video-ID einfügen.
Beispiel: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%
Anforderungen und Empfehlungen
Diese Parameter sind zwar nicht erforderlich, um Anzeigen für eine bestimmte Implementierung oder einen bestimmten Transaktionstyp auszuliefern, sie sind jedoch für das Targeting auf Videocontent erforderlich.
vpi (Inline-Videoplaylist)
Beschreibung
Für den Parameter „Video Playlist Inline“ (vpi) kann ein konstanter Wert verwendet werden, um anzugeben, ob Inline-VMAP ausgeliefert wird (VAST in VMAP wird zurückgegeben).
Dadurch lässt sich die Latenz reduzieren. Außerdem können so das Frequency Capping und Konkurrenzausschlüsse im ganzen Videostream umgesetzt werden.
Verwendungsbeispiele
VAST zurückgeben:
vpi=1
Weiterleitungen zurückgeben:
vpi=0