Cung cấp thông số nhắm mục tiêu đến luồng của bạn

Việc cung cấp bất kỳ thông số nhắm mục tiêu nào sau đây đều là không bắt buộc.

Khi bạn tạo hoặc định cấu hình nguồn nội dung cho video theo yêu cầu (VOD) hoặc thiết lập tính năng phát trực tiếp cho DAI, bạn cần xác định một thẻ quảng cáo dạng video mặc định. Tất cả các luồng DAI đều sử dụng thẻ quảng cáo đó và các thông số của thẻ theo mặc định. Tham số thẻ quảng cáo áp dụng cho cả quảng cáo trong video và trước video. Nếu muốn trình phát của mình yêu cầu một nội dung duy nhất cho một luồng nhất định, bạn có thể sử dụng các lựa chọn sau.

Nội dung trong bài viết này:

• Các tham số thẻ quảng cáo có thể bị ghi đè trong Ad Manager
• Ghi đè thẻ quảng cáo mặc định
• Ghi đè thẻ quảng cáo mặc định bằng cách sử dụng IMA SDK
• Ghi đè thẻ quảng cáo mặc định bằng cách sử dụng DAI API
• Ghi đè thẻ quảng cáo mặc định bằng cách sử dụng SSB
• Truyền tham số nhắm mục tiêu tuỳ chỉnh đến máy chủ quảng cáo của bên thứ ba trong tính năng Chèn quảng cáo động (DAI) của Google (tham số pt_)
• Cập nhật linh động tham số nhắm mục tiêu trong luồng trực tiếp cụ thể

Các tham số thẻ quảng cáo có thể bị ghi đè trong Ad Manager

Chuyển đến một tham số cụ thể:

addtl_consent an ciu_szs cust_params description_url gdpr gdpr_consent givn|paln idtype is_lat iu

iu is_lat ltd mpt mpv npa omid_p ppid ptpl ptpln rdid

rdp sdk_apis sid sz tfat tfcd trt vconp vpa vpmute wta

 

Ghi đè thẻ quảng cáo mặc định

Khi trình phát video của bạn yêu cầu một luồng thì hệ thống sẽ sử dụng thẻ quảng cáo mặc định đúng như bạn đã xác định trong giao diện. Tuy nhiên, bạn có thể ghi đè một số thông số nhất định của thẻ đó trong yêu cầu luồng của mình. Dưới đây là các thông số bạn có thể ghi đè.

Tìm hiểu cách ghi đè thẻ quảng cáo mặc định bằng cách sử dụng IMA SDK hoặc sử dụng SSB.

