Ta strona została przetłumaczona przez Cloud Translation API.

Ikona i nakładka Informacja

Wszystkie aplikacje wyświetlające spersonalizowane reklamy hostowane przez Google muszą zawierać ikonę i nakładkę AdChoices, jeśli są one udostępniane przez Google. AdChoices (inaczej „Dlaczego ta reklama?”) to funkcja związana z przejrzystością, która wyjaśnia użytkownikom, dlaczego wyświetla im się konkretna reklama, i dostarcza informacji o sposobie ochrony ich prywatności.

Więcej informacji znajdziesz w artykule Dlaczego widzisz daną reklamę.

Z tego przewodnika dowiesz się, jak wyodrębnić niezbędne informacje do prawidłowego wdrożenia funkcji AdChoices z odpowiedzi XML VAST reklamy lub odpowiedzi metadanych strumienia DAI.

Wymagania dotyczące renderowania AdChoices

Aby spełniać wymagania Google dotyczące renderowania ikony AdChoices, aplikacja lub witryna musi spełniać te standardy:

Ikona Informacja musi być wyświetlana na każdej reklamie, w której przypadku jest ona udostępniana.
Ikona Informacja musi być wyświetlana w pozycji wskazanej przez właściwości „X location” i „Y location” zawarte w danych ikony oraz w rozmiarze zdefiniowanym przez właściwości szerokość i wysokość w pikselach niezależnych od gęstości (DP).
Ikona Informacja nie może być zasłonięta przez inne nakładki reklamowe ani elementy interfejsu.
Na platformach, które obsługują klikanie lub równoważną funkcję (np. dotyk lub wybór za pomocą pilota), ikona Informacja musi być klikalna.
Na platformach, na których jest obsługiwana przeglądarka, kliknięcie ikony Informacja musi otwierać kartę lub okno przeglądarki z adresem URL określonym w właściwości „ClickThrough” lub „click_data”.
Na platformach bez obsługi przeglądarki kliknięcie ikony Informacja musi powodować otwarcie nakładki modalnej z jednym z obrazów określonych w atrybucie „IconClickFallbackImage” lub „click_fallback_images”.
Na platformach, na których nie ma obsługi przeglądarki, obraz zastępczy musi być wyświetlany w rozmiarze określonym w atrybucie „IconClickFallbackImage” lub „click_fallback_images” w pikselach niezależnych od gęstości (DP).

Analizowanie informacji AdChoices na podstawie odpowiedzi XML VAST

Podczas pracy z odpowiedzią reklamy XML ikona Informacja jest obsługiwana tylko w wersji VAST 3.0 i nowszych. Ikona Informacja jest implementowana jako ikona VAST.

VAST 4.2

Jeśli odpowiedź reklamy XML jest zgodna ze standardem VAST 4.2, ikona AdChoices jest dostarczana jako ikona VAST. Jeśli Twoja aplikacja lub witryna w pełni obsługuje ikony VAST 4.2 (sekcja 3.11 standardu VAST 4.2), obsługa AdChoices nie wymaga żadnych dodatkowych działań.

Jeśli Twoja aplikacja nie obsługuje ikon VAST 4.2, musisz ręcznie przeanalizować ikony z nazwą programu „GoogleWhyThisAd” w odpowiedzi VAST na podstawie tego standardu. Możesz użyć tego przykładowego pliku VAST 4.2 w formacie XML do dodatkowego testowania w aplikacji.

Przykładowa odpowiedź 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

Jeśli odpowiedź reklamy XML jest zgodna ze standardem VAST 3.0, ikona AdChoices jest dostarczana jako kombinacja ikony VAST i niestandardowego rozszerzenia VAST. Jeśli Twoja aplikacja lub witryna jest w pełni zgodna ze standardem ikony VAST 3.0 i jeśli platforma może przejść do adresu URL kliknięcia ikony i go wyświetlić, obsługa AdChoices nie wymaga żadnych dodatkowych działań.

Jeśli Twoja platforma nie może przechodzić do adresów URL z przekierowaniem ani ich wyświetlać (dotyczy to głównie urządzeń bez wbudowanej przeglądarki internetowej), musisz wdrożyć obsługę rozszerzenia „IconFallbackImages”. To rozszerzenie zawiera zestaw tagów „IconFallbackImages”, w których atrybut „program” pasuje do ikony uwzględnionej w pliku VAST.

