Diese Seite wurde von der Cloud Translation API übersetzt.

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 erhalten Sie im Artikel Warum wird dir eine Fehlermeldung angezeigt? Anzeige.

In diesem Leitfaden wird erläutert, wie Sie die notwendigen Informationen extrahieren, um AdChoices aus der VAST-XML-Antwort Ihrer Anzeige oder dem Stream für die dynamische Anzeigenbereitstellung implementieren Metadatenantwort.

Anforderungen für das AdChoices-Rendering

Um die Anforderungen von Google für das Rendern von AdChoices-Symbolen zu erfüllen, muss Ihre App oder muss die folgenden Standards erfüllen:

Das Datenschutzinfo-Symbol muss über jeder Anzeige eingeblendet werden, bereitgestellt
Das Datenschutzinfo-Symbol muss an der Position angezeigt werden, die durch das "X" Standort“ und „Y-Standort“ die in den Symboldaten enthalten sind. Größe, die durch die Eigenschaften für Breite und Höhe definiert wird, in dichteunabhängigen Anzeigen Pixel (DP)
Das Datenschutzinfo-Symbol darf nicht von anderen Anzeigen-Overlays oder einer anderen Benutzeroberfläche verdeckt werden. Elemente.
Auf Plattformen mit Unterstützung für Klicks oder vergleichbaren Funktionen (z.B. durch Tippen oder Remote-Auswahl) muss anklickbar sein.
Auf Plattformen mit Browserunterstützung muss durch Klicken auf das Datenschutzinfo-Symbol ein Browser-Tab oder -Fenster mit der in der Spalte "ClickThrough" angegebenen URL oder „click_data“ Property.
Auf Plattformen ohne Browserunterstützung muss durch einen Klick auf das Datenschutzinfo-Symbol ein Modales Overlay, das eines der im "IconClickFallbackImage" oder "click_fallback_images" Property.
Auf Plattformen ohne Browserunterstützung muss das Fallback-Bild unter die im Feld "IconClickFallbackImage" angegebene Größe oder „click_fallback_images“ in dichteunabhängigen Pixeln (DP) dargestellt.

Datenschutzinfos aus einer VAST-XML-Antwort parsen

Beim Arbeiten mit einer XML-Anzeigenantwort wird das Datenschutzinfo-Symbol nur in VAST unterstützt Version 3.0 und höher. 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 (Abschnitt 3.11 des VAST 4.2-Standards), Unterstützung von Datenschutzinfo keine weitere Arbeit.

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 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 integrierte Web- 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.

IconFallbackImages-Erweiterungsstruktur

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.
-IconClickFallbackImages		Die Struktur dieses Knotens entspricht dem VAST 4.2-Standard für IconClickFallbackImages mit Ausnahme der zusätzlichen `program` .
--IconClickFallbackImage	Breite	Die bevorzugte Breite für die Darstellung des Bilds.
--IconClickFallbackImage	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.
---StaticResource		Ein CDATA-Wert, der die URL des Fallback-Bilds 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 den JSON-Metadaten der DAI API 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 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 oberen linken Ecke des Symbols im Verhältnis zu der oberen linken Ecke des Video-Creatives in Pixeln. In diesem Feld können auch die responsiven Positionswerte „right“ oder „links“.
y_position	Die vertikale Position der oberen linken Ecke des Symbols im Verhältnis zum der oberen linken 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 für das Symbol bereitgestellten Bilds. Die Standardeinstellung ist „image/png“.
Ressource	Die URL, unter der das Datenschutzinfo-Symbol abgerufen werden soll.
alt_text	Der Alt-Text, der für das Datenschutzinfo-Symbol gerendert wird
click_data	Ein Objekt mit der Eigenschaft `click_data.url`, die ist die URL, zu der Nutzer weitergeleitet werden, wenn sie auf das Datenschutzinfo-Symbol die das Surfen im Web unterstützt.
click_fallback_images	Array mit Bildobjekten, die Nutzern angezeigt werden, die auf das Datenschutzinfo-Symbol klicken auf Plattformen, die das Surfen im Web nicht unterstützen.

Fallback-Bild-JSON-Format

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. Die Standardeinstellung ist „image/png“.
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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}