Thursday, February 24, 2022

URL-Parameter für VAST-Anzeigen-Tags - Google Ad Manager-Hilfe [gg-admanager-de]

VAST-Anzeigen-Tag-URL-Parameter

VAST-Anzeigen-Tag-URL-Parameter

Eine VAST-Anzeigen-Tag-URL wird von einem Player verwendet, um Video- und Audioanzeigen abzurufen. Sie können eine VAST-Anzeigen-Tag-URL manuell zusammenstellen oder eine vorhandene URL mit den folgenden Parametern ändern und dann mit dem VAST Suite Inspector testen. Sie können diese Beispiel-Tags auch überprüfen und testen.

VAST-Anzeigen-Tags unterstützen sowohl http als auch https. Impressions-Tracking-URLs respektieren die aktuelle SSL-Einstellung und geben entweder http oder https zurück. Click-through und Click-Tracking verwenden http, da sie von einer anderen Seite umleiten.

Anzeigen-Tag-URLs für Live-Stream-Videos müssen /live in ihrem Pfad enthalten, um sicherzustellen, dass hohes Verkehrsaufkommen bewältigt werden kann, wenn alle Werbeunterbrechungen gleichzeitig geliefert werden.

Beispiel

Eine Beispiel-URL für ein VAST-Anzeigen-Tag mit Parametern und zugewiesenen Werten würde etwa so aussehen:

https://securepubads.g.doubleclick.net/gampad/ads?env=vp&gdfp_req=1&output=vast&iu=/1234/video-demo&sz=400x300&unviewed_position_start=1&ciu_szs=728x90,300x250

Zu einem bestimmten Parameter springen:

aconp
ad_rule
ad_type
addtl_consent
afvsz
allcues
an
ciu_szs
correlator
cmsid
cust_params
description_url
env
excl_cat
gdfp_req

gdpr_consent
hl
idtype
ipe
is_lat
iu
lip
ltd
max_ad_duration
min_ad_duration
mridx
msid
nofb
npa
output

pmad
pmnd
pmxd
pod
pp
ppid
ppos
pubf
pvid
pvid_s
pvtf
rdid
rdp
scor
sdk_apis
sid

ssss
sz
tfcd
trt
unviewed_position_start
url
vad_type
vconp
vid
vid_d
vpa
vpi
vpmute
vpos
wta

Parameter Einzelheiten
aconp

(Audio-Dauerwiedergabe)

Empfohlen gemäß MRC Audio Measurement Guidelines

Der Audio-Continuous-Play-Parameter akzeptiert einen konstanten Wert, der angibt, ob der Player beabsichtigt, Audioinhalt kontinuierlich abzuspielen.

Dieser Parameter sollte nicht festgelegt werden, wenn er nicht bekannt ist.

Anwendungsbeispiel

Dauerwiedergabe EIN:
aconp=2

Dauerwiedergabe AUS:
aconp=1

ad_rule

(Anzeigenregel)

Der Anzeigenregelparameter akzeptiert einen konstanten Wert, der angibt, ob ein VAST-Creative oder eine Anzeigenregelantwort zurückgegeben werden soll.

Die Standardeinstellung für Anzeigenregeln hängt von einer Ad Manager- Werbenetzwerkeinstellung ab . Sie können die Einstellung für bestimmte Anzeigen-Tags mithilfe der folgenden Beispiele überschreiben.

Anwendungsbeispiel

Anfrage für VAST-Creative:
ad_rule=0

Anfrage für Anzeigenregeln (VMAP):
ad_rule=1

Erfordernis

Erforderlich für Videoanzeigenregeln

ad_type

(Anzeigentyp)

Der Anzeigentypparameter akzeptiert einen konstanten Wert, der den Anzeigentyp angibt, der für die Anforderung zurückgegeben werden soll.

Dieser Parameter ist derzeit nicht erforderlich, um nur eine Videoanzeige zurückzugeben.

Anwendungsbeispiel

Nur eine Audioanzeige zurückgeben:
ad_type=audio

Nur eine Videoanzeige zurückgeben:
ad_type=video

Geben Sie entweder eine Audio- oder eine Videoanzeige zurück:
ad_type=audio_video

(Bei diesem Wert können beide Formate konkurrieren, aber nur eines dient)

Erfordernis

Erforderlich für Audio-Anzeigen

afvsz

(Nicht lineare Anzeigengrößen)

