Diese Seite wurde von der Cloud Translation API übersetzt.

Symbol und Overlay für Datenschutzinfo

In allen Apps, in denen von Google gehostete personalisierte Anzeigen ausgeliefert werden, müssen das Symbol und ein Overlay für AdChoices implementiert sein, sofern diese von Google bereitgestellt werden. Datenschutzinfo (auch als „Warum sehe ich diese Werbung?“ bezeichnet) ist eine Transparenzfunktion, mit der Nutzer erfahren, warum ihnen eine bestimmte Anzeige präsentiert wird. Außerdem erhalten sie Informationen zum Datenschutz.

Weitere Informationen finden Sie unter Warum sehe ich eine bestimmte Werbung?.

In diesem Leitfaden wird erläutert, wie Sie die erforderlichen Informationen extrahieren, um Datenschutzinfo richtig aus der VAST-XML-Antwort Ihrer Anzeige oder der Metadatenantwort Ihres Streams für die dynamische Anzeigenbereitstellung zu implementieren.

Anforderungen für das Datenschutzinfo-Rendering

Damit die Anforderungen von Google an das Rendern von Datenschutzinfo-Symbolen erfüllt werden, muss Ihre App oder Website die folgenden Standards erfüllen:

Das Datenschutzinfo-Symbol muss über allen Anzeigen eingeblendet werden, für die es bereitgestellt wird.
Das Datenschutzinfo-Symbol muss an der Position platziert werden, die mit den Eigenschaften „Position X“ und „Y-Position“ in den Symboldaten angegeben wurde. Außerdem muss es in der durch die Breiten- und Höheneigenschaften definierten Größe in dichteunabhängigen Pixeln (DP) angezeigt werden.
Das Datenschutzinfo-Symbol darf nicht durch andere Anzeigen-Overlays oder Oberflächenelemente verdeckt werden.
Auf Plattformen mit Klickunterstützung oder ähnlichen Funktionen (z.B. Touchscreen oder Remote-Auswahl) muss das Datenschutzinfo-Symbol anklickbar sein.
Auf Plattformen mit Browserunterstützung muss durch Klicken auf das Datenschutzinfo-Symbol ein Browsertab oder -fenster mit der in der Eigenschaft "ClickThrough" oder "click_data" angegebenen URL geöffnet werden.
Auf Plattformen ohne Browserunterstützung muss durch Klicken auf das Datenschutzinfo-Symbol ein modales Overlay geöffnet werden, in dem eines der in der Property „IconClickFallbackImage“ oder „click_fallback_images“ angegebenen Bilder angezeigt wird.
Auf Plattformen ohne Browserunterstützung muss das Fallback-Image in der Größe angezeigt werden, die in der Property „IconClickFallbackImage“ oder „click_fallback_images“ in dichteunabhängigen Pixeln (DP) angegeben ist.

Datenschutzinfo aus einer VAST-XML-Antwort parsen

Wenn Sie mit einer XML-Anzeigenantwort arbeiten, wird das Datenschutzinfo-Symbol nur ab VAST-Version 3.0 unterstützt. Das Datenschutzinfo-Symbol wird als VAST-Symbol implementiert.

VAST 4.2

Wenn die XML-Anzeigenantwort dem VAST 4.2-Standard entspricht, wird AdChoices als VAST-Symbol bereitgestellt. Wenn Ihre App oder Website VAST 4.2-Symbole (Abschnitt 3.11 des VAST 4.2-Standards) vollständig unterstützt, müssen Sie nichts weiter tun.

Wenn Ihre App keine VAST 4.2-Symbole unterstützt, müssen Sie die Symbole mit dem Programmnamen "GoogleWhyThisAd" manuell aus Ihrer VAST-Antwort auf der Grundlage dieses Standards parsen. Sie können diese Beispiel-VAST 4.2-XML-Datei für weitere 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 die 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 über die Plattform die Symbol-Klick-URL aufgerufen und angezeigt werden kann, müssen Sie nichts weiter tun.

