Tất cả các ứng dụng hiển thị quảng cáo được cá nhân hóa do Google lưu trữ phải triển khai biểu tượng AdChoices và khi được cung cấp bởi Google. 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à tính năng minh bạch giải thích cho người dùng lý do họ thấy 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 phần 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 Lựa chọn quảng cáo từ phản hồi XML VAST của quảng cáo hoặc từ luồng DAI phản hồi siêu dữ liệu.
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 của bạn hoặc trang web 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 được hiển thị, phủ lên bất kỳ quảng cáo nào có biểu tượng đó đã cung cấp
- Biểu tượng Lựa chọn quảng cáo phải được hiển thị tại vị trí được biểu thị bằng dấu "X địa điểm" và "Vị trí Y" thuộc tính có trong dữ liệu biểu tượng và ở kích thước được xác định theo các thuộc tính chiều rộng và chiều cao, không phụ thuộc vào mật độ Điểm ảnh (DP).
- Biểu tượng Lựa chọn quảng cáo không được che khuất bởi các lớp phủ quảng cáo hoặc giao diện khác phần tử.
- Trên các nền tảng có hỗ trợ nhấp chuột hoặc 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 thông báo "Nhấp qua" hoặc "click_data" thuộc tính này.
- 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, bạn phải mở lớp phủ phương thức, hiển thị một trong những hình ảnh được chỉ định trong "IconClickFallbackImage" hoặc "click_fallback_images" thuộc tính này.
- 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ị tại kích thước được chỉ định trong "IconClickFallbackImage" hoặc "click_fallback_images" thuộc tính, tính bằng Pixel không phụ thuộc vào mật độ (DP).
Phân tích cú pháp phần Lựa chọn quảng cáo từ phản hồi XML của VAST
Khi làm việc với phản hồi quảng cáo XML, phần 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 nội dung phản hồi quảng cáo XML của bạn tuân theo VAST 4.2 tiêu chuẩn, Lựa chọn quảng cáo đượ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 (phần 3.11 của tiêu chuẩn VAST 4.2), hỗ trợ Lựa chọn quảng cáo bạn không cần 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, bạn cần phân tích cú pháp 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. chuẩn. Bạn có thể sử dụng VAST 4.2 xml mẫu này để thử nghiệm thêm trong ứng dụng của bạn.
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 nội dung phản hồi quảng cáo XML của bạn tuân theo VAST 3.0 chuẩn, thì Lựa chọn quảng cáo là đượ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 tùy chỉnh. Nếu ứng dụng hoặc trang web hỗ trợ đầy đủ tiêu chuẩn Biểu tượng VAST 3.0 và nếu nền tảng là có thể điều hướng đến và hiển thị URL nhấp qua biểu tượng, hỗ trợ Lựa chọn quảng cáo bạn không cần làm gì thêm.
Nếu nền tảng của bạn không thể điều hướng đến và hiển thị lượt nhấp URL—điều này chủ yếu áp dụng cho các thiết bị không có trang web được tích hợp trình duyệt—bạn phải triển khai hỗ trợ cho "IconFallbackImages" tiện ích. Tiện ích này chứa một tập hợp "IconFallbackImages" các thẻ mà "chương trình" khớp với một biểu tượng có trong VAST.
Để hỗ trợ đầy đủ cho Lựa chọn quảng cáo, thẻ biểu tượng dự phòng hình ảnh có tên chương trình "GoogleWhatThisAd" (Quảng cáo của Google) phải liên kết biểu tượng với tên chương trình "GoogleWhyThisAd", sao cho khi người dùng tương tác với biểu tượng, sẽ hiển thị hình ảnh dự phòng được liên kết.
Để hỗ trợ các thay đổi tiềm năng trong tương lai đối với tiêu chuẩn Lựa chọn quảng cáo, chúng tôi 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, khi sẵn có. Bạn có thể sử dụng VAST 3.0 mẫu này XML để thử nghiệm thêm trong ứng dụng của bạn.
Cấu trúc mở rộng Biểu tượng dự phòng hình ảnh
Thẻ | Thuộc tính | Mô tả |
---|---|---|
Phần mở rộng | loại | Đối với phần mở rộng 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 VAST được liên kết Biểu tượng 3.0. |
Cấu trúc của nút này phù hợp với tiêu chuẩn VAST 4.2 cho
Biểu tượngClickFallbackImages, ngoại trừ việc thêm program
.
|
||
--IconClickFallbackImage | chiều rộng | Chiều rộng ưu tiên để hiển thị hình ảnh. |
độ cao | Chiều cao ưu tiên để hiển thị hình ảnh. | |
---AltText | Nội dung mô tả hỗ trợ tiếp cận về hình ảnh. | |
---StaticResource | creativeType | Loại mime của hình ảnh dự phòng. |
Một giá trị CDATA 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 của API DAI
Khi làm việc với DAI API, thông tin chi tiết về Lựa chọn quảng cáo là được truyền qua đối tượng JSON được trả về qua các yêu cầu đến 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á bởi adID. Trong mỗi đối tượng quảng cáo là một mảng biểu tượng. Nếu quảng cáo hữu quan sử dụng Lựa chọn quảng cáo, thì Biểu tượng Lựa chọn quảng cáo có 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ừ biểu tượng VAST 4.2 tiêu chuẩn (phần 3.11), bất cứ khi nào có thể. Tuy nhiên, để hỗ trợ JSON nghiêm ngặt hơn định dạng, một số thuộc tính đã đổi tên, khi cần thiết.
Định dạng biểu tượ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í ở góc trên cùng bên trái của biểu tượng theo chiều ngang, 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 giá trị vị trí thích ứng là "phải" hoặc "trái". |
y_position | Vị trí dọc ở 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 giá trị vị trí thích ứng "hàng đầu" 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 | mimetype 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 | Một đối tượng chứa thuộc tính click_data.url
biểu thị 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 loạt các đối tượng hình ảnh để hiển thị cho những người xem nhấp vào Lựa chọn quảng cáo biểu tượng trên các nền tảng không hỗ trợ duyệt web. |
Định dạng JSON của 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ế để hiển thị cho 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"
}
...
]
...
},
...
}
...
}