Der Parameter für nicht lineare Anzeigengrößen akzeptiert konstante Werte, bei denen es sich um eine durch Kommas getrennte Liste von nicht linearen Anzeigengrößen handeln sollte, die in der Videoanzeigenfläche angezeigt werden können.

Diese Größen müssen eine der unterstützten sein:

  • 200x200
  • 250x250
  • 300x250
  • 336x280
  • 450x50
  • 468x60
  • 480x90
  • 729x90

Bei Verwendung des IMA SDK wird dieses Feld überschrieben und mit allen unterstützten Größen ausgefüllt, die in nonLinearAdSlotWidth und nonLinearAdSlotHeight fallen .

Dieser Parameter kann weggelassen werden oder leer sein, wenn keine nichtlinearen Größen unterstützt werden.

Anwendungsbeispiel

Alle Größen werden unterstützt:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90

Die maximale Breite beträgt 250:
afvsz=200x200,250x250

Maximale Höhe ist 60:
afvsz=450x50,468x60

Maximale Breite ist 100:
//empty; no values supported

Erfordernis

Erforderlich für nichtlineare Videoanzeigen , wenn das IMA SDK nicht verwendet wird

allcues

(Alle Cue-Punkte)

Dieser Parameter akzeptiert Variablenwerte , bei denen es sich um eine durch Kommas getrennte Liste von Cue-Punkten in Millisekunden handelt. Für jeden Wert gibt Ad Manager eine Werbeunterbrechung zurück.

Die Parameter vid_d und allcues werden verwendet, um Mid-Roll-Anzeigen ohne Inhaltsaufnahme zu liefern . Anzeigenregeln sind auch erforderlich, um Mid-Rolls zurückzugeben.

Wenn in Ihren Anzeigenregeln zeitbasierte Hinweise verwendet werden (z. B. "Alle N Sekunden" oder "Zu festen Zeiten"), werden die in der Anzeigenregel festgelegten Hinweise verwendet und die an alle Hinweise übergebenen allcues werden ignoriert. Mid-Rolls erfordern weiterhin eine Dauer, daher muss vid_d weiterhin übergeben werden.

Anwendungsbeispiel

Cue-Punkte bei 10 und 20 Sekunden:
allcues=10000,20000

ciu_szs

(Begleitgrößen)

Der Companion-Größenparameter akzeptiert Variablenwerte , bei denen es sich um eine durch Kommas getrennte Liste von Companion-Größen handelt.

Durch senkrechte Striche ( | ) getrennte Werte weisen auf eine Anzeigenfläche mit mehreren Größen hin.

Anwendungsbeispiel

ciu_szs=728x90,300x250

Größen mit Multi-Size-Slot:
ciu_szs=728x90,300x200|300x250

cmsid
vid

(Inhaltsquellen-ID, Video-ID)

Die Parameter Inhaltsquellen-ID und Video-ID akzeptieren variable Werte.

Um Anzeigen auf Video-Content auszurichten , muss Ihr Master-Video-Tag diese beiden Parameter enthalten.

Die cmsid ist eine eindeutige Nummer für jede Inhaltsquelle. Um dies in Ad Manager zu finden, klicken Sie auf Video and then Inhaltsquellen und dann den Namen der Quelle.

Das vid ist eine Zeichenkette oder Zahl, die ein bestimmtes Video identifiziert. Diese ID wird von dem CMS zugewiesen, das Ihre Inhalte hostet. Um dies in Ad Manager zu finden, klicken Sie auf Video and then Inhalt und dann den spezifischen Videoinhalt.

Anwendungsbeispiel

cmsid=[value]&vid=[value]

Wenn Sie ein Tag für die dynamische Anzeigeneinfügung mit Video-on-Demand erstellen, sollten Sie die Makros verwenden, die die richtige Inhaltsquelle und Video-ID dynamisch einfügen.

Zum Beispiel: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%

Erfordernis

Erforderlich für das Targeting von Videoinhalten

correlator

(Korrelator)

Der Correlator-Parameter akzeptiert einen Variablenwert , der von mehreren Anforderungen gemeinsam genutzt wird, die von derselben Seitenansicht stammen. Es wird verwendet, um Wettbewerbsausschlüsse zu implementieren, einschließlich solcher in Umgebungen ohne Cookies.

Wenn das IMA SDK verwendet wird, wird der Korrelatorwert automatisch festgelegt. Wenn Ihr Player versucht, diesen Wert festzulegen, überschreibt das SDK ihn mit seinem eigenen Wert.

