Symbol und Overlay für Datenschutzinfo

Alle von Google gehosteten Apps, in denen personalisierte Anzeigen ausgeliefert werden, müssen das AdChoices-Symbol und Overlay, sofern von Google bereitgestellt. 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 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, bereitgestellt
  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 Unterstützung für Klicks oder vergleichbaren Funktionen (z.B. durch Tippen oder Remote-Auswahl) muss 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 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 die Antwort auf Ihre XML-Anzeige der VAST 4.2- Standard, Das Datenschutzinfo-Symbol wird als VAST-Symbol bereitgestellt. 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 VAST 4.2-Symbole nicht unterstützt, müssen Sie die Symbole manuell parsen. mit dem Programmnamen „GoogleWhyThisAd“ aus Ihrer VAST-Antwort erstellen, Standard. Sie können diese VAST 4.2-XML-Beispieldatei verwenden. für zusätzliche Tests in Ihrer App.

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 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 "Programm" mit einem Symbol übereinstimmt, das in VAST enthalten ist.

Zur vollständigen Unterstützung von AdChoices muss das IconFallbackImages-Tag mit dem Programmnamen „GoogleWhyThisAd“ muss mit dem Symbol mit dem Programmnamen verknüpft sein „GoogleWhyThisAd“: Wenn der Nutzer mit dem Symbol interagiert, zugehöriges Fallback-Bild angezeigt.

Um potenzielle zukünftige Änderungen am Datenschutzinfo-Standard zu unterstützen, haben wir empfehlen, für alle VAST-Symbole Unterstützung für Fallback-Bilder zu integrieren, verfügbar. Sie können dieses Beispiel VAST 3.0 XML für zusätzliche Tests in Ihrer App.

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 Darstellung 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 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 Metadaten-JSON-Objekt enthält eine Liste von Anzeigen, die durch die adID verschlüsselt sind. In jedem ad-Objekt ist ein Symbolarray. Wenn in der betreffenden Anzeige das Datenschutzinfo-Symbol verwendet wird, Das Datenschutzinfo-Symbol ist 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 -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 oberen linken Ecke des Symbols im Verhältnis zu der oberen linken 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. In diesem Feld werden auch die responsive Positionswerte „top“ oder "unten".
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 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, unter der das Fallback-Bild abgerufen wird.
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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}