Symbol und Overlay für Datenschutzinfo

Alle Apps, in denen von Google gehostete personalisierte Anzeigen ausgeliefert werden, müssen das Datenschutzinfo-Symbol und das Overlay implementieren, sofern diese von Google bereitgestellt werden. 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 erhalten Sie im Artikel Warum wird dir eine Fehlermeldung angezeigt? Anzeige.

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:

  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 durch einen Klick auf das Datenschutzinfo-Symbol ein Browser-Tab oder -Fenster mit der in der Spalte "ClickThrough" angegebenen URL oder "click_data" Property.
  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 unter folgendem Pfad angezeigt werden: die im Feld "IconClickFallbackImage" angegebene Größe oder "click_fallback_images" in dichteunabhängigen Pixeln (DP) dargestellt.

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 (Abschnitt 3.11 des VAST 4.2-Standards), Unterstützung von Datenschutzinfo keine weitere Arbeit.

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 die Antwort auf Ihre XML-Anzeige der VAST 3.0- Standard festgelegt ist, ist das Datenschutzinfo-Symbol die als Kombination aus einem VAST-Symbol und einer benutzerdefinierten VAST-Erweiterung ausgeliefert werden. 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 nicht zu einem Klick führt URLs: Dies gilt in erster Linie für Geräte ohne integriertes Browser: Sie müssen die Unterstützung für das Symbol "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 entspricht immer dem Programmattribut eines verknüpften VAST- 3.0-Symbol.
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

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 JSON-Objekt „Metadata“ enthält eine Liste von Anzeigen, die anhand der Anzeigen-ID sortiert ist. In jedem ad-Objekt ist ein Symbolarray. 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 -Format haben einige Attribute gegebenenfalls Namen geändert.

JSON-Symbolformat

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 für das Symbol bereitgestellten Bilds. Die Standardeinstellung ist „image/png“.
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 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.

JSON-Format für das 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 zum Abrufen des Fallback-Bilds.
alt_text Der für das Fallback-Image zu rendernde Alt-Text.

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