Эта страница переведена с помощью Cloud Translation API.

Значок и наложение AdChoices

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

Дополнительную информацию см. в разделе Почему вы видите рекламу .

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

Требования к рендерингу AdChoices

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

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

Анализ AdChoices из XML-ответа VAST

При работе с ответом на объявление в формате XML функция AdChoices поддерживается только в VAST версии 3.0 и более поздних версиях. AdChoices реализован в виде значка VAST.

ВАСТ 4.2

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

Если ваше приложение не поддерживает значки 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>

ВАСТ 3.0

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

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

Для полной поддержки AdChoices тег IconFallbackImages с названием программы «GoogleWhyThisAd» должен быть связан со значком с названием программы «GoogleWhyThisAd», чтобы при взаимодействии пользователя со значком отображалось соответствующее резервное изображение.

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

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

Ярлык	Атрибуты	Описание
Расширение	тип	Для этого расширения тип всегда содержит значение `IconClickFallbackImages` .
-IconClickFallbackImages	программа	Этот атрибут всегда соответствует атрибуту программы связанного значка VAST 3.0.
-IconClickFallbackImages		Структура этого узла соответствует стандарту VAST 4.2 для IconClickFallbackImages, за исключением добавления атрибута `program` .
--IconClickFallbackImage	ширина	Предпочтительная ширина для отображения изображения.
--IconClickFallbackImage	высота	Предпочтительная высота для отображения изображения.
---Альтернативный текст		Доступное описание изображения.
--- Статический ресурс	CreativeType	Миметип резервного изображения.
--- Статический ресурс		Значение 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>

Анализ выбора рекламы из метаданных DAI API в формате JSON

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

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

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

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

Значок формата JSON

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

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

ширина	Ширина резервного изображения в пикселях.
высота	Высота резервного изображения в пикселях.
творческий_тип	Миметип резервного изображения. По умолчанию «изображение/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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}