Bài viết này trình bày danh sách các tham 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 quảng cáo kỹ thuật số ngoài trời.
Trên trang này
- Các tham số bắt buộc để phân phát quảng cáo
- Các tham 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
Bạn có thể xem danh sách các loại hình triển khai khác hoặc các yêu cầu về URL đối với thẻ quảng cáo VAST.
Các tham số bắt buộc và nên dùng cho quảng cáo kỹ thuật số ngoài trời
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
correlator (Tương quan)
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)
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 đồ)
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)
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)
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.
sz (Kích thước)
Mô tả
Tham số kích thước (sz) 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 dùng
Một kích thước:
sz=400x300
Nhiều kích thước:
sz=300x250|400x300
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 và quảng cáo kỹ thuật số ngoài trời.
tham số này không bắt buộc nếu chỉ yêu cầu ad_type=audio.
url (URL)
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ị)
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)
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í)
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)
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.
sid (Mã phiên)
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.
venuetype (Loại địa điểm)
Mô tả
tham số loại địa điểm (venuetype) dùng để cho biết loại địa điểm ngoài trời. Những giá trị đủ điều kiện là mã nhận dạng số nguyên được hệ thống phân loại địa điểm OpenOOH 1.1 theo IAB hỗ trợ.
Ví dụ về cách dùng
Phòng khách sạn:
venuetype=80703
Máy tính bảng ở ghế sau của taxi:
venuetype=103
Yêu cầu và đề xuất
Bạn bắt buộc phải sử dụng tham số này đối với 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.
vpmute (Tắt tiếng khi phát video)
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 tham số nên dùng cho quảng cáo có lập trình
aconp (Phát âm thanh liên tục)
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)
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ị)
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)
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ữ)
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)
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)
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.