Wenn Ihre Plattform Klick-URLs nicht 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 im VAST-Code übereinstimmt.

Um AdChoices vollständig zu unterstützen, muss das SymbolFallbackImages-Tag mit dem Programmnamen "GoogleWhyThisAd" mit dem Symbol mit dem Programmnamen "GoogleWhyThisAd" verknüpft sein, sodass das zugehörige Fallback-Image angezeigt wird, wenn der Nutzer mit dem Symbol interagiert.

Zur Unterstützung potenzieller zukünftiger Änderungen am Datenschutzinfo-Standard empfehlen wir dringend, Fallback-Images für alle VAST-Symbole zu integrieren, sofern verfügbar. Sie können diese Beispiel-VAST 3.0-XML-Datei für zusätzliche Tests in Ihrer App verwenden.

Erweiterungsstruktur für IconFallbackImages

Taggen	Attribute	Beschreibung
Erweiterung	eingeben	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.
-IconClickFallbackImages		Die Struktur dieses Knotens entspricht dem VAST 4.2-Standard für IconClickFallbackImages, mit Ausnahme des zusätzlichen Attributs `program`.
--IconClickFallbackImage	width	Die bevorzugte Breite für die Anzeige des Bildes.
--IconClickFallbackImage	height	Die bevorzugte Höhe für die Anzeige des Bildes.
---AltText		Eine barrierefreie Beschreibung des Bildes.
---StaticResource	creativeType	Der MIME-Typ des Fallback-Images.
---StaticResource		CDATA-Wert, der die URL des Fallback-Bildes enthält

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 aus DAI API-Metadaten-JSON parsen

Wenn Sie mit der DAI API arbeiten, werden Datenschutzinfo-Details ü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 von der adID abhängig sind. Innerhalb jedes Anzeigenobjekts befindet sich ein Symbol-Array. Wenn für die betreffende Anzeige das Datenschutzinfo-Symbol verwendet wird, ist das Datenschutzinfo-Symbol in diesem Array enthalten.

JSON-Symbolformat

Das JSON-Symbolformat entspricht nach Möglichkeit einer 1:1-Übersetzung des Symbolstandards für VAST 4.2 (Abschnitt 3.11). Damit jedoch das strengere JSON-Format unterstützt wird, haben einige Attribute bei Bedarf die Namen geändert.

Symbol-JSON-Format

Programm	Beim Datenschutzinfo-Symbol enthält dieser Wert immer den String „GoogleWhyThisAd“.
x_position	Die horizontale Position der linken oberen Ecke des Symbols im Verhältnis 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 im Verhältnis zur oberen linken Ecke des Video-Creatives in Pixeln. Dieses Feld akzeptiert auch die responsiven Positionswerte "top" oder "bottom".
width	Die Breite des Symbols in Pixeln.
height	Die Höhe des Symbols in Pixeln.
creative_type	Der MIME-Typ des für das Symbol bereitgestellten Bilds. Die Standardeinstellung 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 Betrachter weitergeleitet werden sollen, wenn sie auf einer Plattform, die das Surfen im Web unterstützt, auf das Datenschutzinfo-Symbol klicken.
click_fallback_images	Ein Array von Bildobjekten, die Betrachtern angezeigt werden, die auf Plattformen, die das Surfen im Web nicht unterstützen, auf das Datenschutzinfo-Symbol klicken.

Fallback-Bild-JSON-Format

width	Die Breite des Fallback-Bildes in Pixeln.
height	Höhe des Fallback-Bilds in Pixeln
creative_type	Der MIME-Typ des Fallback-Images. Die Standardeinstellung ist „image/png“.
Ressource	Die URL zum Abrufen des Fallback-Bildes.
alt_text	Der Alt-Text, der für das Fallback-Bild gerendert werden soll.

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