Wenn das IMA SDK nicht verwendet wird, stellen Sie sicher, dass Sie diesen Wert auf einen wirklich zufälligen, positiven Zahlenwert setzen, der nicht von mehreren Seitenaufrufen wiederverwendet wird.

Anwendungsbeispiel

correlator=4345645667

Erfordernis

Erforderlich für Web und App

Empfohlen für die programmatische Monetarisierung

cust_params

(Benutzerdefinierte Schlüsselwertparameter)

Der benutzerdefinierte Parameterparameter akzeptiert variable Werte, bei denen es sich um Schlüsselwertpaare handelt, mit denen Sie ein bestimmtes Targeting festlegen können, z. B. demografische Merkmale, bestimmte Positionen auf einer Seite oder eine bestimmte Seite oder bestimmte Seiten.

Anwendungsbeispiel

Sehen Sie sich Beispiele zum Hinzufügen von Schlüssel/Wert-Paaren an .

description_url

(Beschreibungs-URL)

Der Beschreibungs-URL-Parameter akzeptiert einen Variablenwert , der das auf der Seite abgespielte Video beschreiben sollte. Normalerweise ist das die Seite mit dem Videoplayer, es kann aber auch eine Seite mit Text sein, der das Video beschreibt.

Der Wert description_url muss für Webseiten-Videoplayer und CTV/OTT-Geräte URL-codiert und für mobile In-App-Videoplayer nicht codiert sein.

Dieser Parameter wird nicht automatisch vom IMA SDK festgelegt. Es muss manuell eingestellt werden.

Anwendungsbeispiel

URL-kodiert:
description_url=https%3A%2F%2Fwww.sample.com%2Fgolf.html

Nicht codiert:
description_url=https://www.sample.com/golf.html

Erfordernis

Erforderlich für Web , App und Ad Exchange

env

(Umfeld)

Der Umgebungsparameter akzeptiert einen konstanten Wert, der eine In-Stream-Anforderung angibt oder dass die Anforderung speziell von einem Videoplayer stammt.

Mögliche Werte sind instream , was für Video- und Audioanzeigen verwendet werden kann, oder vp , das nur für Videoanzeigen verwendet werden kann.

Anwendungsbeispiel

Bild und/oder Ton:
env=instream

Nur Video:
env=vp

Erfordernis

Erforderlich für Web und App

excl_cat

(Ausschlusskategorie)

Der Parameter Ausschlusskategorie akzeptiert variable Werte und wird verwendet, um alle Werbebuchungen zu blockieren, die das betreffende Ausschlusslabel enthalten, damit sie für eine bestimmte Anzeigenanfrage nicht in Frage kommen. Dieser Parameter funktioniert mit cust_params .

Anwendungsbeispiel

&cust_params=excl_cat%3Dairline_excl_label%7C

gdfp_req

(Ad Manager-Schemaindikator)

Der Ad Manager-Schemaindikatorparameter akzeptiert einen konstanten Wert, der angibt, dass sich der Nutzer im Ad Manager-Schema befindet.

Anwendungsbeispiel

gdfp_req=1

Erfordernis

Erforderlich für Web und App

hl

(Sprache)

Der Sprachparameter akzeptiert einen konstanten Wert, der zum Anfordern von Anzeigen in dieser Sprache und für die Sprache der Anzeigenauswahl und das Rendern von Videoanzeigen bei der dynamischen Zuordnung zu Ad Exchange oder AdSense Video verwendet wird.

Der Parameterwert kann ein beliebiger Code nach ISO 639-1 (zwei Buchstaben) oder ISO 639-2 (drei Buchstaben) sein. Sehen Sie sich eine Liste dergültigen Codes an .

Wenn er weggelassen wird, wird der Wert standardmäßig auf jede Sprache mit Anzeigen-Targeting nach Sprache in Ad Exchange gesetzt .

Anwendungsbeispiel

hl=it

Erfordernis

Empfohlen für die programmatische Monetarisierung

ipe

(Impressions-Ping-Entität)

Der Impressions-Ping-Entitätsparameter akzeptiert einen konstanten Wert, der verwendet wird, um Impressions-Pings und Conversions anzugeben, die vom Server und nicht vom Client stammen.

Anwendungsbeispiel

Serverseitiges Beaconing (SSB):
ipe=ssb

iu

(Anzeigenblock)

Der Anzeigenblock-Parameter akzeptiert einen Variablenwert , der auf den aktuellen Anzeigenblock festgelegt werden sollte, im Format:

/network_id/.../ad_unit

Anwendungsbeispiel

iu=/6062/videodemo

