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

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 widzą oraz informacje o sposobie ochrony prywatności.

Więcej informacji znajdziesz w sekcji Dlaczego wyświetla się komunikat reklama.

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 Informacja

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

Ikona Informacja musi być wyświetlana na wszystkich reklamach, w których jest podano
Ikona Informacja musi wyświetlać się 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).
Ikona Informacja nie może być zasłonięta innymi nakładkami na reklamach ani interfejsami. .
Na platformach z obsługą kliknięć lub ich odpowiedników (np. dotykowym lub zdalnym) 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, które nie obsługują przeglądarek, obraz zastępczy musi być wyświetlany: rozmiar określony w elemencie „IconClickFallbackImage” lub „click_fallback_images” w pikselach niezależnych od gęstości (DP).

Analiza sekcji AdChoices z 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. Informacja jest zaimplementowana 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 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 przeanalizować je ręcznie. nazwą programu „GoogleWhyThisAd” z odpowiedzi VAST standardowy. Możesz skorzystać z przykładowego pliku VAST 4.2 xml do dodatkowych testów 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 standard, AdChoices to jako połączenie 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 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 „IconFallbackImages” gdzie „program” pasuje do ikony uwzględnionej w 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.

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

Przeanalizuj opcje AdChoices z metadanych interfejsu DAI API w formacie JSON

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. W ramach każdej Obiekt reklamy jest tablicą ikon. Jeśli reklama, której dotyczy problem, zawiera funkcję Informacja, Tablica zawiera ikonę Informacja.

Format ikon JSON

Format ikony JSON to tłumaczenie 1:1 z ikony VAST 4.2 standardowa (art. 3.11), jeśli tylko jest to możliwe. Jednak w celu obsługi bardziej rygorystycznego kodu JSON niektóre atrybuty zmieniły w razie potrzeby nazwy.

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	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 pobierania ikony Informacja.
alt_text	Tekst alternatywny do renderowania 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 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ł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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}