Die Bereitstellung der folgenden Targeting-Parameter ist optional.
Wenn Sie eine Contentquelle für Video-on-Demand (VOD) erstellen bzw. konfigurieren oder einen Livestream für die dynamische Anzeigenbereitstellung einrichten, müssen Sie ein Videoanzeigen-Tag festlegen, das als Standard verwendet wird. Zusammen mit den zugehörigen Parametern wird es standardmäßig in allen Streams zur dynamischen Anzeigenbereitstellung verwendet. Anzeigen-Tag-Parameter gelten sowohl für Mid-Rolls als auch für Pre-Rolls. Wenn Ihr Player für einen bestimmten Stream etwas Eindeutiges anfordern soll, stehen Ihnen folgende Optionen zur Verfügung.
Parameter für Ad Manager-Anzeigen-Tags, die überschrieben werden können
Zu einem bestimmten Parameter wechseln:
addtl_consent an ciu_szs cust_params description_url gdpr gdpr_consent idtype is_lat |
iu ltd mpt mpv npa ppid ptpl ptpln rdid |
rdp sid sz tfcd trt vconp vpa vpmute wta |
Standard-Anzeigen-Tag überschreiben
Wenn Ihr Videoplayer einen Stream anfordert, wird das Standard-Anzeigen-Tag genauso verwendet, wie Sie es auf der Benutzeroberfläche angegeben haben. Sie können mit der Streamanfrage jedoch bestimmte Parameter dieses Tags überschreiben. Das sind die einzigen Parameter, die überschrieben werden können.
Sehen Sie sich an, wie Sie das Standard-Anzeigen-Tag mit dem IMA SDK oder mit dem SSB überschreiben können.
Parameter | Beschreibung | Beispielwert | |
---|---|---|---|
iu |
Aktueller Anzeigenblock. Dies sollte folgendes Format haben: |
iu=/6062/video/example_unit |
|
cust_params |
Schlüssel/Wert-Paare, die für das Targeting einer Ad Manager-Kampagne verwendet werden sollen. Manche Plattformen erfordern eine URL-Codierung. Die URL-Codierung ist nicht erforderlich, wenn das IMA DAI SDK für HTML5 verwendet wird, da der Wert automatisch codiert wird. Dieser Parameter funktioniert nicht, wenn er bereits in HTML5 codiert ist. |
Beispiele mit mehreren Schlüssel/Wert-Paaren, z. B.:
SSB-Streams (serverseitiges Beaconing): Codieren und verketten Sie den gesamten Wert für
Chromecast:
Roku: Codieren und verketten Sie den gesamten Wert für
iOS und tvOS: Codieren Sie nichts.
Android: Codieren Sie nichts.
|
|
sz |
Überschreibt den Parameter Geben Sie hinter der Größe nicht |
sz=400x300 |
|
tfcd |
Hiermit wird eine Anfrage mit einem Tag zur Klassifizierung als Inhalte für Kinder versehen. Wenn eine Anfrage für die dynamische Anzeigenbereitstellung |
|
|
Der Wert sollte das Video beschreiben, das auf der Seite wiedergegeben wird. Meist wird die URL der Seite verwendet, auf der sich der Videoplayer befindet. Sie können jedoch auch eine Seite angeben, auf der das Video beschrieben wird. Der Parameter wird nicht automatisch über das IMA SDK festgelegt. Er muss manuell angegeben werden. |
Beispiel mit URL-Codierung: Beispiel ohne URL-Codierung: |
||
ppid |
Eine PPID (Publisher Provided Identifier, vom Publisher bereitgestellte Kennung) ermöglicht es Publishern, eine ID zur Verwendung beim Frequency Capping, bei der Zielgruppensegmentierung und beim Targeting auf Zielgruppen, bei der sequenziellen Anzeigenrotation und bei anderen Funktionen zur zielgruppenbasierten Anzeigenauslieferung auf beliebigen Geräten zu senden. Weitere Informationen | ppid= |
|
ciu_szs |
Liste mit durch Kommas getrennten Companion-Anzeigengrößen Companion-Anzeigen werden in der dynamischen Anzeigenbereitstellung nur unterstützt, wenn Sie das HTML5 SDK verwenden. |
ciu_szs=728x90,300x250 |
|
mpt |
Mit diesem Parameter wird der Name des Players von einem Partner angegeben. Er wird hauptsächlich von Partnern wie JWPlayer, Brightcove und Ooyala verwendet, die in das SDK eingebunden sind. |
mpt=JWPlayer |
|
mpv |
Hiermit wird die Version des Players von einem Partner angegeben. Dieser Parameter sollte nur festgelegt werden, wenn auch |
mpv=2.1 |
|
ptpl |
Das ist die Vorlagen-ID für eine Werbeunterbrechung. Diese ID finden Sie in der URL, wenn Sie in Ad Manager die Einstellungen der Vorlage für eine Werbeunterbrechung aufrufen. Sie wird als Wert für den Parameter |
ptpl=1234 |
|
ptpln |
Das ist der Name der Vorlage für eine Werbeunterbrechung. Er entspricht dem Feld „Name“ in Ad Manager, nicht dem Anzeigenamen.
|
ptpln=my_break_template |
|
an |
Der Parameter Er sollte auf Anfragen angewendet werden, die von mobilen Apps und internetfähigen Geräten gesendet werden, weil er von den meisten programmatischen Videoanzeigen benötigt wird.* Über das IMA SDK wird der Parameter automatisch ausgefüllt, er muss aber mit der DAI API und SSB (in Umgebungen ohne SDK) manuell angegeben werden. * Der Name der App sollte verständlich sein. Im Fall von iOS und tvOS kann das SDK allerdings nicht auf die 9-stellige ID aus dem App Store zugreifen. In diesen Fällen sendet das SDK das App Bundle über den Parameter |
|
|
ltd |
Damit wird angegeben, ob Anzeigen eingeschränkt ausgeliefert werden, wenn der Publisher keine Einwilligung für die Verwendung von Cookies oder anderen lokalen Kennungen erhalten hat. Weitere Informationen | ltd=1 |
|
rdid |
Bei nativen Anwendungen (nicht im Web oder im mobilen Web) werden über das 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. In SSB-Streams müssen Sie sie als explizite Parameter senden, so wie es bei einer clientseitigen Anzeigenanfrage aus Lösungen für Videoanzeigen der Fall ist.
|
Detaillierte Beispiele für rücksetzbare Geräte-IDs | |
trt |
Damit wird angegeben, ob Traffic z. B. gekauft ist. |
Nicht definierter Traffic-Typ: Gekaufter Traffic: Organischer Traffic: |
|
vconp |
Empfohlen vom MRC (gemäß Richtlinien zur Videomessung)
Der Parameter gibt an, ob über den Player kontinuierlich ein Video nach dem anderen abgespielt werden soll, ähnlich wie bei einer TV-Übertragung. Mögliche Werte sind Dieser Parameter sollte nicht festgelegt werden, wenn er nicht bekannt ist. |
Kontinuierliche Wiedergabe aktiviert:vconp=2 Kontinuierliche Wiedergabe deaktiviert: |
|
vpa |
Empfohlen vom MRC (gemäß Richtlinien zur Videomessung)
Hiermit wird angegeben, ob die Anzeige automatisch wiedergegeben oder per Klick gestartet wird. Mögliche Werte sind Dieser Parameter sollte nicht festgelegt werden, wenn er nicht bekannt ist. |
Automatisch:vpa=auto Per Klick: |
|
vpmute |
Empfohlen vom MRC (gemäß Richtlinien zur Videomessung)
Hiermit wird angegeben, ob die Anzeige abgespielt wird, während der Videoplayer stummgeschaltet ist. Mögliche Werte sind Dieser Parameter sollte nicht festgelegt werden, wenn er nicht bekannt ist. |
Stummgeschaltet:vpmute=1 Stummschaltung aufgehoben: |
|
npa |
Hiermit werden die personalisierten Einstellungen für Anzeigenanfragen festgelegt. Sie sollten den Parameter vorn im Tag einfügen, damit er nicht abgeschnitten wird.
Geben Sie |
npa=1 |
|
gdpr gdpr_consent |
Diese Felder werden verwendet, um die Einwilligungsinformationen von Version 2.0 des TCF für eingehende und ausgehende Anfragen zur Cookie-Synchronisierung zu übergeben. |
Siehe DSGVO-Spezifikationen. |
|
addtl_consent |
Eine Liste der Anzeigentechnologie-Anbieter von Google, für die eine Einwilligung erteilt wurde und die nicht beim IAB registriert sind. |
||
rdp |
Sie müssen entweder speziell |
|
|
sid |
Das ist eine Art von ID für Werbung, bei der der Datenschutz eingehalten wird und die nur für das Frequency Capping verwendet werden kann. Gemäß den Richtlinien zur Analyse des eingehenden Feeds (IFA) des IAB muss dieser Parameter im UUID-Format angegeben werden. Weitere Informationen Wenn Sie nicht möchten, dass die Sitzungs-ID weitergegeben wird, legen Sie |
|
|
wta |
Mit dem Parameter wird angegeben, ob der Videoplayer das Rendering von Warum sehe ich diese Werbung? unterstützt. Das ist bei Verwendung des IMA SDKs automatisch der Fall. Wenn das IMA SDK nicht eingesetzt wird, muss in Videoplayern eine Unterstützung für das WTA wird für SSB nicht unterstützt. Dieses Feld ist erforderlich, wenn Sie Ad Exchange verwenden. Weitere Informationen * Unterstützung für |
Unterstützt: Nicht unterstützt: |
Standard-Anzeigen-Tag mit dem IMA SDK überschreiben
Wenn ein Videoplayer über das IMA SDK einen Stream für die dynamische Anzeigenbereitstellung anfordert, wird dabei möglicherweise das Feld adTagParameters
übergeben. Diese wörterbuchähnliche Struktur lässt sich mit Schlüssel/Wert-Paaren festlegen. Die Schlüssel können dabei Parameter für Anzeigen-Tags aus Ad Manager sein, die in der obigen Tabelle aufgeführt sind.
Sie haben die Möglichkeit, Ihren Stream anzupassen und mit dieser Struktur Parameter zu übergeben, die keinen Bezug zur Anzeigenanfrage in Ad Manager haben. Weitere Informationen erhalten Sie im Hilfeartikel Parameter der Streamvarianten überschreiben und in diesem Hilfeartikel unter „Zeitraum ohne Anzeigen einrichten“.
Die Implementierung des Felds adTagParameters
kann abhängig von der Sprache und der Plattform geringfügig variieren. Weitere Informationen erhalten Sie in der Entwicklerdokumentation für iOS, Android, tvOS, Chromecast und HTML5 oder im Leitfaden zur Player- und App-Entwicklung für die dynamische Anzeigenbereitstellung.
Das Feld „adTagParameters“ über das SDK festlegen
Wenn Sie cust_params
oder description_url
über das SDK festlegen, sollten Sie bei Apps für iOS, tvOS und Android keine URL-Codierung für die Strings durchführen. Sie können cust_params
als einzelnen String weitergeben, bei dem die Schlüssel/Wert-Paare mit einem &
-Zeichen verkettet sind.
Ein Beispiel: Sie möchten cust_params
auf den Wert sport=football&city=newyork
festlegen.
Die adTagParams
-Struktur mit nicht codierten Werten sieht in diesem Fall so aus:
{
"tfcd": 1,
"iu": "/987654321/path/to/adunit",
"cust_params": "sport=football&city=newyork",
"description_url": "http://www.sample.com/golf.html",
"ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
Die adTagParameters
-Struktur mit codierten Werten für HTML5-Stream-Anfragen sieht so aus:
{
"tfcd": 1,
"iu": "/987654321/path/to/adunit",
"cust_params": "sport%3Dfootball%26city%3Dnewyork",
"description_url": "http%3A%2F%2Fwww.sample.com%2Fgolf.html",
"ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
Die adTagParams
-Struktur mit codierten Werten für Roku-Streamanfragen sieht so aus:
request.adTagParams="tfcd=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=http%3A%2F%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"
Standard-Anzeigen-Tag mit der DAI API (Beta) überschreiben
Wenn in einem Videoplayer über die DAI API ein Stream für die dynamische Anzeigenbereitstellung angefordert wird, können Schlüssel/Wert-Paare übertragen werden. Die Schlüssel können dabei Parameter für Anzeigen-Tags aus Ad Manager sein, die in der obigen Tabelle aufgeführt sind.
Diese Parameter müssen im Text der HTTP-POST-Anforderung enthalten sein und sowohl bei linearen und Livestreams als auch bei VOD-Streams das Format application/x‑www‑form‑urlencoded
haben.
Sie haben die Möglichkeit, Ihren Stream anzupassen und mit dieser Struktur Parameter zu übergeben, die keinen Bezug zur Anzeigenanfrage in Ad Manager haben. Weitere Informationen zum Überschreiben der Parameter in Streamvarianten und Implementieren der HMAC-Authentifizierung
Implementierungsbeispiel der DAI API
Standard-Anzeigen-Tag mit SSB überschreiben
Im Folgenden finden Sie Beispiele für Änderungen an einem VOD-Standard-Anzeigen-Tag für SSB. Die überschriebenen Parameter, die vom Player oder der App übergeben werden, sind hervorgehoben.
Video-on-Demand-Beispiele |
Beispiel | |
---|---|
VOD-Stream-Basis-URL | http://dai.google.com/ondemand/hls/content/ |
(mit Angabe des Anzeigenblocks) | http://dai.google.com/ondemand/hls/content/ |
(mit überschriebenen Schlüssel/Wert-Paaren) |
http://dai.google.com/ondemand/hls/content/ |
(mit einer Deklarierung von Inhalten für Kinder) |
http://dai.google.com/ondemand/hls/content/ |
(mit einem überschriebenen Anzeigenblock UND Schlüssel/Wert-Paaren UND einem benutzerdefinierten Parameter description_url UND einer Deklarierung von Inhalten für Kinder) |
http://dai.google.com/ondemand/hls/content/ |
Beispiele für lineare Livestreams |
Beispiel | |
---|---|
Basis-URL für linearen Livestream | https://dai.google.com/linear/hls/event/<asset_key> |
(mit Angabe des Anzeigenblocks) | https://dai.google.com/linear/hls/event/<asset_key> |
(mit überschriebenen Schlüssel/Wert-Paaren) | https://dai.google.com/linear/hls/event/<asset_key> |
(mit einer Deklarierung von Inhalten für Kinder) |
https://dai.google.com/linear/hls/event/<asset_key> |
(mit einem überschriebenen Anzeigenblock UND Schlüssel/Wert-Paaren UND einem benutzerdefinierten Parameter description_url UND einer Deklarierung von Inhalten für Kinder) |
https://dai.google.com/linear/hls/event/<asset_key> |
Targeting-Parameter während eines spezifischen Livestreams dynamisch aktualisieren
Mit der Methode replaceAdTagParameters des IMA DAI SDKs lassen sich die Targeting-Daten eines bestimmten Nutzers, der sich den Stream gerade ansieht, dynamisch aktualisieren.