Erfordernis

Erforderlich für Web und App

lip

(Letzte Position im Pod)

Der letzte Position im Pod-Parameter akzeptiert einen konstanten Wert, um eine Anfrage von der letzten Position in einem Pod anzugeben.

Dieser Parameter gilt nur für Standard-Pods.

Anwendungsbeispiel

lip=true

ltd

(Begrenzte Anzeigen)

Der Parameter „Limited Ads" akzeptiert einen konstanten Wert, der angibt, ob Anzeigen in eingeschränkter Weise geschaltet werden sollen , wenn keine Zustimmung zur Verwendung von Cookies oder anderen lokalen Kennungen vorliegt.

Anwendungsbeispiel

ltd=1

min_ad_duration
max_ad_duration

(Anzeigendauer)

Die Anzeigendauerparameter akzeptieren variable Werte, die zusammengenommen den Dauerbereich angeben, den eine Anzeige in Millisekunden erfüllen muss.

Dieser Parameter wird verwendet, um eine einzelne Anzeige anzufordern.

Anwendungsbeispiel

min_ad_duration=15000&max_ad_duration=30000

mridx

(Mid-Roll-Nummer)

Der Mid-Roll-Nummernparameter akzeptiert einen Variablenwert , der die Ordnungszahl der Mid-Roll angibt (z. B. Mid-Roll 1, Mid-Roll 2 usw.).

Anwendungsbeispiel

mridx=2

msid
an

(App-ID und Name)

Die App-ID- und Namensparameter akzeptieren variable Werte, die auf Anfragen angewendet werden sollten, die von mobilen Apps und verbundenen TV-Geräten gesendet werden, da die meisten programmatischen Videoanzeigen dies erfordern.

Das IMA SDK füllt beide Parameter automatisch aus, sie müssen jedoch in direkten VAST-Aufrufen (Nicht-SDK-Umgebungen) manuell angegeben werden.

Während der App-Name ein für Menschen lesbarer Name sein sollte, ist es unter iOS und tvOS für das SDK nicht möglich, auf die 9-stellige App Store-ID zuzugreifen. In diesen Fällen wird der msid-Parameter nicht gesendet und das SDK sendet das App-Bundle über den Parameter an (im Format com.package.publisher ).

Anwendungsbeispiel

msid=com.package.publisher an=sample%20app

Erfordernis

Erforderlich für App

Empfohlen für die programmatische Monetarisierung

nofb

(Fallback deaktiviert)

Der Fallback-deaktiviert-Parameter akzeptiert einen konstanten Wert, um anzugeben, dass die Anzeigenanfrage keine Playlist mit Video-Fallback- Anzeigen zurückgeben soll.

Anwendungsbeispiel

Fallback deaktiviert:
nofb=1

npa

(Nicht personalisierte Anzeige)

Der Parameter für nicht personalisierte Anzeigen akzeptiert einen konstanten Wert, um anzugeben, dass die Anzeigenanfrage als nicht personalisiert behandelt werden soll.

Sie müssen entweder ausdrücklich npa=1 oder einfach npa (ohne festgelegten Wert) einfügen, um die Anfrage als nicht personalisiert zu kennzeichnen. Bei Anzeigenanfragen, bei denen entweder dieser Parameter fehlt oder auf npa=0 gesetzt ist, werden standardmäßig personalisierte Anzeigen angezeigt .

Anwendungsbeispiel

Nicht personalisierte Anzeigen:
npa=1

output

(Anzeigenausgabeformat)

Der Parameter für das Anzeigenausgabeformat akzeptiert einen konstanten Wert, der auf das Ausgabeformat der Anzeige festgelegt werden sollte.

Verwenden Sie output=vast für die standardmäßige VAST-Version, die für Ihr Netzwerk festgelegt ist . Für bestimmte Anzeigen-Tags oder Teile Ihrer Website können Sie bestimmte VAST- oder VMAP-Versionen anfordern.

Wenn Ihr Videoplayer für VAST das IMA SDK verwendet, wird der Ausgabeparameter für eine Videoanzeigenanfrage immer auf output=xml_vast4 . Dies stellt kein Zuverlässigkeitsrisiko dar, da das SDK mit allen VAST-Versionen abwärtskompatibel ist, die von beliebigen Ad-Servern von Drittanbietern bereitgestellt werden können.

