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. 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:

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 innymi nakładkami na reklamach ani interfejsem .
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 obsługujących przeglądarki po kliknięciu ikony Informacja karta lub okno przeglądarki z adresem URL określonym w kolumnie „ClickThrough” lub "click_data" usłudze.
Na platformach, które nie obsługują przeglądarek, kliknięcie ikony Informacja musi spowodować otwarcie nakładkę modalną wyświetlającą jeden z obrazów określonych w parametrze "IconClickFallbackImage" lub „click_fallback_images” usłudze.
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).

Analiza sekcji AdChoices z odpowiedzi XML VAST

Podczas pracy z odpowiedzią reklamy XML ikona Informacja jest obsługiwana tylko w wersji VAST 3.0 i nowszych. Informacja jest zaimplementowana 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 aplikacja lub witryna w pełni obsługuje Ikony VAST 4.2 (sekcja 3.11 standardu VAST 4.2), obsługa informacji nie wymaga dalszej pracy.

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 przejścia ikony i go wyświetlić, obsługa AdChoices nie wymaga żadnych dodatkowych działań.

Jeśli nie można przejść do Twojej platformy i wyświetlić wskaźnika klikalności adresów URL – dotyczy to głównie urządzeń, które nie mają zintegrowanej przeglądarki. przeglądarki – musisz zaimplementować obsługę 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 z nazwą programu „GoogleWhyThisAd” musi być powiązana z ikoną z nazwą programu. „GoogleWhyThisAd”, tak aby po interakcji użytkownika z ikoną 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 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.
–IconClickFallbackImages		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.
--IconClickFallbackImage	wysokość	Preferowana wysokość wyświetlania obrazu.
---AltText		Przystępny opis obrazu.
---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 korzystania z DAI API, szczegóły usługi AdChoices jest przesyłana przez obiekt JSON zwracany przez żądania do metadanych, Adres URL.

Obiekt JSON metadanych zawiera listę reklam powiązaną z identyfikatorem adID. 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 „GoogleWhyThisAd”.
x_position	Położenie lewego górnego rogu ikony w poziomie względem w lewym górnym rogu kreacji wideo (w pikselach). To pole akceptuje też wartość pozycji elastycznej to „right”; lub „w lewo”.
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 „top” lub „bottom” określających pozycję w wersji responsywnej.
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 pobierania ikony Informacja.
alt_text	Tekst alternatywny do wyrenderowania dla ikony Informacja.
click_data	Obiekt zawierający właściwość `click_data.url`, która oznacza adres URL, do którego mają być kierowani widzowie po kliknięciu ikony Informacja która obsługuje przeglądanie stron internetowych.
click_fallback_images	Tablica obrazów wyświetlanych użytkownikom klikającym Informacja na platformach, które nie obsługują przeglądania.

Format 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 pobierania obrazu zastępczego.
alt_text	Tekst alternatywny do renderowania dla obrazu zastępczego.

Przykładowy plik JSON metadanych

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