Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Ikona i nakładka Informacja

Wszystkie aplikacje, które wyświetlają reklamy hostowane przez Google, muszą implementować ikonę AdChoices i nakładkę, jeśli są one udostępniane przez Google. Informacja (nazywana też „Dlaczego ta reklama?”) to funkcja zapewniająca przejrzystość, która wyjaśnia użytkownikom, dlaczego wyświetla im się dana reklama, i zawiera informacje o tym, jak chroniona jest ich prywatność. Szczegółowe informacje znajdziesz w artykule Informacja w usłudze Google Ad Manager.

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

Z tego przewodnika dowiesz się, jak wyodrębnić niezbędne informacje, aby prawidłowo wdrożyć Informacje w odpowiedzi XML VAST reklamy lub w odpowiedzi metadanych strumienia DAI.

Wymagania dotyczące renderowania ikony Informacja

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

Ikona Informacja musi być wyświetlana jako nakładka na każdą reklamę, w przypadku której jest udostępniana.
Ikona Informacja musi być wyświetlana w miejscu wskazanym przez właściwości „X location” i „Y location” zawarte w danych ikony oraz w rozmiarze określonym przez właściwości szerokości i wysokości 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 obsługujących kliknięcia lub ich odpowiedniki (np. dotyk lub wybór za pomocą pilota) ikona Informacja musi być klikalna.
Na platformach obsługujących przeglądarki kliknięcie ikony Informacja musi otwierać kartę przeglądarki lub okno z adresem URL określonym we właściwości „ClickThrough” lub „click_data”.
Na platformach, które nie obsługują przeglądarki, kliknięcie ikony Informacja musi otwierać nakładkę modalną z jednym z obrazów określonych we właściwości „IconClickFallbackImage” lub „click_fallback_images”.
Na platformach bez obsługi przeglądarki obraz zastępczy musi być wyświetlany w rozmiarze określonym we właściwości „IconClickFallbackImage” lub „click_fallback_images” w pikselach niezależnych od gęstości (DP).

Analizowanie ikony Informacja na podstawie odpowiedzi XML VAST

W przypadku odpowiedzi na żądanie reklamy w formacie XML ikona Informacja jest obsługiwana tylko w VAST w wersji 3.0 i nowszych. Ikona Informacja jest implementowana jako element Icon w VAST.

VAST 4.2

Jeśli odpowiedź na żądanie reklamy w formacie XML jest zgodna ze standardem VAST 4.2, Informacja 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 Informacji 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” z odpowiedzi VAST na podstawie tego standardu. Do dodatkowych testów w aplikacji możesz użyć tego przykładowego pliku XML VAST 4.2.

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ź na żądanie reklamy w formacie XML jest zgodna ze standardem VAST 3.0, Informacja jest dostarczana jako połączenie ikony VAST i niestandardowego rozszerzenia VAST. Jeśli Twoja aplikacja lub witryna w pełni obsługuje standard ikony VAST 3.0 i jeśli platforma może przejść do adresu URL kliknięcia ikony i go wyświetlić, obsługa Informacji nie wymaga żadnych dodatkowych działań.

Jeśli Twoja platforma nie może przejść do adresów URL kliknięcia i ich wyświetlić (dotyczy to głównie urządzeń, które nie mają zintegrowanej 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 dołączonej do VAST.

Aby w pełni obsługiwać Informacje, tag IconFallbackImages z nazwą programu „GoogleWhyThisAd” musi być powiązany z ikoną z nazwą programu „GoogleWhyThisAd”, tak aby po wejściu użytkownika w interakcję z ikoną wyświetlał się powiązany obraz zastępczy.

Aby uwzględnić potencjalne przyszłe zmiany w standardzie Informacja, zdecydowanie zalecamy włączenie obsługi obrazów zastępczych dla wszystkich ikon VAST, jeśli są dostępne. Do dodatkowych testów w aplikacji możesz użyć tego przykładowego pliku XML VAST 3.0.

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 dotyczącym elementu IconClickFallbackImages, z wyjątkiem dodania 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 informacji AdChoices z pliku JSON z metadanymi interfejsu DAI API

Podczas pracy z interfejsem DAI API szczegóły AdChoices są przekazywane przez obiekt JSON zwracany przez żądania wysyłane na adres URL metadanych.

Obiekt JSON metadanych zawiera listę reklam, których kluczem jest identyfikator reklamy. W każdym obiekcie reklamy znajduje się tablica icons. Jeśli dana reklama korzysta z Informacji, w tej tablicy znajduje się ikona Informacja.

Format ikony JSON

Format ikony JSON jest w miarę możliwości 1:1 tłumaczeniem standardu ikony VAST 4.2 (sekcja 3.11). Aby jednak obsługiwać bardziej rygorystyczny format JSON, w razie potrzeby zmieniliśmy nazwy niektórych atrybutów.

Format JSON ikony

program	W przypadku ikony Informacja ta wartość zawsze zawiera ciąg znaków „GoogleWhyThisAd”.
x_position	Położenie poziome lewego górnego rogu ikony względem lewego górnego rogu kreacji wideo w pikselach. To pole akceptuje też wartości pozycji elastycznej „right” (prawa) lub „left” (lewa).
y_position	Pozycja w pionie lewego górnego rogu ikony względem lewego górnego rogu kreacji wideo (w pikselach). To pole akceptuje też wartości pozycji elastycznej „top” (góra) lub „bottom” (dół).
szerokość	Szerokość ikony w pikselach.
wysokość	Wysokość ikony w pikselach.
creative_type	Typ MIME obrazu podanego dla ikony. Domyślnie jest to „image/png”.
zasób	URL, z którego można pobrać ikonę Informacja.
alt_text	Tekst alternatywny do renderowania ikony Informacja.
click_data	Obiekt zawierający właściwość `click_data.url`, która reprezentuje adres URL, na który mają być kierowani widzowie, jeśli klikną ikonę Informacja na platformie obsługującej przeglądanie internetu.
click_fallback_images	Tablica obiektów obrazu do wyświetlania widzom, którzy klikną ikonę AdChoices na platformach, które nie obsługują przeglądania internetu.

Format JSON obrazu zastępczego

szerokość	Szerokość obrazu zastępczego w pikselach.
wysokość	Wysokość obrazu zastępczego w pikselach.
creative_type	Typ MIME obrazu zastępczego. Domyślnie jest to „image/png”.
zasób	Adres URL, z którego można pobrać obraz zastępczy.
alt_text	Tekst alternatywny, który ma być renderowany w przypadku obrazu zastępczego.

Przykładowy plik JSON z metadanymi

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