Bài viết này trình bày danh sách các thông số bắt buộc và nên dùng cho thẻ quảng cáo VAST được sử dụng để phân phát quảng cáo trong quá trình triển khai trên nền tảng âm thanh.
Trên trang này
- Các thông số bắt buộc để phân phát quảng cáo
- Các thông số bắt buộc cho quảng cáo có lập trình
- Các thông số nên dùng cho quảng cáo có lập trình
Các tham số bắt buộc và nên dùng cho nền tảng âm thanh
Mở rộng tất cả Thu gọn tất cả
Các thông số bắt buộc để phân phát quảng cáo
ad_type (Loại quảng cáo)
Nội dung mô tả
Tham số loại quảng cáo (ad_type) chấp nhận giá trị hằng số cho biết loại quảng cáo sẽ được trả về cho yêu cầu.
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ị
audio_videonày cho phép cả hai định dạng cạnh tranh, nhưng chỉ có một định dạng phân phát. Giá trị này 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 phát cho nội dung về bản chất "có thể nghe được", chẳng hạn như luồng phát nội dung thể thao, phát video, tin tức, v.v. Hãy đọc thông tin về nội dung âm thanh trong video.
Chỉ chấp nhận quảng cáo dạng 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 và đề xuất
- Nếu ứng dụng của bạn có nội dung video, hãy đặt tham số này thành
video,audio_videohoặc không đặt tham số này. - Nếu ứng dụng của bạn chỉ có nội dung âm thanh (ví dụ: ứng dụng phát thanh hoặc ứng dụng giọng nói), bạn phải đặt tham số này thành
audio. Nếu bạn không đặt tham số này, hệ thống sẽ không trả về quảng cáo dạng âm thanh.
correlator (Tương quan)
Nội dung mô tả
Tham số tương quan (correlator) 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 tham 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.
Ví dụ về cách dùng
correlator=4345645667
Yêu cầu và đề xuất
Bạn phải sử dụng tham số này để triển khai tính năng phân phát quảng cáo trên web, ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
Sử dụng SDK
- Nếu bạn dùng SDK IMA, 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 SDK IMA, hãy đảm bảo rằng bạn đặt giá trị này thành một giá trị số giá trị số nguyên dương, thực sự ngẫu nhiên và không được sử dụng lại trong nhiều lượt xem trang.
env (Môi trường)
Nội dung mô tả
Tham số môi trường (env) 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 phát hay yêu cầu đó cụ thể là 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 dùng
Video và/hoặc âm thanh:
env=instream
Chỉ video:
env=vp
Yêu cầu và đề xuất
Bạn phải sử dụng tham số này để triển khai tính năng phân phát quảng cáo trên web, ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
Bạn phải sử dụng tham số này để báo cáo chính xác về loại yêu cầu được phân chia theo "Thẻ video".
gdfp_req (Chỉ báo giản đồ)
Nội dung mô tả
Tham số chỉ báo giản đồ Google Ad Manager (gdfp_req) chấp nhận một giá trị hằng số cho biết rằng yêu cầu quảng cáo là dành cho khoảng không quảng cáo của Google Ad Manager.
Ví dụ về cách dùng
gdfp_req=1
Yêu cầu và đề xuất
Bạn phải sử dụng tham số này để triển khai tính năng phân phát quảng cáo trên web, ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
iu (Đơn vị quảng cáo)
Nội dung mô tả
Tham số đơn vị quảng cáo (iu) 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, theo định dạng: /network_code/.../ad_unit.
Ví dụ về cách dùng
iu=/6062/videodemo
Yêu cầu và đề xuất
Bạn phải sử dụng tham số này để triển khai tính năng phân phát quảng cáo trên web, ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
output (Đầu ra)
Nội dung mô tả
Thông số định dạng đầu ra (output) 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.
Ví dụ về cách dùng
Sử dụng phiên bản VAST mặc định của mạng:
output=vast
Sử dụng VAST 4 (bạn có thể đặt phiên bản cụ thể cho các thẻ cụ thể):
output=xml_vast4
Sử dụng chế độ cài đặt VMAP mặc định của mạng:
output=vmap
Sử dụng VMAP 1:
output=xml_vmap1
Sử dụng VMAP 1, trả về VAST 4 (nếu bạn trả về VAST bên trong VMAP):
output=xml_vmap1_vast4
Yêu cầu và đề xuất
Bạn phải sử dụng thông số này để triển khai tính năng phân phát quảng cáo trên web, ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời. Bạn phải xuất đúng định dạng phản hồi phân phát quảng cáo.
Sử dụng SDK
Đố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 gây 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 của bên thứ ba đều có thể phân phát.
Phiên bản VAST cho Authorized Buyers và tính năng Đặt giá thầu mở
Nếu muốn lọc nghiêm ngặt dựa trên phiên bản VAST cho Authorized Buyers và tính năng Đặt giá thầu mở, bạn có thể bật chế độ cài đặt "Lọc nghiêm ngặt theo phiên bản VAST" trong phần cài đặt mạng.
url (URL)
Nội dung mô tả
tham số URL (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 bên 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 web, đây là URL của trang hiển thị trình phát video.
- Trong môi trường không phải web, 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 di động cũng có sẵn tại một URL tương đương trên máy tính.*
Lưu ý: url khác với description_url ở chỗ url đề cập đến vị trí mà yêu cầu quảng cáo được thực hiện, trong khi description_url là một trang web có thể thu thập thông tin mô tả nội dung video.
Giá trị của tham số này phải được mã hoá.
Ví dụ về cách dùng
url=https%3A%2F%2Fwww.example.com%2Fvideo.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 đổi, thì bạn nên đặt tham số này theo mẫu sau: url=https%3A%2F%2F<app/bundleid>.example.com
Yêu cầu và đề xuất
Bạn chỉ phải sử dụng tham số này cho hoạt động kiếm tiền có lập trình trên web, ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
Sử dụng SDK
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.
Các thông số bắt buộc cho quảng cáo có lập trình
idtype (Loại thiết bị)
Nội dung mô tả
tham số giá trị nhận dạng thiết bị có thể đặt lại (rdid, idtype, is_lat) chấp nhận các giá trị biến. Giá trị này còn được gọi là giá trị nhận dạng cho quảng cáo (IFA).
Với các ứng dụng di động sử dụng IMA SDK cho Android hoặc iOS, IMA SDK sẽ truyền giá trị nhận dạng 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 tham số cho rdid, idtype và is_lat.
Khi không sử dụng IMA SDK hoặc khi sử dụng tính năng báo hiệu phía máy chủ (SSB), bạn phải truyền các tham số này một cách rõ ràng. 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 |
Ví dụ về cách dùng
Xem ví dụ chi tiết về giá trị nhận dạng thiết bị có thể đặt lại.
Yêu cầu và đề xuất
Mặc dù không bắt buộc phải sử dụng các tham số này để phân phát quảng cáo cho bất kỳ phương thức triển khai cụ thể nào, nhưng bạn phải sử dụng các tham số này cho hoạt động kiếm tiền có lập trình trong ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
Đối với các hoạt động triển khai trên web, giá trị nhận dạng thiết bị có thể đặt lại sẽ không được sử dụng.
Sử dụng SDK
IMA SDK sẽ tự động truyền trường này, trừ phi idType được đặt thành dpid. Trong trường hợp này, nhà xuất bản sẽ cần phải truyền tham số rdid theo cách thủ công.
Nhà xuất bản sẽ cần truyền các tham số này theo cách thủ công khi sử dụng SDK PAL.
is_lat (Giới hạn việc theo dõi quảng cáo)
Nội dung mô tả
tham số giá trị nhận dạng thiết bị có thể đặt lại (rdid, idtype, is_lat) chấp nhận các giá trị biến. Giá trị này còn được gọi là giá trị nhận dạng cho quảng cáo (IFA).
Với các ứng dụng di động sử dụng IMA SDK cho Android hoặc iOS, IMA SDK sẽ truyền giá trị nhận dạng 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 tham số cho rdid, idtype và is_lat.
Khi không sử dụng IMA SDK hoặc khi sử dụng tính năng báo hiệu phía máy chủ (SSB), bạn phải truyền các tham số này một cách rõ ràng. 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 |
Ví dụ về cách dùng
Xem ví dụ chi tiết về giá trị nhận dạng thiết bị có thể đặt lại.
Yêu cầu và đề xuất
Mặc dù không bắt buộc phải sử dụng các tham số này để phân phát quảng cáo cho bất kỳ phương thức triển khai cụ thể nào, nhưng bạn phải sử dụng các tham số này cho hoạt động kiếm tiền có lập trình trong ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
Đối với các hoạt động triển khai trên web, giá trị nhận dạng thiết bị có thể đặt lại sẽ không được sử dụng.
Sử dụng SDK
IMA SDK sẽ tự động truyền trường này, trừ phi idType được đặt thành dpid. Trong trường hợp này, nhà xuất bản sẽ cần phải truyền tham số rdid theo cách thủ công.
Nhà xuất bản sẽ cần truyền các tham số này theo cách thủ công khi sử dụng SDK PAL.
plcmt (Vị trí)
Nội dung mô tả
Tham số vị trí (plcmt) chấp nhận một giá trị hằng số 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 ngoài luồng phát, tham số 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 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 và đề xuất
Bạn phải sử dụng tham số này cho hoạt động kiếm tiền có lập trình trên web, ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
rdid (Giá trị nhận dạng thiết bị có thể đặt lại)
Nội dung mô tả
tham số giá trị nhận dạng thiết bị có thể đặt lại (rdid, idtype, is_lat) chấp nhận các giá trị biến. Giá trị này còn được gọi là giá trị nhận dạng cho quảng cáo (IFA).
Với các ứng dụng di động sử dụng IMA SDK cho Android hoặc iOS, IMA SDK sẽ truyền giá trị nhận dạng 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 tham số cho rdid, idtype và is_lat.
Khi không sử dụng IMA SDK hoặc khi sử dụng tính năng báo hiệu phía máy chủ (SSB), bạn phải truyền các tham số này một cách rõ ràng. 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 |
Ví dụ về cách dùng
Xem ví dụ chi tiết về giá trị nhận dạng thiết bị có thể đặt lại.
Yêu cầu và đề xuất
Mặc dù không bắt buộc phải sử dụng các tham số này để phân phát quảng cáo cho bất kỳ phương thức triển khai cụ thể nào, nhưng bạn phải sử dụng các tham số này cho hoạt động kiếm tiền có lập trình trong ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
Đối với các hoạt động triển khai trên web, giá trị nhận dạng thiết bị có thể đặt lại sẽ không được sử dụng.
Sử dụng SDK
IMA SDK sẽ tự động truyền trường này, trừ phi idType được đặt thành dpid. Trong trường hợp này, nhà xuất bản sẽ cần phải truyền tham số rdid theo cách thủ công.
Nhà xuất bản sẽ cần truyền các tham số này theo cách thủ công khi sử dụng SDK PAL.
vpa (Tự động phát video)
Nội dung mô tả
tham số tự động phát video (vpa) 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. tham số này không thay đổi trạng thái của trình phát video mà hoạt động phát phải do trình phát video trực tiếp xử lý.
Ví dụ về cách dùng
Tự động phát:
vpa=auto
Nhấp để phát:
vpa=click
Bạn không nên đặt tham số này nếu đó là tham số không xác định.
Yêu cầu và đề xuất
Bạn phải sử dụng tham số này cho hoạt động kiếm tiền có lập trình trên web, ứng dụng di động, TV thông minh và nền tảng âm thanh.
Bạn cũng nên sử dụng tham số này theo Hướng dẫn đo lường video của Hội đồng xếp hạng truyền thông (MRC).
vpmute (Tắt tiếng khi phát video)
Nội dung mô tả
Tham số tắt tiếng khi phát video (vpmute) chấp nhận giá trị hằng số, cho biết liệu quá trình phát quảng cáo có bắt đầu khi trình phát video bị tắt tiếng hay không. tham số này không thay đổi trạng thái của trình phát video mà hoạt động phát phải do trình phát video trực tiếp xử lý.
Ví dụ về cách dùng
Quá trình phát bắt đầu ở trạng thái tắt tiếng:
vpmute=1
Quá trình phát bắt đầu ở trạng thái bật tiếng:
vpmute=0
Yêu cầu và đề xuất
Bạn phải sử dụng tham số này cho hoạt động kiếm tiền có lập trình trên web, ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
Bạn cũng nên sử dụng tham số này theo Hướng dẫn đo lường video của Hội đồng xếp hạng truyền thông (MRC).
Các thông số nên dùng cho quảng cáo có lập trình
aconp (Phát âm thanh liên tục)
Nội dung mô tả
Tham số âm thanh phát liên tục (aconp) 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. Điều này giúp Google Ad Manager chọn quảng cáo phù hợp nhất cho trải nghiệm người dùng.
Ví dụ về cách 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
Nếu bạn không biết liệu âm thanh có phát liên tục hay không, bạn không nên đặt tham số này hoặc đặt thành aconp=0.
Yêu cầu và đề xuất
Mặc dù không bắt buộc phải sử dụng tham số này để phân phát quảng cáo cho bất kỳ loại phương thức triển khai cụ thể nào, nhưng bạn nên sử dụng tham số này cho hoạt động kiếm tiền có lập trình trên web, ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
Bạn cũng nên sử dụng tham số này theo Hướng dẫn đo lường âm thanh của Hội đồng xếp hạng truyền thông (MRC).
an (Tên ứng dụng)
Nội dung mô tả
Tham số mã ứng dụng (msid) và tham số tên ứng dụng (an) chấp nhận các giá trị biến. Bạn có thể sử dụng các giá trị này cho những yêu cầu được gửi từ ứng dụng di động và thiết bị kết nối Internet cho TV, vì hầu hết quảng cáo dạng video có lập trình đều cần đến các giá trị này.
Tên ứng dụng phải là tên mà con người có thể đọc được.
Ví dụ về cách 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 những 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 và đề xuất
Mặc dù không bắt buộc phải sử dụng thông số này để phân phát quảng cáo cho bất kỳ phương thức triển khai cụ thể nào, nhưng bạn nên sử dụng thông số này cho hoạt động kiếm tiền có lập trình trên ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
Để đảm bảo an toàn cho thương hiệu và tăng cường sự minh bạch cho người mua, bạn nên thêm thông tin về ứng dụng.
Sử dụng SDK
Ngoại trừ iOS và tvOS, IMA SDK 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).
Trên iOS và tvOS, IMA SDK hoặc PAL không thể truy cập vào mã ứng dụng. Trong những trường hợp này, tham số msid không được gửi và SDK gửi gói ứng dụng qua tham số an.
Lưu ý: Nếu bạn sử dụng IMA SDK HTML5, thông tin ứng dụng sẽ không được sử dụng.
dth (Gợi ý về loại thiết bị)
Nội dung mô tả
Thông số gợi ý loại thiết bị (dth) 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 Nhà sản xuất thiết bị gốc (OEM) của TV thông minh. Thông 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 có 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 và đề xuất
Mặc dù tham số này không phải là bắt buộc để phân phát quảng cáo cho bất kỳ phương thức triển khai cụ thể nào, nhưng bạn nên sử dụng để kiếm tiền từ quảng cáo có lập trình trên web, ứng dụng di động, môi trường TV có kết nối Internet và hộp giải mã tín hiệu số, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
givn (Số chỉ dùng một lần cho video)
Nội dung mô tả
Đối với các hoạt động tích hợp sử dụng Thư viện truy cập có lập trình (PAL), tham số số chỉ dùng một lần cho video sẽ chấp nhận giá trị chuỗi biến.
Số chỉ dùng một lần an toàn cho URL – bạn không cần phải mã hoá số này thành URL.
Lưu ý: Nếu trước đây bạn đã cung cấp số chỉ dùng một lần bằng tham số paln cũ, bạn nên chuyển sang tham số givn và ngừng gửi paln. Không gửi cả hai tham số.
Ví dụ về cách dùng
Bạn có thể đọc thêm về giá trị được truyền đến tham số này trong hướng dẫn bắt đầu sử dụng cho PAL.
Yêu cầu và đề xuất
Mặc dù không bắt buộc phải sử dụng tham số này để phân phát quảng cáo cho bất kỳ loại phương thức triển khai cụ thể nào, nhưng bạn nên sử dụng tham số này cho hoạt động kiếm tiền có lập trình trên web, ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
hl (Ngôn ngữ)
Nội dung mô tả
Tham số ngôn ngữ (hl) 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ữ 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.
Ví dụ về cách dùng
Yêu cầu quảng cáo bằng tiếng Việt:
hl=vi
Giá trị tham 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.
Yêu cầu và đề xuất
Mặc dù không bắt buộc phải sử dụng tham số này để phân phát quảng cáo cho bất kỳ loại phương thức triển khai cụ thể nào, nhưng bạn nên sử dụng tham số này cho hoạt động kiếm tiền có lập trình trên web, ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
msid (Mã ứng dụng)
Nội dung mô tả
Tham số mã ứng dụng (msid) và tham số tên ứng dụng (an) chấp nhận các giá trị biến. Bạn có thể sử dụng các giá trị này cho những yêu cầu được gửi từ ứng dụng di động và thiết bị kết nối Internet cho TV, vì hầu hết quảng cáo dạng video có lập trình đều cần đến các giá trị này.
Tên ứng dụng phải là tên mà con người có thể đọc được.
Ví dụ về cách 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 những 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 và đề xuất
Mặc dù không bắt buộc phải sử dụng thông số này để phân phát quảng cáo cho bất kỳ phương thức triển khai cụ thể nào, nhưng bạn nên sử dụng thông số này cho hoạt động kiếm tiền có lập trình trên ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
Để đảm bảo an toàn cho thương hiệu và tăng cường sự minh bạch cho người mua, bạn nên thêm thông tin về ứng dụng.
Sử dụng SDK
Ngoại trừ iOS và tvOS, IMA SDK 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).
Trên iOS và tvOS, IMA SDK hoặc PAL không thể truy cập vào mã ứng dụng. Trong những trường hợp này, tham số msid không được gửi và SDK gửi gói ứng dụng qua tham số an.
Lưu ý: Nếu bạn sử dụng IMA SDK HTML5, thông tin ứng dụng sẽ không được sử dụng.
omid_p (Tên đối tác OMID)
Nội dung mô tả
Tham số tên đối tác OMID (omid_p) chấp nhận một giá trị biến biểu thị 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ố API SDK được hỗ trợ (sdk_apis) chấp nhận các giá trị biến có thể là một API được hỗ trợ hoặc một danh sách API được hỗ trợ được phân tách bằng dấu phẩy.
Các tham số này là một phần của một tập hợp tham số dùng để xác minh khả năng xem và quảng cáo.
Ví dụ về cách dùng
Khi không sử dụng PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7
Hãy xem danh sách các giá trị Khung API có thể áp dụng.
Khi sử dụng PAL:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'
Yêu cầu và đề xuất
Mặc dù không bắt buộc phải sử dụng tham số này để phân phát quảng cáo cho bất kỳ loại phương thức triển khai cụ thể nào, nhưng bạn nên sử dụng tham số này cho hoạt động kiếm tiền có lập trình trên web, ứng dụng di động, TV thông minh, nền tảng âm thanh và quảng cáo kỹ thuật số ngoài trời.
Sử dụng SDK
- Tham số này chỉ áp dụng cho những nhà xuất bản muốn đo lường bằng Active View khi sử dụng SDK Đo lường mở (SDK OM).
- Để biểu thị 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
omidPartnerNamevàomidPartnerVersionđể đặt tên và phiên bản cho đối tác. Khi không sử dụng SDK PAL hoặc IMA, bạn phải đặt các tham sốomid_pvàsdk_apis. - Bạn không nên dùng tham số này khi sử dụng SDK IMA do SDK IMA được đặt tự động.
sid (Mã phiên)
Nội dung mô tả
Tham số mã phiên (sid) chấp nhận giá trị biến, là mã nhận dạng cho quảng cáo bảo đảm 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 thông minh 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.
Bạn có thể chọn không truyền mã phiên này bằng cách đặt sid=0.
Ví dụ về cách dùng
sid=123e4567-e89b-12d3-a456-426614174000
Bạn phải điền tham 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.
Yêu cầu và đề xuất
Mặc dù không bắt buộc phải sử dụng tham số này để phân phát quảng cáo cho bất kỳ phương thức triển khai cụ thể nào, nhưng bạn cần có tham số này cho hoạt động kiếm tiền có lập trình trong quảng cáo kỹ thuật số ngoài trời.
Bạn nên sử dụng tham số này cho hoạt động kiếm tiền có lập trình trong ứng dụng di động, TV thông minh và nền tảng âm thanh.
Sử dụng SDK
IMA SDK tự động gửi tham số này.
vconp (Phát video liên tục)
Nội dung mô tả
tham số phát video liên tục (vconp) 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.
Ví dụ về cách 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
Bạn không nên đặt tham số này nếu đó là tham số không xác định.
Yêu cầu và đề xuất
Mặc dù không bắt buộc phải sử dụng tham số này để phân phát quảng cáo cho bất kỳ phương thức triển khai cụ thể nào, nhưng bạn nên sử dụng tham số này cho hoạt động kiếm tiền có lập trình trên web, ứng dụng di động, TV thông minh và nền tảng âm thanh.
Bạn cũng nên sử dụng tham số này theo Hướng dẫn đo lường video của Hội đồng xếp hạng truyền thông (MRC).
vpos (Vị trí video)
Nội dung mô tả
tham số vị trí video (vpos) chấp nhận giá trị hằng số, 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 dùng
Trước video:
vpos=preroll
Trong video:
vpos=midroll
Sau video:
vpos=postroll
Yêu cầu và đề xuất
Mặc dù không bắt buộc phải sử dụng tham số này để phân phát quảng cáo cho bất kỳ phương thức triển khai cụ thể nào, nhưng bạn nên sử dụng tham số này cho hoạt động kiếm tiền có lập trình trên web, ứng dụng di động, TV thông minh và nền tảng âm thanh.
Nếu sử dụng quy tắc quảng cáo, thì bạn không cần tham số này vì máy chủ quảng cáo sẽ tự động thêm tham số này.
wta (Tại sao có quảng cáo này)
Nội dung mô tả
Tham số "Tại sao có quảng cáo này?" (wta) 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ị quá trình gắn huy hiệu cho quảng cáo.
Ví dụ về cách dùng
Nếu trình phát hiển thị biểu tượng Lựa chọn quảng cáo được cung cấp trong phản hồi VAST, hãy sử dụng:
wta=1(hoặc bỏ qua tham sốwtahoặc truyềnwtamà không đặt giá trị)Yêu cầu quảng cáo dạng âm thanh cần sử dụng
wta=1nếu biểu tượng Lựa chọn quảng cáo được cung cấp trong phản hồi VAST sẽ được hiển thị trên quảng cáo đồng hành hoặc được cung cấp cho người dùng.
Nếu trình phát không hiển thị biểu tượng Lựa chọn quảng cáo được cung cấp trong phản hồi VAST, hãy sử dụng:
wta=0
Yêu cầu và đề xuất
Mặc dù không bắt buộc phải sử dụng tham số này để phân phát quảng cáo cho bất kỳ loại phương thức triển khai cụ thể nào, nhưng bạn nên sử dụng tham số này cho hoạt động kiếm tiền có lập trình cho quảng cáo trên web, ứng dụng di động, TV thông minh và dạng âm thanh.
Trường hợp sử dụng tham số:
- Lưu lượng truy cập
&wta=0không đủ điều kiện cho một số loại cá nhân hoá nhất định mà Nhu cầu của Google cung cấp. - Lưu lượng truy cập
&wta=0từ Khu vực kinh tế Châu Âu (EEA) không đủ điều kiện cho các mẫu quảng cáo đã bật tính năng gắn huy hiệu cho quảng cáo trên mục hàng đặt trước và mục hàng Đảm bảo có lập trình do nhà xuất bản quản lý.
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. Quy định này có cả 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 bằng biểu mẫu Báo cáo nội dung vi phạm trên Google.
Sử dụng SDK
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ư được nêu trong tiêu chuẩn VAST của IAB.