开始使用安全信号

请选择平台： HTML5 Android iOS tvOS

安全信号是在客户端设备上收集并与选定出价方共享的编码数据。本指南将向您介绍如何使用 IMA SDK 收集安全信号并将其发送给 Google Ad Manager。

安全信号 API 需要 IMA SDK for Android 3.29.0 或更高版本。

如需选择信号和出价方，并启用安全信号共享，请参阅与出价方共享 安全信号。

使用第三方信号提供方

如需使用安全信号，您必须在应用中部署信号收集器适配器类以收集信号、对其进行编码并将其传递给 IMA SDK。

请按照第三方提供方的说明，在其中设置账号、 添加 build 依赖项、 并在应用中设置其安全信号适配器。

IMA SDK for Android 会自动初始化每个安全信号适配器，而无需对代码进行任何其他更改。

以下示例说明了如何将安全信号适配器添加到项目中：

发送自定义数据

除了使用第三方信号提供方之外，您还可以收集、编码和发送包含自定义数据的信号。如需发送包含自定义数据的安全信号，您必须先在 Ad Manager 中启用自定义信号。

对于每个流请求，请执行以下操作：

  1. 创建一个 SecureSignals 对象，其中包含编码后的自定义数据（以字符串形式）。
  2. 通过调用 streamRequest.setSecureSignals() 方法，将 SecureSignals 对象添加到您的 流请求 中：

app/src/main/java/com/example/project name/SampleAdsWrapper.java

 public void requestAndPlayAds() {
    adsLoader.addAdErrorListener(this);
    adsLoader.addAdsLoadedListener(this);
    StreamRequest request = buildStreamRequest();
    SecureSignals signal = SecureSignals.create("My encoded signal string");
    request.setSecureSignals(signal);
    request.setFormat(StreamFormat.HLS);
    adsLoader.requestStream(request);
  }