Thông số URL của thẻ quảng cáo VAST

Thông số URL của thẻ quảng cáo Mẫu phân phát quảng cáo dạng video (VAST)

Trình phát sử dụng URL của thẻ quảng cáo VAST để truy xuất quảng cáo dạng video và âm thanh. Bạn có thể tập hợp URL của thẻ quảng cáo VAST theo cách thủ công hoặc sửa đổi URL hiện tại bằng cách dùng các thông số bên dưới rồi thử nghiệm với trình theo dõi bộ VAST. Bạn cũng có thể xem xét và thử nghiệm bằng cách sử dụng các thẻ mẫu này.

Yêu cầu chung về URL

  • Giao thức: Thẻ quảng cáo VAST hỗ trợ cả HTTP và HTTPS. URL theo dõi lượt hiển thị tuân theo chế độ cài đặt SSL hiện tại và trả về dưới dạng http hoặc https. URL lượt nhấp qua và theo dõi lượt nhấp dùng http vì các URL này chuyển hướng từ một trang khác.
  • Miền: Không được phép sử dụng miền động, được tạo qua macro so khớp mẫu hoặc bất kỳ phương thức động nào khác; việc này sẽ gây ra lỗi.
  • Lưu lượng trực tiếp: URL thẻ quảng cáo cho video phát trực tiếp phải chứa /live trong đường dẫn để đảm bảo khả năng xử lý lưu lượng truy cập lớn, khi tất cả điểm chèn quảng cáo được phân phối cùng một lúc.

Ví dụ về thẻ quảng cáo VAST

Sau đây là mẫu URL của thẻ quảng cáo VAST, trong đó các thông số và giá trị chỉ định sẽ tương tự như sau:

https://securepubads.g.doubleclick.net/gampad/ads?env=vp&gdfp_req=1&output=vast&iu=/1234/video-demo&sz=400x300&unviewed_position_start=1&ciu_szs=728x90,300x250

 đánh dấu trangChuyển đến một thông số cụ thể trong danh sách

aconp
ad_rule
ad_type
addtl_consent
afvsz
allcues
an
ciu_szs
correlator
cmsid
cust_params
description_url
dth
env
excl_cat
gdfp_req
gdpr
gdpr_consent
givn

hl
iabexcl
idtype
ipd
ipe
is_lat
iu
lip
ltd
max_ad_duration
min_ad_duration
mridx
msid
nofb
npa
omid_p
output
paln
plcmt

pmad
pmnd
pmxd
pod
pp
ppt
ppid
ppos
ppsj
ptpl
ptpln
pubf
pvid
pvid_s
pvtf
rdid
rdp
schain
scor

sdk_apis
sdmax
sid
ssss
sz
tfcd
trt
unviewed_position_start
url
vad_type
vconp
vid
vid_d
vpa
vpi
vpmute
vpos
wta

Thông số Chi tiết
aconp

(Âm thanh phát liên tục)

Được đề xuất theo Hướng dẫn đo lường âm thanh của MRC

Thông số âm thanh phát liên tục chấp nhận một giá trị hằng số cho biết liệu trình phát có định phát nội dung âm thanh một cách liên tục hay không.

Bạn không nên đặt thông số này nếu đó là thông số không xác định.

Ví dụ về cách sử dụng

Tính năng phát liên tục BẬT:
aconp=2

Tính năng phát liên tục TẮT:
aconp=1

ad_rule

(Quy tắc quảng cáo)

Thông số quy tắc quảng cáo chấp nhận giá trị hằng số. Giá trị này cho biết liệu có nên trả về mẫu quảng cáo VAST hoặc phản hồi của quy tắc quảng cáo hay không.

Chế độ cài đặt mặc định cho quy tắc quảng cáo phụ thuộc vào chế độ cài đặt mạng Ad Manager. Bạn có thể ghi đè chế độ cài đặt cho các thẻ quảng cáo cụ thể bằng cách tham khảo các ví dụ bên dưới.

Ví dụ về cách sử dụng

Yêu cầu đối với mẫu quảng cáo VAST:
ad_rule=0

Yêu cầu đối với quy tắc quảng cáo (VMAP):
ad_rule=1

Yêu cầu

Bắt buộc Yêu cầu đối với quy tắc quảng cáo dạng video

ad_type

(Loại quảng cáo)

Tham số loại quảng cáo chấp nhận một giá trị không đổi cho biết loại quảng cáo nào sẽ được trả về cho yêu cầu.

Tham số này chỉ bắt buộc đối với quảng cáo dạng âm thanh.

Khi ad_type được đặt thành audio hoặc audio_video, tham số vpmute phải được đặt thành 0.

Ví dụ về cách dùng

Chỉ chấp nhận quảng cáo dạng âm thanh:
ad_type=audio

Chấp nhận cả quảng cáo dạng video có thể bỏ qua và không thể bỏ qua:
ad_type=video

Chấp nhận cả quảng cáo dạng âm thanh và quảng cáo dạng video:
ad_type=audio_video
(Giá trị này cho phép cả hai định dạng cạnh tranh, nhưng chỉ một định dạng phân phát.)

Loại quảng cáo audio_video chỉ được dùng để phân phát mẫu quảng cáo dạng video vào nội dung âm thanh có hỗ trợ tính năng phát quảng cáo dạng video hoặc phân phát mẫu quảng cáo dạng âm thanh vào trình phát video trong luồng cho nội dung về bản chất "có thể nghe được". Ví dụ: luồng phát nội dung thể thao, phát video, tin tức, v.v. Hãy đọc thêm về âm thanh trong nội dung video.

Chỉ chấp nhận quảng cáo video có thể bỏ qua:
ad_type=skippablevideo

Chỉ chấp nhận quảng cáo dạng video không thể bỏ qua:
ad_type=standardvideo

Yêu cầu

Bắt buộc Bắt buộc đối với quảng cáo dạng âm thanh

afvsz

(Kích thước quảng cáo phi tuyến tính)

Thông số kích thước quảng cáo phi tuyến tính chấp nhận các giá trị hằng số. Các giá trị này phải là danh sách các kích thước quảng cáo phi tuyến tính được phân tách bằng dấu phẩy có thể hiển thị trong vùng quảng cáo dạng video.

Các kích thước này phải là kích thước được hỗ trợ:

  • 200x200
  • 250x250
  • 300x250
  • 336x280
  • 450x50
  • 468x60
  • 480x90
  • 729x90

Khi bạn dùng IMA SDK, thì trường này sẽ bị ghi đè và điền tất cả các kích thước được hỗ trợ trong nonLinearAdSlotWidthnonLinearAdSlotHeight.

Bạn có thể bỏ qua hoặc bỏ trống thông số này khi không có kích thước phi tuyến tính nào được hỗ trợ.

Ví dụ về cách sử dụng

Tất cả kích thước được hỗ trợ:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90

Với chiều rộng tối đa là 250:
afvsz=200x200,250x250

