安全信号是在客户端设备上收集并与所选出价方共享的编码数据。本指南介绍了如何使用 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);
}