Thông tin tổng quan về sự kiện phát trực tiếp
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
API phân phát nhóm cho phép truy cập vào các nhóm quảng cáo dạng video có tốc độ bit thích ứng được chuẩn bị theo cách có thể ghép chúng trực tiếp vào danh sách phát nội dung nghe nhìn HLS hoặc MPEG DASH mà người dùng nhìn thấy.
API này dành cho các nhà xuất bản và đối tác công nghệ video tiên tiến.
Để sử dụng API này trên quy mô lớn, bạn phải thiết kế và triển khai một quy trình phân phát nội dung nghe nhìn tinh vi nằm ngoài phạm vi của tài liệu này.
Điều kiện tiên quyết
Trước khi xử lý một chương trình phát trực tiếp thông qua API phân phát nhóm DAI, bạn cần tạo một sự kiện phát trực tiếp bằng cách sử dụng giao diện người dùng Google Ad Manager hoặc API sự kiện trực tiếp.
Thành phần
Có ba thành phần tạo nên bất kỳ cách triển khai nào của API phân phát nhóm: Google Ad Manager, một trình phát video ứng dụng và một máy chủ thao tác tệp kê khai.

Ad Manager
Ad Manager chịu trách nhiệm phân phối quảng cáo đến người dùng và có thể được quản lý
thông qua SDK Ad Manager hoặc giao diện web của SDK đó. Dịch vụ có những trách nhiệm sau:
- Nhận yêu cầu phát trực tiếp từ trình phát video của ứng dụng, quyết định quảng cáo và cung cấp hiển thị để khớp với hồ sơ mã hoá nội dung của bạn
- Phản hồi các yêu cầu về phân khúc quảng cáo từ trình phát video của khách hàng và
cung cấp phần thích hợp của nhóm quảng cáo cho người dùng cụ thể
- Nhận và xử lý ping theo dõi từ trình phát video của ứng dụng
Trình phát video của ứng dụng
Trình phát video của ứng dụng là ứng dụng hoặc trang web mà ứng dụng sử dụng để phát luồng video kết quả. Người chơi có những trách nhiệm sau:
- Khởi tạo tài nguyên luồng từ Ad Manager và nhận một đối tượng luồng
đại diện cho một phiên phát duy nhất của một sự kiện phát trực tiếp cụ thể.
- Yêu cầu tệp kê khai luồng từ máy chủ thao tác tệp kê khai, máy chủ này sẽ bắt đầu phát
- Định kỳ thăm dò siêu dữ liệu của nhóm quảng cáo từ Ad Manager mô tả các sự kiện
quảng cáo được nhúng trong phân khúc quảng cáo của luồng
- Theo dõi các sự kiện siêu dữ liệu được tính giờ do trình phát nâng lên có chứa mã nhận dạng nội dung nghe nhìn
quảng cáo. Khi gặp những sự kiện này, người chơi sẽ chuyển tiếp các sự kiện đó đến
Ad Manager để xác minh rằng các sự kiện quảng cáo đã xảy ra thành công.
Để tìm hiểu thêm về cách triển khai đúng trình phát video của ứng dụng, hãy xem hướng dẫn phân phát nhóm cho nền tảng của bạn:
Để triển khai tuỳ chỉnh, hãy xem hướng dẫn ứng dụng phân phát nhóm cho API DAI.
Máy chủ thao tác trong tệp kê khai
Máy chủ thao tác tệp kê khai là máy chủ chịu trách nhiệm lưu trữ tệp kê khai luồng được cung cấp cho trình phát video của ứng dụng. Máy chủ có những trách nhiệm sau:
- Xử lý việc phân phối tệp kê khai đến trình phát video của ứng dụng
- Yêu cầu mẫu khoảng thời gian từ Ad Manager (chỉ dành cho luồng MPEG DASH)
để điền sẵn các phân khúc quảng cáo.
- Chèn URL phân đoạn quảng cáo do Ad Manager lưu trữ vào tệp kê khai luồng video (đối với HLS) hoặc giai đoạn quảng cáo (đối với MPEG DASH) trong thời điểm chèn quảng cáo.
- Phân phối tệp kê khai đã sửa đổi tới trình phát video của ứng dụng.
Để tìm hiểu thêm về cách triển khai một máy chủ thao tác tệp kê khai tuỳ chỉnh, hãy xem hướng dẫn thao tác với tệp kê khai.
Bảng thuật ngữ
- Sự kiện phát trực tiếp: Một sự kiện lưu trữ dữ liệu cấu hình quan trọng cho sự kiện phát trực tiếp, chẳng hạn như hồ sơ mã hoá. Các sự kiện phát trực tiếp được tạo bằng Ad Manager.
- Đối tượng luồng: Đối tượng đại diện cho một phiên phát duy nhất của một tài sản video cụ thể. Các thuộc tính đáng chú ý bao gồm mã luồng và URL xác minh nội dung nghe nhìn.
- Nhóm quảng cáo: Nhóm các video quảng cáo hiển thị trong một điểm chèn quảng cáo
- Phân khúc quảng cáo: Tệp phân khúc nội dung nghe nhìn cho điểm chèn quảng cáo
- Siêu dữ liệu của nhóm quảng cáo: Siêu dữ liệu cho điểm chèn quảng cáo dùng để hiển thị giao diện người dùng của quảng cáo trên máy khách; ví dụ: ẩn các nút tìm kiếm trong khi quảng cáo
- Mã nhận dạng nội dung đa phương tiện của quảng cáo: Siêu dữ liệu được mã hoá dưới dạng thẻ ID3 trong các tệp phân khúc quảng cáo. Siêu dữ liệu
này dùng để xác định thời điểm xảy ra các sự kiện cụ thể liên quan đến quảng cáo
trong khi phát, chẳng hạn như thời điểm bắt đầu hoặc điểm giữa quảng cáo.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-01 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-08-01 UTC."],[[["\u003cp\u003eThe Pod Serving API facilitates the integration of adaptive-bitrate video ad pods directly into HLS or MPEG DASH media playlists for advanced publishers and video technology partners.\u003c/p\u003e\n"],["\u003cp\u003eImplementing the Pod Serving API involves three core components: Google Ad Manager, which handles ad delivery and tracking; a client video player, which manages stream initialization and playback; and a manifest manipulation server, which modifies and serves the stream manifest.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, a livestream event must be created via the Google Ad Manager UI or the live-event API, serving as a configuration resource for the livestream.\u003c/p\u003e\n"],["\u003cp\u003eThe client video player is responsible for initializing the stream, requesting the manifest, polling for ad pod metadata, and forwarding timed metadata events to Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eThe manifest manipulation server handles manifest delivery, requests ad period templates, and inserts Ad Manager-hosted ad segment URLs or ad periods into the stream manifest during ad breaks.\u003c/p\u003e\n"]]],[],null,["# Overview for live streams\n\nThe Pod Serving API provides access to adaptive-bitrate video ad pods prepared\nin such a way that they can be stitched directly into a user-facing HLS or MPEG\nDASH media playlist.\n\nThis API is intended for advanced publishers and video technology partners.\nUsing this API at scale requires design and implementation of a sophisticated\nmedia serving workflow which is outside the scope of this documentation.\n\nPrerequisites\n-------------\n\nBefore processing a livestream through the DAI Podserving API, you\nwill need to create a\n[livestream event](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/manipulator#livestreamevent)\nusing the Google Ad Manager UI, or the live-event API.\n\nComponents\n----------\n\nThere are three components that make up any implementation of the Pod Serving\nAPI: Google Ad Manager, a client video player, and a manifest manipulation\nserver.\n\n### Ad Manager\n\nAd Manager is responsible for delivering ads to the user and can be managed\nthrough either the Ad Manager SDK or its web interface. The service has these\nresponsibilities:\n\n- Receiving stream requests from the client video player, decisioning ads, and providing renditions to match your content encoding profiles\n- Responding to ad segment requests from the client video player and providing the appropriate portion of the ad pod for the given user\n- Receiving and processing tracking pings from the client video player\n\n### Client video player\n\nThe client video player is the app or website that clients use to play the\nresulting video stream. The player has these responsibilities:\n\n- Initializing a stream resource from Ad Manager and receiving a stream object that represents a single playback session of a specific livestream event.\n- Requesting a stream manifest from the manifest manipulation server, which starts playback\n- Periodically polling ad pod metadata from Ad Manager that describes the ad events embedded in the stream's ad segments\n- Listening for timed metadata events raised by the player that contain ad media IDs. Upon encountering these events, the player forwards them to Ad Manager to verify that ad events have successfully occurred.\n\nTo learn more about the proper implementation of the client video player, see\nthe pod serving guide for your platform:\n\n- [Android](/ad-manager/dynamic-ad-insertion/sdk/android?service=pod)\n- [HTML5](/ad-manager/dynamic-ad-insertion/sdk/html5?service=pod)\n- [iOS](/ad-manager/dynamic-ad-insertion/sdk/ios?service=pod)\n- [tvOS](/ad-manager/dynamic-ad-insertion/sdk/tvos?service=pod)\n\nFor custom implementations, see our [pod serving client guide for the DAI\nAPI](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/client).\n\n### Manifest manipulation server\n\nThe manifest manipulation server is the server in charge of hosting the\nstream manifest provided to the client video player. The server has these\nresponsibilities:\n\n- Handling manifest delivery to the client video player\n- Requesting a period template from Ad Manager (for MPEG DASH streams only), to populate with ad segments.\n- Inserting Ad Manager-hosted ad segment URLs into the video stream manifest (for HLS) or ad period (for MPEG DASH) during ad breaks.\n- Serving the modified manifest to the client video player.\n\nTo learn more about implementing a custom manifest manipulator server, see the\n[manifest manipulation\nguide](/ad-manager/dynamic-ad-insertion/api/pod-serving/live/manipulator).\n\nGlossary\n--------\n\n- **Livestream event**: An event that stores important configuration data for livestream, such as encoding profiles. Livestream events are created using Ad Manager.\n- **Stream object**: An object that represents a single playback session of a specific video asset. Notable properties include the stream ID and the media verification URL.\n- **Ad pod**: Grouping of ad videos shown in an ad break\n- **Ad segments**: Media segment files for the ad break\n- **Ad pod metadata**: Metadata for the ad break used to render ad UI on the client; for example, hide seek buttons during ad\n- **Ad media ID**: Metadata encoded as ID3 tags within ad segment files. This metadata is used to identify when specific ad-related events have occurred during playback, such as ad start or midpoint."]]