Symbol und Overlay für Datenschutzinfo

In allen Apps, in denen von Google gehostete Anzeigen ausgeliefert werden, müssen das AdChoices-Symbol und das Overlay implementiert werden, sofern sie von Google bereitgestellt werden. Datenschutzinfo (auch „Warum sehe ich diese Werbung?“ genannt) ist eine Transparenzfunktion, die Nutzern erklärt, warum ihnen eine bestimmte Anzeige präsentiert wird, und Informationen dazu liefert, wie ihre Privatsphäre geschützt wird. Weitere Informationen finden Sie unter Datenschutzinfo für Google Ad Manager.

Weitere Informationen

In diesem Leitfaden wird beschrieben, wie Sie die erforderlichen Informationen extrahieren, um AdChoices richtig in die VAST-XML-Antwort Ihrer Anzeige oder die Metadatenantwort Ihres DAI-Streams zu implementieren.

Anforderungen für das Rendern von „Datenschutzinfo“

Damit Ihre App oder Website die Google-Anforderungen für das Rendern von Datenschutzinfo-Symbolen erfüllt, müssen die folgenden Standards eingehalten werden:

  1. Das Datenschutzinfo-Symbol muss über jeder Anzeige eingeblendet werden, für die es bereitgestellt wird.
  2. Das Datenschutzinfo-Symbol muss an der Position angezeigt werden, die durch die Eigenschaften „X-Position“ und „Y-Position“ in den Symboldaten angegeben ist, und in der Größe, die durch die Eigenschaften „Breite“ und „Höhe“ in geräteunabhängigen Pixeln (DP) definiert ist.
  3. Das Datenschutzinfo-Symbol darf nicht durch andere Anzeigen-Overlays oder Benutzeroberflächenelemente verdeckt werden.
  4. Auf Plattformen mit Klickunterstützung oder Äquivalenten (z.B. Touch- oder Fernbedienungsauswahl) muss das Datenschutzinfo-Symbol anklickbar sein.
  5. Auf Plattformen mit Browserunterstützung muss durch Klicken auf das Datenschutzinfo-Symbol ein Browsertab oder -fenster mit der URL geöffnet werden, die in der Eigenschaft „ClickThrough“ oder „click_data“ angegeben ist.
  6. Auf Plattformen ohne Browserunterstützung muss durch Klicken auf das Datenschutzinfo-Symbol ein modales Overlay geöffnet werden, in dem eines der Bilder angezeigt wird, die in der Property „IconClickFallbackImage“ oder „click_fallback_images“ angegeben sind.
  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 dichteunabhängigen Pixeln (DP) angegeben ist.

Datenschutzinfo-Symbol aus einer VAST-XML-Antwort parsen

Bei einer XML-Anzeigenantwort wird „Datenschutzinfo“ nur in VAST-Version 3.0 und höher unterstützt. Datenschutzinfo 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 Datenschutzinfos keine weiteren Maßnahmen erforderlich.

Wenn Ihre App keine VAST 4.2-Symbole unterstützt, müssen Sie Symbole mit dem Programmnamen „GoogleWhyThisAd“ in Ihrer VAST-Antwort manuell gemäß diesem Standard parsen. Sie können dieses VAST 4.2-XML-Beispiel 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-Standard entspricht, wird das Datenschutzinfo-Symbol als Kombination aus einem VAST-Symbol und einer benutzerdefinierten VAST-Erweiterung bereitgestellt. 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 Unterstützung von Datenschutzinfos erforderlich.

Wenn Ihre Plattform keine Clickthrough-URLs aufrufen und anzeigen kann (dies 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 im VAST enthalten war.

Damit AdChoices vollständig unterstützt wird, muss das IconFallbackImages-Tag mit dem Programmnamen „GoogleWhyThisAd“ dem Icon mit dem Programmnamen „GoogleWhyThisAd“ zugeordnet werden. Wenn der Nutzer mit dem Icon interagiert, wird das zugehörige Fallback-Bild angezeigt.

Um potenzielle zukünftige Änderungen am Datenschutzinfo-Standard zu unterstützen, empfehlen wir dringend, Fallback-Bilder für alle VAST-Symbole zu verwenden, sofern verfügbar. Sie können dieses VAST 3.0-XML-Beispiel 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 Programmattribut eines zugehörigen VAST 3.0-Symbols überein.
Die Struktur dieses Knotens entspricht dem VAST 4.2-Standard für IconClickFallbackImages, mit Ausnahme des 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 Bildes.
---StaticResource creativeType Der MIME-Typ des Fallback-Bilds.
Ein 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>

AdChoices aus DAI API-Metadaten-JSON parsen

Wenn Sie mit der dynamischen Anzeigenbereitstellung API arbeiten, werden die 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 nach der Anzeigen-ID indexiert sind. Jedes Anzeigenobjekt enthält ein Array mit Symbolen. Wenn für die betreffende Anzeige „Datenschutzinfo“ verwendet wird, ist das Datenschutzinfo-Symbol in diesem Array enthalten.

JSON-Symbolformat

Das JSON-Symbolformat ist, soweit möglich, eine 1:1-Übersetzung des VAST 4.2-Symbolstandards (Abschnitt 3.11). Um das strengere JSON-Format zu unterstützen, wurden jedoch einige Attribute 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. In diesem Feld sind auch die responsiven Positionswerte „right“ (rechts) oder „left“ (links) zulässig.
y_position Die vertikale Position der oberen linken Ecke des Symbols in Bezug auf die obere linke Ecke des Video-Creatives in Pixeln. In diesem Feld sind auch die responsiven Positionswerte „top“ oder „bottom“ zulässig.
Breite Die Breite des Symbols in Pixeln.
Höhe Die Höhe des Symbols in Pixeln.
creative_type Der MIME-Typ des für das Symbol bereitgestellten Bildes. 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 das Surfen im Web unterstützt, auf das Datenschutzinfo-Symbol klicken.
click_fallback_images Ein Array von Bildobjekten, die Zuschauern angezeigt werden, die auf Plattformen, die kein Webbrowsen 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. Der Standardwert 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 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}