Các tham số bắt buộc và nên dùng cho Chiến dịch có lập trình

Tính năng triển khai giải pháp video dựa trên thẻ cho nhu cầu Ad Exchange mà không sử dụng SDK IMA đang ở chế độ thử nghiệm và có thể không được cung cấp cho mạng của bạn. Bạn có thể liên hệ với người quản lý tài khoản của mình để biết thêm thông tin.

Sau đây là tập hợp con của các thông số URL cho thẻ quảng cáo VAST. Những tham số này là dành cho các giải pháp video dựa trên thẻ cho chiến dịch Quảng cáo có lập trình khi không tích hợp với SDK IMA.

Xem danh sách tham số bắt buộc và nên dùng cho web hoặc các tham số bắt buộc cho ứng dụng.

 Chuyển đến một thông số cụ thể trong danh sách

an description_url dth hl idtype is_lat

msid plcmt pp rdid sid url

vpa vpmute vpos wta

 

Thông số	Chi tiết
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
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 đố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
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 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.
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
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
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
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
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
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
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
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)	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ợ Icon và IconClickFallbackImage 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 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