Với chiều cao tối đa là 60:
afvsz=450x50,468x60

Với chiều rộng tối đa là 100:
//trống; không hỗ trợ giá trị nào

 

Yêu cầu

Bắt buộc Bắt buộc đối với quảng cáo dạng video không tuyến tính khi không sử dụng SDK IMA.

allcues

(Tất cả điểm dừng)

Thông số này chấp nhận các giá trị biến là danh sách các điểm dừng được phân tách bằng dấu phẩy, tính bằng mili giây. Đối với mỗi giá trị, Ad Manager trả về một điểm chèn quảng cáo.

Các thông số vid_dallcues dùng để phân phát quảng cáo trong video mà không cần nhập nội dung. Hệ thống cũng cần có các quy tắc quảng cáo để trả lại quảng cáo trong video.

Nếu bạn sử dụng điểm dừng dựa trên thời gian trong các quy tắc quảng cáo của mình (ví dụ: "Mỗi N giây" hoặc "Vào thời gian cố định"), thì hệ thống sẽ sử dụng những điểm dừng được đặt trong quy tắc quảng cáo và bỏ qua những điểm dừng được chuyển vào allcues. Quảng cáo trong video vẫn cần có thời lượng, vì vậy bạn vẫn cần phải chuyển thông số vid_d.

Ví dụ về cách sử dụng

Điểm dừng ở 10 và 20 giây:
allcues=10000,20000

ciu_szs

(Kích thước quảng cáo đồng hành)

Thông số kích thước đồng hành chấp nhận các giá trị biến. Các giá trị này là danh sách kích thước đồng hành được phân tách bằng dấu phẩy.

Các giá trị được phân tách bằng dấu (|) biểu thị vùng quảng cáo nhiều kích thước.

Ví dụ về cách sử dụng

ciu_szs=728x90,300x250

Kích thước có vị trí nhiều kích thước:
ciu_szs=728x90,300x200|300x250

cmsid

(Mã nguồn nội dung)

vid

(Mã video)

Các thông số mã nguồn nội dung và mã video chấp nhận các giá trị biến

Để nhắm mục tiêu quảng cáo đến nội dung video, thẻ video chính của bạn cần phải có cả hai thông số này.

cmsid là một giá trị khác biệt với mỗi nguồn nội dung. Để xác định giá trị này trong Ad Manager, hãy nhấp vào Video và sau đó Nguồn nội dung và sau đó nhấp vào tên của nguồn nội dung.

vid là một chuỗi số hoặc số xác định một video cụ thể. Mã này do CMS lưu trữ nội dung của bạn gán. Để xác định giá trị này trong Ad Manager, hãy nhấp vào Video và sau đó Nội dung và sau đó nhấp vào nội dung video cụ thể.

Ví dụ về cách sử dụng

cmsid=[value]&vid=[value]

Nếu đang tạo thẻ cho tính năng Chèn quảng cáo động với video theo yêu cầu, thì bạn phải sử dụng macro có chức năng tự động chèn nguồn nội dung và mã video một cách chính xác. 

Ví dụ: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%

Yêu cầu

Bắt buộc Bắt buộc để nhắm mục tiêu nội dung video

correlator

(Correlator)

Thông số tương quan chấp nhận một giá trị biến dùng chung cho nhiều yêu cầu đến từ cùng một lượt xem trang. Bạn có thể dùng thông số này để triển khai quy tắc loại trừ cạnh tranh, kể cả trong môi trường không có cookie.

Nếu bạn dùng IMA SDK, thì giá trị tương quan được đặt tự động. Nếu trình phát của bạn cố gắng đặt giá trị này, thì SDK sẽ ghi đè giá trị đó bằng giá trị của chính SDK.

Nếu không sử dụng IMA SDK, hãy đảm bảo rằng bạn đặt giá trị này thành một giá trị số thực sự ngẫu nhiên, dương và không được sử dụng lại trong nhiều lượt xem trang.

Ví dụ về cách sử dụng

correlator=4345645667

Yêu cầu

Bắt buộc Bắt buộc đối với webứng dụng

được đề xuất Nên dùng cho hoạt động kiếm tiền có lập trình

cust_params

(Thông số khoá-giá trị tuỳ chỉnh)

Thông số tùy chỉnh chấp nhận giá trị biến là các cặp khóa-giá trị cho phép bạn đặt tiêu chí nhắm mục tiêu cụ thể, ví dụ như nhân khẩu học, các vị trí nhất định trên trang hoặc một trang hay các trang cụ thể.

Ví dụ về cách sử dụng

Xem ví dụ về cách để thêm cặp khóa‑giá trị.

description_url

(URL mô tả)

Tham số URL mô tả chấp nhận một giá trị biến có chức năng mô tả video đang phát trên trang. Vẽ phác thảo trang bằng 1-3 đoạn mô tả nội dung. Ví dụ: tự động ghép nội dung trang description_url từ các khối được định sẵn. Tìm hiểu thêm về cách cung cấp URL mô tả riêng biệt.

Các giá trị description_url phải được mã hóa URL cho trình phát video trên trang web và thiết bị CTV (TV kết nối Internet)/OTT (trực tiếp qua Internet) và không mã hoá cho trình phát video trong ứng dụng trên thiết bị di động.

SDK IMA không tự động đặt thông số này. Bạn phải đặt thông số này theo cách thủ công.

Ví dụ về cách sử dụng

URL được mã hóa:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html

Không được mã hóa:
description_url=
https://www.sample.com/golf.html

Yêu cầu

Bắt buộc Bắt buộc đối với webứng dụngAd Exchange

được đề xuất Nên dùng cho hoạt động kiếm tiền có lập trình

dth

(Gợi ý loại thiết bị)

Tham số gợi ý loại thiết bị chấp nhận một giá trị hằng số giúp giảm thiểu tình trạng phân loại sai thiết bị, cụ thể là trên các môi trường TV thông minh và hộp giải mã tín hiệu số.

Việc phân loại sai thiết bị có thể là do lỗi ngoài ý muốn của nhà xuất bản hoặc OEM (Nhà sản xuất thiết bị gốc) của TV thông minh. Tham số này sẽ được sử dụng cùng với các tín hiệu khác để Google tự động gắn cờ các trường hợp có thể phân loại lại khoảng không quảng cáo trên TV thông minh.

Ví dụ về cách dùng

Yêu cầu của:

  • Điện thoại phổ thông: dth=1
  • Điện thoại thông minh: dth=2
  • Máy tính: dth=3
  • Máy tính bảng: dth=4
  • TV kết nối Internet: dth=5
  • Máy chơi trò chơi: dth=6
  • Hộp giải mã tín hiệu số: dth=7

Yêu cầu

được đề xuất Nên dùng cho Hoạt động kiếm tiền có lập trình trên TV thông minh.

Bạn nên sử dụng tham số này cho các hoạt động triển khai PAL và PAI (không phải SDK). Bạn không cần sử dụng tham số này cho SDK IMA hoặc SDK DAI.

