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:
- 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 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 przez inne nakładki reklamowe ani elementy interfejsu.
- 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, 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”.
- 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”.
- 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"
}
...
]
...
},
...
}
...
}