Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Значок и оверлей "Выбор рекламы"

Во всех приложениях, в которых показываются объявления, размещенные на серверах Google, должен быть реализован значок AdChoices и оверлей, если они предоставлены Google. "Выбор рекламы" (также называется "Почему я вижу эту рекламу?") – это функция, которая обеспечивает прозрачность и позволяет пользователям узнать причину показа объявления и ознакомиться с информацией о защите конфиденциальности. Подробнее о значке "Выбор рекламы" в Google Менеджере рекламы…

Подробнее о том, почему вы видите определенную рекламу…

В этом руководстве рассказывается, как извлечь необходимую информацию из XML-ответа VAST для объявления или ответа с метаданными для потока DAI, чтобы правильно реализовать элемент "Выбор рекламы".

Требования к показу значка "Выбор рекламы"

Чтобы соответствовать требованиям Google к показу значков "Выбор рекламы", ваше приложение или сайт должны отвечать следующим стандартам:

Значок "Выбор рекламы" должен быть наложен на любое объявление, для которого он предоставлен.
Значок "Выбор рекламы" должен быть показан в позиции, указанной в свойствах "X location" и "Y location", и в размере, заданном в свойствах width и height, в независимых от плотности пикселях (DP).
Значок "Выбор рекламы" не должен перекрываться другими элементами интерфейса или наложениями объявлений.
На платформах, поддерживающих клики или аналогичные действия (например, касания или выбор с помощью пульта), значок "Выбор рекламы" должен быть кликабельным.
На платформах, поддерживающих браузеры, при нажатии на значок "Выбор рекламы" должна открываться вкладка или окно браузера с URL, указанным в свойстве ClickThrough или click_data.
На платформах, где браузер не поддерживается, при нажатии на значок "Выбор рекламы" должен открываться модальный оверлей с одним из изображений, указанных в свойстве "IconClickFallbackImage" или "click_fallback_images".
На платформах без поддержки браузера резервное изображение должно показываться в размере, указанном в свойстве IconClickFallbackImage или click_fallback_images, в пикселях, не зависящих от плотности экрана (dp).

Как извлечь значок "Выбор рекламы" из XML-ответа VAST

При работе с XML-ответом на запрос объявления значок "Выбор рекламы" поддерживается только в VAST версии 3.0 и более поздних. Значок "Выбор рекламы" реализуется как значок VAST.

VAST 4.2

Если ответ на запрос объявления в формате XML соответствует стандарту VAST 4.2, значок "Выбор рекламы" будет передан как значок VAST. Если ваше приложение или сайт полностью поддерживают значки VAST 4.2 (раздел 3.11 стандарта VAST 4.2), то для поддержки функции "Выбор рекламы" не требуется никаких дополнительных действий.

Если ваше приложение не поддерживает значки VAST 4.2, вам нужно вручную проанализировать значки с названием программы GoogleWhyThisAd из ответа VAST в соответствии со стандартом. Вы можете использовать этот образец XML-кода VAST 4.2 для дополнительного тестирования в приложении.

Пример ответа 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

Если ваш ответ на запрос объявления в формате XML соответствует стандарту VAST 3.0, значок "Выбор рекламы" будет доставлен как сочетание значка VAST и специального расширения VAST. Если ваше приложение или сайт полностью поддерживают стандарт VAST 3.0 Icon и если платформа может перейти по URL перехода по клику на значок и отобразить его, то для поддержки значка "Выбор рекламы" не требуется никаких дополнительных действий.

Если ваша платформа не может перейти по URL перехода и показать его (в основном это относится к устройствам без встроенного браузера), вам необходимо реализовать поддержку расширения IconFallbackImages. Это расширение содержит набор тегов IconFallbackImages, в которых атрибут program соответствует значку, включенному в VAST.

Чтобы полностью поддерживать функцию "Выбор рекламы", тег IconFallbackImages с названием программы GoogleWhyThisAd должен быть связан со значком с названием программы GoogleWhyThisAd. В результате при взаимодействии пользователя со значком будет показываться связанное с ним резервное изображение.

Чтобы обеспечить поддержку возможных будущих изменений стандарта "Выбор рекламы", мы настоятельно рекомендуем добавить поддержку резервных изображений для всех значков VAST, если они доступны. Вы можете использовать этот образец VAST 3.0 xml для дополнительного тестирования в приложении.

Структура расширения IconFallbackImages

Тег	Атрибуты	Описание
Расширение	тип	Для этого расширения тип всегда содержит значение `IconClickFallbackImages`.
-IconClickFallbackImages	Программа	Этот атрибут всегда соответствует атрибуту program значка VAST 3.0.
-IconClickFallbackImages		Структура этого узла соответствует стандарту VAST 4.2 для IconClickFallbackImages, за исключением добавления атрибута `program`.
--IconClickFallbackImage	ширина	Предпочтительная ширина для показа изображения.
--IconClickFallbackImage	высота	Предпочтительная высота для показа изображения.
---AltText		Доступное описание изображения.
---StaticResource	creativeType	MIME-тип резервного изображения.
---StaticResource		Значение CDATA, содержащее URL резервного изображения.

Пример ответа 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>

Как извлечь значок "Выбор рекламы" из метаданных JSON DAI API

При работе с DAI API сведения о значке "Выбор рекламы" передаются через объект JSON, который возвращается в ответ на запросы к URL метаданных.

Объект JSON метаданных содержит список объявлений, отсортированных по adID. В каждом объекте ad есть массив icons. Если в объявлении используется значок "Выбор рекламы", он будет содержаться в этом массиве.

Формат значка JSON

Формат значка JSON является прямым переводом стандарта значка VAST 4.2 (раздел 3.11), где это возможно. Однако, чтобы соответствовать более строгим требованиям формата JSON, некоторые атрибуты были переименованы.

Формат JSON для значков

Программа	Для значка "Выбор рекламы" это значение всегда содержит строку "GoogleWhyThisAd".
x_position	Горизонтальное положение верхнего левого угла значка относительно верхнего левого угла видеокреатива в пикселях. В этом поле также можно указать адаптивные значения "right" или "left".
y_position	Вертикальное положение верхнего левого угла значка относительно верхнего левого угла видеокреатива в пикселях. В этом поле также можно указать значения "top" или "bottom" для адаптивных позиций.
ширина	Ширина значка в пикселях.
высота	Высота значка в пикселях.
creative_type	MIME-тип изображения, предоставленного для значка. Значение по умолчанию – image/png.
ресурс	URL, по которому можно получить значок "Выбор рекламы".
alt_text	Альтернативный текст для значка "Выбор рекламы".
click_data	Объект, содержащий свойство `click_data.url`, которое представляет собой URL, на который переходят пользователи, нажав на значок "Выбор рекламы" на платформе, поддерживающей просмотр веб-страниц.
click_fallback_images	Массив объектов изображений, которые будут показываться пользователям, нажавшим на значок "Выбор рекламы" на платформах, не поддерживающих просмотр веб-страниц.

Формат JSON для резервного изображения

ширина	Ширина запасного изображения в пикселях.
высота	Высота резервного изображения в пикселях.
creative_type	MIME-тип резервного изображения. Значение по умолчанию – image/png.
ресурс	URL, по которому можно получить резервное изображение.
alt_text	Альтернативный текст для резервного изображения.

Пример файла 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}