env

(Môi trường)

Thông số môi trường chấp nhận một giá trị hằng số. Giá trị này cho biết đó là một yêu cầu trong luồng hoặc yêu cầu là cụ thể từ trình phát video.

Bạn có thể sử dụng giá trị instream cho quảng cáo dạng video và quảng cáo dạng âm thanh hoặc giá trị vp chỉ cho quảng cáo dạng video.

Ví dụ về cách sử dụng

Video và/hoặc âm thanh:
env=instream

Chỉ video:
env=vp

Yêu cầu

Bắt buộc Bắt buộc đối với webứng dụng

excl_cat

(Danh mục loại trừ)

Thông số danh mục loại trừ chấp nhận các giá trị biến và được dùng để chặn bất kỳ mục hàng nào có nhãn loại trừ liên quan đủ điều kiện cho một yêu cầu quảng cáo nhất định. Thông số này hoạt động với cust_params.

Ví dụ về cách sử dụng

&cust_params=excl_cat%3Dairline_excl_label%7C

gdfp_req

(Chỉ báo trong giản đồ của Ad Manager)

Thông số chỉ báo giản đồ Ad Manager chấp nhận một giá trị không đổi cho biết rằng người dùng đang ở trên giản đồ Ad Manager.

Ví dụ về cách sử dụng

gdfp_req=1

Yêu cầu

Bắt buộc Yêu cầu cho webứng dụng

gdpr

(GDPR)

Thông số theo GDPR (Quy định chung về việc bảo vệ dữ liệu) chấp nhận các giá trị hằng và được những nhà xuất bản muốn tích hợp với TCF phiên bản 2.0 của IAB (Cục Quảng cáo tương tác) sử dụng. Các yêu cầu VAST trực tiếp không tự động đọc các giá trị nhưng chúng được chấp nhận khi thêm vào thẻ quảng cáo.

Chỉ 0 và 1 là giá trị hợp lệ cho thông số này, trong đó 0 có nghĩa là không áp dụng GDPR và 1 có nghĩa là áp dụng GDPR. Nếu áp dụng GDPR, thì bạn cũng phải cung cấp một chuỗi về sự minh bạch và sự đồng ý hợp lệ bằng cách sử dụng thông số gdpr_consent.

Bạn có thể đọc thêm về các giá trị được chuyển sang thông số này trong hướng dẫn chung để triển khai khung hoặc trong phần Chuỗi TC (Chuỗi về sự minh bạch và sự đồng ý) của thông số kỹ thuật TCF phiên bản 2.0 của IAB.

Ví dụ về cách sử dụng

Áp dụng GDPR:
gdpr=1

Không áp dụng GDPR:
gdpr=0

givn
paln

(Số chỉ dùng một lần của video)

For integrations that use the Programmatic Access Library (PAL), the video nonce parameter accepts a variable string value.

The nonce is URL safe—you don't need to URL-encode it.

Note: If you previously provided a nonce using the legacy paln parameter, it is strongly recommended to migrate to the givn parameter and stop sending paln. Do not include both parameters.

Usage example

You can read more about the value passed to this parameter in the getting started guides for PAL.

hl

(Ngôn ngữ)

Thông số ngôn ngữ chấp nhận một giá trị hằng số dùng để yêu cầu quảng cáo bằng ngôn ngữ đó. Giá trị hằng số này cũng dùng cho ngôn ngữ của việc lựa chọn quảng cáo và hiển thị quảng cáo dạng video trong tính năng phân bổ động cho Ad Exchange hoặc AdSense Video.

Giá trị thông số có thể là mã ISO 639-1 (hai chữ cái) hoặc ISO 639-2 (ba chữ cái). Xem danh sách mã hợp lệ.

Nếu bị bỏ qua, thì giá trị này sẽ được đặt thành bất kỳ ngôn ngữ nào có tiêu chí nhắm mục tiêu quảng cáo theo ngôn ngữ trong Ad Exchange theo mặc định.

Ví dụ về cách sử dụng

hl=vi

Yêu cầu

được đề xuất Nên dùng cho hoạt động kiếm tiền có lập trình

iabexcl

(URL loại trừ theo IAB)

Tham số URL iabexcl chấp nhận một danh sách danh mục được phân tách bằng dấu phẩy.

Ví dụ về cách sử dụng

iabexcl=3,14,527 không bao gồm "Xe tải thương mại", "Xe địa hình" và "Rugby".

Tìm hiểu thêm về Hệ thống phân loại nội dung của IAB.

ipd

(Miền của đối tác khoảng không quảng cáo)

Thông số miền của đối tác chia sẻ khoảng không quảng cáo (IPD) chấp nhận các giá trị biến phải được đặt thành giá trị khai báo inventorypartnerdomain trong tệp app-ads.txt (hoặc ads.txt) của nhà xuất bản. 

Thông số inventorypartnerdomain là một thông số kỹ thuật của Cục Quảng cáo tương tác (IAB), giúp nhà xuất bản chỉ định một miền của đối tác chia sẻ khoảng không quảng cáo cho mục đích xác thực ads.txt/app-ads.txt.

Việc khai báo IPD đặc biệt quan trọng trong trường hợp sử dụng tính năng chia sẻ khoảng không quảng cáo mà trong đó khoảng không quảng cáo nơi yêu cầu bắt nguồn có thể thuộc sở hữu của một đối tác khác (đối tác chia sẻ khoảng không quảng cáo).

Tìm hiểu thêm về ads.txt/app-ads.txt và đối tác chia sẻ khoảng không quảng cáo.

ipe

(Thực thể ping lượt hiển thị)

Thông số thực thể ping lượt hiển thị chấp nhận một giá trị hằng số dùng để biểu thị lệnh ping lượt hiển thị và lượt chuyển đổi bắt nguồn từ máy chủ, không phải từ ứng dụng.

Ví dụ về cách sử dụng

Báo hiệu phía máy chủ (SSB):
ipe=ssb

iu

(Đơn vị quảng cáo)

Thông số đơn vị quảng cáo chấp nhận một giá trị biến phải được đặt cho đơn vị quảng cáo hiện tại, theo định dạng:

/network_code/.../ad_unit

Ví dụ về cách sử dụng

iu=/6062/videodemo

Yêu cầu

Bắt buộc Yêu cầu cho webứng dụng

lip

(Vị trí cuối cùng trong nhóm)

Vị trí cuối cùng trong thông số nhóm chấp nhận giá trị không đổi để chỉ ra yêu cầu từ vị trí cuối cùng trong nhóm.

Thông số này chỉ dành cho các nhóm tiêu chuẩn.

Ví dụ về cách sử dụng

lip=true

ltd

(Quảng cáo bị hạn chế)

Tham số quảng cáo bị hạn chế chấp nhận giá trị không đổi. Giá trị này cho biết liệu có nên phân phát quảng cáo theo cách hạn chế hay không trong trường hợp không có sự đồng ý cho việc sử dụng cookie hoặc giá trị nhận dạng cục bộ khác.

