Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Symbol und Overlay für Datenschutzinfo

In allen Apps, in denen personalisierte Anzeigen von Google ausgeliefert werden, müssen das AdChoices-Symbol und das Overlay implementiert sein, wenn sie von Google bereitgestellt werden. „Datenschutzinfo“ (auch „Warum sehe ich diese Werbung?“) 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

In diesem Leitfaden wird erklärt, wie Sie die erforderlichen Informationen extrahieren, um das Datenschutzinfo-Symbol und das Datenschutzinfo-Overlay ordnungsgemäß zu implementieren. Die Informationen stammen aus der VAST-XML-Antwort Ihrer Anzeige oder aus der Metadatenantwort Ihres DAI-Streams.

Anforderungen für das Rendern des Datenschutzinfo-Symbols

Damit Ihre App oder Website die Anforderungen von Google für das Rendern des Datenschutzinfo-Symbols erfüllt, muss sie die folgenden Standards einhalten:

Das Datenschutzinfo-Symbol muss als Overlay über jeder Anzeige eingeblendet werden, für die es bereitgestellt wird.
Das Datenschutzinfo-Symbol muss an der Position angezeigt werden, die durch die Properties „X-Position“ und „Y-Position“ in den Symboldaten angegeben ist. Die Größe muss durch die Properties „Breite“ und „Höhe“ in dichteunabhängigen Pixeln (DP) definiert sein.
Das Datenschutzinfo-Symbol darf nicht durch andere Anzeigen-Overlays oder Benutzeroberflächenelemente verdeckt werden.
Auf Plattformen mit Klickunterstützung oder einer entsprechenden Funktion (z.B. Touch- oder Fernbedienungsauswahl) muss das Datenschutzinfo-Symbol anklickbar sein.
Auf Plattformen mit Browserunterstützung muss ein Klick auf das Datenschutzinfo-Symbol einen Browsertab oder ein Browserfenster mit der URL öffnen, die in der Property „ClickThrough“ oder „click_data“ angegeben ist.
Auf Plattformen ohne Browserunterstützung muss ein Klick auf das Datenschutzinfo-Symbol ein modales Overlay öffnen, in dem eines der Bilder angezeigt wird, die in der Property „IconClickFallbackImage“ oder „click_fallback_images“ angegeben sind.
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 dichteunabhängigen Pixeln (DP) angegeben ist.

Datenschutzinfo-Symbol aus einer VAST-XML-Antwort parsen

Wenn Sie mit einer XML-Anzeigenantwort arbeiten, wird das Datenschutzinfo-Symbol 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 das Datenschutzinfo-Symbol 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 für die Unterstützung von Datenschutzinfo keine weiteren Schritte erforderlich.

Wenn Ihre App keine VAST 4.2-Symbole unterstützt, müssen Sie Symbole mit dem Programmnamen „GoogleWhyThisAd“ manuell aus Ihrer VAST-Antwort parsen. Sie können diese VAST 4.2-XML-Beispieldatei für zusätzliche Tests in Ihrer 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 Standardentspricht, wird das Datenschutzinfo-Symbol 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 für das Symbol aufrufen und anzeigen kann, sind keine weiteren Schritte erforderlich.

Wenn Ihre Plattform keine Klick-URLs aufrufen und anzeigen kann – das gilt hauptsächlich 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 in der VAST-Antwort enthalten war.

Damit das Datenschutzinfo-Symbol vollständig unterstützt wird, muss das IconFallbackImages-Tag mit dem Programmnamen „GoogleWhyThisAd“ mit dem Symbol mit dem Programmnamen „GoogleWhyThisAd“ verknüpft sein. Wenn der Nutzer mit dem Symbol interagiert, wird das zugehörige Fallback-Bild angezeigt.

Um potenzielle zukünftige Änderungen am Datenschutzinfo-Standard zu unterstützen, empfehlen wir dringend, die Unterstützung für Fallback-Bilder für alle VAST-Symbole zu implementieren, sofern verfügbar. Sie können diese VAST 3.0 XML-Beispieldatei für zusätzliche Tests in Ihrer App verwenden.

Struktur der Erweiterung „IconFallbackImages“

Tag	Attribute	Beschreibung
Erweiterung	Typ	Für diese Erweiterung enthält der Typ immer den Wert `IconClickFallbackImages`.
-IconClickFallbackImages	Programm	Dieses Attribut stimmt immer mit dem Attribut „program“ eines zugehörigen VAST 3.0-Symbols überein.
-IconClickFallbackImages		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.
--IconClickFallbackImage	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.
---StaticResource		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>

Datenschutzinfo-Symbol aus Metadaten-JSON der DAI API parsen

Wenn Sie mit der DAI API arbeiten, werden die Details zum Datenschutzinfo-Symbol über das JSON-Objekt übergeben, das von Anfragen an die Metadaten URL zurückgegeben wird.

Das JSON-Objekt „Metadata“ enthält eine Liste von Anzeigen, die nach der Anzeigen-ID sortiert sind. Jedes Anzeigenobjekt enthält ein Array mit Symbolen. Wenn die betreffende Anzeige das Datenschutzinfo-Symbol verwendet, ist es in diesem Array enthalten.

JSON-Symbolformat

Das JSON-Symbolformat ist nach Möglichkeit eine 1:1-Übersetzung des VAST 4.2-Symbol standards (Abschnitt 3.11). Um das strengere JSON-Format zu unterstützen, wurden einige Attribute jedoch umbenannt.

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 oberen linken Ecke des Symbols relativ zur oberen linken Ecke des Video-Creatives in Pixeln. Dieses Feld akzeptiert auch die responsiven Positionswerte „right“ oder „left“.
y_position	Die vertikale Position der oberen linken Ecke des Symbols relativ zur oberen linken 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. Der Standardwert ist „image/png“.
Ressource	Die URL zum Abrufen des Datenschutzinfo-Symbols.
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, zu der Zuschauer weitergeleitet werden, wenn sie auf einer Plattform, die Webbrowsing unterstützt, auf das Datenschutzinfo-Symbol klicken.
click_fallback_images	Ein Array von Bildobjekten, die Zuschauern angezeigt werden, wenn sie auf Plattformen, die Webbrowsing nicht unterstützen, auf das Datenschutzinfo-Symbol klicken.

JSON-Format für Fallback-Bilder

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. Der Standardwert ist „image/png“.
Ressource	Die URL zum Abrufen des Fallback-Bilds.
alt_text	Der Alt-Text, der für das Fallback-Bild gerendert werden soll.

Beispiel für Metadaten-JSON

{
  ...
  "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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}