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 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 innymi nakładkami na reklamach ani interfejsem .
- 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 ręcznie przeanalizować ikony. 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. |
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 | Przystępny opis obrazu. | |
| ---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 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"
}
...
]
...
},
...
}
...
}