Die Tagging-Struktur für AdSense für Videos und AdSense für Spiele unterscheidet sich von AdSense für Content-Seiten. Für AdSense für Videos und AdSense für Spiele ist ein Interactive Media Ads(IMA)-Tag sowie ein Videoplayer oder Game Launcher erforderlich, der in das Google IMA SDK integriert und/oder mit VAST und VPAID kompatibel ist, wie zum Beispiel der IMA-Adapter.
Diese Tags können in der Regel mit dem Tag-Generator für AdSense für Videos erstellt werden. Im Folgenden finden Sie eine Liste der verschiedenen Kriterien zur Konfiguration dieser Anzeigen-Tags. Für die Schaltung von Anzeigen über ein AFV-Tag sind nur wenige Parameter erforderlich. Wenn Sie jedoch optionale Parameter wie Channel-IDs, minimale und maximale Anzeigendauer oder Sprache hinzufügen, erhalten Sie die gewünschten Anzeigenanfragen.
| IMA-Parameter für Anzeigen-Tags | Erforderlicher Parameter |
|---|---|
| ad_type | Ja |
| client | Ja |
| description_url | Ja – URL-Codierung erforderlich |
| Kanal | Nein – Empfohlen, wenn verfügbar |
| adsafe | Nein – Empfohlen |
| videoad_start_delay | Nein – Empfohlen |
| hl | Nein – Empfohlen |
| max_ad_duration | Nein – Empfohlen |
| min_ad_duration | Nein – Empfohlen |
| sdmax | Nein – Empfohlen |
| adtest | Nein |
| cust_age | Nein |
| cust_gender | Nein |
| host | Nein |
| h_ch | Nein |
| overlay | Nein |
Basis-URL
Die folgende URL bildet die Basis für alle im Folgenden beschriebenen Suchparameter:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(String) Gibt den Typ der gewünschten Anzeige an. Diese einzelnen Anzeigentypen sollten mit einem Unterstrich ("_") verkettet werden.
Werte
- video: Alle Videoanzeigen sind zulässig. Dieser Wert entspricht standardvideo_skippablevideo_bumpervideo.
- skippablevideo: Nur überspringbare Videoanzeigen sind zulässig. Publisher benötigen möglicherweise zusätzliche Berechtigungen, um überspringbare Videoanzeigen zu erhalten.
- bumpervideo: Sechs Sekunden lange nicht überspringbare Videoanzeigen sind zulässig.
- standardvideo: Nur nicht überspringbare Videoanzeigen sind zulässig.
- image: Bildanzeigen, die in die angegebene nicht-lineare Größe der Anzeigenfläche passen, sind zulässig.
- text: Textanzeigen sind zulässig.
Beispiele
- &ad_type=video_text_image
- Alle Formate sind zulässig.
- &ad_type=video_text
- Alle Videoformate und Textanzeigen sind zulässig.
- &ad_type=standardvideo_image
- Nur herkömmliche, nicht überspringbare Video- und Bildanzeigen sind zulässig.
client
(String) Die Web-Property-ID des Publishers
Beispiel: &client=ca-video-afvtest
description_url
(String) Eine vollständige, URL-codierte URL einer HTML-Seite, auf der das Video beschrieben wird. Der Wert description_url kann dynamisch durch Programmcode auf Serverseite erstellt oder manuell mit einem Onlinetool für die URL-Codierung ermittelt werden.
Beispiel: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
Beispiel-URL
Die folgende Beispiel-URL enthält die mindestens erforderlichen Parameter: https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2
Mit der dieser Beispiel-URL werden für den Publisher ca-video-afvtest Videoanzeigen mit der Beschreibungs-URL http://myurl.com/page?schluessel=wert&schluessel2=wert2 angefordert.
channel
(String) Eine durch Pluszeichen getrennte Liste von Channels, die für die AdSense-Ausrichtung und für AdSense-Berichte verwendet werden. Pro Anzeigenanfrage können bis zu fünf Channels übergeben werden.
Beispiel: &channel=meinchannel+andererchannel+targetingchannel
adsafe
(String) Legt die Einstellung fest, die zur Filterung der geschalteten Anzeigen verwendet wird. Die Standardeinstellung ist "high".
Werte:
- high – (Standardeinstellung) Gibt jugendfreie Anzeigen zurück. Nicht jugendfreie Anzeigen oder Anzeigen mit pornografischen Inhalten werden nicht geschaltet.
- medium – Gibt jugendfreie und nicht jugendfreie Anzeigen (z. B. Anzeigen für Glücksspiele oder verschreibungspflichtige Arzneimittel) zurück. Gibt keine Anzeigen mit pornografischen Inhalten zurück.
Beispiel: &adsafe=high
adtest
(String) Gibt an, ob es sich um eine Testimplementierung handelt. Mögliche Werte sind "on" oder "off". Bei der Einstellung "on" werden Impressionen und Klicks nicht in Ihrem AdSense für Videos-Konto erfasst. Dieser Parameter MUSS bei Tests verwendet werden. Die Standardeinstellung ist "off", wenn kein Wert festgelegt wird.
Werte:
- off – (Standardeinstellung) Alle Anzeigen werden normal berechnet. Diese Einstellung sollte für die Produktion verwendet werden.
- on – Mit dieser Einstellung wird sichergestellt, dass während des Tests keine Impressionen oder Klicks für Anzeigen erfasst werden.
Beispiel: &adtest=on
videoad_start_delay
(Ganzzahl) Gibt an, nach wie vielen Millisekunden Videodauer die Anzeige wiedergegeben wird. Die Standardeinstellung ist ein Mid-Roll-Wert, und zwar "1".
Werte:
- -1 – Gibt an, dass am Ende des Inhalts eine Post-Roll-Anzeige geschaltet wird.
- 0 – Gibt an, dass vor der Inhaltswiedergabe eine Pre-Roll-Anzeige geschaltet wird.
- Eine beliebige positive Ganzzahl – Gibt an, nach wie vielen Millisekunden der Inhaltswiedergabe eine Mid-Roll-Anzeige geschaltet wird.
Beispiel:
- &videoad_start_delay=-1 – Post-roll
- &videoad_start_delay=15000 – Die Anzeige wird nach einer Wiedergabedauer von 15 Sekunden ausgeliefert.
cust_age
(Ganzzahl) Gibt das Alter des Nutzers an. Unterstützt werden sowohl ein genaues Alter als auch eine in "com.google.ads.ima.api.Demographics" definierte Altersgruppe.
Beispiel:
- &cust_age=1001 – 18 bis 24 Jahre
- &cust_age=38 – Genau 38 Jahre alt
cust_gender
(Ganzzahl) Gibt das Geschlecht des Nutzers an, so wie in "com.google.ads.ima.api.Demographics" definiert.
Werte:
- 1 – Männlich
- 2 – Weiblich
Beispiel:
- &cust_gender=1 – Männlich
- &cust_gender=2 – Weiblich
host
(String) Host-ID, die für die Dreiwege-Umsatzbeteiligung verwendet wird.
Beispiel: &host=ca-host-test – Dieser Host wird am Umsatz beteiligt.
h_ch
(String) Eine durch Pluszeichen getrennte Liste von Zeichenfolgen, die Channel-IDs zur AdSense-Ausrichtung/-Berichterstellung für den Host darstellen.
Beispiel: &h_ch=channel1+channel2+channel3 – Für diese zusätzlichen Channels für den Host werden Berichte erstellt und die AdSense-Ausrichtung vorgenommen.
ht_id
(Zahl) Ebenen-ID, die zur Angabe der Umsatzbeteiligungsstufe zwischen Publisher und Host verwendet wird.
Beispiel: &ht_id=2 – Host der Ebene 2
hl
(String) Ein Sprachcode, der zur Anfrage von Anzeigen in dieser Sprache verwendet wird. Dabei kann es sich um einen beliebigen zweistelligen ISO 639-1- oder dreistelligen ISO 639-2-Code handeln. Liste gültiger Codes
Beispiel:
- &hl=en – Englisch
- &hl=es – Spanisch
max_ad_duration
(Ganzzahl) Gibt die maximale Länge des wiederzugebenden Videos in Millisekunden an. Wird kein Wert festgelegt, beträgt die Standardeinstellung 100 Sekunden.
Beispiel: &max_ad_duration=30000 – Die maximale Dauer einer beliebigen nicht überspringbaren Anzeige beträgt 30 Sekunden.
min_ad_duration
(Ganzzahl) Gibt die minimale Länge des wiederzugebenden Videos in Millisekunden an. Wird kein Wert festgelegt, beträgt die Standardeinstellung 0 Sekunden.
Beispiel:
- &min_ad_duration=15000 – Die zurückgegebene nicht überspringbare Anzeige muss mindestens 15 Sekunden lang sein.
- &min_ad_duration=0 – Die Dauer wird nur durch den Wert "max_ad_duration" beschränkt.
sdmax
(Ganzzahl) Gibt die maximale Videolänge für überspringbare Anzeigen in Millisekunden an. Wird kein Wert festgelegt, ist die Länge standardmäßig unbegrenzt.
Beispiel: &sdmax=120000 – Die zurückgegebene überspringbare Anzeige darf maximal 2 Minuten lang sein.
overlay
(Ganzzahl) Wenn Sie diesen Parameter verwenden, können ausschließlich nicht lineare Overlays im unteren Drittel als Overlay-Größen angefordert werden. Standardmäßig ist keine solche Begrenzung festgelegt.
Beispiel:
- &overlay=1 – Nur Overlay-Größen im unteren Drittel sind bei der Anzeigenanfrage zulässig. Full-Slot-Overlays werden nicht angefordert.
- &overlay=0 – Overlay-Größen werden nicht beschränkt (Standardwert). Die Overlay-Größen werden auf Grundlage von "AdsRequest.nonLinearAdSlotWidth" und "adsRequest.nonLinearAdSlotHeight" bereitgestellt.
