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

 Chuyể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 env excl_cat gdfp_req gdpr gdpr_consent hl

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

pmnd pmxd pod pp ppt ppid ppos ppsj ptpl ptpln pubf pvid pvid_s pvtf rdid rdp 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ố	Thông tin 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 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 đối với quảng cáo dạng âm thanh
addtl_consent (Additional Consent)	Thông số Sự đồng ý bổ sung chấp nhận các giá trị biến và được dùng bởi 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 đồng thời dùng một nhà cung cấp chưa được đăng ký trên Danh sách nhà cung cấp toàn cầu của IAB Châu Âu nhưng thuộc danh sách Nhà cung cấp công nghệ quảng cáo của Google (ATP). 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. Bạn có thể đọc thêm về các giá trị được chuyển sang thông số này trong Bản đặc tả kỹ thuật của Chế độ đồng ý bổ sung. Ví dụ về cách sử dụng addtl_consent=1~1.35.41.101
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 nonLinearAdSlotWidth và nonLinearAdSlotHeight. 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 đố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_d và allcues 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  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  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 để 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 đối với web và ứng dụng 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. Đó thường là trang chứa trình phát video, nhưng cũng có thể là trang có văn bản mô tả video. 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ã hóa 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 đối với web, ứng dụng và Ad Exchange Nên dùng cho hoạt động kiếm tiền có lập trình
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 đối với web và ứ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 Yêu cầu cho web và ứ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
gdpr_consent (Sự đồng ý theo GDPR)	Thông số Sự đồng ý theo GDPR (Quy định chung về bảo vệ dữ liệu) chấp nhận các giá trị biến và được dùng bởi 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 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. 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 gdpr_consent=GDPR_CONSENT_123
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 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 thành đơn vị quảng cáo hiện tại, trong định dạng: /network_id/.../ad_unit Ví dụ về cách sử dụng iu=/6062/videodemo Yêu cầu Yêu cầu cho web và ứ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. 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 Cả hai tham số này đều bắt buộc đối với ứng dụng 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 omidPartnerName và omidPartnerVersion để đặ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_p và sdk_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 đối với web và ứ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 đối với web và Kiế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
pod (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 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 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 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ấp và cá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_floor và pvtf 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 đối với ứng dụng 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, idtype và is_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. 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 đối với ứng dụng 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
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 đố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 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 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 đối với web và ứ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 đối với web và ứ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 đối với web và ứng dụng 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_d và allcues 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 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 đối với web và Kiế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 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)	Thông số "Tại sao có quảng cáo này?" chấp nhận giá trị không đổi. Giá trị này cho biết sự hỗ trợ của trình phát video để hiển thị mục "Tại sao có quảng cáo này?". Hệ thống tự động hỗ trợ tính năng "Tại sao có quảng cáo này?" khi 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ợ Icon và IconClickFallbackImage VAST, như được ghi trong tiêu chuẩn VAST của IAB. 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ư được 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ều kiện sử dụng Nhu cầu của Google và lưu lượng truy cập đặt trước do Google lưu trữ ở Khu vực kinh tế Châu Âu (EEA), các yêu cầu quảng cáo phải gửi wta=1 để cho biết rằng biểu tượng Lựa chọn quảng cáo (như được cung cấp trong phản hồi VAST) xuất hiện trên video quảng cáo, quảng cáo đồng hành hoặc quảng cáo khác được cung cấp cho người dùng (đối với tất cả các mẫu quảng cáo). Ví dụ về cách sử dụng Có hỗ trợ: wta=1 Không được hỗ trợ: wta=0 Yêu cầu Yêu cầu đối với Ad Exchange Bắt buộc đối với lưu lượng truy cập qua web và ứng dụng ở Khu vực kinh tế Châu Âu (EEA) Nên dùng cho hoạt động kiếm tiền có lập trình