Alle von Google gehosteten Apps, in denen personalisierte Anzeigen ausgeliefert werden, müssen das AdChoices-Symbol und Overlay, sofern von Google bereitgestellt. Datenschutzinfo (auch als „Warum sehe ich diese Werbung?“ bezeichnet) ist eine Transparenzfunktion, die den Nutzenden erklärt, warum ihnen ein bestimmte Anzeige mit Informationen zum Datenschutz.
Weitere Informationen finden Sie im Hilfeartikel Warum sehe ich eine bestimmte Werbung?
In diesem Leitfaden wird erläutert, wie Sie die erforderlichen Informationen aus der VAST-XML-Antwort Ihrer Anzeige oder der Metadatenantwort Ihres dynamischen Anzeigenstreams extrahieren, um AdChoices richtig zu implementieren.
Anforderungen für das AdChoices-Rendering
Damit Ihre App oder Website den Anforderungen von Google zum Rendern von Datenschutzinfo-Symbolen entspricht, müssen folgende Standards erfüllt sein:
- Das Datenschutzinfo-Symbol muss über jeder Anzeige eingeblendet werden, für die es vorgesehen ist.
- Das Datenschutzinfo-Symbol muss an der Position angezeigt werden, die durch das "X" Standort“ und „Y-Standort“ die in den Symboldaten enthalten sind. Größe, die durch die Eigenschaften für Breite und Höhe definiert wird, in dichteunabhängigen Anzeigen Pixel (DP)
- Das AdChoices-Symbol darf nicht von anderen Anzeigen-Overlays oder Benutzeroberflächenelementen verdeckt werden.
- Auf Plattformen mit Klickunterstützung oder einer ähnlichen Funktion (z. B. Touchbedienung oder Auswahl über die Fernbedienung) muss das Datenschutzinfo-Symbol anklickbar sein.
- Auf Plattformen mit Browserunterstützung muss ein Klick auf das Datenschutzinfo-Symbol dazu führen, dass ein Browsertab oder -fenster mit der in der Property „ClickThrough“ oder „click_data“ angegebenen URL geöffnet wird.
- Auf Plattformen ohne Browserunterstützung muss durch Klicken auf das Datenschutzinfo-Symbol ein Modales Overlay, das eines der im "IconClickFallbackImage" oder "click_fallback_images" Property.
- Auf Plattformen ohne Browserunterstützung muss das Fallback-Bild in der Größe angezeigt werden, die in der Property „IconClickFallbackImage“ oder „click_fallback_images“ in Dichte-unabhängigen Pixeln (DP) angegeben ist.
Datenschutzinfos aus einer VAST-XML-Antwort parsen
Bei der Verwendung einer XML-Anzeigenantwort wird AdChoices nur in VAST-Version 3.0 und höher unterstützt. Das Datenschutzinfo-Symbol ist als VAST-Symbol implementiert.
VAST 4.2
Wenn Ihre XML-Anzeigenantwort dem VAST 4.2-Standard entspricht, wird das AdChoices-Symbol als VAST-Symbol gesendet. Wenn Ihre App oder Website VAST 4.2-Symbole vollständig unterstützt (Abschnitt 3.11 des VAST 4.2-Standards), sind keine weiteren Maßnahmen für die AdChoices-Unterstützung erforderlich.
Wenn Ihre App keine VAST 4.2-Symbole unterstützt, müssen Sie Symbole mit dem Programmnamen „GoogleWhyThisAd“ aus Ihrer VAST-Antwort manuell gemäß diesem Standard parsen. Sie können diese VAST 4.2-XML-Beispieldatei verwenden. für zusätzliche Tests in Ihrer App.
Beispiel für eine VAST 4.2-Antwort
<?xml version="1.0" encoding="UTF-8"?>
<VAST version="4.2">
<Ad id="20011">
<Wrapper>
...
<Creatives>
...
<Creative id="5480" sequence="1">
...
<Linear>
...
<Icons>
...
<Icon program="GoogleWhyThisAd" width="40" height="30" xPosition="left" yPosition="100" duration="00:00:10" offset="00:00:00" apiFramework="VAST" altText="AdChoices icon">
<StaticResource creativeType="image/png">
<![CDATA[ https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png ]]>
</StaticResource>
<IconClicks>
<IconClickThrough>
<![CDATA[ https://g.co/adsettings ]]>
</IconClickThrough>
<IconClickFallbackImages>
<IconClickFallbackImage width="950" height="600">
<AltText>
<![CDATA[ This ad was shown to you based on: * Google's estimation of your interests, based on your activity on Google on this device (for example, your searches) * the information on the website you were viewing. ]]>
</AltText>
<StaticResource creativeType="image/png">
<![CDATA[ https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices_fallback_image.png ]]>
</StaticResource>
</IconClickFallbackImage>
...
</IconClickFallbackImages>
</IconClicks>
</Icon>
...
</Icons>
...
</Linear>
...
</Creative>
...
</Creatives>
...
</Wrapper>
...
</Ad>
</VAST>
VAST 3.0
Wenn Ihre XML-Anzeigenantwort dem VAST 3.0-Standard entspricht, wird AdChoices als Kombination aus einem VAST-Symbol und einer benutzerdefinierten VAST-Erweiterung ausgeliefert. Wenn Ihr die App oder Website den VAST 3.0-Symbolstandard vollständig unterstützt und können die Symbol-Klick-URL aufrufen und diese anzeigen lassen, Datenschutzinfo-Support keine weitere Arbeit.
Wenn Ihre Plattform keine Klick-URLs aufrufen und anzeigen kann – dies gilt vor allem für Geräte ohne integrierten Webbrowser –, müssen Sie die Erweiterung „IconFallbackImages“ unterstützen. Diese Erweiterung enthält eine Reihe von „IconFallbackImages“-Tags, bei denen das Attribut „program“ mit einem Symbol übereinstimmt, das im VAST enthalten war.
Damit AdChoices vollständig unterstützt wird, muss das Tag „IconFallbackImages“ mit dem Programmnamen „GoogleWhyThisAd“ mit dem Symbol mit dem Programmnamen „GoogleWhyThisAd“ verknüpft sein. Wenn der Nutzer dann mit dem Symbol interagiert, wird das zugehörige Fallback-Bild angezeigt.
Um potenzielle zukünftige Änderungen am Datenschutzinfo-Standard zu unterstützen, haben wir empfehlen, für alle VAST-Symbole Unterstützung für Fallback-Bilder zu integrieren, verfügbar. Du kannst dieses Beispiel für VAST 3.0-XML für zusätzliche Tests in deiner App verwenden.
Struktur der Erweiterung „IconFallbackImages“
Tag | Attribute | Beschreibung |
---|---|---|
Erweiterung | Typ | Bei dieser Erweiterung enthält der Typ immer den Wert
IconClickFallbackImages
|
-IconClickFallbackImages | Programm | Dieses Attribut stimmt immer mit dem Programmattribut eines verknüpften VAST 3.0-Symbols überein. |
Die Struktur dieses Knotens entspricht dem VAST 4.2-Standard für
IconClickFallbackImages, mit Ausnahme der zusätzlichen program
.
|
||
--IconClickFallbackImage | Breite | Die bevorzugte Breite für die Darstellung des Bilds. |
Höhe | Die bevorzugte Höhe für die Anzeige des Bilds. | |
---AltText | Eine barrierefreie Beschreibung des Bildes. | |
---StaticResource | creativeType | Der MIME-Typ des Fallback-Bilds. |
Ein CDATA-Wert mit der URL des Fallback-Bilds. |
Beispiel für eine VAST 3.0-Antwort
<?xml version="1.0" encoding="UTF-8"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
<Ad id="123456">
<InLine>
...
<Creatives>
...
<Creative id="7891011" AdID="ABCD123456EF" sequence="1">
...
<Linear>
...
<Icons>
...
<Icon program="GoogleWhyThisAd" width="50" height="50" xPosition="20" yPosition="bottom" duration="00:00:10" offset="00:00:00" apiFramework="VAST" altText="Why This Ad?">
<StaticResource creativeType="image/png">
<![CDATA[https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png]]>
</StaticResource>
<IconClicks>
...
<IconClickThrough><![CDATA[https://g.co/adsettings]]></IconClickThrough>
</IconClicks>
</Icon>
...
</Icons>
...
</Linear>
...
</Creative>
...
</Creatives>
<Extensions>
...
<Extension type="IconClickFallbackImages">
...
<IconClickFallbackImages program="GoogleWhyThisAd">
<IconClickFallbackImage width="400" height="150">
<AltText>Alt icon fallback</AltText>
<StaticResource creativeType="image/png"><![CDATA[https://storage.googleapis.com/gvabox/nickchavez/media/png/wta_dialog.png]]></StaticResource>
</IconClickFallbackImage>
...
</IconClickFallbackImages>
...
</Extension>
...
</Extensions>
...
</InLine>
...
</Ad>
</VAST>
AdChoices aus den JSON-Metadaten der DAI API parsen
Wenn Sie mit der dynamischen Anzeigenbereitstellung arbeiten API, werden die Datenschutzinfo-Details das durch das JSON-Objekt übergeben wird, das von Anfragen an die Metadaten URL
Das Metadaten-JSON-Objekt enthält eine Liste von Anzeigen, die durch die adID verschlüsselt sind. Jedes Anzeigenobjekt enthält ein Symbol-Array. Wenn für die betreffende Anzeige AdChoices verwendet wird, ist das AdChoices-Symbol in diesem Array enthalten.
JSON-Symbolformat
Das JSON-Symbolformat ist eine 1:1-Übersetzung des VAST 4.2-Symbols Standard (Abschnitt 3.11). Zur Unterstützung des strengeren JSON-Formats wurden jedoch bei einigen Attributen die Namen geändert.
JSON-Format für Symbole
Programm | Für das Datenschutzinfo-Symbol enthält dieser Wert immer den String "GoogleWhyThisAd". |
x_position | Die horizontale Position der linken oberen Ecke des Symbols relativ zur linken oberen Ecke des Video-Creatives in Pixeln. In diesem Feld können auch die responsiven Positionswerte „right“ oder „links“. |
y_position | Die vertikale Position der linken oberen Ecke des Symbols relativ zur linken oberen Ecke des Video-Creatives in Pixeln. In diesem Feld werden auch die responsive Positionswerte „top“ oder "unten". |
Breite | Die Breite des Symbols in Pixeln. |
Höhe | Die Höhe des Symbols in Pixeln. |
creative_type | Der MIME-Typ des Bilds, das für das Symbol bereitgestellt wird. Standardmäßig ist „image/png“ festgelegt. |
Ressource | URL, unter der das Datenschutzinfo-Symbol abgerufen werden soll |
alt_text | Der Alt-Text, der für das Datenschutzinfo-Symbol gerendert wird |
click_data | Ein Objekt mit der Property click_data.url , die die URL darstellt, auf die Zuschauer weitergeleitet werden, wenn sie auf einer Plattform, die das Surfen im Web unterstützt, auf das Datenschutzinfo-Symbol klicken.
|
click_fallback_images | Eine Reihe von Bildobjekten, die Zuschauern angezeigt werden, die auf Plattformen, die das Surfen im Web nicht unterstützen, auf das AdChoices-Symbol klicken. |
Fallback-Bild-JSON-Format
Breite | Die Breite des Fallback-Bilds in Pixeln. |
Höhe | Die Höhe des Fallback-Bilds in Pixeln. |
creative_type | Der MIME-Typ des Fallback-Bilds. Die Standardeinstellung ist „image/png“. |
Ressource | Die URL, unter der das Fallback-Bild abgerufen wird. |
alt_text | Der Alt-Text, der für das Fallback-Bild gerendert werden soll. |
Beispiel für JSON-Metadaten
{
...
"ads": {
...
"0002640412_ad1": {
...
"icons": [
...
{
"alt_text": "AdChoices icon",
"click_data": {
"url": "https://g.co/adsettings"
},
"click_fallback_images": [
{
"alt_text": "This ad was shown to you based on: * Google's estimation of your interests, based on your activity on Google on this device (for example, your searches) * the information on the website you were viewing.",
"creative_type": "image/jpg",
"height": 600,
"resource": "https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices_fallback_image.png",
"width": 950
}
],
"creative_type": "image/png",
"height": 30,
"program": "AdChoices",
"resource": "https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png",
"type": "static",
"width": 40,
"x_position": "0",
"y_position": "100"
}
...
]
...
},
...
}
...
}