Icône et superposition Choisir sa pub

Toutes les applications qui diffusent des annonces hébergées par Google doivent implémenter l'icône et la superposition AdChoices, lorsqu'elles sont fournies par Google. Choisir sa pub (également appelé "Pourquoi cette annonce ?") est une fonctionnalité de transparence qui explique aux utilisateurs pourquoi ils voient s'afficher une annonce spécifique et fournit des informations sur la façon dont leur confidentialité est protégée. Pour en savoir plus, consultez Choisir sa pub pour Google Ad Manager.

Pour en savoir plus, consultez Pourquoi une annonce s'affiche.

Ce guide explique comment extraire les informations nécessaires pour implémenter correctement AdChoices à partir de la réponse XML VAST de votre annonce ou de la réponse des métadonnées de votre flux DAI.

Exigences concernant l'affichage de Choisir sa pub

Pour respecter les exigences de Google concernant l'affichage des icônes "Vos choix de publicité", votre application ou votre site Web doivent répondre aux normes suivantes :

  1. L'icône Choisir sa pub doit être affichée en superposition sur toutes les annonces pour lesquelles elle est fournie.
  2. L'icône Choisir sa pub doit être affichée à l'emplacement indiqué par les propriétés "Emplacement X" et "Emplacement Y" incluses dans les données de l'icône, et à la taille définie par les propriétés de largeur et de hauteur, en pixels indépendants de la densité (DP).
  3. L'icône "Choisir sa pub" ne doit pas être masquée par d'autres éléments d'interface ou de superposition d'annonces.
  4. Sur les plates-formes compatibles avec les clics ou une fonctionnalité équivalente (par exemple, la sélection tactile ou à distance), l'icône Choisir sa pub doit être cliquable.
  5. Sur les plates-formes compatibles avec les navigateurs, le clic sur l'icône "Choisir sa pub" doit ouvrir un onglet ou une fenêtre de navigateur avec l'URL spécifiée dans la propriété "ClickThrough" ou "click_data".
  6. Sur les plates-formes non compatibles avec les navigateurs, le clic sur l'icône "Choisir sa pub" doit ouvrir une superposition modale affichant l'une des images spécifiées dans la propriété "IconClickFallbackImage" ou "click_fallback_images".
  7. Sur les plates-formes non compatibles avec les navigateurs, l'image de remplacement doit être affichée à la taille spécifiée dans la propriété "IconClickFallbackImage" ou "click_fallback_images", en pixels indépendants de la densité (dp).

Analyser le choix de l'annonce à partir d'une réponse XML VAST

Lorsque vous travaillez avec une réponse d'annonce XML, Choisir sa pub n'est compatible qu'avec VAST 3.0 et les versions ultérieures. Choisir sa pub est implémenté en tant qu'icône VAST.

VAST 4.2

Si votre réponse d'annonce XML suit la norme VAST 4.2, Choisir sa pub est fourni en tant qu'icône VAST. Si votre application ou votre site Web sont entièrement compatibles avec les icônes VAST 4.2 (section 3.11 de la norme VAST 4.2), vous n'avez rien d'autre à faire pour la prise en charge de Choisir sa pub.

Si votre application n'est pas compatible avec les icônes VAST 4.2, vous devez analyser manuellement les icônes avec le nom de programme "GoogleWhyThisAd" à partir de votre réponse VAST, en fonction de cette norme. Vous pouvez utiliser cet exemple de fichier XML VAST 4.2 pour effectuer des tests supplémentaires dans votre application.

Exemple de réponse 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 votre réponse d'annonce XML suit la norme VAST 3.0, Choisir sa pub est fourni sous la forme d'une combinaison d'une icône VAST et d'une extension VAST personnalisée. Si votre application ou votre site Web sont entièrement compatibles avec la norme VAST 3.0 pour les icônes et si la plate-forme est en mesure d'accéder à l'URL de destination de l'icône et de l'afficher, vous n'avez rien d'autre à faire pour la prise en charge de Choisir sa pub.