Tham số	Mô tả	Giá trị mẫu
iu	Đơn vị quảng cáo hiện tại. Theo định dạng như sau: /network_id/directory/ad_unit	iu=/6062/video/example_unit
cust_params	Cặp khóa-giá trị dùng để nhắm mục tiêu trong chiến dịch Ad Manager. Một số nền tảng yêu cầu mã hoá URL. Yêu cầu mã hoá URL không áp dụng khi sử dụng IMA DAI SDK cho HTML5, do giá trị được mã hoá tự động. Tham số này sẽ không hoạt động nếu đã được mã hoá trên HTML5.	Ví dụ với nhiều cặp khoá-giá trị, chẳng hạn như: section=sports  page=golf,tennis   Luồng SSB: Mã hoá và liên kết toàn bộ giá trị cust_params, nhưng không mã hoá kép. cust_params=   "section%3Dsports   %26page%3Dgolf%2Ctennis"   Chromecast: Chỉ mã hoá giá trị. streamRequest. adTagParameters = {   "cust_params":   "section=sports&   multi=golf%2Ctennis"};   Roku: Mã hoá và liên kết toàn bộ giá trị cust_params, nhưng không mã hoá kép. request.adTagParameters =   "cust_params=   section%3Dsports   %26page%3Dgolf%2Ctennis"   iOS và tvOS: Không mã hoá bất kỳ giá trị nào. request.adTagParameters = @{   @"cust_params" :   @"section=sports&   multi=golf,tennis"};   Android: Không mã hoá bất kỳ giá trị nào. Map<String, String> adTagParams =   new HashMap<>();   adTagParams.put(   "cust_params",   "ge=0&gr=2");
sz	Ghi đè thông số sz trong thẻ quảng cáo mặc định của bạn để cho phép bạn thay đổi theo các thiết bị khác nhau. Không có "v" sau kích thước.	sz=400x300
tfat	Gắn thẻ yêu cầu là xử lý theo độ tuổi. Khi một yêu cầu DAI chứa tfat=1, bất kỳ giá trị nào được gán cho các tham số rdid, idtype hoặc is_lat đều bị xoá để tuân thủ COPPA. tfat=1 cho biết chế độ xử lý nội dung dành cho trẻ em tfat=2 cho biết chế độ xử lý nội dung dành cho thanh thiếu niên tfat=0 cho biết không có chế độ xử lý cụ thể theo độ tuổi	tfat=1 tfat=2 tfat=0
tfcd(Đã ngừng hoạt động)	Gắn thẻ yêu cầu là nội dung hướng đến trẻ em. Khi yêu cầu DAI gồm tfcd=1, thì bất kỳ giá trị nào được gán cho rdid, idtype hoặc thông số is_lat đều bị xóa để tuân thủ theo COPPA (Đạo luật bảo vệ quyền riêng tư của trẻ em trên mạng).	tfcd=1
description_url	Giá trị phải 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 chứa văn bản mô tả video. Bạn luôn phải mã hoá URL description_url trên luồng SSB và khi sử dụng IMA DAI SDK cho Roku. Yêu cầu này không áp dụng khi sử dụng IMA DAI SDK cho HTML5, do giá trị được mã hoá tự động. Tham số này sẽ không hoạt động nếu đã được mã hoá trên HTML5. IMA SDK không tự động đặt tham số này. Bạn phải đặt thông số này theo cách thủ công. Trường này là bắt buộc nếu bạn sử dụng Ad Exchange. Tìm hiểu thêm	Mẫu URL được mã hoá: description_url= http%3A%2F%2Fwww.sample.com %2Fgolf.html Ví dụ không mã hoá: description_url= http://www.sample.com/ golf.html
ppid	Giá trị nhận dạng do nhà xuất bản cung cấp (PPID) cho phép nhà xuất bản gửi số nhận dạng để sử dụng trong tính năng giới hạn tần suất, nhắm mục tiêu và phân khúc đối tượng, xoay vòng quảng cáo tuần tự và các tuỳ chọn kiểm soát phân phối quảng cáo dựa trên đối tượng khác trên các thiết bị. Tìm hiểu thêm	ppid= 12JD92J...
ciu_szs	Danh sách kích thước quảng cáo đồng hành được phân tách bằng dấu phẩy. Quảng cáo đồng hành chỉ được hỗ trợ với DAI khi bạn sử dụng SDK HTML5.	ciu_szs=728x90,300x250
mpt	Cho biết tên của trình phát đối tác. Thông tin này chủ yếu sẽ được các đối tác đang tích hợp với SDK như JWPlayer hoặc Brightcove sử dụng.	mpt=JWPlayer
mpv	Cho biết phiên bản của trình phát đối tác. Bạn chỉ nên đặt giá trị này nếu mpt cũng được đặt và thể hiện phiên bản của trình phát đối tác đang tích hợp với SDK.	mpv=2.1
ptpl	Mã mẫu điểm chèn quảng cáo. Bạn có thể tìm thấy mã này trong URL Ad Manager khi xem các chế độ cài đặt cho mẫu điểm chèn trong giao diện của Ad Manager. Thông tin xuất hiện dưới dạng giá trị cho thông số break_template_id.	ptpl=1234
ptpln	Tên mẫu điểm chèn quảng cáo. Thông tin này tương ứng với trường "Tên" trong Ad Manager, chứ không phải tên hiển thị.	ptpln=my_break_template
an	Thông số an là tên của ứng dụng. Bạn nên áp dụng tham số này cho các yêu cầu gửi từ ứng dụng di động và thiết bị truyền hình có kết nối Internet, vì hầu hết quảng cáo dạng video có lập trình đều cần tham số này.* IMA SDK sẽ tự động điền sẵn thông tin này, nhưng thông tin đó phải được chỉ định theo cách thủ công với API DAI và SSB (môi trường không phải SDK). * Tuy tên ứng dụng phải là tên mà con người có thể đọc được, nhưng trên iOS và tvOS, SDK không thể truy cập Mã cửa hàng ứng dụng gồm 9 chữ số. Trong những trường hợp này, SDK sẽ gửi gói ứng dụng qua tham số an (ở định dạng com.package.publisher).	an=sample%20app
ltd	Cho biết có nên phân phát quảng cáo theo cách giới hạn trong trường hợp không có sự đồng ý của người dùng về việc sử dụng cookie hoặc giá trị nhận dạng cục bộ khác hay không. Tìm hiểu thêm	ltd=1
rdid idtype is_lat	Với các ứng dụng gốc (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 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 Giải pháp video phía khách hàng. 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.	Xem ví dụ chi tiết về giá trị nhận dạng thiết bị có thể đặt lại.
trt	Chỉ định lưu lượng truy cập là đã mua hoặc loại khác.	Loại lưu lượng truy cập không xác định: trt=0 Lưu lượng truy cập đã mua: trt=1 Lưu lượng truy cập tự nhiên: trt=2
vconp	Đề xuất theo MRC Hướng dẫn đo lường video Cho biết liệu trình phát có ý định liên tục phát lần lượt các video nội dung, tương tự như phát sóng trên truyền hình hay không. Các giá trị bạn có thể sử dụng là 2 nếu tính năng phát liên tục BẬT và 1 nếu tính năng TẮT. Bạn không nên đặt thông số này nếu đó là thông số không xác định.	BẬT tính năng phát liên tục: vconp=2   TẮT tính năng phát liên tục: vconp=1
vpa	Đề xuất theo MRC Hướng dẫn đo lường video Cho biết quảng cáo sẽ bắt đầu thông qua chức 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.	Tự động phát: vpa=auto   Lượt nhấp: vpa=click
vpmute	Đề xuất theo MRC Hướng dẫn đo lường video Cho biết liệu hoạt động 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. Các giá trị có thể là 1 nếu trình phát tắt tiếng, và là 0 nếu trình phát bật tiếng. Bạn không nên đặt thông số này nếu đó là thông số không xác định.	Tắt tiếng: vpmute=1   Bật tiếng: vpmute=0
npa	Tùy chọn cài đặt cá nhân hóa cho yêu cầu quảng cáo. Bạn phải sớm chỉ định thông số trong thẻ để tránh mọi nguy cơ bị cắt bớt nội dung. Chỉ định npa=1 để đánh dấu yêu cầu quảng cáo là không được cá nhân hóa. Việc bỏ qua tham số này đồng nghĩa với việc cho phép quảng cáo được cá nhân hoá theo mặc định.	npa=1
omid_p	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 bằng Active View khi sử dụng SDK Đo lường mở (OM SDK). Bạn không nên sử dụng tham số này khi sử dụng IMA SDK do IMA SDK đượ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).	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
gdpr gdpr_consent	Các trường này được dùng để chuyển Thông tin về sự đồng ý của TCF v2.0 cho cả yêu cầu đồng bộ hóa cookie trong và ngoài giới hạn.	Xem thông số kỹ thuật của GDPR.
givn|paln	Đố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 bao gồm cả hai tham số.	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.
addtl_consent	Một danh sách các Nhà cung cấp Công nghệ Quảng cáo Google được đồng ý nhưng chưa đăng ký với IAB.	Xem thông số kỹ thuật về Sự đồng ý bổ sung.
rdp	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ế xử lý dữ liệu. Các yêu cầu quảng cáo thiếu thông số này hoặc được đặt thành rdp=0, sẽ không hạn chế, trừ khi chế độ cài đặt mạng Hạn chế xử lý dữ liệu đã bật.	rdp=1
sdk_apis	Tham số khung SDK API chấp nhận danh sách giá trị số nguyên không đổi được phân tách bằng dấu phẩy. Tham số này cho biết tất cả cá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. Tham số này dành cho các nhà xuất bản sử dụng Thư viện truy cập có lập trình (PAL). Nếu bạn cố gắng đặt giá trị cho tham số này trong khi sử dụng IMA SDK, thì các giá trị đó sẽ bị ghi đè bằng các giá trị mà IMA SDK hỗ trợ.	sdk_apis=2,7,9
sid	Loại mã nhận dạng cho quảng cáo giúp đảm bảo quyền riêng tư chỉ có thể dùng cho mục đích giới hạn tần suất. Bạn phải điền tham số này theo định dạng UUID. Tìm hiểu thêm Bạn có thể chọn không chuyển mã phiên này bằng cách đặt sid=0.	sid=123e4567-e89b-12d3 -a456-426614174000
wta	Cho biết trình phát video có hỗ trợ việc hiển thị thông báo "Tại sao có quảng cáo này?" hay không. Hoạt động này được hỗ trợ tự động khi sử dụng IMA SDK. Khi không sử dụng IMA SDK, trình phát video phải triển khai việc hỗ trợ Icon và IconClickFallbackImage VAST, như được nêu trong hướng dẫn API DAI này.*  Hệ thống không hỗ trợ WTA cho SSB. Trường này là bắt buộc nếu bạn sử dụng Ad Exchange. Tìm hiểu thêm * Không bắt buộc phải hỗ trợ IconClickFallbackImage, ngoại trừ trên thiết bị TV kết nối Internet.	Có hỗ trợ: wta=1 Không hỗ trợ: wta=0

