Questa pagina è stata tradotta dall'API Cloud Translation.

Icona e overlay Scegli Tu!

Tutte le app che mostrano annunci personalizzati ospitate da Google devono implementare il AdChoices e di testo, se fornito da Google. Scegli Tu! (indicata anche come "Perché questo annuncio?") è una funzionalità di trasparenza che spiega agli utenti perché gli viene mostrato un un annuncio specifico e fornisce informazioni su come viene protetta la privacy.

Per ulteriori informazioni, consulta la sezione Perché viene visualizzato un annunci.

Questa guida spiega come estrarre correttamente le informazioni necessarie implementa Scegli Tu! dalla risposta XML VAST dell'annuncio o dallo stream DAI risposta dei metadati.

Requisiti per il rendering Scegli Tu!

Per rispettare i requisiti di Google relativi al rendering delle icone Scegli Tu!, la tua app o il sito web deve soddisfare i seguenti standard:

L'icona Scegli Tu! deve essere visualizzata in sovrapposizione agli annunci a cui è associata fornito
L'icona Scegli Tu! deve essere visualizzata nella posizione indicata dalla "X posizione" e "posizione Y" incluse nei dati dell'icona e alla dimensione definita dalle proprietà di larghezza e altezza, indipendentemente dalla densità Pixel (DP).
L'icona Scegli Tu! non deve essere oscurata da altri overlay di annunci o da un'altra interfaccia. elementi.
Sulle piattaforme con supporto dei clic o equivalente (ad es. tocco o selezione remota), L'icona Scegli Tu! deve essere cliccabile.
Sulle piattaforme che supportano il browser, se fai clic sull'icona Scegli Tu! deve aprire una scheda o finestra del browser con l'URL specificato nella sezione "Click-through" o "dati_clic" proprietà.
Sulle piattaforme che non supportano il browser, se fai clic sull'icona Scegli Tu! devi aprire una overlay modale, che mostra una delle immagini specificate nel "IconClickFallbackImage" o "click_fallback_images" proprietà.
Sulle piattaforme che non supportano il browser, l'immagine di riserva deve essere visualizzata all'indirizzo la dimensione specificata all'interno della sezione "IconClickFallbackImage" o "immagini_di_fallback_clic" in pixel indipendenti dalla densità (DP).

Analizza Scegli Tu! da una risposta XML VAST

Quando lavori con una risposta di annuncio XML, Scegli Tu! è supportato solo in VAST versione 3.0 e successive. Scegli Tu! è implementato come icona VAST.

VAST 4.2

Se la risposta all'annuncio XML è conforme a VAST 4.2 standard, Scegli Tu! viene pubblicata come icona VAST. Se la tua app o il tuo sito web supporta completamente Icone VAST 4.2 (sezione 3.11 dello standard VAST 4.2), supporto per Scegli Tu! non richiede ulteriori interventi.

Se la tua app non supporta le icone VAST 4.2, devi analizzare manualmente le icone. con il nome del programma "GoogleWhyThisAd" dalla tua risposta VAST, sulla base di ciò standard. Puoi utilizzare questo esempio di file xml VAST 4.2 per ulteriori test nella tua app.

Esempio di risposta 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

Se la risposta all'annuncio XML è conforme a VAST 3.0 standard, Scegli Tu! pubblicati come combinazione di un'icona VAST e un'estensione VAST personalizzata. Se le tue l'app o il sito web supporta completamente lo standard delle icone VAST 3.0 e, se la piattaforma accedere all'URL di clickthrough dell'icona e visualizzarlo, il supporto per Scegli Tu! non richiede ulteriori interventi.

Se la tua piattaforma non è in grado di accedere e di visualizzare il clickthrough URL. Questo vale principalmente per i dispositivi che non dispongono di un server web browser: devi implementare il supporto per "IconFallbackImages" . Questa estensione contiene un insieme di "IconFallbackImages" i tag in cui il "programma" corrisponde a un'icona inclusa nel codice VAST.