Verwenden Sie output=vmap , um die standardmäßige VMAP-Version zurückzugeben, die Sie für Ihr Netzwerk aktiviert haben (z. B. VMAP 1). Wenn Sie VAST innerhalb von VMAP zurückgeben , können Sie xml_vmap1_vast3 oder xml_vmap1_vast4 , um die zurückzugebende VAST-Version anzugeben.

Anwendungsbeispiel

VAST-Standardeinstellung Ihres Netzwerks:
output=vast

VAST 4:
output=xml_vast4

Standard-VMAP-Einstellung Ihres Netzwerks:
output=vmap

VMAP 1:
output=xml_vmap1

VMAP 1, Rückgabe von VAST 4:
output=xml_vmap1_vast4

Erfordernis

Erforderlich für Web und App

pmad

(Pod-Maximalanzeigen)

Der Pod-Ad-Maximum-Parameter akzeptiert einen Variablenwert , der die maximale Anzahl von Anzeigen in einem Pod angibt.

Dieser Parameter ist spezifisch für optimierte Pods, die Publishern mit einem erweiterten Videopaket zur Verfügung stehen. Es sollte nicht für VMAP verwendet werden (wenn ad_rule=1 ).

Anwendungsbeispiel

pmad=4

pmnd
pmxd

(Pod-Dauer)

Die Parameter für die Pod-Dauer akzeptieren variable Werte, die zusammengenommen den Dauerbereich in Millisekunden angeben, den ein Pod erfüllen muss.

Diese Parameter werden verwendet, um mehrere Anzeigen anzufordern. Sie sind spezifisch für optimierte Pods, die Publishern mit einem erweiterten Videopaket zur Verfügung stehen. Sie sollten nicht für VMAP verwendet werden (wenn ad_rule=1 ).

Anwendungsbeispiel

pmnd=0&pmxd=60000

pod

(Pod-Nummer)

Der Pod-Nummernparameter akzeptiert einen Variablenwert , der die Ordnungszahl des Pods in einem Video darstellt (z. B. Pod 1, Pod 2 usw.).

Anwendungsbeispiel

pod=3

Erfordernis

Erforderlich, damit Konkurrenzausschlüsse , Frequency Capping und zugehörige Funktionen ordnungsgemäß funktionieren.

pp

(Creative-Profil)

Der Creative-Profilparameter akzeptiert einen Variablenwert , der die Creatives steuert, die basierend auf der in einem Video- und Audio-Creative-Profil eingerichteten Konfiguration geschaltet werden können .

Anwendungsbeispiel

pp=creative_profile

Erfordernis

Empfohlen für die programmatische Monetarisierung

ppid

(Vom Herausgeber bereitgestellte Kennung)

Der vom Publisher bereitgestellte Identifikator ( PPID ) -Parameter akzeptiert einen variablen Wert des Identifikators, der beim Frequency Capping, der Zielgruppensegmentierung und -ausrichtung, der sequenziellen Anzeigenrotation und anderen zielgruppenbasierten Steuerungen der Anzeigenbereitstellung auf allen Geräten verwendet wird.

Anwendungsbeispiel

ppid=12JD92JD8078S8J29SDOAKC0EF230337

ppos

(Position im Pod)

Der Position im Pod-Parameter akzeptiert einen Variablenwert , der die Position innerhalb eines Pods darstellt (z. B. Position 1, Position 2 usw.).

Dieser Parameter gilt nur für Standard-Pods und ist für das automatische Ausfüllen von Companions erforderlich.

Anwendungsbeispiel

ppos=2

Erfordernis

Erforderlich, damit Konkurrenzausschlüsse , Frequency Capping und zugehörige Funktionen ordnungsgemäß funktionieren.

pubf
pvtf

(Mindestpreise in Ad Exchange-Tags)

pubf ist das Äquivalent zu google_ad_public_floor und pvtf ist das Äquivalent zu google_ad_private_floor . Diese werden verwendet, um Ad Exchange-Tags Mindestpreise hinzuzufügen .

Anwendungsbeispiel

pubf=123
pvtf=123

pvid
pvid_s

(App-Set-ID)

Die App-Set-ID-Werte werden für die Monetarisierung benötigt, wenn Benutzer die Personalisierung auf Android-Geräten ablehnen.

Der pvid -Parameter akzeptiert einen Variablenwert , der auf die Android-App-Set-ID festgelegt ist, und der pvid_s -Parameter akzeptiert einen konstanten Wert, der den Bereich der App-Set-ID darstellt (entweder scope_app oder scope_developer ).

Während das IMA/PAL-SDK dieses Feld automatisch übergibt, müssen Publisher mit Nicht-SDK-Implementierungen das App-Set-SDK aufrufen und diese Parameter bei einer Anzeigenanfrage manuell übergeben.

