AdChoices 아이콘 및 오버레이

Google에서 호스팅하는 개인 맞춤 광고를 표시하는 모든 앱은 AdChoices 아이콘 오버레이됩니다. AdChoices('이 광고가 표시된 이유'라고도 함) 이 기능은 사용자에게 광고가 게재되는 이유를 개인 정보가 보호되는 방식에 대한 정보를 제공합니다.

자세한 내용은 메시지가 표시되는 이유와 광고로 이동합니다.

이 가이드에서는 정보를 올바르게 추출하기 위해 필요한 정보를 광고의 VAST XML 응답 또는 DAI 스트림의 메타데이터 응답입니다.

AdChoices 렌더링 요구사항

AdChoices 아이콘 렌더링에 관한 Google의 요건을 준수하려면 웹사이트가 다음 표준을 충족해야 합니다.

  1. AdChoices 아이콘은 표시되는 모든 광고 위에 표시되어야 합니다. 제공
  2. AdChoices 아이콘은 'X'로 표시된 위치에 표시되어야 합니다. 위치' 'Y 위치' 속성 및 너비 및 높이 속성으로 정의된 크기(밀도 독립형) 픽셀 (DP).
  3. AdChoices 아이콘을 다른 광고 오버레이나 인터페이스로 가리지 않아야 합니다. 요소
  4. 클릭 지원 또는 이와 동등한 플랫폼 (예: 터치 또는 원격 선택)의 경우 AdChoices 아이콘을 클릭할 수 있어야 합니다.
  5. 브라우저가 지원되는 플랫폼에서 AdChoices 아이콘을 클릭하면 '클릭률'에 URL이 지정된 브라우저 탭 또는 창을 또는 'click_data' 속성
  6. 브라우저가 지원되지 않는 플랫폼에서 AdChoices 아이콘을 클릭하면 모달 오버레이를 사용하여 "IconClickFallbackImage" 또는 'click_fallback_images' 속성
  7. 브라우저를 지원하지 않는 플랫폼에서는 대체 이미지가 'IconClickFallbackImage' 내에 지정된 크기 또는 'click_fallback_images' 속성을 사용합니다.

VAST XML 응답에서 AdChoices 파싱

XML 광고 응답을 사용할 때 AdChoices는 VAST에서만 지원됩니다. 버전 3.0 이상이 필요합니다. AdChoices는 VAST 아이콘으로 구현됩니다.

VAST 4.2

XML 광고 응답이 VAST 4.2 표준 AdChoices는 VAST 아이콘으로 제공됩니다. 앱 또는 웹사이트에서 VAST 4.2 아이콘 (VAST 4.2 표준의 섹션 3.11), AdChoices 지원 더 이상 추가 작업이 필요하지 않습니다.

앱이 VAST 4.2 아이콘을 지원하지 않는 경우 아이콘을 수동으로 파싱해야 합니다. 프로그램 이름 'GoogleWhyThisAd' 사용자가 제공한 정보를 기반으로 있습니다. 이 샘플 VAST 4.2 xml을 을 사용하세요.

샘플 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 아이콘에 대체 이미지 지원을 통합하는 것이 좋습니다. 있습니다. 이 샘플 VAST 3.0 XML 을 사용하세요.

IconFallbackImages 확장 구조

태그 속성 설명
확장 유형 이 확장 프로그램의 경우 유형에는 항상 IconClickFallbackImages
-IconClickFallbackImages 프로그램 이 속성은 연결된 VAST의 프로그램 속성과 항상 일치합니다. 3.0 아이콘.
이 노드의 구조는 IconClickFallbackImages(program 추가 제외) 속성의 값을 제공합니다.
--IconClickFallbackImage 너비 이미지를 표시할 기본 너비입니다.
높이 이미지를 표시할 기본 높이입니다.
---AltText 액세스 가능한 이미지 설명입니다.
---StaticResource creativeType 대체 이미지의 MIME 유형입니다.
대체 이미지의 URL을 포함하는 CDATA 값입니다.

샘플 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에서 AdChoices 파싱

DAI로 작업할 때 API를 사용하는 경우 AdChoices 세부정보는 메타데이터에 대한 요청에서 반환된 JSON 객체를 통해 전달됩니다. URL을 입력합니다.

메타데이터 JSON 객체에는 adID로 키가 지정된 광고 목록이 포함됩니다. 각 광고 개체는 아이콘 배열입니다. 문제의 광고에서 AdChoices를 활용하는 경우 AdChoices 아이콘이 이 배열에 포함됩니다.

JSON 아이콘 형식

JSON 아이콘 형식은 VAST 4.2 아이콘 일반 (섹션 3.11)을 준수해야 합니다. 그러나 보다 엄격한 JSON을 지원하려면 형식에서 일부 속성의 경우 필요에 따라 이름이 변경되었습니다.

아이콘 JSON 형식

프로그램 AdChoices 아이콘의 경우 이 값에 항상 'GoogleWhyThisAd' 문자열이 포함됩니다.
x_position 아이콘을 기준으로 왼쪽 상단 모서리의 가로 위치입니다. 왼쪽 상단 모서리(픽셀)입니다. 이 필드는 반응형 위치 값 'right'가 또는 'left').
y_position 아이콘 왼쪽 상단 모서리의 세로 위치를 기준으로 왼쪽 상단 모서리(픽셀)입니다. 이 필드는 반응형 위치 값 '상단' '하단'이라고 입력합니다.
너비 아이콘의 너비입니다(단위: 픽셀).
높이 아이콘의 높이입니다(단위: 픽셀).
creative_type 아이콘에 제공된 이미지의 MIME 유형입니다. 기본값은 'image/png'입니다.
리소스 AdChoices 아이콘을 가져올 URL입니다.
alt_text AdChoices 아이콘에 렌더링할 대체 텍스트입니다.
click_data click_data.url 속성을 포함하는 객체입니다. 은 시청자가 광고의 AdChoices 아이콘을 클릭하면 연결되는 URL을 나타냅니다. 웹 탐색을 지원하는 플랫폼입니다
click_fallback_images AdChoices를 클릭하는 사용자에게 표시할 이미지 객체의 배열 아이콘이 표시되지 않습니다.

대체 이미지 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}