Thiết lập bằng dịch vụ Nhóm DAI

SDK IMA giúp bạn dễ dàng tích hợp quảng cáo đa phương tiện vào trang web và ứng dụng của mình. SDK IMA có thể yêu cầu quảng cáo từ bất kỳ máy chủ quảng cáo nào tuân thủ VAST và quản lý việc phát quảng cáo trong ứng dụng của bạn. Với SDK IMA DAI, các ứng dụng sẽ gửi yêu cầu về luồng cho quảng cáo và video nội dung (nội dung VOD hoặc nội dung trực tiếp). Sau đó, SDK sẽ trả về một luồng video kết hợp để bạn không phải quản lý việc chuyển đổi giữa quảng cáo và video nội dung trong ứng dụng.

Hướng dẫn này minh hoạ cách phát luồng Phân phát nhóm DAI, sử dụng SDK IMA DAI với trình phát video để phát luồng trực tiếp và VOD. Để xem hoặc làm theo một mẫu tích hợp hoàn chỉnh, hãy tải Ví dụ về tính năng Phân phát nhóm quảng cáo xuống.

Tổng quan về cơ chế Phân phát nhóm IMA DAI

• StreamRequest: Một đối tượng xác định yêu cầu luồng đến máy chủ quảng cáo của Google. Phải được tạo bằng ImaSdkFactory.createPodStreamRequest() hoặc ImaSdkFactory.createPodVodStreamRequest() để bật tính năng Phân phát nhóm. Các phương thức này yêu cầu Mã mạng, và createPodStreamRequest cũng yêu cầu Khoá tài sản tuỳ chỉnh và Khoá API (không bắt buộc). Cả hai đều bao gồm các tham số không bắt buộc khác.

• StreamManager: Một đối tượng xử lý hoạt động giao tiếp giữa luồng video và SDK IMA DAI, chẳng hạn như kích hoạt ping theo dõi và chuyển tiếp sự kiện luồng đến nhà xuất bản.

Điều kiện tiên quyết

• Một ứng dụng Android đã được thiết lập bằng SDK IMA DAI để phát các luồng video có quảng cáo DAI. Nếu chưa có ứng dụng như vậy, bạn nên sử dụng Android DAI BasicExample làm điểm xuất phát. BasicExample có toàn bộ mã nguồn được tham chiếu trong hướng dẫn này.

• Ứng dụng của bạn cần gửi sự kiện ID3 bằng VideoStreamPlayerCallback.onUserTextReceived() để IMA DAI hoạt động. Hãy xem Ví dụ về đoạn mã DAI đầy đủ dịch vụ này.

Thiết lập các biến Phân phát nhóm quảng cáo

Tất cả thay đổi cần thiết cho tính năng Phân phát nhóm đều được thực hiện trong SampleAdsWrapper.java. Bước đầu tiên là cập nhật các biến hằng số.

Sau đây là các hằng số yêu cầu luồng nhóm quảng cáo cần thêm:

• STREAM_URL: Chỉ dùng cho sự kiện phát trực tiếp – URL của luồng video do trình thao tác tệp kê khai hoặc đối tác bên thứ ba cung cấp bằng tính năng Phân phát nhóm. Bạn cần phải chèn mã nhận dạng luồng do SDK IMA DAI cung cấp trước khi gửi yêu cầu. Trong trường hợp này, URL của luồng bao gồm một phần giữ chỗ, "[[STREAMID]]", được thay thế bằng mã luồng trước khi đưa ra yêu cầu.

• NETWORK_CODE: Mã mạng cho tài khoản Ad Manager 360 của bạn.

• CUSTOM_ASSET_KEY: Chỉ dùng cho sự kiện phát trực tiếp – Khoá thành phần tuỳ chỉnh giúp xác định sự kiện Phân phát nhóm quảng cáo trong Ad Manager 360. Tệp kê khai này có thể do trình thao tác tệp kê khai của bạn hoặc đối tác Phân phát nhóm quảng cáo bên thứ ba tạo.