Informationen zum Abrufen der App-Set-ID finden Sie in der Android-Dokumentation .

Anwendungsbeispiel

pvid=[AppSetID_value]
pvid_s=scope_app

Erfordernis

Erforderlich für App

Empfohlen für die programmatische Monetarisierung

rdid
idtype
is_lat

(Rücksetzbare Gerätekennungen)

Die rücksetzbaren Gerätekennungen akzeptieren variable Werte.

Bei integrierten Anwendungen (nicht im Web oder im mobilen Web) übergibt das SDK zurücksetzbare Gerätekennungen für das Nutzer-Targeting an Ihre Stream-Anforderungen mit den Parametern für rdid , idtype und is_lat . Bei SSB-Streams müssen Sie diese als explizite Parameter übergeben, genau wie bei einer clientseitigen Anzeigenanfrage. Erfahren Sie mehr über Gerätekennungen .

Nahezu alle programmatischen Videoanzeigen erfordern das Vorhandensein dieser Werte.

Beginnend mit IOS14 hat Apple das LAT -Signal als veraltet markiert, sodass die Standardeinstellung zum Opt-out deaktiviert ist. Wo Publisher dies bestätigt haben, verlässt sich Google stattdessen auf das Vorhandensein eines IDFA ungleich Null, um anzuzeigen, dass das Tracking nicht deaktiviert wurde. Daher ist ein gültiger UserAgent erforderlich, der die richtige Betriebssystemversion angibt.

Anwendungsbeispiel

Siehe detaillierte Beispiele für rücksetzbare Gerätekennungen .

Erfordernis

Erforderlich für App

Empfohlen für die programmatische Monetarisierung

rdp

(Datenverarbeitung einschränken)

Der Parameter Datenverarbeitung einschränken akzeptiert einen konstanten Wert, um anzugeben, dass die Anzeigenanfrage die Datenverarbeitung einschränken soll.

Sie müssen entweder ausdrücklich rdp=1 setzen oder einfach rdp (ohne gesetzten Wert) einbinden, um die Datenverarbeitung einzuschränken. Anzeigenanfragen, bei denen dieser Parameter entweder fehlt oder auf rdp=0 gesetzt ist, werden nicht eingeschränkt, es sei denn, die Netzwerkeinstellung „ Datenverarbeitung beschränken" ist aktiviert.

Anwendungsbeispiel

rdp=1

scor

(Stream-Korrelator)

Der Stromkorrelatorparameter akzeptiert einen Variablenwert , der eine ganze Zahl sein sollte, die für jeden Videostrom generiert wird. Die Nummer sollte innerhalb eines Streams gleich und innerhalb eines Seitenaufrufs eindeutig sein. Es wird für Konkurrenzausschlüsse, Frequency Capping und verwandte Funktionen verwendet, wenn ein Nutzer mehrere Videos auf derselben Seite ansieht.

Anwendungsbeispiel

scor=17

Erfordernis

Erforderlich, damit Konkurrenzausschlüsse , Frequency Capping und zugehörige Funktionen ordnungsgemäß funktionieren.

sdk_apis

(SDK-API-Framework)

Der SDK-API-Framework-Parameter akzeptiert eine durch Kommas getrennte Liste konstanter ganzzahliger Werte, die alle API-Frameworks angeben, die der Player unterstützt.

Sehen Sie sich eine Liste möglicher API-Framework-Werte an .

Dieser Parameter unterstützt APIs in der Programmatic Access Library (PAL) für Publisher, die das IMA SDK nicht verwenden. Das IMA SDK überschreibt alle Werte, die mit den vom IMA SDK unterstützten Werten festgelegt wurden.

Anwendungsbeispiel

sdk_apis=2,7,9

sid

(Session-ID)

Der Sitzungs-ID-Parameter akzeptiert einen Variablenwert , bei dem es sich um eine den Datenschutz wahrende Werbekennung handelt, die nur für Frequency Capping-Zwecke verwendet wird.

Gemäß den IFA-Richtlinien des IAB muss dieser Parameter im UUID-Format ausgefüllt werden. Erfahren Sie mehr über zurücksetzbare Gerätekennungen für das Nutzer-Targeting .

Sie können die Weitergabe der Sitzungs-ID ablehnen, indem Sie sid=0 setzen.

Anwendungsbeispiel

123e4567-e89b-12d3-a456-426614174000

Erfordernis

