Stellen Sie Targeting-Parameter für Ihren Stream bereit
Die Angabe eines der folgenden Targeting-Parameter ist optional.
Wenn Sie eine Inhaltsquelle für Video-on-Demand (VOD) erstellen oder konfigurieren oder einen Live-Stream für die dynamische Anzeigenbereitstellung einrichten, müssen Sie ein Standard- Videoanzeigen-Tag angeben . Alle Streams für die dynamische Anzeigenbereitstellung verwenden standardmäßig dieses Anzeigen-Tag und seine Parameter. Wenn Sie möchten, dass Ihr Player etwas Einzigartiges für einen bestimmten Stream anfordert, stehen Ihnen diese Optionen zur Verfügung.
Ad Manager-Anzeigen-Tag-Parameter, die überschrieben werden können
Zu einem bestimmten Parameter springen:
addtl_consentanciu_szscust_paramsdescription_urlgdprgdpr_consentidtypeis_lat | iultdmptmpvnpappidptplptplnrdid | rdpsidsztfcdtrtvconpvpavpmutewta |
Überschreiben Sie das Standardanzeigen-Tag
Wenn Ihr Videoplayer einen Stream anfordert, wird das Standardanzeigen-Tag genau so verwendet, wie Sie es in der Benutzeroberfläche angegeben haben. Sie haben jedoch die Möglichkeit, bestimmte Parameter dieses Tags in Ihrer Stream-Anfrage zu überschreiben. Dies sind die einzigen Parameter, die überschrieben werden können.
Erfahren Sie, wie Sie das Standard-Anzeigen-Tag mit dem IMA SDK oder mit SSB überschreiben.
| Parameter | Beschreibung | Beispielwert | |
|---|---|---|---|
iu | Aktueller Anzeigenblock. Dies sollte dem Format folgen: | iu =/6062/video/example_unit | |
cust_params | Schlüssel/Wert-Paare, die für das Ad Manager-Kampagnen-Targeting verwendet werden sollten. Einige Plattformen erfordern URL-Codierung . | Beispiele mit mehreren Schlüssel/Wert-Paaren, wie z. B.:
SSB-Streams : Codieren und verketten Sie den gesamten HTML5 und Chromecast : Roku : Codieren und verketten Sie den gesamten iOS und tvOS : Nichts codieren. Android : Nichts kodieren. | |
sz | Überschreibt den Schließen Sie das " | sz=400x300 | |
tfcd | Markieren Sie eine Anfrage für eine kindgerechte Behandlung . Wenn eine DAI-Anforderung | | |
Der Wert sollte das Video beschreiben, das auf der Seite abgespielt wird. Normalerweise ist dies die Seite mit dem Videoplayer, es kann sich aber auch um eine Seite mit Text handeln, der das Video beschreibt. Dieser Parameter wird nicht automatisch vom IMA SDK festgelegt. Es muss manuell eingestellt werden. | URL-codiertes Beispiel: Nicht codiertes Beispiel: | ||
ppid | Der Publisher Provided Identifier (PPID) ermöglicht es Publishern, einen Identifikator zur Verwendung bei der Häufigkeitsbegrenzung, der Zielgruppensegmentierung und -ausrichtung, der sequentiellen Anzeigenrotation und anderen zielgruppenbasierten Anzeigenlieferungskontrollen auf allen Geräten zu senden. Erfahren Sie mehr | ppid= | |
ciu_szs | Durch Kommas getrennte Liste der Companion-Anzeigengrößen. Companion-Anzeigen werden von der dynamischen Anzeigenbereitstellung nur unterstützt, wenn Sie das HTML5 SDK verwenden. | ciu_szs=728x90,300x250 | |
mpt | Zeigt den Namen des Partnerspielers an. Dies würde hauptsächlich von Partnern wie JWPlayer, Brightcove, Ooyala verwendet, die sich in das SDK integrieren. | mpt=JWPlayer | |
mpv | Zeigt die Version des Partnerplayers an. Dies sollte nur festgelegt werden, wenn | mpv=2.1 | |
ptpl | Die ID der Werbeunterbrechungsvorlage. Sie finden diese ID in der Ad Manager-URL, wenn Sie die Einstellungen für die Unterbrechungsvorlage auf der Ad Manager-Benutzeroberfläche anzeigen. Er erscheint als Wert für den Parameter | ptpl=1234 | |
ptpln | Der Name der Werbeunterbrechungsvorlage. Dies entspricht dem Feld "Name" in Ad Manager, nicht dem Anzeigenamen. | ptpln=my_break_template | |
an | Der Es sollte auf Anfragen angewendet werden, die von mobilen Apps und verbundenen TV-Geräten gesendet werden, da die meisten programmatischen Videoanzeigen dies erfordern.* Das IMA SDK füllt dies automatisch aus, es muss jedoch manuell mit der DAI-API und SSB (Nicht-SDK-Umgebungen) 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 sendet das SDK das App-Bundle über | | |
ltd | Gibt an, ob Anzeigen ohne Zustimmung zur Verwendung von Cookies oder anderen lokalen Kennungen eingeschränkt geschaltet werden sollen. Erfahren Sie mehr | ltd=1 | |
rdid | Bei nativen Anwendungen (nicht im Web oder im mobilen Web) übergibt das SDK rücksetzbare Gerätekennungen für das Benutzer-Targeting mit den Parametern für rdid , idtype und is_lat an Ihre Stream-Anforderungen. Bei SSB-Streams müssen Sie diese als explizite Parameter übergeben, genau wie bei einer clientseitigen Video Solutions-Anzeigenanfrage.
| Siehe detaillierte Beispiele für rücksetzbare Gerätekennungen . | |
trt | Kennzeichnet Verkehr als gekauft oder anderweitig. | Undefinierter Verkehrstyp: Gekaufter Traffic: Organischer Verkehr: | |
vconp | Empfohlen gemäß den MRC- Richtlinien für Videomessungen Gibt an, ob der Player beabsichtigt, die Inhaltsvideos kontinuierlich nacheinander abzuspielen, ähnlich wie bei einer Fernsehsendung. Mögliche Werte sind Dieser Parameter sollte nicht gesetzt bleiben, wenn er unbekannt ist. | Dauerwiedergabe EIN:vconp=2 Dauerwiedergabe AUS: | |
vpa | Empfohlen gemäß den MRC- Richtlinien für Videomessungen Gibt an, ob die Anzeige durch Autoplay oder Klick gestartet wird. Mögliche Werte sind Dieser Parameter sollte nicht gesetzt bleiben, wenn er unbekannt ist. | Automatisches Abspielen:vpa=auto Klicken: | |
vpmute | Empfohlen gemäß den MRC- Richtlinien für Videomessungen Gibt an, ob die Wiedergabe der Werbung startet, während der Videoplayer stummgeschaltet ist. Mögliche Werte sind Dieser Parameter sollte nicht gesetzt bleiben, wenn er unbekannt ist. | Stumm:vpmute=1 Nicht stummgeschaltet: | |
npa | Die Personalisierungseinstellung für Anzeigenanfragen. Sie sollten den Parameter früh im Tag angeben, um das Risiko einer Kürzung zu vermeiden. Geben Sie | npa=1 | |
gdprgdpr_consent | Diese Felder werden verwendet, um TCF v2.0-Zustimmungsinformationen für eingehende und ausgehende Cookie-Synchronisierungsanforderungen zu übergeben. | Siehe die DSGVO- Spezifikationen. | |
addtl_consent | Eine Liste der genehmigten Google Ad Tech-Anbieter, die nicht beim IAB registriert sind. | Siehe die zusätzlichen Einwilligungsspezifikationen . | |
rdp | Sie müssen entweder ausdrücklich | | |
sid | Eine Art datenschutzschützender Werbekennung, die nur für Frequency Capping-Zwecke verwendet werden kann. Gemäß den IFA-Richtlinien des IAB muss dieser Parameter im UUID-Format ausgefüllt werden. Erfahren Sie mehr Sie können die Weitergabe der Sitzungs-ID ablehnen, indem Sie | | |
wta | Zeigt die Unterstützung des Videoplayers für das Rendern von "Warum diese Anzeige?" an. . Dies wird automatisch unterstützt, wenn Sie das IMA SDK verwenden. Wenn das IMA SDK nicht verwendet wird, müssen Videoplayer VAST WTA wird für SSB nicht unterstützt. Dieses Feld ist erforderlich, wenn Sie Ad Exchange verwenden. Erfahren Sie mehr * Unterstützung für | Unterstützt: Nicht unterstützt: |
Überschreiben Sie das standardmäßige Anzeigen-Tag mit dem IMA SDK
Wenn ein Videoplayer mit dem IMA SDK einen Stream für die dynamische Anzeigenbereitstellung anfordert, kann er ein Feld namens " adTagParameters " übergeben. Diese wörterbuchähnliche Struktur kann mit Schlüssel/Wert-Paaren festgelegt werden, wobei die Schlüssel die in der Tabelle oben aufgeführten Ad Manager-Anzeigen-Tag-Parameter sein können.
Sie können Ihren Stream anpassen und Parameter übergeben, die sich nicht auf die Ad Manager-Anzeigenanfrage beziehen, indem Sie dieselbe Struktur verwenden. Erfahren Sie, wie Sie bestimmte Stream-Varianten anfordern und einen Werbefeiertag einrichten .
Die Implementierung des adTagParameters Felds unterscheidet sich je nach Programmiersprache oder Plattform geringfügig. Weitere Informationen finden Sie in der Entwicklungsdokumentation für iOS , Android , tvOS , Chromecast und HTML5 oder in der zusätzlichen Dokumentation im DAI-Player- und App-Entwicklungsleitfaden .
Legen Sie adTagParameters über das SDK fest
Wenn Sie cust_params oder description_url über das SDK in iOS- , tvOS- und Android -Apps festlegen, sollten Sie die Zeichenfolgen nicht url-codieren. Sie können cust_params als einzelne Zeichenfolge übergeben, die die Schlüssel-Wert-Paare mit einem „ & " verkettet.
Wenn Sie beispielsweise cust_params auf den Wert von sport=football&city=newyork setzen möchten:
Die adTagParams -Struktur mit nicht codierten Werten wäre:
{
"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-Anforderungen wäre:
{
"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- Stream-Anfragen wäre:
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"Überschreiben Sie das Standard-Anzeigen-Tag mit der DAI-API (Beta)
Wenn ein Videoplayer über die DAI-API einen Stream für die dynamische Anzeigenbereitstellung anfordert, kann er optional Schlüssel/Wert-Paare übergeben, wobei es sich bei den Schlüsseln um die in der Tabelle oben aufgeführten Ad Manager-Anzeigen-Tag-Parameter handeln kann.
Diese Parameter sollten als Teil des HTTP-POST-Anforderungstexts des Formulartyps application/x‑www‑form‑urlencoded sowohl für linear/live als auch für VOD gesendet werden.
Sie können Ihren Stream anpassen und Parameter übergeben, die sich nicht auf die Ad Manager-Anzeigenanfrage beziehen, indem Sie dieselbe Struktur verwenden. Erfahren Sie, wie Sie bestimmte Parameter für Stream-Varianten und die HMAC-Authentifizierung anfordern.
Sehen Sie sich eine Beispielimplementierung der API für die dynamische Anzeigenbereitstellung an .
Überschreiben Sie das Standardanzeigen-Tag mit SSB
Im Folgenden finden Sie Beispiele für die Änderung eines SSB-Standard-VOD-Anzeigen-Tags. Vom Player oder der App übergebene überschriebene Parameter werden hervorgehoben.
Beispiele für Video-on-Demand |
| Beispiel | |
|---|---|
| Basis-VOD-Stream-URL | http://dai.google.com/ondemand/hls/content/ |
| (mit angegebenem Anzeigenblock) | http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ |
| (mit überschrieben Schlüsselwerte) | http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ |
| (mit einer Erklärung von an Kinder gerichtete Inhalte) | http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ |
| (mit einem überschriebenen Anzeigenblock UND Schlüsselwerten UND eine benutzerdefinierte description_urlUND eine Erklärung zu kindgerechten Inhalten) | http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ http://dai.google.com/ondemand/hls/content/ |
Beispiele für lineare Live-Streams |
| Beispiel | |
|---|---|
| Basis-URL des linearen Live-Streams | https://dai.google.com/linear/hls/event/<asset_key> |
| (mit angegebenem Anzeigenblock) | https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> |
| (mit überschriebenen Schlüsselwerten) | https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> |
| (mit einer Erklärung von an Kinder gerichtete Inhalte) | https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> |
| (mit einem überschriebenen Anzeigenblock UND Schlüsselwerten UND eine benutzerdefinierte description_urlUND eine Erklärung zu kindgerechten Inhalten) | https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> https://dai.google.com/linear/hls/event/<asset_key> |
Aktualisieren Sie Targeting-Parameter dynamisch während eines bestimmten Live-Streams
Mit der Methode replaceAdTagParameters im IMA DAI SDK können Sie die Targeting-Daten für einen bestimmten Nutzer während der Wiedergabe des Streams dynamisch aktualisieren.
No comments:
Post a Comment