开始使用安全信号

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

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

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

使用第三方信号提供商

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

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

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

以下示例展示了如何向项目添加安全信号适配器：

发送自定义数据

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

对于每个流请求，创建一个 SecureSignals 对象，其中包含您的编码自定义数据（以字符串形式）。然后，通过调用 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);
  }