Empfohlen für die programmatische Monetarisierung

ssss

(Serverseitige Stitching-Quelle)

Der serverseitige Stitching-Quellenparameter akzeptiert einen konstanten Wert, der auf einen anerkannten, von Google bereitgestellten Wert für Ihren Video-Stitching-Technologieanbieter festgelegt werden sollte.

Anbieter von Video-Stitching-Technologien, die Server-zu-Server-Integrationen mit Google verwenden, erhalten diesen Wert von Google und können ihn Ihnen zur Verfügung stellen. Bei Fragen zu dem für diesen Parameter festzulegenden Wert können Sie sich an Ihren Google Account Manager wenden.

Anwendungsbeispiel

ssss=mystitcher

Erfordernis

Erforderlich für serverseitige Implementierungen

sz

(Größe)

Der Größenparameter akzeptiert einen Variablenwert , der auf die Größe der Master-Videoanzeigenfläche festgelegt werden sollte.

Mehrere Größen sollten durch das Pipe-Zeichen ( | ) getrennt werden.

Fügen Sie nach der Größe kein " v " ein.

Anwendungsbeispiel

sz=400x300

Erfordernis

Erforderlich für Web und App

Dieser Parameter ist optional, wenn nur ad_type=audio .

tfcd

(Tag für kindgerecht)

Der auf Kinder ausgerichtete Parameter akzeptiert einen konstanten Wert, der die Anzeigenanfrage für eine auf Kinder ausgerichtete Behandlung kennzeichnet .

Anwendungsbeispiel

tfcd=1

trt

(Verkehrstyp)

Der Verkehrstypparameter akzeptiert einen konstanten Wert, der dazu dient, entweder gekauften oder organischen Verkehr anzufordern.

Das IMA SDK füllt keinen Standardwert aus, wenn der Verkehrstypparameter in einer Anfrage fehlt. In diesen Fällen liefert der Server einen Standardwert von 0 (undefinierter Datenverkehr).

Anwendungsbeispiel

Anfrage für gekauften Traffic:
trt=1

Anfrage für organischen Traffic:
trt=2

unviewed_position_start

(Verzögerte Impressionen)

Der Parameter für verzögerte Impressionen akzeptiert einen konstanten Wert, um verzögerte Impressionen für Videos anzugeben.

Anwendungsbeispiel

unviewed_position_start=1

Erfordernis

Erforderlich für Web und App

url

(URL)

Der URL-Parameter akzeptiert einen Variablenwert , der auf die vollständige URL gesetzt werden sollte, von der die Anforderung gesendet wird. Dieser Wert wird benötigt, damit Käufer den Kontext erkennen und verstehen können, aus dem diese Anfrage stammt. Soweit möglich, sollte dieser Wert bei der Anzeigenanfrage dynamisch ausgefüllt werden.

Auf einer Webseite ist dies die URL der Seite, die den Videoplayer anzeigt. Wenn Sie das IMA SDK verwenden, wird der URL-Wert automatisch festgelegt. Wenn Ihr Player diesen Wert festlegt, überschreibt ihn das IMA SDK und legt einen eigenen Wert fest.

In einer App (mobil oder CTV) sollte dieser Wert auf eine URL festgelegt werden, die das zu monetarisierende Video- oder Audioinventar am genauesten darstellt. Zum Beispiel, wenn der Benutzer ein Video in einer mobilen App ansieht, die auch auf einer Desktop-Äquivalent-URL verfügbar ist.*

Der Wert dieses Parameters sollte codiert werden.

Anwendungsbeispiel

url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html

* Wenn es für Apps nicht möglich ist, diesen Parameter auf einen variablen URL-Wert festzulegen, wird empfohlen, ihn mit dem folgenden Muster festzulegen:
url=<app/bundleid>.adsenseformobileapps.com

Erfordernis

Erforderlich für Web und App

Empfohlen für die programmatische Monetarisierung

vad_type

(Videoanzeigentyp)

Der Parameter für den Videoanzeigentyp akzeptiert einen konstanten Wert, der angibt, ob eine lineare oder eine nichtlineare Anzeige zurückgegeben werden soll.

Anwendungsbeispiel

Geben Sie eine lineare Anzeige zurück:
vad_type=linear

Geben Sie eine nicht lineare Anzeige zurück:
vad_type=nonlinear

vid_d

(Videodauer)

Dieser Parameter akzeptiert einen Variablenwert , der die Dauer des Inhalts in Sekunden angibt.