• API_KEY: Chỉ dùng cho sự kiện phát trực tiếp – Khoá API không bắt buộc có thể cần thiết để truy xuất mã luồng phát từ SDK IMA DAI.

Android DAI BasicExample được thiết kế để phát nhiều loại luồng khác nhau, nhưng đối với tính năng Phân phát nhóm, ứng dụng này được thiết lập để chỉ phát một luồng. Thay đổi phần biến của ví dụ cho khớp với phần sau:

/** This class implements IMA to add pod ad-serving support to SampleVideoPlayer */
@SuppressLint("UnsafeOptInUsageError")
/* @SuppressLint is needed for new media3 APIs. */
public class SampleAdsWrapper
    implements AdEvent.AdEventListener, AdErrorEvent.AdErrorListener, AdsLoader.AdsLoadedListener {

  // Set up the pod serving variables.
  private static final String NETWORK_CODE = "";
  private static final String CUSTOM_ASSET_KEY = "";
  private static final String API_KEY = "";
  private static final String STREAM_URL = "";
  private static final StreamFormat STREAM_FORMAT = StreamFormat.HLS;
SampleAdsWrapper.java

Tạo yêu cầu luồng nhóm trực tiếp hoặc VOD để bật tính năng Phân phát nhóm

// Live pod stream request.
request = sdkFactory.createPodStreamRequest(NETWORK_CODE, CUSTOM_ASSET_KEY, API_KEY);
SampleAdsWrapper.java

// VOD pod stream request.
request = sdkFactory.createPodVodStreamRequest(NETWORK_CODE);
SampleAdsWrapper.java

Sau khi tạo thực thể yêu cầu luồng, hãy yêu cầu luồng bằng cách sử dụng AdsLoader.requestStream():

request.setFormat(STREAM_FORMAT);
adsLoader.requestStream(request);
SampleAdsWrapper.java

Chỉnh sửa và đặt URL của sự kiện phát trực tiếp

// Play the live pod stream.
streamID = streamManager.getStreamId();
String liveStreamUrl = STREAM_URL.replace("[[STREAMID]]", streamID);
// Call videoPlayer.play() here, because IMA doesn't call the VideoStreamPlayer.loadUrl()
// function for livestreams.
videoPlayer.setStreamUrl(liveStreamUrl);
videoPlayer.play();
SampleAdsWrapper.java

// Play the VOD pod stream.
streamID = streamManager.getStreamId();
String vodStreamUrl = "";
// Refer to your Video Tech Partner (VTP) or video stitching guide to fetch the stream URL
// and the subtitles for a the ad stitched VOD stream.

// In the following commented out code, 'vtpInterface' is a place holder
// for your own video technology partner (VTP) API calls.
// vodStreamUrl = vtpInterface.requestStreamURL(streamID);
List<Map<String, String>> subtitles = new ArrayList<>();
streamManager.loadThirdPartyStream(vodStreamUrl, subtitles);
SampleAdsWrapper.java

private VideoStreamPlayer createVideoStreamPlayer() {
  return new VideoStreamPlayer() {
    @Override
    public void loadUrl(String url, List<HashMap<String, String>> subtitles) {
      // IMA doesn't make calls to VideoStreamPlayer.loadUrl() for pod serving live streams.
      // The following code is for VOD streams.
      videoPlayer.setStreamUrl(url);
      videoPlayer.play();
    }
SampleAdsWrapper.java

Dọn dẹp các thành phần IMA DAI

Khi bạn đã hoàn tất thành công việc yêu cầu và hiển thị quảng cáo trong một luồng Phân phát nhóm quảng cáo bằng IMA DAI SDK, bạn nên dọn dẹp mọi tài nguyên sau khi phiên Phân phát nhóm quảng cáo hoàn tất. Gọi StreamManager.destroy() để dừng phát trực tuyến, dừng tất cả hoạt động theo dõi quảng cáo và giải phóng tất cả thành phần luồng đã tải.

Để xem các ví dụ khác về cách sử dụng SDK Android, hãy xem các mẫu trên GitHub.