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

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

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

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

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

Требования к отображению AdChoices

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

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

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

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

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>

VAST 3.0

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

Если ваша платформа не может переходить по ссылкам и отображать URL-адреса, по которым можно перейти по клику (это в основном относится к устройствам без встроенного веб-браузера), вам необходимо реализовать поддержку расширения "IconFallbackImages". Это расширение содержит набор тегов "IconFallbackImages", где атрибут "program" соответствует значку, включенному в 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	высота	Предпочтительная высота для отображения изображения.
---Альтернативный текст		Доступное описание изображения.
---StaticResource	креативный тип	Типографический шаблон резервного изображения.
---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>

Анализ рекламных объявлений AdChoices из JSON-метаданных API DAI.

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

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

формат иконок JSON

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

Иконка в формате JSON

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

Резервный формат изображения JSON

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