Se usó la API de Cloud Translation para traducir esta página.

Ícono y superposición de AdChoices

Todas las aplicaciones que muestran anuncios personalizados alojados por Google deben implementar el ícono de AdChoices y superposición, cuando Google la proporciona. AdChoices (también conocida como "¿Por qué este anuncio?") es una función de transparencia que explica a los usuarios por qué se les muestra un determinado anuncio y brinda información sobre cómo se protege su privacidad.

Para obtener más información, consulta ¿Por qué ves un anuncio.

Esta guía explica cómo extraer la información necesaria para implementar AdChoices a partir de la respuesta XML de VAST de su anuncio o de la transmisión respuesta de metadatos.

Requisitos para la renderización de AdChoices

Para cumplir con los requisitos de Google para renderizar íconos de AdChoices, su aplicación o sitio web debe cumplir con los siguientes estándares:

El ícono de AdChoices se debe mostrar superpuesto a todos los anuncios que correspondan proporcionado
El ícono de AdChoices debe mostrarse en la posición indicada por la "X ubicación" y "Y ubicación" propiedades incluidas en los datos de iconos y en la el tamaño definido por las propiedades de ancho y alto, en valores independientes de la densidad Píxeles (DP)
El ícono de AdChoices no debe estar oculto detrás de otras superposiciones de anuncios o interfaces o de terceros.
En plataformas compatibles con clics o equivalentes (p.ej., toque o selección remota), se debe poder hacer clic en el ícono de AdChoices.
En plataformas compatibles con navegadores, al hacer clic en el ícono de AdChoices, se debe abrir una pestaña o ventana del navegador con la URL especificada en la opción "Clics" o “datos_clic” propiedad.
En plataformas no compatibles con navegadores, al hacer clic en el ícono de AdChoices, se debe abrir una superposición modal, en la que se muestra una de las imágenes especificadas en la "IconClickFallbackImage" o "click_fallback_images" propiedad.
En plataformas no compatibles con navegadores, la imagen de resguardo debe mostrarse en el tamaño especificado en el encabezado o “click_fallback_images” en píxeles independientes de la densidad (DP).

Analiza AdChoices de una respuesta XML de VAST

Cuando se trabaja con una respuesta de anuncio XML, AdChoices solo se admite en VAST versión 3.0 y posteriores. AdChoices se implementa como un ícono de VAST.

VAST 4.2

Si la respuesta de tu anuncio XML cumple con las recomendaciones de VAST 4.2 estándar, AdChoices se publica como un ícono de VAST. Si tu aplicación o sitio web son totalmente compatibles Íconos de VAST 4.2 (sección 3.11 del estándar VAST 4.2), compatibilidad con AdChoices no requiere trabajo adicional.

Si tu app no admite íconos de VAST 4.2, debes analizarlos manualmente con el nombre de programa "GoogleWhyThisAd". de tu respuesta de VAST, en función del estándar. Puede usar esta muestra de XML de VAST 4.2 para realizar más pruebas en tu app.

Ejemplo de respuesta de VAST 4.2

<?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

Si la respuesta de tu anuncio XML cumple con las recomendaciones de VAST 3.0 estándar, AdChoices es se publica como una combinación de un ícono de VAST y una extensión de VAST personalizada. Si el la aplicación o el sitio web sean totalmente compatibles con el estándar de ícono de VAST 3.0 y, si la plataforma está navegar hasta la URL de clic del ícono y mostrarla, la asistencia de AdChoices no requiere trabajo adicional.

Si tu plataforma no puede navegar y mostrar la tasa de clics, haz lo siguiente: URLs: Esto se aplica principalmente a dispositivos que no tienen un sitio web integrado debes implementar compatibilidad con la API de “IconFallbackImages” . Esta extensión contiene un conjunto de imágenes "IconFallbackImages" etiquetas en las que la palabra “program” coincide con un ícono incluido en el VAST.