Ghi đè thẻ quảng cáo mặc định bằng cách sử dụng IMA SDK

Khi yêu cầu một luồng DAI bằng cách sử dụng IMA SDK, thì trình phát video có thể chuyển vào một trường có tên gọi "adTagParameters". Bạn có thể thiết lập cấu trúc giống từ điển này cho các cặp khóa-giá trị mà tại đó khóa có thể là thông số thẻ quảng cáo Ad Manager đã liệt kê trong bảng trên.

Bạn cũng có thể tùy chỉnh luồng của mình và đưa vào các thông số không liên quan đến yêu cầu quảng cáo Ad Manager bằng cách sử dụng cấu trúc tương tự này. Hãy tìm hiểu cách yêu cầu các biến thể của luồng cụ thể và cách thiết lập tính năng nghỉ quảng cáo.

Cách triển khai trường adTagParameters sẽ khác nhau một chút, tùy thuộc vào ngôn ngữ lập trình hoặc nền tảng cụ thể. Xem tài liệu dành cho nhà phát triển iOS, Android, tvOS, Chromecast, HTML5 hoặc tài liệu bổ sung trong hướng dẫn cho nhà phát triển ứng dụng và trình phát DAI.

 

Đặt adTagParameters qua SDK

Khi thiết lập cust_params hoặc description_url thông qua SDK, trên ứng dụng iOS, tvOS và Android, bạn không cần mã hóa URL các chuỗi này. Bạn có thể chuyển cust_params dưới dạng một chuỗi duy nhất liên kết cặp khóa-giá trị với "&".

