Cette page a été traduite par l'API Cloud Translation.

Icône et superposition Choisir sa pub

Toutes les applications qui diffusent des annonces personnalisées hébergées par Google doivent implémenter l'icône et le calque Choisir sa pub, le cas échéant. "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 vie privée est protégée.

Pour en savoir plus, consultez l'article Raisons pour lesquelles un annonce.

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 de 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 Choisir sa pub, votre application ou votre site Web doit respecter les normes suivantes:

L'icône Choisir sa pub doit se superposer aux annonces pour lesquelles elle est fourni
L'icône Choisir sa pub doit s'afficher à la position indiquée par les propriétés "Position X" et "Position 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).
L'icône "Choisir sa pub" ne doit pas être masquée par d'autres superpositions d'annonces ou éléments d'interface.
Sur les plates-formes compatibles avec les clics ou un équivalent (par exemple, la sélection tactile ou à distance), l'icône Choisir sa pub doit être cliquable.
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".
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".
Sur les plates-formes qui ne sont pas compatibles avec les navigateurs, l'image de remplacement doit être affichée sur la taille spécifiée dans la colonne "IconClickFallbackImage" ; ou "click_fallback_images" dans les pixels indépendants de la densité (DP).

Analyser les choix publicitaires à partir d'une réponse XML VAST

Lorsque vous utilisez une réponse d'annonce XML, AdChoices n'est compatible qu'avec la version 3.0 de VAST et les versions ultérieures. Elle se présente sous la forme d'une icône VAST.

VAST 4.2

Si votre réponse d'annonce XML respecte la norme VAST 4.2 standard, "Choisir sa pub" s'affiche sous la forme d'une icône VAST. Si votre application ou votre site Web est entièrement compatible avec les icônes VAST 4.2 (section 3.11 de la norme VAST 4.2), la prise en charge d'AdChoices ne nécessite aucune autre action.

Si votre application n'est pas compatible avec les icônes VAST 4.2, vous devez analyser manuellement les icônes avec le nom du programme "GoogleWhyThisAd" à partir de votre réponse VAST, conformément à 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 respecte la norme VAST 3.0 standard, Choisir sa pub est diffusées sous la forme d'une icône VAST et d'une extension VAST personnalisée. Si votre application ou votre site Web est entièrement compatible avec la norme d'icône VAST 3.0 et si la plate-forme peut accéder à l'URL de clic sur l'icône et l'afficher, la prise en charge d'AdChoices ne nécessite aucune autre action.

Si votre plate-forme ne parvient pas à accéder aux URL de suivi des clics et à 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 d'éléments "IconFallbackImages" les balises où le "programme" correspond à une icône incluse dans le fichier VAST.

Pour une compatibilité totale avec AdChoices, la balise IconFallbackImages avec le nom du programme "GoogleWhyThisAd" doit être associée à l'icône avec le nom du programme "GoogleWhyThisAd", de sorte que lorsque l'utilisateur interagit avec l'icône, l'image de remplacement associée s'affiche.

Pour prendre en charge les futures modifications potentielles de la norme AdChoices, 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 VAST 3.0 xml pour 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 de programme d'une balise VAST associée Icône 3.0.
-IconClickFallbackImages		La structure de ce nœud est conforme à la norme VAST 4.2 pour IconClickFallbackImages, à l'exception de l'ajout de `program` .
--IconClickFallbackImage	largeur	Largeur recommandée pour afficher l'image.
--IconClickFallbackImage	hauteur	Hauteur préférée pour l'image.
---AltText		Description accessible de l'image.
---StaticResource	creativeType	Type MIME de l'image de remplacement.
---StaticResource		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 le fichier JSON des métadonnées de l'API d'insertion dynamique d'annonces parmi "Choisir sa pub"

Lorsque vous utilisez l'insertion dynamique d'annonce API, les détails de Choisir sa pub transmis via l'objet JSON qui est renvoyé par les requêtes aux métadonnées URL.

L'objet JSON "Metadata" contient une liste d'annonces, triées par identifiant d'annonce. Au sein de chaque est 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 à l'échelle 1:1 de la norme d'icône VAST 4.2 (section 3.11), dans la mesure du possible. Toutefois, pour prendre en charge le format JSON plus strict, certains attributs ont changé de nom, le cas échéant.

Format JSON des icônes

programme	Pour l'icône Choisir sa pub, cette valeur contient toujours la chaîne "GoogleWhyThisAd".
x_position	La position horizontale du coin supérieur gauche de l'icône, par rapport à l'angle supérieur gauche de la création vidéo, en pixels. Ce champ accepte également les valeurs de position responsive "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 responsive "top" ou "bottom".
largeur	Largeur de l'icône, en pixels.
hauteur	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 pour 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 à laquelle rediriger les spectateurs s'ils cliquent sur l'icône AdChoices sur une plate-forme compatible avec la navigation Web.
click_fallback_images	Tableau d'objets image à afficher auprès des internautes qui cliquent sur "Choisir sa pub" sur les plates-formes qui ne prennent pas en charge la navigation Web.

Format JSON de l'image de remplacement

largeur	Largeur de l'image de remplacement, en pixels.
hauteur	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 pour 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}