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

Ikona i nakładka Informacja

Wszystkie aplikacje, w których wyświetlają się reklamy spersonalizowane hostowane przez Google, muszą zawierać ikonę AdChoices i nakładkę, jeśli są dostarczane przez Google. Informacja (zwana też „Dlaczego ta reklama?”) to funkcja związana z przejrzystością, która wyjaśnia użytkownikom, dlaczego wyświetla się im konkretną reklamę, oraz podaje informacje o tym, jak chronimy ich prywatność.

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

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

Wymagania dotyczące renderowania Informacja

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

Ikona Informacja musi być wyświetlana na tle każdej reklamy, która jest dostarczana
Ikona Informacja musi być wyświetlana w pozycji wskazywanej przez właściwości „X lokalizacja” i „lokalizacja Y” zawarte w danych ikony oraz w rozmiarze określonym przez właściwości szerokości i wysokości, w polu pikseli niezależnych od gęstości (DP).
Ikona Informacja nie może być zasłonięta innymi nakładkami na reklamy ani elementami interfejsu.
Na platformach z obsługą kliknięć lub z odpowiednimi funkcjami (np. z wyborem dotykowym lub zdalnym) ikona Informacja musi być klikalna.
Na platformach obsługujących przeglądarkę kliknięcie ikony Informacja musi otworzyć kartę lub okno przeglądarki z adresem URL określonym we właściwości „ClickThrough” lub „click_data”.
Na platformach, które nie obsługują przeglądarek, kliknięcie ikony Informacja musi otworzyć nakładkę modalną zawierającą jeden z obrazów określonych we właściwości „IconClickFallbackImage” lub „click_fallback_images”.
Na platformach, które nie obsługują przeglądarek, 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 wartości AdChoices z odpowiedzi XML VAST

W przypadku pracy z odpowiedzią na żądanie reklamy XML element Informacja jest obsługiwany tylko w VAST w wersji 3.0 i nowszych. Wartość Informacja jest implementowana jako ikona VAST.

VAST 4.2

Jeśli odpowiedź reklamy XML jest zgodna ze standardem VAST 4.2, komponent Informacja jest wyświetlany w postaci ikony 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 Informacja nie wymaga dalszych 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, biorąc pod uwagę ten standard. Aby przeprowadzić dodatkowe testy w aplikacji, możesz użyć tego przykładowego pliku VAST 4.2 w formacie XML.

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, funkcja Informacja jest wyświetlana jako połączenie ikony VAST i niestandardowego rozszerzenia VAST. Jeśli Twoja aplikacja lub witryna w pełni obsługuje standard VAST 3.0 Icon, a platforma umożliwia przejście do docelowego adresu URL ikony i jej wyświetlenie, obsługa Informacja nie wymaga już więcej pracy.

Jeśli Twoja platforma nie może otwierać i wyświetlać docelowych adresów URL (dotyczy to głównie urządzeń bez zintegrowanej przeglądarki), musisz wdrożyć obsługę rozszerzenia „IconFallbackImages”. To rozszerzenie zawiera zestaw tagów „IconFallbackImages”, w których atrybut „program” odpowiada ikonie uwzględnionej w VAST.

Aby w pełni obsługiwać funkcję Informacja, tag IconFallbackImages o nazwie programu musi być powiązany z ikoną o nazwie programu „GoogleWhyThisAd”. Dzięki temu, gdy użytkownik wejdzie w interakcję z tą ikoną, pojawi się powiązany z nią obraz zastępczy.

Aby możliwe było wprowadzenie w przyszłości zmian w standardzie Informacja, zdecydowanie zalecamy wprowadzenie obsługi obrazów zastępczych w przypadku wszystkich ikon VAST, jeśli jest dostępna. Do dodatkowych testów w aplikacji możesz użyć tego przykładowego VAST 3.0 XML.

Struktura rozszerzenia IconFallbackImages

Oznacz	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 odpowiada standardowi VAST 4.2 w przypadku IconClickFallbackImages, z wyjątkiem dodania atrybutu `program`.
– IconClickFallbackImage	szerokość	Preferowana szerokość wyświetlania obrazu.
– IconClickFallbackImage	wysokość	Preferowana wysokość wyświetlania obrazu.
---AltText		Opis obrazu z ułatwieniami 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>

Analizuj element AdChoices z metadanych interfejsu DAI API w formacie JSON

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

Obiekt JSON Metadata zawiera listę reklam kluczowych na podstawie identyfikatora adID. W każdym obiekcie reklamy znajduje się tablica ikon. Jeśli reklama korzysta z funkcji Informacja, ikona Informacja znajduje się w tej tablicy.

Format ikon JSON

Jeśli to możliwe, ikona w formacie JSON jest tłumaczeniem 1:1 ze standardowej ikony VAST 4.2 (sekcja 3.11). Jednak ze względu na obsługę bardziej rygorystycznego formatu JSON niektóre atrybuty w razie potrzeby zmieniły nazwy.

Format JSON ikony

program	W przypadku ikony Informacja ta wartość zawsze zawiera ciąg „GoogleWhyThisAd”.
x_position	Poziome położenie lewego górnego rogu ikony względem lewego górnego rogu kreacji wideo (w pikselach). To pole akceptuje też wartości elastycznej pozycji „right” (prawa) i „left” (lewo).
y_position	Położenie pionowego lewego górnego rogu ikony (w pikselach) względem lewego górnego rogu kreacji wideo. To pole akceptuje też elastyczne wartości pozycji „top” lub „bottom”.
szerokość	Szerokość ikony w pikselach.
wysokość	Wysokość ikony w pikselach.
creative_type	Typ MIME obrazu ikony. Wartość domyślna to „image/png”.
zasób	Adres URL do pobrania ikony Informacja.
alt_text	Tekst alternatywny do renderowania ikony Informacja.
click_data	Obiekt zawierający właściwość `click_data.url` reprezentującą adres URL, na który mają być kierowani widzowie po kliknięciu ikony Informacja na platformie obsługującej przeglądanie internetu.
click_fallback_images	Tablica obiektów graficznych wyświetlanych widzom, którzy klikną ikonę Informacja na platformach nieobsługujących przeglądania internetu.

Format JSON obrazu zastępczego

szerokość	Szerokość obrazu zastępczego wyrażona w pikselach.
wysokość	Wysokość obrazu zastępczego wyrażona w pikselach.
creative_type	Typ MIME obrazu zastępczego. Wartość domyślna to „image/png”.
zasób	Adres URL pobierania obrazu zastępczego.
alt_text	Tekst alternatywny do renderowania 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}