Cảnh báo

Không giống như các tham số URL khác, việc đặt ltd=1 sẽ thay đổi hành vi của SDK IMA để coi yêu cầu này là không có mã nhận dạng và không cho phép lưu trữ.

Ví dụ về cách sử dụng

ltd=1

min_ad_duration

(Thời lượng tối thiểu của quảng cáo)

max_ad_duration

(Thời lượng tối đa của quảng cáo)

Tham số thời lượng quảng cáo chấp nhận các giá trị biến mà khi được kết hợp với nhau sẽ chỉ ra khoảng thời lượng mà quảng cáo cần khớp, tính bằng mili giây.

Hãy sử dụng tham số này để giới hạn thời lượng quảng cáo riêng lẻ cho các quảng cáo riêng lẻ và yêu cầu nhóm đã tối ưu hoá.

Ví dụ về cách sử dụng

min_ad_duration=15000&max_ad_duration=30000

mridx

(Số quảng cáo giữa video)

Thông số số quảng cáo giữa video chấp nhận giá trị biến. Giá trị này cho biết số thứ tự của quảng cáo giữa video (ví dụ: giữa video 1, giữa video 2, v.v.).

Ví dụ về cách sử dụng

mridx=2

msid

(Mã ứng dụng)

an

(Tên ứng dụng)

Các tham số tên ứng dụng và mã ứng dụng chấp nhận các giá trị biến. Bạn có thể sử dụng các giá trị này cho các yêu cầu gửi từ ứng dụng di động và thiết bị TV có kết nối, vì hầu hết các quảng cáo dạng video có lập trình đều cần đến các giá trị này.

SDK IMA sẽ tự động điền cả hai tham số, nhưng bạn phải chỉ định hai tham số này theo cách thủ công trong môi trường không phải SDK, bao gồm cả lệnh gọi VAST trực tiếp, hoặc khi sử dụng Thư viện quyền truy cập có lập trình (PAL) hoặc Khoảng không quảng cáo do nhà xuất bản xác thực (PAI).

Mặc dù tên ứng dụng phải là tên con người có thể đọc được, nhưng trên iOS và tvOS, SDK không thể truy cập Mã ứng dụng. Trong những trường hợp này, thông số msid không được gửi và SDK gửi gói ứng dụng qua thông số an.

Ví dụ về cách sử dụng

msid=com.package.publisher&an=sample%20app

Mã ứng dụng được đặt tên và định dạng khác nhau theo từng cửa hàng ứng dụng. Xem nguyên tắc của IAB trong việc nhận dạng ứng dụng hoặc ví dụ về các giá trị nhận dạng duy nhất phổ biến.

Đối với các nền tảng không có cửa hàng ứng dụng, IAB khuyên nhà xuất bản nên sử dụng định dạng sau cho mã cửa hàng: com.publisher.deviceplatform

Yêu cầu

Bắt buộc Cả hai tham số này đều bắt buộc đối với ứng dụng

được đề xuất Nên dùng cho hoạt động kiếm tiền có lập trình

nofb

(Đã tắt dự phòng)

Thông số bị vô hiệu hóa dự phòng chấp nhận một giá trị hằng số để cho biết rằng yêu cầu quảng cáo sẽ không trả về danh sách phát quảng cáo video dự phòng.

Ví dụ về cách sử dụng

Chức năng dự phòng bị vô hiệu hóa:
nofb=1

npa

(Quảng cáo không được cá nhân hoá)

Thông số quảng cáo không được cá nhân hóa chấp nhận giá trị một hằng số để cho biết cần coi yêu cầu quảng cáo là không được cá nhân hóa.

Bạn phải đặt cụ thể npa=1 hoặc chỉ sử dụng npa (không có giá trị đặt trước) để gắn thẻ yêu cầu là không được cá nhân hóa. Với các yêu cầu quảng cáo thiếu thông số này hoặc đặt thành npa=0, các yêu cầu quảng cáo đó mặc định thành quảng cáo được cá nhân hóa.

Ví dụ về cách sử dụng

Quảng cáo không được cá nhân hóa:
npa=1

omid_p

Tên đối tác OMID

Tham số tên đối tác OMID chấp nhận một giá trị biến cho biết tên của đối tác tích hợp hoạt động đo lường OMID, cũng như phiên bản của đối tác.

Tham số này chỉ áp dụng cho những nhà xuất bản muốn đo lường Active View khi sử dụng Open Measurement SDK (SDK OM). Bạn không nên sử dụng tuỳ chọn này khi sử dụng SDK IMA do SDK IMA được đặt tự động.

Để chỉ báo việc hỗ trợ OMID khi sử dụng Thư viện truy cập có lập trình (PAL), bạn cần sử dụng API omidPartnerNameomidPartnerVersion để đặt tên và phiên bản cho đối tác. Khi không sử dụng PAL cũng như IMA, bạn phải đặt các tham số omid_psdk_apis (các API được hỗ trợ, cũng có thể bao gồm cả các API khác được phân tách bằng dấu phẩy).

Ví dụ về cách sử dụng

Khi sử dụng PAL:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'

Khi không sử dụng PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7

output

(Định dạng đầu ra của quảng cáo)

Thông số định dạng đầu ra quảng cáo chấp nhận một giá trị hằng số phải được đặt thành định dạng đầu ra của quảng cáo.

Hãy sử dụng output=grow cho phiên bản VAST mặc định được đặt cho mạng của bạn. Đối với các thẻ quảng cáo cụ thể hoặc các phần của trang web, bạn có thể yêu cầu các phiên bản VAST hoặc VMAP cụ thể.

Đối với VAST, nếu trình phát video của bạn sử dụng SDK IMA, thì thông số đầu ra cho yêu cầu quảng cáo dạng video sẽ luôn được đặt thành output=xml_vast4. Điều này không có rủi ro về độ tin cậy vì SDK tương thích ngược với tất cả các phiên bản VAST mà mọi máy chủ quảng cáo bên thứ ba đều có thể phân phát.

Sử dụng output=vmap để trả lại phiên bản VMAP mặc định mà bạn đã kích hoạt cho mạng của mình (ví dụ: VMAP 1). Nếu trả lại VAST bên trong VMAP, thì bạn có thể sử dụng xml_vmap1_vast3 hoặc xml_vmap1_vast4 để chỉ định phiên bản VAST cần trả lại.

Ví dụ về cách sử dụng

Chế độ cài đặt VAST mặc định của mạng của bạn:
output=vast

VAST 4:
output=xml_vast4

Chế độ cài đặt VAST mặc định của mạng của bạn:
output=vmap

VMAP 1:
output=xml_vmap1

VMAP 1, trả lại VAST 4:
output=xml_vmap1_vast4

Yêu cầu

Bắt buộc Bắt buộc đối với webứng dụng

plcmt

