セキュア シグナルは、クライアント デバイスで収集され、一部のビッダーと共有されるエンコードされたデータです。このガイドでは、IMA SDK を使用してセキュア シグナルを収集し、Google アド マネージャーに送信する方法について説明します。
secure signals API には、Android 向け IMA SDK のバージョン 3.29.0 以降が必要です。
シグナルとビッダーを選択し、セキュア シグナルの共有を有効にするには、セキュア シグナルをビッダーと共有するをご覧ください。
サードパーティのシグナル プロバイダを使用する
安全なシグナルを使用するには、アプリにシグナル コレクタ アダプター クラスをデプロイして、シグナルを収集、エンコードし、IMA SDK に渡す必要があります。
サードパーティ プロバイダの手順に沿ってアカウントを設定し、ビルド依存関係を追加し、アプリでセキュア シグナル アダプタを設定します。
IMA SDK for Android では、コードを変更しなくても、各セキュア シグナル アダプタが自動的に初期化されます。
プロジェクトにセキュア シグナル アダプタを追加する方法の例を次に示します。
カスタムデータを送信する
サードパーティのシグナル プロバイダを使用するだけでなく、カスタムデータを使用してシグナルを収集、エンコード、送信することもできます。カスタムデータを使用してセキュア シグナルを送信する前に、アド マネージャーでカスタム シグナルを有効にする必要があります。
広告リクエストごとに、エンコードされたカスタムデータを文字列として格納する SecureSignals オブジェクトを作成します。次に、adsRequest.setSecureSignals() を呼び出して SecureSignals オブジェクトを広告リクエストに追加します。
次の例は Java です。
app/src/main/java/com/example/project name/MainActivity.java
...
private void requestAds(String adTagUrl) {
// Create the ads request.
AdsRequest request = sdkFactory.createAdsRequest();
request.setAdTagUrl(adTagUrl);
request.setContentProgressProvider(
() -> {
if (videoPlayer.getDuration() <= 0) {
return VideoProgressUpdate.VIDEO_TIME_NOT_READY;
}
return new VideoProgressUpdate(
videoPlayer.getCurrentPosition(), videoPlayer.getDuration());
});
SecureSignals signal = SecureSignals.create("My encoded signal string");
request.setSecureSignals(signal);
// Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
adsLoader.requestAds(request);
}
...