Ikona i nakładka Informacja

Wszystkie aplikacje, które wyświetlają reklamy spersonalizowane hostowane przez Google, muszą stosować: ikonę AdChoices i (jeśli zostały dostarczone przez Google). Informacja (inaczej „Dlaczego ta reklama?”) to funkcja, która wyjaśnia użytkownikom, dlaczego wyświetlamy im oraz informacje o sposobie ochrony prywatności.

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

Z tego przewodnika dowiesz się, jak wyodrębnić informacje niezbędne do prawidłowego dodaj funkcję Informacja z odpowiedzi XML VAST reklamy lub tagu DAI odpowiedzi metadanych.

Wymagania dotyczące renderowania AdChoices

Aby spełniać wymagania Google dotyczące renderowania ikony AdChoices, aplikacja lub witryna musi być zgodna z tymi standardami:

  1. Ikona Informacja musi być wyświetlana na każdej reklamie, w której przypadku jest ona udostępniana.
  2. Ikona Informacja musi być wyświetlana w miejscu oznaczonym symbolem „X” lokalizacja i „lokalizacja na osi Y” właściwości zawartych w danych ikon oraz na stronie rozmiar określony przez właściwości szerokości i wysokości w niezależnych od gęstości Piksele (DP).
  3. Ikona Informacja nie może być zasłonięta przez inne nakładki reklamowe ani elementy interfejsu.
  4. 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.
  5. 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”.
  6. 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”.
  7. Na platformach, na których nie ma obsługi przeglądarki, obraz zastępczy musi być wyświetlany w rozmiarze określonym w właściwości „IconClickFallbackImage” lub „click_fallback_images” w pikselach niezależnych od gęstości (DP).

Analizowanie informacji AdChoices na podstawie odpowiedzi XML VAST

W przypadku pracy z odpowiedzią reklamy XML usługa AdChoices jest obsługiwana tylko w formacie VAST wersji 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 standardowy, Informacja jest dostarczana 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 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 aplikacja lub strona w pełni obsługuje standard VAST 3.0, a jeśli platforma jest jak przejść do docelowego adresu URL i wyświetlić tę ikonę, nie wymaga dalszej pracy.

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 „IconFallbackImages” gdzie „program” pasuje do ikony uwzględnionej w 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.

W związku z przyszłymi zmianami standardu Informacja zalecamy włączenie obsługi obrazów zastępczych dla wszystkich ikon VAST, gdy i dostępności informacji. Możesz skorzystać z tego przykładowego VAST 3.0 xml do dodatkowych testów 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ązanego VAST Ikona 3.0.
Struktura tego węzła odpowiada standardowi VAST 4.2 w przypadku IconClickFallbackImages, oprócz dodania funkcji program .
--IconClickFallbackImage szerokość Preferowana szerokość wyświetlania obrazu.
wysokość Preferowana wysokość wyświetlania obrazu.
---AltText Opis obrazu obsługujący ułatwienia dostępu.
---StaticResource creativeType Typ MIME obrazu zastępczego.
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>

Przeanalizuj opcje AdChoices z metadanych interfejsu DAI API w formacie JSON

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 usługi 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 znaków „GoogleWhyThisAd”.
x_position Pozycja pozioma lewego górnego rogu ikony względem lewego górnego rogu kreacji wideo w pikselach. To pole akceptuje też wartość pozycji elastycznej to „right”; lub „w lewo”.
y_position Pionowe położenie lewego górnego rogu ikony względem lewy górny róg kreacji wideo (w pikselach). To pole akceptuje również elastyczne wartości pozycji „góra” lub „dół”.
szerokość Szerokość ikony w pikselach.
wysokość Wysokość ikony w pikselach.
creative_type Typ MIME obrazu dla ikony. Domyślna wartość to „image/png”.
zasób Adres URL ikony 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, do którego mają być kierowani widzowie, jeśli klikną 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 zastępczego w pikselach.
wysokość Wysokość obrazu zastępczego w pikselach.
creative_type Typ MIME obrazu zastępczego. Domyślna wartość to „image/png”.
zasób Adres URL do pobierania obrazu zastępczego.
alt_text Tekst alternatywny do renderowania 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}