(Vị trí đặt)

Tham số vị trí chấp nhận một giá trị hằng số. Giá trị này dùng để cho biết liệu khoảng không quảng cáo trong luồng phát có được khai báo dưới dạng trong luồng phát hay đi kèm theo hướng dẫn trong bản đặc tả quy cách kỹ thuật của IAB hay không.

Đối với các yêu cầu không ở trong luồng, trường này được điền tự động cho người mua dựa trên định dạng khoảng không quảng cáo đã khai báo và sẽ ghi đè mọi nội dung khai báo trong luồng phát hoặc nội dung đi kèm.

Ví dụ về cách sử dụng

Yêu cầu trong luồng phát:
plcmt=1

Yêu cầu nội dung đi kèm:
plcmt=2

Yêu cầu

 Bắt buộc Bắt buộc đối với webKiếm tiền có lập trình

pmad

(Nhóm quảng cáo tối đa)

Thông số tối đa của nhóm quảng cáo chấp nhận giá trị biến. Giá trị này cho biết số quảng cáo tối đa trong một nhóm.

Thông số này chỉ dành riêng cho nhóm được tối ưu hóa mà các nhà xuất bản có gói video nâng cao có thể sử dụng. Bạn không nên dùng thông số này cho VMAP (khi ad_rule=1).

Ví dụ về cách sử dụng

pmad=4

pmnd

(Thời lượng tối thiểu của nhóm)

pmxd

(Thời lượng tối đa của nhóm)

Thông số thời lượng nhóm chấp nhận các giá trị biến được kết hợp cùng nhau, chỉ định phạm vi thời lượng cần có của nhóm, tính bằng mili giây.

Các thông số này dùng để yêu cầu nhiều quảng cáo. Các thông số này dành riêng cho các nhóm được tối ưu hóa, được cung cấp cho các nhà xuất bản có gói video nâng cao. Bạn không được sử dụng các thông số này cho VMAP (khi ad_rule=1).

Ví dụ về cách sử dụng

pmnd=0&pmxd=60000

nhóm

(Số nhóm)

Thông số số nhóm chấp nhận giá trị biến đại diện cho số thứ tự của nhóm trong video (ví dụ: nhóm 1, nhóm 2, v.v.).

Ví dụ về cách sử dụng

pod=3

Yêu cầu

Bắt buộc Bắt buộc cho tính năng loại trừ cạnh tranh, giới hạn tần suất và các tính năng liên quan để hoạt động chính xác.

pp

(Hồ sơ mẫu quảng cáo)

Thông số hồ sơ tệp sáng tạo chấp nhận một giá trị biến đổi kiểm soát các tệp sáng tạo đủ điều kiện để phân phát dựa trên cấu hình được thiết lập trong hồ sơ tệp sáng tạo dạng video và âm thanh.

Ví dụ về cách sử dụng

pp=creative_profile

Yêu cầu

được đề xuất Nên dùng cho hoạt động kiếm tiền có lập trình

ppt

(Cách nhà xuất bản xử lý quyền riêng tư)

Thông số Cách nhà xuất bản xử lý quyền riêng tư chấp nhận một giá trị hằng số. Giá trị này dùng để cho biết liệu có tắt tính năng cá nhân hoá quảng cáo cho yêu cầu quảng cáo hay không.

Tìm hiểu thêm về Cách nhà xuất bản xử lý quyền riêng tư.

Ví dụ về cách sử dụng

Tắt chế độ cá nhân hoá quảng cáo:
ppt=1

ppid

(Giá trị nhận dạng do nhà xuất bản cung cấp)

Thông số giá trị nhận dạng do Nhà xuất bản cung cấp (PPID) chấp nhận một giá trị biến của giá trị nhận dạng được sử dụng trong giới hạn tần suất, phân khúc đối tượng và nhắm mục tiêu, xoay vòng quảng cáo tuần tự và các biện pháp kiểm soát phân phối quảng cáo dựa trên đối tượng khác trên nhiều thiết bị.

Ví dụ về cách sử dụng

ppid=12JD92JD8078S8J29SDOAKC0EF230337

ppos

(Vị trí trong nhóm)

Vị trí trong thông số nhóm chấp nhận giá trị biến đại diện cho vị trí trong nhóm (ví dụ: vị trí 1, vị trí 2, v.v.).

Thông số này chỉ dành cho nhóm tiêu chuẩn và cần thiết cho tính năng tự động điền đồng hành.

Ví dụ về cách sử dụng

ppos=2

Yêu cầu

Bắt buộc Bắt buộc cho tính năng loại trừ cạnh tranh, giới hạn tần suất và các tính năng liên quan để hoạt động chính xác.

ppsj

(đối tượng JSON tín hiệu do nhà xuất bản cung cấp)

Tham số JSON tín hiệu do nhà xuất bản cung cấp chấp nhận đối tượng JSON được mã hoá base64 chứa dữ liệu về đối tượng và bối cảnh do nhà xuất bản cung cấp để cải thiện khả năng kiếm tiền có lập trình.

Tìm hiểu thêm về tín hiệu do nhà xuất bản cung cấpcác hệ thống phân loại được hỗ trợ.

Xem thông tin chi tiết về cặp khoá-giá trị JSON hợp lệ trong
mẫu SDK IMA HTML5.

Ví dụ về cách sử dụng

Đối tượng JSON:
{
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["6", "284"]
  }]
}

Giá trị được mã hoá base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s
idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj
pbIjEiLCIyODQiXX1dfQ

ptpl

(Mã mẫu chèn quảng cáo)

ptpln

(Tên mẫu chèn quảng cáo)

Tên và mã mẫu chèn quảng cáo chấp nhận các giá trị biến và cho biết cần áp dụng mẫu chèn quảng cáo nào cho yêu cầu nhóm được tối ưu hoá. Mẫu chèn quảng cáo cho phép bạn định cấu hình các vị trí quảng cáo hoặc vị trí quảng cáo tuỳ chỉnh cần xuất hiện trong một điểm chèn quảng cáo cũng như thứ tự phân phát các vị trí quảng cáo đó.

Bạn chỉ cần có một trong 2 tham số (tên hoặc mã) để yêu cầu mẫu chèn quảng cáo.

Ví dụ về cách sử dụng

Bạn có thể xem thêm thông tin chi tiết về cách thiết lập và yêu cầu mẫu chèn quảng cáo tại đây.
 
pubf

(Giá sàn công khai trong thẻ Ad Exchange)

pvtf

(Giá sàn riêng tư trong thẻ Ad Exchange)

pubf tương đương với google_ad_public_floorpvtf tương đương với google_ad_private_floor. Bạn có thể dùng các thông số này để thêm giá sàn vào thẻ Ad Exchange.

Ví dụ về cách sử dụng

pubf=123
pvtf=123

pvid

(Mã nhóm ứng dụng)

pvid_s

(Phạm vi nhóm ứng dụng)