Per supportare completamente Scegli Tu!, il tag IconFallbackImages con il nome del programma "GoogleWhyThisAd" deve essere associato all'icona con il nome del programma "GoogleWhyThisAd", in modo che quando l'utente interagisce con l'icona, l'immagine di riserva associata.

Per supportare potenziali modifiche future allo standard Scegli Tu!, consigliamo di incorporare il supporto delle immagini di riserva per tutte le icone VAST, quando disponibili. Puoi utilizzare questo esempio di VAST 3.0 XML per ulteriori test nella tua app.

Struttura dell'estensione IconFallbackImages

Tag	Attributi	Descrizione
Estensione	tipo	Per questa estensione, il tipo contiene sempre il valore `IconClickFallbackImages`.
-IconClickFallbackImages	programma	Questo attributo corrisponde sempre all'attributo del programma di un VAST associato 3.0.
-IconClickFallbackImages		La struttura di questo nodo corrisponde allo standard VAST 4.2 per IconClickFallbackImages, fatta eccezione per l'aggiunta di `program` .
--IconClickFallbackImage	larghezza	La larghezza preferita per visualizzare l'immagine.
--IconClickFallbackImage	altezza	L'altezza preferita per la visualizzazione dell'immagine.
---AltText		Una descrizione accessibile dell'immagine.
---StaticResource	creativeType	Il tipo MIME dell'immagine di riserva.
---StaticResource		Un valore CDATA contenente l'URL dell'immagine di riserva.

Esempio di risposta 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>

Analizza Scegli Tu! dal file JSON dei metadati dell'API DAI

Quando si utilizza il DAI API, i dettagli di Scegli Tu! passa attraverso l'oggetto JSON restituito dalle richieste ai metadati URL.

L'oggetto JSON Metadata contiene un elenco di annunci, codificati dall'ID annuncio. All'interno di ogni è un array di icone. Se l'annuncio in questione utilizza Scegli Tu!, L'icona Scegli Tu! è contenuta nell'array.

Formato icona JSON

Il formato delle icone JSON è una traduzione 1:1 dall'icona VAST 4.2 standard (sezione 3.11), ove possibile. Tuttavia, per supportare i file JSON più rigidi, , alcuni attributi hanno cambiato nome, se necessario.

Formato JSON icona

programma	Per l'icona Scegli Tu!, questo valore contiene sempre la stringa "GoogleWhyThisAd".
x_position	La posizione orizzontale dell'angolo in alto a sinistra dell'icona, rispetto a nell'angolo in alto a sinistra della creatività video, in pixel. Questo campo accetta anche i valori di posizione adattabili "right" o "sinistra".
y_position	La posizione verticale dell'angolo in alto a sinistra dell'icona, rispetto al angolo in alto a sinistra della creatività video, in pixel. Questo campo accetta anche valori di posizione adattabili "top" o "in basso".
larghezza	La larghezza dell'icona, in pixel.
altezza	L'altezza dell'icona, in pixel.
creative_type	Il tipo MIME dell'immagine fornita per l'icona. Il valore predefinito è "image/png".
risorsa	L'URL per recuperare l'icona Scegli Tu!.
alt_text	Il testo alternativo da visualizzare per l'icona Scegli Tu!.
click_data	Un oggetto contenente la proprietà `click_data.url` che rappresenta l'URL a cui indirizzare gli spettatori se fanno clic sull'icona Scegli Tu! che supporta la navigazione sul web.
click_fallback_images	Un array di oggetti immagine da mostrare agli utenti che fanno clic su Scegli Tu! su piattaforme che non supportano la navigazione sul web.

Formato JSON immagine di riserva

larghezza	La larghezza dell'immagine di riserva, in pixel.
altezza	L'altezza dell'immagine di riserva, in pixel.
creative_type	Il tipo MIME dell'immagine di riserva. Il valore predefinito è "image/png".
risorsa	L'URL per recuperare l'immagine di riserva.
alt_text	Il testo alternativo da visualizzare per l'immagine di riserva.

JSON di metadati di esempio

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