Para admitir AdChoices, se debe agregar la etiqueta IconFallbackImages con el nombre del programa "GoogleWhyThisAd" Debe estar asociado al ícono con el nombre del programa. "GoogleWhyThisAd", de modo que cuando el usuario interactúe con el ícono, el se muestra la imagen de resguardo asociada.

Para respaldar posibles cambios futuros en el estándar de AdChoices, recomendamos se recomienda incorporar compatibilidad con imágenes de resguardo para todos los íconos de VAST, cuando disponibles. Puede usar esta muestra de VAST 3.0 XML para realizar más pruebas en tu app.

Estructura de la extensión IconFallbackImages

Etiqueta	Atributos	Descripción
Extensión	tipo	Para esta extensión, el tipo siempre contiene el valor `IconClickFallbackImages`
-IconClickFallbackImages	programa	Este atributo siempre coincide con el atributo de programa de un VAST asociado. 3.0 Ícono.
-IconClickFallbackImages		La estructura de este nodo coincide con el estándar VAST 4.2 para IconClickFallbackImages, excepto por la adición de `program` .
--IconClickFallbackImage	ancho	Es el ancho preferido para mostrar la imagen.
--IconClickFallbackImage	alto	La altura preferida para mostrar la imagen.
---AltText		Es una descripción accesible de la imagen.
---StaticResource	creativeType	El tipo MIME de la imagen de resguardo.
---StaticResource		Es un valor de CDATA que contiene la URL de la imagen de resguardo.

Ejemplo de respuesta de VAST 3.0

<?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>

Analizar AdChoices del JSON de metadatos de la API de DAI

Cuando trabajes con la DAI API, los detalles de AdChoices son los siguientes: pasan a través del objeto JSON que devuelven las solicitudes a los metadatos de destino.

El objeto Metadata JSON contiene una lista de anuncios, con el adID como clave. Dentro de cada es un array de íconos. Si el anuncio en cuestión utiliza AdChoices, el El ícono de AdChoices se encuentra en ese array.

Formato de ícono JSON

El formato del ícono JSON es una traducción 1:1 del ícono de VAST 4.2 estándar (sección 3.11), siempre que sea posible. Sin embargo, para admitir el modelo JSON más estricto, , se cambió el nombre de algunos atributos en caso de ser necesario.

Formato JSON de íconos

programa	Para el ícono de AdChoices, este valor siempre contiene la string "GoogleWhyThisAd".
x_position	La posición horizontal de la esquina superior izquierda del icono, en relación con que aparece en la esquina superior izquierda de la creatividad de video, en píxeles. Este campo también acepta los valores de posición adaptables "derecha" o "izquierda".
y_position	La posición vertical de la esquina superior izquierda del ícono, en relación con la esquina superior izquierda de la creatividad de video, en píxeles. Este campo también acepta valores de posición responsivos "top" o “inferior”.
ancho	El ancho del ícono en píxeles.
alto	La altura del ícono en píxeles.
creative_type	El tipo MIME de la imagen proporcionada para el ícono. La configuración predeterminada es “image/png”.
recurso	Es la URL para recuperar el ícono de AdChoices.
alt_text	Es el texto alternativo que se renderizará para el ícono de AdChoices.
click_data	Un objeto que contiene la propiedad `click_data.url`, que representa la URL a la que se dirigirá a los usuarios si hacen clic en el ícono de AdChoices en una plataforma que admite la navegación web.
click_fallback_images	Es un array de objetos de imagen para mostrar a los usuarios que hacen clic en la Selección de anuncios. en plataformas que no admiten la navegación web.

Formato JSON de imagen de resguardo

ancho	Es el ancho de la imagen de resguardo en píxeles.
alto	Es la altura de la imagen de resguardo en píxeles.
creative_type	El tipo MIME de la imagen de resguardo. La configuración predeterminada es “image/png”.
recurso	La URL para recuperar la imagen de resguardo
alt_text	El texto alternativo que se renderizará para la imagen de resguardo.

JSON de metadatos de muestra

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