Cần có giá trị mã nhóm ứng dụng cho hoạt động kiếm tiền khi người dùng chọn không cá nhân hoá trên thiết bị Android.

Thông số pvid chấp nhận một giá trị biến được đặt thành mã nhóm ứng dụng Android và thông số pvid_s chấp nhận một giá trị hằng số đại diện cho phạm vi của mã nhóm ứng dụng (scope_app hoặc scope_developer).

Mặc dù SDK IMA/PAL tự động cho qua trường này, nhưng nhà xuất bản không triển khai SDK vẫn phải gọi SDK nhóm ứng dụng và chuyển thông số này theo cách thủ công trên yêu cầu quảng cáo.

Xem Tài liệu của Android về cách truy xuất mã nhóm ứng dụng.

Ví dụ về cách sử dụng

pvid=[AppSetID_value]
pvid_s=scope_app

Yêu cầu

Bắt buộc Bắt buộc đối với ứng dụng

được đề xuất Nên dùng cho hoạt động kiếm tiền có lập trình

rdid
idtype
is_lat

(Giá trị nhận dạng thiết bị có thể đặt lại)

Các giá trị nhận dạng của thiết bị có thể đặt lại chấp nhận giá trị biến.

Với các ứng dụng tích hợp (không phải trên web hoặc web dành cho thiết bị di động), SDK truyền đi giá trị nhận dạng của thiết bị có thể đặt lại để nhắm mục tiêu người dùng đến các yêu cầu luồng của bạn kèm theo các thông số cho rdid, idtypeis_lat. Trên luồng SSB, bạn phải chuyển những thông số này dưới dạng thông số rõ ràng, tương tự như cách bạn sẽ làm đối với yêu cầu quảng cáo phía máy khách. Tìm hiểu thêm về giá trị nhận dạng thiết bị.

Hầu như tất cả quảng cáo dạng video có lập trình đều yêu cầu phải có các giá trị này.

Cảnh báo

Kể từ iOS 14.5, Apple đã ngừng sử dụng tín hiệu LAT. Thay vào đó, Google dựa vào sự hiện diện của một IDFA khác 0 để cho biết rằng người dùng đã đồng ý theo dõi trên các phiên bản iOS hỗ trợ chính sách Minh bạch về việc theo dõi ứng dụng. Như vậy, cần phải có một UserAgent hợp lệ cho biết phiên bản hệ điều hành chính xác.

Ví dụ về cách sử dụng

Xem ví dụ chi tiết về giá trị nhận dạng của thiết bị có thể đặt lại.

Yêu cầu

Bắt buộc Bắt buộc đối với ứng dụng

được đề xuất Nên dùng cho hoạt động kiếm tiền có lập trình

rdp

(Hạn chế hoạt động xử lý dữ liệu)

Thông số xử lý dữ liệu hạn chế chấp nhận giá trị không đổi để cho biết yêu cầu quảng cáo nên hạn chế việc xử lý dữ liệu.

Bạn phải đặt cụ thể rdp=1 hoặc chỉ bao gồm rdp (không có giá trị đặt trước) để hạn chế hoạt động xử lý dữ liệu. Các yêu cầu quảng cáo thiếu thông số này hoặc đặt thành rdp=0, sẽ không hạn chế, trừ khi bạn bật chế độ cài đặt mạng Hạn chế xử lý dữ liệu.

Ví dụ về cách sử dụng

rdp=1

schain

(Chuỗi cung ứng)

Tham số chuỗi cung ứng chấp nhận một giá trị biến phải được chuyển đổi tuần tự đối tượng SupplyChain. Khi bạn thêm tham số này, Google sẽ thêm một nút vào mọi đối tượng schain đã nhận được trước khi gửi cho người mua.

Hãy xem tài liệu đầy đủ của IAB để truyền đạt thông tin về Chuỗi cung ứng thông qua thẻ (thay vì OpenRTB).

Xem các yêu cầu để phân tích cú pháp schain một cách chính xác

Dựa trên tài liệu của IAB, nội dung sau đây xác định quá trình chuyển đổi tuần tự cho đối tượng SupplyChain:

  • {SupplyChainObject}!{mảng SupplyChainNode}. Các thuộc tính SupplyChainObjectSupplyChainNode được phân tách bằng dấu phẩy để bạn có thể bỏ qua các trường không bắt buộc và dấu phân tách dấu phẩy mà bạn có thể chọn loại trừ.
  • Mỗi phần tử SupplyChainNode được phân tách bằng dấu "!".
  • Nếu giá trị của bất kỳ thuộc tính nào chứa các ký tự cần mã hoá URL (ví dụ: "," hoặc ","), thì giá trị đó phải được mã hoá URL trước khi chuyển đổi tuần tự.

Thứ tự chuyển đổi tuần tự

Các thuộc tính SupplyChainObject được chuyển đổi tuần tự theo thứ tự sau:

ver,complete

Các thuộc tính SupplyChainNode được chuyển đổi tuần tự theo thứ tự sau:

asi,sid,hp,rid,name,domain,ext

Lưu ý: Nội dung của ext là dành riêng cho từng sàn giao dịch. Google Ad Manager không phân tích cú pháp thuộc tính này.

Ví dụ về cách chuyển đổi tuần tự đối tượng SupplyChain

Dưới đây là hai ví dụ về cách chuyển đổi tuần tự đối tượng SupplyChain ở trên:

Chuyển đổi tuần tự bằng dấu phẩy cho các trường trống không bắt buộc

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Chuyển đổi tuần tự không có dấu phẩy cho các trường không bắt buộc trống

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Tìm hiểu thêm về đối tượng SupplyChain.

Ví dụ về cách dùng

schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Nếu giá trị của asiexchange,1, thì quá trình chuyển đổi tuần tự với các ký tự thoát sẽ có dạng như sau:

1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Yêu cầu

Bắt buộc Bắt buộc đối với những nhà xuất bản sử dụng tổ chức trung gian thanh toán trước khi yêu cầu được gửi đến Google Ad Manager. Điều này cũng áp dụng cho những nhà xuất bản sử dụng công nghệ máy chủ quảng cáo của bên thứ ba.

scor

(Công cụ tương quan luồng)

Thông số tương quan luồng chấp nhận một giá trị biến là một số nguyên được tạo cho mỗi luồng video. Số này phải giống nhau trong một luồng và phải là duy nhất trong một lượt xem trang. Được sử dụng cho tính năng loại trừ cạnh tranh, giới hạn tần suất và các tính năng có liên quan nếu người dùng đang xem nhiều video trên cùng một trang.

Ví dụ về cách sử dụng

scor=17

Yêu cầu

Bắt buộc Bắt buộc đối với tính năng loại trừ cạnh tranh, giới hạn tần suất và các tính năng liên quan để hoạt động chính xác.

sdk_apis

(Khung API SDK)

Thông số khung API SDK chấp nhận một danh sách các giá trị số nguyên không đổi được phân tách bằng dấu phẩy. Thông số này cho biết tất cả khung API mà trình phát hỗ trợ.