Si votre plate-forme n'est pas en mesure d'accéder aux URL de suivi des clics et de les afficher (cela s'applique principalement aux appareils qui ne disposent pas d'un navigateur Web intégré), vous devez implémenter la prise en charge de l'extension "IconFallbackImages". Cette extension contient un ensemble de balises "IconFallbackImages" dont l'attribut "program" correspond à une icône incluse dans le fichier VAST.

Pour prendre pleinement en charge Choisir sa pub, le tag IconFallbackImages avec le nom de programme "GoogleWhyThisAd" doit être associé à l'icône portant le nom de programme "GoogleWhyThisAd". Ainsi, lorsque l'utilisateur interagit avec l'icône, l'image de remplacement associée s'affiche.

Pour anticiper d'éventuelles modifications futures de la norme Choisir sa pub, nous vous recommandons vivement d'intégrer la prise en charge des images de remplacement pour toutes les icônes VAST, le cas échéant. Vous pouvez utiliser cet exemple de fichier XML VAST 3.0 pour effectuer des tests supplémentaires dans votre application.

Structure de l'extension IconFallbackImages

Tag Attributs Description
Extension type Pour cette extension, le type contient toujours la valeur IconClickFallbackImages.
-IconClickFallbackImages programme Cet attribut correspond toujours à l'attribut "program" d'une icône VAST 3.0 associée.
La structure de ce nœud correspond à la norme VAST 4.2 pour les IconClickFallbackImages, à l'exception de l'ajout de l'attribut program.
--IconClickFallbackImage width Largeur préférée pour afficher l'image.
height Hauteur recommandée pour afficher l'image.
---AltText Description accessible de l'image.
---StaticResource creativeType Type MIME de l'image de remplacement.
Valeur CDATA contenant l'URL de l'image de remplacement.

Exemple de réponse 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>

Analyser les choix publicitaires à partir du JSON des métadonnées de l'API DAI

Lorsque vous utilisez l'API d'insertion dynamique d'annonces, les informations sur Choisir sa pub sont transmises via l'objet JSON renvoyé par les requêtes à l'URL des métadonnées.

L'objet JSON des métadonnées contient une liste d'annonces, indexées par leur ID. Chaque objet d'annonce contient un tableau d'icônes. Si l'annonce en question utilise Choisir sa pub, l'icône Choisir sa pub est contenue dans ce tableau.

Format d'icône JSON

Le format d'icône JSON est une traduction 1:1 de la norme VAST 4.2 pour les icônes (section 3.11), dans la mesure du possible. Toutefois, pour prendre en charge le format JSON plus strict, certains attributs ont été renommés, si nécessaire.

Format JSON des icônes

programme Pour l'icône Choisir sa pub, cette valeur contient toujours la chaîne "GoogleWhyThisAd".
x_position Position horizontale du coin supérieur gauche de l'icône, par rapport au coin supérieur gauche de la création vidéo, en pixels. Ce champ accepte également les valeurs de position responsives "right" (droite) ou "left" (gauche).
y_position Position verticale du coin supérieur gauche de l'icône, par rapport au coin supérieur gauche de la création vidéo, en pixels. Ce champ accepte également les valeurs de position responsives "top" ou "bottom".
width Largeur de l'icône, en pixels.
height Hauteur de l'icône, en pixels.
creative_type Type MIME de l'image fournie pour l'icône. La valeur par défaut est "image/png".
ressource URL permettant de récupérer l'icône Choisir sa pub.
alt_text Texte alternatif à afficher pour l'icône Choisir sa pub.
click_data Objet contenant la propriété click_data.url qui représente l'URL vers laquelle les spectateurs sont redirigés s'ils cliquent sur l'icône "Choisir sa pub" sur une plate-forme compatible avec la navigation Web.
click_fallback_images Tableau d'objets image à afficher aux spectateurs qui cliquent sur l'icône "Choix de pub" sur les plates-formes qui ne sont pas compatibles avec la navigation Web.

Format JSON de l'image de remplacement

width Largeur de l'image de remplacement, en pixels.
height Hauteur de l'image de remplacement en pixels.
creative_type Type MIME de l'image de remplacement. La valeur par défaut est "image/png".
ressource URL permettant de récupérer l'image de remplacement.
alt_text Texte alternatif à afficher pour l'image de remplacement.

Exemple de métadonnées 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}