Trang này được dịch bởi Cloud Translation API.

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

Tất cả các ứng dụng hiển thị quảng cáo được cá nhân hoá do Google lưu trữ đều phải triển khai lớp phủ và biểu tượng 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ải thích cho người dùng lý do họ 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êm thông tin, hãy xem bài viết Tại sao bạn thấy 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 đúng cách Lựa chọn quảng cáo từ phản hồi VAST XML 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ị 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:

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

VAST 4.2

Nếu phản hồi quảng cáo XML của bạn tuân theo tiêu chuẩn VAST 4.2, 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ì việc hỗ trợ Lựa chọn quảng cáo không cần phải làm gì thêm.

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

Phản hồi VAST 4.2 mẫu

<?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 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 kết hợp Biểu tượng VAST và phần mở rộng 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ể điều hướng đến và hiển thị URL nhấp qua của biểu tượng, thì bạn không cần phải làm gì thêm để hỗ trợ phần Lựa chọn quảng cáo.

Nếu nền tảng của bạn không thể điều hướng đến và hiển thị các URL nhấp qua (điều này chủ yếu áp dụng cho các thiết bị không có trình duyệt web tích hợp), bạn phải triển khai 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 "chương trình" khớp với biểu tượng có trong VAST.

Để hỗ trợ đầy đủ cho Lựa chọn quảng cáo, thẻ IconToggleImages có tên chương trình "GoogleWhyThisAd" phải được liên kết với Biểu tượng 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ợ các 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ả các Biểu tượng VAST (nếu có). Bạn có thể dùng xml VAST 3.0 này để kiểm thử thêm trong ứng dụng của mình.

Cấu trúc mở rộng dự phòng

Gắn thẻ	Thuộc tính	Nội dung mô tả
Phần mở rộng	loại	Đối với tiện ích này, loại luôn chứa giá trị `IconClickFallbackImages`.
-IconClickFallbackImages	chương trình	Thuộc tính này luôn khớp với thuộc tính chương trình của một Biểu tượng VAST 3.0 được liên kết.
-IconClickFallbackImages		Cấu trúc của nút này phù hợp với tiêu chuẩn VAST 4.2 cho IconClickFallbackImages, ngoại trừ việc thêm thuộc tính `program`.
--Biểu tượngNhấp dự phòngHình ảnh	chiều rộng	Chiều rộng ưu tiên để hiển thị hình ảnh.
--Biểu tượngNhấp dự phòngHình ảnh	độ cao	Chiều cao ưu tiên để hiển thị hình ảnh.
---AltText		Nội dung mô tả hình ảnh dễ đọc.
---StaticResource	creativeType	Loại MIME của hình ảnh dự phòng.
---StaticResource		Giá trị CSV có chứa URL của hình ảnh dự phòng.

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 Lựa chọn quảng cáo từ siêu dữ liệu JSON API của DAI

Khi làm việc với API DAI, thông tin chi tiết về Lựa chọn quảng cáo sẽ được truyền qua đối tượng JSON mà 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 mã quảng cáo (adID). Trong mỗi đối tượng quảng cáo là một mảng các biểu tượng. Nếu quảng cáo được đề cập sử dụ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), nếu có thể. Tuy nhiên, để hỗ trợ định dạng JSON nghiêm ngặt hơn, một số thuộc tính đã đổi tên (nếu cần).

Biểu tượng ở định dạng JSON

chương trình	Đối với biểu tượng Lựa chọn quảng cáo, giá trị này luôn chứa chuỗi "GoogleWhyThisAd".
x_position	Vị trí ngang cho góc trên cùng bên trái của biểu tượng, so với góc trên cùng bên trái của mẫu quảng cáo dạng video, tính bằng pixel. Trường này cũng chấp nhận các giá trị vị trí thích ứng "phải" hoặc "trái".
y_position	Vị trí dọc của góc trên cùng bên trái của biểu tượng, so với góc trên cùng bên trái của mẫu quảng cáo dạng video, tính bằng pixel. Trường này cũng chấp nhận các giá trị vị trí thích ứng "trên cùng" hoặc "dưới cùng".
chiều rộng	Chiều rộng của biểu tượng, tính bằng pixel.
độ cao	Chiều cao của biểu tượng, tính bằng pixel.
creative_type	Loại MIME của hình ảnh được cung cấp cho biểu tượng. Giá trị mặc định là "image/png".
tài nguyên	URL để truy xuất biểu tượng Lựa chọn quảng cáo.
alt_text	Văn bản thay thế cần hiển thị cho biểu tượng Lựa chọn quảng cáo.
click_data	Đối tượng chứa thuộc tính `click_data.url` đại diện cho URL để hướng người xem đến nếu họ nhấp vào biểu tượng Lựa chọn quảng cáo trên nền tảng hỗ trợ duyệt web.
click_fallback_images	Một mảng các đối tượng hình ảnh để hiển thị cho người xem nhấp vào biểu tượng Lựa chọn quảng cáo trên các nền tảng không hỗ trợ hoạt động duyệt web.

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

chiều rộng	Chiều rộng của hình ảnh dự phòng, tính bằng pixel.
độ cao	Chiều cao của hình ảnh dự phòng, tính bằng pixel.
creative_type	Loại MIME của hình ảnh dự phòng. Giá trị mặc định là "image/png".
tài nguyên	URL để truy xuất hình ảnh dự phòng.
alt_text	Văn bản thay thế cần hiển thị cho hình ảnh dự phòng.

JSON mẫu siêu dữ liệ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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}