Hãy xem danh sách các giá trị Khung API có thể áp dụng.

Thông số này hỗ trợ các API trong Thư viện truy cập có lập trình (PAL) dành cho những nhà xuất bản không sử dụng SDK IMA. SDK IMA ghi đè mọi giá trị được đặt bằng các giá trị mà SDK IMA hỗ trợ.

Ví dụ về cách sử dụng

sdk_apis=2,7,9

sdmax

(Thời lượng quảng cáo tối đa có thể bỏ qua)

Thông số yêu cầu quảng cáo sdmax (thời lượng quảng cáo tối đa có thể bỏ qua) chấp nhận một giá trị biến cho phép nhà xuất bản chỉ định thời lượng quảng cáo tối đa mà họ muốn đối với quảng cáo có thể bỏ qua.

Cần một thời lượng tính bằng mili giây thể hiện giới hạn trên được cho phép trong thời lượng của mẫu quảng cáo dạng video/âm thanh có thể bỏ qua đối với yêu cầu quảng cáo cụ thể đó.

Có thể sử dụng độc lập sdmax cho quảng cáo có thể bỏ qua hoặc kết hợp với thông số max_ad_duration hiện tại để đưa ra thời lượng tối đa khác cho quảng cáo có thể bỏ qua và quảng cáo không thể bỏ qua.

Ví dụ về cách sử dụng

Sử dụng các chế độ cài đặt sau:

  • max_ad_duration = 15000 (15 giây)
  • sdmax = 45000 (45 giây)

Cho các mẫu quảng cáo sau:

  • Mẫu quảng cáo A: không thể bỏ qua; 30 giây
  • Mẫu quảng cáo B: có thể bỏ qua; 30 giây

Kết quả:

  • Mẫu quảng cáo A sẽ bị lọc vì không thể bỏ qua và thời lượng của mẫu quảng cáo vượt quá giới hạn tối đa (không thể bỏ qua).
  • Mẫu quảng cáo B sẽ không bị lọc vì tuy thời lượng vượt quá max_ad_duration nhưng có thể bỏ qua và thời lượng không vượt quá giới hạn tối đa có thể bỏ qua.
sid

(Mã phiên)

Thông số mã phiên chấp nhận giá trị biến. Giá trị này là giá trị nhận dạng quảng cáo bảo vệ quyền riêng tư chỉ dùng để giới hạn tần suất.

Mã phiên được hỗ trợ cho các yêu cầu video trong luồng phát từ TV có thể nối mạng và tại khoảng không quảng cáo trên video trong luồng phát từ thiết bị sử dụng ứng dụng di động. Mã này hiện chưa được hỗ trợ trên web.

Theo nguyên tắc IFA của IAB, bạn phải điền thông số này theo định dạng UUID. Tìm hiểu thêm về giá trị nhận dạng thiết bị có thể đặt lại cho tiêu chí nhắm mục tiêu người dùng.

Bạn có thể chọn không chuyển mã phiên này bằng cách đặt sid=0.

Ví dụ về cách sử dụng

123e4567-e89b-12d3-a456-426614174000

Yêu cầu

được đề xuất Nên dùng cho hoạt động kiếm tiền có lập trình

ssss

(Nguồn ghép phía máy chủ)

Thông số nguồn ghép phía máy chủ chấp nhận giá trị hằng số và cần đặt thành giá trị được Google công nhận, do Google cung cấp cho nhà cung cấp công nghệ ghép video của bạn.

Các nhà cung cấp công nghệ ghép video dùng các dịch vụ tích hợp máy chủ với Google được cung cấp giá trị này từ Google và có thể cung cấp cho bạn. Bạn có thể liên hệ với người quản lý Tài khoản Google của mình nếu có bất kỳ câu hỏi nào về giá trị để đặt cho thông số này.

Ví dụ về cách sử dụng

ssss=mystitcher

Yêu cầu

Bắt buộc Cần có cho hoạt động triển khai phía máy chủ

sz

(Kích thước)

Thông số kích thước chấp nhận một giá trị biến phải được đặt thành kích thước của vùng quảng cáo dạng video chính.

Các kích thước phải được phân tách bằng ký tự sổ thẳng (|).

Không sử dụng "v" sau kích thước.

Ví dụ về cách sử dụng

sz=400x300

Yêu cầu

Bắt buộc Bắt buộc đối với webứng dụng

Thông số này là không bắt buộc nếu chỉ yêu cầu ad_type=audio.

tfcd

(Gắn thẻ hướng tới trẻ em)

Thông số hướng tới trẻ em chấp nhận giá trị không đổi. Giá trị này gắn thẻ yêu cầu quảng cáo cho quảng cáo được dành cho trẻ em.

Ví dụ về cách sử dụng

tfcd=1

trt

(Loại lưu lượng truy cập)

Thông số loại lưu lượng truy cập chấp nhận giá trị hằng số có chức năng yêu cầu lưu lượng truy cập không phải trả tiền hoặc đã mua.

SDK IMA không điền sẵn giá trị mặc định nếu thiếu thông số loại lưu lượng truy cập trong yêu cầu. Trong những trường hợp này, máy chủ cung cấp giá trị mặc định là 0 (lưu lượng truy cập không xác định).

Ví dụ về cách sử dụng

Yêu cầu đối với lưu lượng truy cập đã mua:
trt=1

Yêu cầu đối với lưu lượng không phải trả tiền:
trt=2

unviewed_position_start

(Lượt hiển thị bị trì hoãn)

Thông số lượt hiển thị bị trì hoãn chấp nhận một giá trị hằng số để biểu thị số lượt hiển thị bị trễ đối với video.

Ví dụ về cách sử dụng

unviewed_position_start=1

Yêu cầu

Bắt buộc Bắt buộc đối với webứng dụng

url

(URL)

Thông số URL chấp nhận một giá trị biến phải được đặt thành URL đầy đủ để gửi yêu cầu từ URL đó. Giá trị này là cần thiết để giúp người mua xác định và hiểu bối cảnh về nguồn gốc của yêu cầu này. Trong phạm vi có thể, giá trị này phải được điền tự động vào yêu cầu quảng cáo. 

Trên một trang web, đây sẽ là địa chỉ URL của trang hiển thị trình phát video. Nếu bạn sử dụng SDK IMA thì giá trị URL sẽ được đặt tự động. Nếu trình phát của bạn đặt giá trị này thì SDK IMA sẽ tuân theo giá trị đang được đặt.

Trong một ứng dụng trên thiết bị di động hoặc TV có kết nối internet (CTV), giá trị này phải được đặt thành URL thể hiện chính xác nhất khoảng không quảng cáo dạng video hoặc âm thanh đang dùng để kiếm tiền. Ví dụ: nếu người dùng đang xem video trong một ứng dụng dành cho thiết bị di động cũng có sẵn tại một URL tương đương trên máy tính.*

