Lớp phủ và biểu tượng Lựa chọn quảng cáo

Tất cả ứng dụng hiển thị quảng cáo do Google lưu trữ đều phải triển khai biểu tượng và lớp phủ AdChoices khi được Google cung cấp. Lựa chọn quảng cáo (còn được gọi là "Tại sao có quảng cáo này?") là một tính năng minh bạch giúp giải thích cho người dùng lý do họ nhìn thấy một quảng cáo cụ thể và cung cấp thông tin về cách bảo vệ quyền riêng tư của họ. Để biết thông tin chi tiết, hãy xem bài viết Biểu tượng Lựa chọn quảng cáo cho Google Ad Manager.

Để biết thêm thông tin, hãy xem bài viết Lý do bạn thấy một quảng cáo.

Hướng dẫn này giải thích cách trích xuất thông tin cần thiết để triển khai AdChoices đúng cách từ phản hồi XML VAST của quảng cáo hoặc phản hồi siêu dữ liệu của luồng DAI.

Yêu cầu đối với việc hiển thị nhãn Lựa chọn quảng cáo

Để tuân thủ các yêu cầu của Google về việc hiển thị biểu tượng Lựa chọn quảng cáo, ứng dụng hoặc trang web của bạn phải đáp ứng các tiêu chuẩn sau:

1. Biểu tượng Lựa chọn quảng cáo phải xuất hiện trên mọi quảng cáo mà biểu tượng này được cung cấp
2. Biểu tượng Lựa chọn quảng cáo phải xuất hiện ở vị trí được chỉ định bằng các thuộc tính "Vị trí X" và "Vị trí Y" có trong dữ liệu biểu tượng, cũng như ở kích thước được xác định bằng các thuộc tính chiều rộng và chiều cao, tính bằng Pixel độc lập với mật độ (DP).
3. Biểu tượng Lựa chọn quảng cáo không được bị các lớp phủ quảng cáo hoặc phần tử giao diện khác che khuất.
4. Trên những nền tảng có hỗ trợ lượt nhấp hoặc tương đương (ví dụ: chạm hoặc chọn bằng điều khiển từ xa), biểu tượng Lựa chọn quảng cáo phải có thể nhấp vào.
5. Trên các nền tảng có hỗ trợ trình duyệt, khi nhấp vào biểu tượng Lựa chọn quảng cáo, một thẻ hoặc cửa sổ trình duyệt phải mở ra với URL được chỉ định trong thuộc tính "ClickThrough" hoặc "click_data".
6. Trên các nền tảng không hỗ trợ trình duyệt, khi nhấp vào biểu tượng Lựa chọn quảng cáo, một lớp phủ phương thức phải mở ra, hiển thị một trong các hình ảnh được chỉ định trong thuộc tính "IconClickFallbackImage" hoặc "click_fallback_images".
7. Trên các nền tảng không hỗ trợ trình duyệt, hình ảnh dự phòng phải được hiển thị ở kích thước được chỉ định trong thuộc tính "IconClickFallbackImage" hoặc "click_fallback_images", theo đơn vị Pixel không phụ thuộc vào mật độ (DP).

Phân tích cú pháp Lựa chọn quảng cáo từ phản hồi VAST XML

Khi làm việc với một lượt phản hồi quảng cáo XML, Lựa chọn quảng cáo chỉ được hỗ trợ trong VAST phiên bản 3.0 trở lên. AdChoices được triển khai dưới dạng một Biểu tượng VAST.

VAST 4.2

Nếu lượt phản hồi quảng cáo XML của bạn tuân theo tiêu chuẩn VAST 4.2, thì Lựa chọn quảng cáo sẽ được phân phối dưới dạng Biểu tượng VAST. Nếu ứng dụng hoặc trang web của bạn hỗ trợ đầy đủ biểu tượng VAST 4.2 (mục 3.11 của tiêu chuẩn VAST 4.2), thì bạn không cần làm gì thêm để hỗ trợ Lựa chọn quảng cáo.

Nếu ứng dụng của bạn không hỗ trợ biểu tượng VAST 4.2, bạn cần phân tích cú pháp biểu tượng theo cách thủ công bằng tên chương trình "GoogleWhyThisAd" trong phản hồi VAST, dựa trên tiêu chuẩn đó. Bạn có thể sử dụng VAST 4.2 xml mẫu này để kiểm thử thêm trong ứng dụng của mình.

Phản hồi mẫu 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

Nếu lượt phản hồi quảng cáo XML của bạn tuân theo tiêu chuẩn VAST 3.0, thì Lựa chọn quảng cáo sẽ được phân phối dưới dạng một tổ hợp gồm biểu tượng VAST và một tiện ích VAST tuỳ chỉnh. Nếu ứng dụng hoặc trang web của bạn hỗ trợ đầy đủ tiêu chuẩn Biểu tượng VAST 3.0 và nếu nền tảng có thể chuyển đến và hiển thị URL của trang đích khi nhấp vào biểu tượng, thì bạn không cần làm gì thêm để hỗ trợ Lựa chọn quảng cáo.

Nếu nền tảng của bạn không thể chuyển đến và hiển thị URL nhấp qua (điều này chủ yếu áp dụng cho những thiết bị không có trình duyệt web tích hợp), thì bạn phải triển khai tính năng hỗ trợ cho tiện ích "IconFallbackImages". Tiện ích này chứa một tập hợp các thẻ "IconFallbackImages" trong đó thuộc tính "program" khớp với một biểu tượng có trong VAST.

Để hỗ trợ đầy đủ AdChoices, thẻ IconFallbackImages có tên chương trình "GoogleWhyThisAd" phải được liên kết với Icon có tên chương trình "GoogleWhyThisAd", sao cho khi người dùng tương tác với biểu tượng, hình ảnh dự phòng được liên kết sẽ xuất hiện.

Để hỗ trợ những thay đổi có thể xảy ra trong tương lai đối với tiêu chuẩn Lựa chọn quảng cáo, bạn nên kết hợp tính năng hỗ trợ hình ảnh dự phòng cho tất cả biểu tượng VAST (nếu có). Bạn có thể sử dụng mẫu VAST 3.0 xml này để kiểm thử thêm trong ứng dụng của mình.

Cấu trúc của tiện ích IconFallbackImages

Phản hồi VAST 3.0 mẫu

<?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>

Phân tích cú pháp AdChoices từ JSON siêu dữ liệu DAI API

Khi sử dụng API DAI, thông tin chi tiết về AdChoices sẽ được truyền qua đối tượng JSON do các yêu cầu trả về đến URL siêu dữ liệu.

Đối tượng JSON siêu dữ liệu chứa một danh sách quảng cáo, được khoá theo adID. Trong mỗi đối tượng quảng cáo đều có một mảng biểu tượng. Nếu quảng cáo có liên quan sử dụng biểu tượng Lựa chọn quảng cáo, thì biểu tượng Lựa chọn quảng cáo sẽ nằm trong mảng đó.

Định dạng biểu tượng JSON

Định dạng biểu tượng JSON là bản dịch 1:1 từ tiêu chuẩn biểu tượng VAST 4.2 (mục 3.11), bất cứ khi nào có thể. Tuy nhiên, để hỗ trợ định dạng JSON nghiêm ngặt hơn, một số thuộc tính đã thay đổi tên (nếu cần).

Định dạng JSON của biểu tượng

Định dạng JSON của hình ảnh dự phòng

JSON siêu dữ liệu mẫu

{
  ...
  "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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}