Ví dụ: nếu bạn muốn đặt cust_params thành giá trị của sport=football&city=newyork:

Cấu trúc adTagParams sử dụng các giá trị không được mã hóa sẽ là:

{
  "tfat": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport=football&city=newyork",
  "description_url": "http://www.sample.com/golf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
 

Cấu trúc adTagParameters sử dụng các giá trị mã hoá cho các yêu cầu luồng HTML5 sẽ là:

{
  "tfat": 1,
  "iu": "/987654321/path/to/adunit",
  "cust_params": "sport%3Dfootball%26city%3Dnewyork",
  "description_url": "http%3A%2F%2Fwww.sample.com%2Fgolf.html",
  "ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
 

Cấu trúc adTagParams sử dụng các giá trị mã hoá cho các yêu cầu luồng Roku sẽ là:

request.adTagParams="tfat=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=http%3A%2F%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"

Ghi đè thẻ quảng cáo mặc định bằng cách sử dụng DAI API ^{(Thử nghiệm)} 

Khi yêu cầu luồng DAI bằng cách sử dụng API DAI, trình phát video có thể tùy ý chuyển các cặp khóa-giá trị, trong đó khóa có thể là các thông số thẻ quảng cáo Ad Manager đã liệt kê trong bảng trên.

Các thông số này phải được gửi dưới dạng một phần của nội dung yêu cầu POST HTTP, thuộc loại biểu mẫu application/x‑www‑form‑urlencoded cho cả linear/live và VOD.

Bạn cũng có thể tùy chỉnh luồng của mình và đưa vào các thông số không liên quan đến yêu cầu quảng cáo Ad Manager bằng cách sử dụng cấu trúc tương tự này. Tìm hiểu cách yêu cầu thông số biến thể của luồng cụ thể và xác thực HMAC.

Xem ví dụ triển khai mẫu API DAI.

Ghi đè thẻ quảng cáo mặc định bằng cách sử dụng SSB

Sau đây là ví dụ về cách sửa đổi thẻ quảng cáo VOD mặc định SSB. Hệ thống đánh dấu các thông số ghi đè được trình phát hoặc ứng dụng chuyển đi.

Ví dụ video theo yêu cầu

	Ví dụ
URL luồng phát VOD cơ sở	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8
(với một đơn vị quảng cáo đã xác định)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?iu=/9876/ path/to/adunit
(với khoá-giá trị bị ghi đè)	http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8? cust_params=sport%3Dgolf%26section%3Dblog %26anotherKey%3Dvalue1%2Cvalue2
(với thông tin khai báo nội dung xử lý theo độ tuổi)	Ví dụ về chế độ xử lý nội dung dành cho trẻ em: http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfat=1  Ví dụ về chế độ xử lý nội dung dành cho thanh thiếu niên: http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfat=2 Ví dụ về trường hợp không có chế độ xử lý cụ thể theo độ tuổi: http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8?tfat=0
(với một đơn vị quảng cáo VÀ khoá-giá trị bị ghi đè VÀ một description_url tuỳ chỉnh VÀ thông tin khai báo xử lý nội dung theo độ tuổi)	Ví dụ về chế độ xử lý nội dung dành cho trẻ em: http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8? iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section %3Dblog%26anotherKey%3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfat=1 Ví dụ về chế độ xử lý nội dung dành cho thanh thiếu niên: http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8? iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section %3Dblog%26anotherKey%3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfat=2 Ví dụ về trường hợp không có chế độ xử lý cụ thể theo độ tuổi: http://dai.google.com/ondemand/hls/content/ <contentid>/vid/<vid>/master.m3u8? iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section %3Dblog%26anotherKey%3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfat=0

 

Ví dụ về luồng phát truyền hình trực tiếp truyền thống

	Ví dụ
URL luồng phát truyền hình trực tiếp truyền thống cơ sở	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8
(với một đơn vị quảng cáo đã xác định)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?iu=/9876/path/to/adunit
(với khoá-giá trị bị ghi đè)	https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?cust_params=sport%3Dgolf%26section %3Dblog%26otherKey%3Dvalue1%2Cvalue2
(với thông tin khai báo nội dung xử lý theo độ tuổi)	Ví dụ về chế độ xử lý nội dung dành cho trẻ em: https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfat=1 Ví dụ về chế độ xử lý nội dung dành cho thanh thiếu niên: https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfat=2 Ví dụ về trường hợp không có chế độ xử lý cụ thể theo độ tuổi: https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8?tfat=0
(với một đơn vị quảng cáo VÀ khoá-giá trị bị ghi đè VÀ một description_url tuỳ chỉnh VÀ một thông tin khai báo xử lý nội dung theo độ tuổi)	Ví dụ về chế độ xử lý nội dung dành cho trẻ em https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8? iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section%3Dblog%26otherKey %3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfat=1 Ví dụ về chế độ xử lý nội dung dành cho thanh thiếu niên https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8? iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section%3Dblog%26otherKey %3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfat=2 Ví dụ về trường hợp không có chế độ xử lý cụ thể theo độ tuổi https://dai.google.com/linear/hls/event/<asset_key> /master.m3u8? iu=/9876/path/to/adunit& cust_params=sport%3Dgolf%26section%3Dblog%26otherKey %3Dvalue1%2Cvalue2& description_url=https://mysite.com/description.html& tfat=0

Truyền tham số nhắm mục tiêu tuỳ chỉnh đến máy chủ quảng cáo của bên thứ ba trong tính năng Chèn quảng cáo động (DAI) của Google (tham số pt_)

Cơ chế truyền qua pt_

Để ngăn tham số nhắm mục tiêu tuỳ chỉnh xung đột với tham số hoạt động dành riêng cho DAI của Google, DAI xác định các tham số dành cho máy chủ quảng cáo của bên thứ ba bằng tiền tố pt_.

Khi DAI xử lý yêu cầu luồng và thực hiện lệnh gọi quảng cáo chính đến máy chủ quảng cáo của bên thứ ba của bạn:

1. DAI phát hiện mọi tham số truy vấn trong yêu cầu luồng bắt đầu bằng pt_ (ví dụ: pt_category=sports).
2. DAI tự động loại bỏ tiền tố pt_ khi tạo yêu cầu hạ nguồn cho thẻ máy chủ quảng cáo của bên thứ ba của bạn.
3. Máy chủ quảng cáo của bên thứ ba nhận được tên và giá trị tham số đã loại bỏ tiền tố trong URL yêu cầu (ví dụ: category=sports).

Ví dụ về cách triển khai

1. Yêu cầu tạo/khởi chạy luồng

Khi yêu cầu danh sách phát chính hoặc khởi chạy luồng bằng tính năng Chèn quảng cáo động (DAI) của Google, hãy thêm các tham số nhắm mục tiêu tuỳ chỉnh bằng tiền tố pt_ : https://dai.google.com/linear/hls/event/YOUR_EVENT_ID/master.m3u8?pt_category=sports&pt_content_rating=tv-ma&pt_custom_id=98765

2. Yêu cầu quảng cáo hạ nguồn được gửi đến máy chủ quảng cáo của bên thứ ba

Khi yêu cầu quảng cáo từ thẻ máy chủ quảng cáo của bên thứ ba mà bạn đã định cấu hình, DAI của Google tự động loại bỏ pt_ và truyền các cặp khoá-giá trị qua: https://ad.3rdparty-adserver.com/vast?category=sports&content_rating=tv-ma&custom_id=98765

Tiêu chí nhắm mục tiêu dành riêng cho quảng cáo chèn trước (tiền tố tp_pre_)

Nếu bạn cần truyền tham số nhắm mục tiêu chỉ áp dụng cho yêu cầu quảng cáo chèn trước (và khác với điểm chèn quảng cáo chèn giữa trong cùng một sự kiện phát trực tiếp), DAI của Google hỗ trợ tiền tố tham số tp_pre_ trong quá trình khởi chạy luồng.

Cơ chế của tp_pre_

1. Ghi đè tiêu chí nhắm mục tiêu quảng cáo chèn trước: Mọi tham số có tiền tố tp_pre_ trong yêu cầu tạo luồng sẽ được đánh giá riêng cho yêu cầu quảng cáo chèn trước.
2. Loại bỏ tiền tố: Khi tạo lệnh gọi quảng cáo chèn trước, DAI tự động loại bỏ tp_pre_ và sử dụng giá trị này để ghi đè hoặc đặt tham số tương ứng (chẳng hạn như iu hoặc cust_params) chỉ cho điểm chèn quảng cáo chèn trước.
3. Tính độc lập của quảng cáo chèn giữa: Tham số cấp luồng không có tp_pre_ tiếp tục áp dụng cho các điểm chèn quảng cáo chèn giữa tiếp theo.

Ví dụ về tiêu chí nhắm mục tiêu quảng cáo chèn trước

• Yêu cầu tạo luồng: https://dai.google.com/linear/hls/event/YOUR_EVENT_ID/master.m3u8?iu=/1234/live_midroll&tp_pre_iu=/1234/live_preroll&pt_category=sports
• Yêu cầu quảng cáo chèn trước: Đánh giá iu=/1234/live_preroll cụ thể cho điểm chèn quảng cáo chèn trước.
• Yêu cầu quảng cáo chèn giữa: Đánh giá iu=/1234/live_midroll và category=sports cho các điểm chèn quảng cáo chèn giữa.

Các phương pháp hay nhất và những điều quan trọng cần cân nhắc

• Yêu cầu quảng cáo chính so với Trình bao bọc VAST: Việc truyền tham số qua pt_ được áp dụng trong lệnh gọi quảng cáo chính từ DAI đến máy chủ quảng cáo của bên thứ ba. Nếu máy chủ quảng cáo của bên thứ ba trả về trình bao bọc VAST phụ dựa trên các khoá-giá trị nhắm mục tiêu cụ thể, hãy đảm bảo rằng các khoá-giá trị đó được nhúng trong <VASTAdTagURI> thuộc phản hồi VAST của máy chủ quảng cáo.
• Vị trí macro DAI và VAST: Macro (chẳng hạn như [IFA], [GDPRCONSENT] hoặc [TIMESTAMP]) được mở rộng khi được định cấu hình trực tiếp bên trong URL thẻ máy chủ quảng cáo của bên thứ ba. Các giá trị được truyền trong tham số pt_ tạo luồng được coi là chuỗi giá trị cố định và không được DAI mở rộng macro một cách linh động.
• GDPR, quyền riêng tư và sự đồng ý của người dùng: DAI cung cấp các tham số luồng được xác định trước cho GDPR, quyền riêng tư và sự đồng ý. Hãy sử dụng các macro DAI/VAST hiện có ([GDPRCONSENT], %%GDPR%%, %%US_PRIVACY%%, [REGULATIONS], [LIMITADTRACKING], %%TFCD%%) trong thẻ quảng cáo của bên thứ ba thay vì pt_. Để biết thông tin chi tiết, hãy xem Tài liệu về macro DAI của Google cho GDPR và quyền riêng tư.

• Giá trị nhận dạng thiết bị: DAI cung cấp các tham số được xác định trước cho mã thiết bị. Hãy sử dụng các macro DAI/VAST hiện có ([IFA] và [IFATYPE]) trong thẻ quảng cáo của bên thứ ba thay vì pt_. Để biết thông tin chi tiết, hãy xem Tài liệu về macro DAI của Google cho mã thiết bị.

Cập nhật linh động tham số nhắm mục tiêu trong luồng trực tiếp cụ thể

Bạn có thể cập nhật động dữ liệu nhắm đến một người dùng cụ thể trong khi đang xem luồng bằng cách sử dụng phương pháp replaceAdTagParameters trong IMA DAI SDK.

Đối với mọi vấn đề liên quan đến việc khắc phục sự cố hoặc gián đoạn dịch vụ DAI (chèn quảng cáo động), hãy liên hệ với bộ phận hỗ trợ của nhà xuất bản.