Giá trị của thông số này phải được mã hoá.

Ví dụ về cách sử dụng

url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html

* Đối với ứng dụng, nếu không thể đặt tham số này thành một giá trị URL biến số, thì bạn nên đặt tham số này theo mẫu sau:
url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com

Yêu cầu

Bắt buộc Bắt buộc đối với webứng dụng

được đề xuất Nên dùng cho hoạt động kiếm tiền có lập trình

vad_type

(Loại quảng cáo dạng video)

Thông số loại quảng cáo dạng video chấp nhận giá trị không đổi. Giá trị này cho biết liệu có cần trả lại quảng cáo tuyến tính hay phi tuyến tính hay không.

Ví dụ về cách sử dụng

Trả lại quảng cáo tuyến tính:
vad_type=linear

Trả lại quảng cáo phi tuyến tính:
ad_type=nonlinear

vid_d

(Thời lượng video)

Thông số này chấp nhận một giá trị biến chỉ định thời lượng của nội dung, tính bằng giây. 

Các thông số vid_dallcues dùng để phân phát quảng cáo trong video mà không cần nhập nội dung. Hệ thống cũng cần có các quy tắc quảng cáo để trả lại quảng cáo trong video.

Ví dụ về cách sử dụng

Thời lượng nội dung video 90000 giây (25 giờ):
vid_d=90000

vconp

(Phát video liên tục)

Được đề xuất theo Hướng dẫn đo lường trong video của MRC

Thông số video phát liên tục chấp nhận một giá trị hằng số cho biết liệu trình phát có định phát nội dung video một cách liên tục, tương tự như chương trình phát sóng trên TV hay không.

Bạn không nên đặt thông số này nếu đó là thông số không xác định.

Ví dụ về cách sử dụng

Tính năng phát liên tục BẬT:
vconp=2

Tính năng phát liên tục TẮT:
vconp=1

vpa

(Tự động phát video)

Đề xuất theo MRC Hướng dẫn đo lường video

Tham số tự động phát video chấp nhận một giá trị hằng số. Giá trị này cho biết liệu nội dung video trong quảng cáo bắt đầu thông qua tính năng tự động phát hay thao tác nhấp.

Các giá trị bạn có thể sử dụng là click nếu trang phải chờ hành động của người dùng hoặc auto nếu video phát tự động.

Bạn không nên đặt thông số này nếu đó là thông số không xác định.

Ví dụ về cách sử dụng

Tự động phát:
vpa=auto

Nhấp để phát:
vpa=click

Yêu cầu

được đề xuất Nên dùng cho hoạt động kiếm tiền có lập trình

vpi

(InRed danh sách phát video)

Thông số inred của danh sách phát video chấp nhận một giá trị hằng số cho biết có nên phân phát VMAP cùng dòng hay không (trả về VAST bên trong VMAP).

Bạn có thể dùng thông số này để giảm độ trễ và đảm bảo việc giới hạn tần suất và loại trừ cạnh tranh trên một luồng video.

Ví dụ về cách sử dụng

Trả lại VAST:
vpi=1

Trả lại lệnh chuyển hướng:
vpi=0

vpmute

(Tắt tiếng khi phát video)

Đề xuất theo MRC Hướng dẫn đo lường video

Thông số video bị tắt tiếng chấp nhận giá trị không đổi. Giá trị này cho biết liệu quá trình phát lại quảng cáo có bắt đầu trong khi trình phát video bị tắt tiếng hay không.

Ví dụ về cách sử dụng

Tắt tiếng:
vpmute=1

Bật tiếng:
vpmute=0

Yêu cầu

 Bắt buộc Bắt buộc đối với webKiếm tiền có lập trình

vpos

(Vị trí video)

Thông số vị trí video chấp nhận giá trị không đổi. Giá trị này cho biết liệu yêu cầu quảng cáo đang được gửi từ trước video, trong video hay sau video.

Ví dụ về cách sử dụng

Vị trí trước video:
vpos=preroll

Vị trí trong video:
vpos=midroll

Vị trí sau video:
vpos=postroll

Yêu cầu

được đề xuất Nên dùng cho hoạt động kiếm tiền có lập trình

wta

(Tại sao có quảng cáo này)

Tham số "Tại sao có quảng cáo này?" chấp nhận một giá trị hằng số cho biết trình phát video có hỗ trợ việc hiển thị quy trình gắn huy hiệu cho quảng cáo. Khi không có tham số &wta nào được gửi, giá trị này sẽ được đặt mặc định là &wta=1.

Hệ thống tự động hỗ trợ quy trình gắn huy hiệu cho quảng cáo khi bạn sử dụng SDK IMA. Khi không sử dụng SDK IMA, trình phát video phải triển khai việc hỗ trợ IconIconClickFallbackImage VAST, như ghi nhận trong tiêu chuẩn VAST của IAB.

Nhà xuất bản bắt buộc phải gửi &wta=0 nếu nhà xuất bản không hiển thị biểu tượng Lựa chọn quảng cáo (như cung cấp trong phản hồi VAST). Yêu cầu quảng cáo có &wta=1 hoặc không có tham số &wta được coi là cho biết rằng nhà xuất bản sẽ hiển thị thông tin Lựa chọn quảng cáo được cung cấp.

Yêu cầu quảng cáo dạng âm thanh phải gửi wta=1 nếu biểu tượng Lựa chọn quảng cáo (như cung cấp trong phản hồi VAST) xuất hiện trên quảng cáo đồng hành hoặc được cung cấp cho người dùng.

Đối với lưu lượng truy cập từ Khu vực kinh tế Châu Âu (EEA), những yêu cầu có &wta=0 sẽ không đủ điều kiện cho các mẫu quảng cáo đặt trước đã bật quy trình gắn huy hiệu của Google.

Quảng cáo phải tuân thủ các yêu cầu theo quy định hiện hành đối với quảng cáo được phân phát ở EEA. Chẳng hạn như một cơ chế để người dùng báo cáo nội dung bất hợp pháp. Nhà xuất bản phải thông báo cho Google về mọi báo cáo liên quan đến nội dung bất hợp pháp qua biểu mẫu thích hợp.

Ví dụ về cách sử dụng

Có hỗ trợ:

wta=1 hoặc không có tham số wta

Không hỗ trợ:
wta=0

Yêu cầu

Bắt buộc Yêu cầu đối với Ad Exchange

Bắt buộc Bắt buộc đối với lưu lượng truy cập qua webứng dụng ở Khu vực kinh tế Châu Âu (EEA)

được đề xuất Nên dùng cho hoạt động kiếm tiền có lập trình

Thông tin này có hữu ích không?

Chúng tôi có thể cải thiện trang này bằng cách nào?
Tìm kiếm
Xóa nội dung tìm kiếm
Đóng tìm kiếm
Trình đơn chính
12541972867174145248
true
Tìm kiếm trong Trung tâm trợ giúp
true
true
true
true
true
148
false
false