Symbol und Overlay für Datenschutzinfo

Alle Apps, in denen von Google gehostete personalisierte Anzeigen ausgeliefert werden, müssen das AdChoices und das Overlay implementieren, sofern von Google bereitgestellt. Datenschutzinfo (auch „Warum sehe ich diese Werbung?“ genannt) ist eine Funktion für mehr Transparenz, über die der Nutzer erfährt, warum ihm eine bestimmte Anzeige präsentiert wird. Außerdem erhält er Informationen dazu, wie seine Daten geschützt werden.

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 Rendern von „Datenschutzinfo“

Damit Ihre App oder Website den Anforderungen von Google zum Rendern von Datenschutzinfo-Symbolen entspricht, müssen folgende Standards erfüllt sein:

  1. Das Datenschutzinfo-Symbol muss über jeder Anzeige eingeblendet werden, für die es vorgesehen ist.
  2. Das Datenschutzinfo-Symbol muss an der Position angezeigt werden, die durch die in den Symboldaten enthaltenen Eigenschaften „X-Position“ und „Y-Position“ angegeben ist, und in der Größe, die durch die Eigenschaften „Breite“ und „Höhe“ in dpi (Density-Independent Pixel) definiert ist.
  3. Das AdChoices-Symbol darf nicht von anderen Anzeigen-Overlays oder Benutzeroberflächenelementen verdeckt werden.
  4. Auf Plattformen mit Klickunterstützung oder einer ähnlichen Funktion (z.B. Touchbedienung oder Auswahl über die Fernbedienung) muss das Datenschutzinfo-Symbol anklickbar sein.
  5. 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.
  6. Auf Plattformen ohne Browserunterstützung muss ein Klick auf das Datenschutzinfo-Symbol ein modales Overlay öffnen, in dem eines der in der Property „IconClickFallbackImage“ oder „click_fallback_images“ angegebenen Bilder angezeigt wird.
  7. 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.

AdChoices 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 wird als VAST-Symbol implementiert.

VAST 4.2

Wenn Ihre XML-Anzeigenantwort dem VAST 4.2-Standard entspricht, wird AdChoices als VAST-Symbol ausgeliefert. 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. Du kannst dieses Beispiel-VAST 4.2-XML-Dokument für weitere Tests in deiner App verwenden.

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 Ihre App oder Website den VAST 3.0-Symbolstandard vollständig unterstützt und die Plattform die Klick-URL des Symbols aufrufen und anzeigen kann, sind keine weiteren Maßnahmen für die AdChoices-Unterstützung erforderlich.

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 Unterstützung für die Erweiterung „IconFallbackImages“ implementieren. 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 AdChoices-Standard zu unterstützen, empfehlen wir dringend, die Unterstützung von Fallback-Bildern für alle VAST-Symbole zu implementieren, sofern 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 des zusätzlichen Attributs program.
--IconClickFallbackImage Breite Die bevorzugte Breite für die Anzeige des Bilds.
Höhe Die bevorzugte Höhe für die Anzeige des Bilds.
---AltText Eine barrierefreie Beschreibung des Bilds.
---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 DAI API-Metadaten-JSON-Dateien parsen

Bei der Verwendung der DAI API werden AdChoices-Details über das JSON-Objekt übergeben, das über Anfragen an die Metadaten-URL zurückgegeben wird.

Das JSON-Objekt „Metadata“ enthält eine Liste von Anzeigen, die anhand der Anzeigen-ID sortiert ist. 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 nach Möglichkeit eine 1:1-Übersetzung des VAST 4.2-Symbolstandards (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. Dieses Feld akzeptiert auch die responsiven Positionswerte „rechts“ oder „links“.
y_position Die vertikale Position der linken oberen Ecke des Symbols relativ zur linken oberen Ecke des Video-Creatives in Pixeln. Dieses Feld akzeptiert auch die responsiven Positionswerte „top“ oder „bottom“.
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 Die URL, über die das Datenschutzinfo-Symbol abgerufen wird.
alt_text Der Alt-Text, der für das Datenschutzinfo-Symbol gerendert werden soll.
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 Websurfen 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.

JSON-Format für Fallback-Bild

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. Standardmäßig ist „image/png“ festgelegt.
Ressource Die URL, unter der das Fallback-Bild abgerufen werden kann.
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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}