Die Parameter vid_d und allcues werden verwendet, um Mid-Roll-Anzeigen ohne Inhaltsaufnahme zu liefern . Anzeigenregeln sind auch erforderlich, um Mid-Rolls zurückzugeben.

Anwendungsbeispiel

Dauer des Videoinhalts von 90000 Sekunden (25 Stunden):
vid_d=90000

vconp

(Video-Dauerwiedergabe)

Empfohlen gemäß den MRC-Richtlinien für Videomessungen

Der kontinuierliche Videoparameter akzeptiert einen konstanten Wert, der angibt, ob der Player beabsichtigt, Videoinhalt ähnlich wie bei einer Fernsehsendung kontinuierlich abzuspielen.

Dieser Parameter sollte nicht gesetzt bleiben, wenn er unbekannt ist.

Anwendungsbeispiel

Dauerwiedergabe EIN:
vconp=2

Dauerwiedergabe AUS:
vconp=1

vpa

(Automatische Videowiedergabe)

Empfohlen gemäß den MRC - Richtlinien für Videomessungen

Der automatische Parameter für die Videowiedergabe akzeptiert einen konstanten Wert, der angibt, ob die Anzeige durch Autoplay oder durch Klicken gestartet wird.

Mögliche Werte sind click , wenn die Seite auf eine Benutzeraktion wartet, oder auto , wenn das Video automatisch abgespielt wird.

Dieser Parameter sollte nicht gesetzt bleiben, wenn er unbekannt ist.

Anwendungsbeispiel

Automatisches Abspielen:
vpa=auto

Anklicken um abzuspielen:
vpa=click

Erfordernis

Empfohlen für die programmatische Monetarisierung

vpi

(Video-Playlist in rot)

Der inred-Parameter der Videowiedergabeliste akzeptiert einen konstanten Wert, der angibt, ob Inline-VMAP bereitgestellt werden soll (Rückgabe von VAST innerhalb von VMAP).

Dieser Parameter kann verwendet werden, um die Latenz zu reduzieren und Frequency Caps und Konkurrenzausschlüsse über einen Videostream hinweg zu garantieren.

Anwendungsbeispiel

VAST zurückgeben:
vpi=1

Weiterleitungen zurückgeben:
vpi=0

vpmute

(Videowiedergabe stumm)

Empfohlen gemäß den MRC - Richtlinien für Videomessungen

Der Parameter für stummgeschaltetes Video akzeptiert einen konstanten Wert, der angibt, ob die Wiedergabe der Anzeige beginnt, während der Videoplayer stummgeschaltet ist.

Dieser Parameter sollte nicht gesetzt bleiben, wenn er unbekannt ist.

Anwendungsbeispiel

Stumm:
vpmute=1

Nicht stummgeschaltet:
vpmute=0

Erfordernis

Empfohlen für die programmatische Monetarisierung

vpos

(Videoposition)

Der Videopositionsparameter akzeptiert einen konstanten Wert, der angibt, ob die Anzeigenanfrage von Pre-Roll, Mid-Roll oder Post-Roll gesendet wird.

Anwendungsbeispiel

Vorlauf:
vpos=preroll

Mid-Roll:
vpos=midroll

Nachlauf:
vpos=postroll

Erfordernis

Empfohlen für die programmatische Monetarisierung

wta

(Warum diese Werbung)

Die Frage "Warum diese Anzeige?" Der Parameter akzeptiert einen konstanten Wert, der die Unterstützung des Videoplayers für die Wiedergabe von "Warum diese Anzeige?" angibt. .

Die Frage "Warum diese Anzeige?" Funktionalität wird automatisch unterstützt, wenn das IMA SDK verwendet wird. Wenn das IMA SDK nicht verwendet wird, müssen Videoplayer VAST Icon und IconClickFallbackImage Unterstützung implementieren, wie im IAB VAST-Standard dokumentiert.

Anfragen für Audioanzeigen sollten wta=0 für offene Auktionen und/oder wenn es keine Companion-Anzeigenfläche gibt, gesendet werden. Der wta Parameter kann weggelassen oder auf 1 gesetzt werden, wenn ein Companion-Slot bereitgestellt wird und alle Werbetreibendenkampagnen mit Zielgruppen-Targeting Companions mit WTA-Offenlegung bereitstellen.

Anwendungsbeispiel

Unterstützt:
wta=1

Nicht unterstützt:
wta=0

Erfordernis

Erforderlich für Ad Exchange

Empfohlen für die programmatische Monetarisierung

No comments:

Post a Comment