Aby zapewnić pełną obsługę AdChoices, tag IconFallbackImages o nazwie programu „GoogleWhyThisAd” musi być powiązany z ikoną o nazwie programu „GoogleWhyThisAd”, tak aby po kliknięciu ikony wyświetlał się powiązany obraz zastępczy.

Aby umożliwić obsługę potencjalnych przyszłych zmian standardu AdChoices, zdecydowanie zalecamy uwzględnienie obsługi obrazu zastępczego dla wszystkich ikon VAST (w razie ich dostępności). Możesz użyć tego przykładowego tagu VAST 3.0 xml do dodatkowego testowania w aplikacji.

Struktura rozszerzenia IconFallbackImages

Tag	Atrybuty	Opis
Rozszerzenie	typ	W przypadku tego rozszerzenia typ zawsze zawiera wartość `IconClickFallbackImages`.
–IconClickFallbackImages	program	Ten atrybut zawsze pasuje do atrybutu programu powiązanej ikony VAST 3.0.
–IconClickFallbackImages		Struktura tego węzła jest zgodna ze standardem VAST 4.2 w przypadku atrybutu IconClickFallbackImages, z wyjątkiem dodatkowego atrybutu `program`.
--IconClickFallbackImage	szerokość	Preferowana szerokość wyświetlania obrazu.
--IconClickFallbackImage	wysokość	Preferowana wysokość wyświetlania obrazu.
---AltText		Opis obrazu obsługujący ułatwienia dostępu.
---StaticResource	creativeType	Typ MIME obrazu zastępczego.
---StaticResource		Wartość CDATA zawierająca adres URL obrazu zastępczego.

Przykładowa odpowiedź 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>

Analizowanie ustawień AdChoices z pliku metadanych JSON interfejsu DAI API

Podczas pracy z interfejsem DAI API szczegóły dotyczące AdChoices są przekazywane za pomocą obiektu JSON zwracanego przez żądania do adresu URL metadanych.

Obiekt JSON metadanych zawiera listę reklam z kluczem identyfikatora reklamy. Każdy obiekt ad zawiera tablicę ikon. Jeśli reklama korzysta z AdChoices, w tym tablicy znajduje się ikona Informacja.

Format ikony JSON

Format ikony w formacie JSON jest w miarę możliwości kopią formatu standardu ikony VAST 4.2 (sekcja 3.11). Jednak ze względu na obsługę bardziej rygorystycznego formatu JSON nazwy niektórych atrybutów zostały zmienione w niektórych przypadkach.

Format JSON ikony

program	W przypadku ikony Informacja ta wartość zawsze zawiera ciąg „GoogleWhyThisAd”.
x_position	Pozycja pozioma lewego górnego rogu ikony względem lewego górnego rogu kreacji wideo w pikselach. W tym polu możesz też użyć wartości „prawo” lub „lewo” w przypadku wersji responsywnej.
y_position	Pozycja pionowa lewego górnego rogu ikony względem lewego górnego rogu kreacji wideo w pikselach. W tym polu możesz też użyć wartości pozycji w układance „góra” lub „dół”.
szerokość	Szerokość ikony w pikselach.
wysokość	Wysokość ikony w pikselach.
creative_type	Typ MIME obrazu użytego jako ikona. Domyślna wartość to „image/png”.
zasób	Adres URL ikony Informacja.
alt_text	Tekst alternatywny do wyrenderowania dla ikony Informacja.
click_data	Obiekt zawierający właściwość `click_data.url`, która reprezentuje adres URL, do którego odsyła się widzów, gdy kliknie ikonę Informacje na platformie obsługującej przeglądanie stron internetowych.
click_fallback_images	Tablica obiektów obrazu, które mają się wyświetlać widzom, którzy klikną ikonę AdChoices na platformach, które nie obsługują przeglądania stron internetowych.

Format pliku JSON obrazu zastępczego

szerokość	Szerokość obrazu zapasowego w pikselach.
wysokość	Wysokość obrazu zapasowego w pikselach.
creative_type	Typ MIME obrazu zastępczego. Domyślna wartość to „image/png”.
zasób	Adres URL do pobrania obrazu zastępczego.
alt_text	Tekst alternatywny do wyrenderowania dla obrazu zastępczego.

Przykładowe metadane w formacie 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}