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
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ụngTính năng phát liên tục BẬT: Tính năng phát liên tục TẮT: |
|
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ụngYêu cầu đối với mẫu quảng cáo VAST: Yêu cầu đối với quy tắc quảng cáo (VMAP): Yêu cầu
|
|
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. Ví dụ về cách dùngChỉ chấp nhận quảng cáo dạng âm thanh: Chấp nhận cả quảng cáo dạng video có thể bỏ qua và không thể bỏ qua: Chấp nhận cả quảng cáo dạng âm thanh và quảng cáo dạng video: 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: Chỉ chấp nhận quảng cáo dạng video không thể bỏ qua: Yêu cầu
|
|
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
|
|
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ợ:
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ụngTất cả kích thước được hỗ trợ: Với chiều rộng tối đa là 250: Với chiều cao tối đa là 60: Với chiều rộng tối đa là 100:
Yêu cầu
|
|
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ố 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 Ví dụ về cách sử dụngĐiểm dừng ở 10 và 20 giây: |
|
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 ( Ví dụ về cách sử dụng
Kích thước có vị trí nhiều kích thước: |
|
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.
Ví dụ về cách sử dụng
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ụ: Yêu cầu
|
|
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
Yêu cầu
|
|
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ụngXem 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ị 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ụngURL được mã hóa: Không được mã hóa: Yêu cầu
|
|
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 sử dụngYêu cầu của một TV thông minh: Yêu cầu của một môi trường hộp giải mã tín hiệu số: Yêu cầu
Bạn nên sử dụng tham số này cho các hoạt động triển khai PAL và PAI (không phải SDK). Bạn không cần sử dụng tham số này cho SDK IMA hoặc SDK DAI. |
|
env
(Môi trường) |
Thông số môi trường chấp nhận một giá trị hằng số. Giá trị này cho biết đó là một yêu cầu trong luồng hoặc yêu cầu là cụ thể từ trình phát video. Bạn có thể sử dụng giá trị Ví dụ về cách sử dụngVideo và/hoặc âm thanh: Chỉ video: Yêu cầu |
|
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 Ví dụ về cách sử dụng
|
|
gdfp_req
(Chỉ báo trong giản đồ của Ad Manager) |
||
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: Không áp dụng GDPR: |
|
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
|
|
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
Yêu cầu
|
|
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
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 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 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ụngBáo hiệu phía máy chủ (SSB): |
|
iu
(Đơn vị quảng cáo) |
||
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
|
|
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.
Ví dụ về cách sử dụng
|
|
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
|
|
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
|
|
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ố Ví dụ về cách sử dụng
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: Yêu cầu
|
|
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ụngChức năng dự phòng bị vô hiệu hóa: |
|
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ể Ví dụ về cách sử dụngQuảng cáo không được cá nhân hóa: |
|
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 Ví dụ về cách sử dụngKhi sử dụng PAL: Khi không sử dụng PAL: |
|
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 Đố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 Sử dụng Ví dụ về cách sử dụngChế độ cài đặt VAST mặc định của mạng của bạn: VAST 4: Chế độ cài đặt VAST mặc định của mạng của bạn: VMAP 1: VMAP 1, trả lại VAST 4: Yêu cầu |
|
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ụngYêu cầu trong luồng phát: Yêu cầu nội dung đi kèm: Yêu cầu |
|
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 Ví dụ về cách sử dụng
|
|
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 Ví dụ về cách sử dụng
|
|
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
Yêu cầu
|
|
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
Yêu cầu
|
|
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ụngTắt chế độ cá nhân hoá quảng cáo: |
|
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
|
|
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
Yêu cầu
|
|
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 Ví dụ về cách sử dụngĐối tượng JSON: Giá trị được mã hoá base64: |
|
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 đó. Ví dụ về cách sử dụngBạ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) |
Ví dụ về cách sử dụng
|
|
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ố 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
Yêu cầu
|
|
rdid
(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 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.
Ví dụ về cách sử dụngXem 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
|
|
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ể Ví dụ về cách sử dụng
|
|
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
Yêu cầu
|
|
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
|
|
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 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 Ví dụ về cách sử dụngSử dụng các chế độ cài đặt sau:
Cho các mẫu quảng cáo sau:
Kết quả:
|
|
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 Ví dụ về cách sử dụng
Yêu cầu
|
|
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
Yêu cầu
|
|
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í dụ về cách sử dụng
Yêu cầu
Thông số này là không bắt buộc nếu chỉ yêu cầu |
|
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
|
|
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à Ví dụ về cách sử dụngYêu cầu đối với lưu lượng truy cập đã mua: Yêu cầu đối với lưu lượng không phải trả tiền: |
|
unviewed_position_start
(Lượt hiển thị bị trì hoãn) |
||
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
* Đố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: Yêu cầu
|
|
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ụngTrả lại quảng cáo tuyến tính: Trả lại quảng cáo phi tuyến tính: |
|
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ố Ví dụ về cách sử dụngThời lượng nội dung video 90000 giây (25 giờ): |
|
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ụngTính năng phát liên tục BẬT: Tính năng phát liên tục TẮT: |
|
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à 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ụngTự động phát: Nhấp để phát: Yêu cầu
|
|
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ụngTrả lại VAST: Trả lại lệnh chuyển hướng: |
|
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ụngTắt tiếng: Bật tiếng: Yêu cầu |
|
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ụngVị trí trước video: Vị trí trong video: Vị trí sau video: Yêu cầu
|
|
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ố 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ợ Nhà xuất bản bắt buộc phải gửi Yêu cầu quảng cáo dạng âm thanh phải gửi Đố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ó 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ụngCó hỗ trợ:
Không hỗ trợ: Yêu cầu
|