セキュア シグナルの利用を開始する

プラットフォームを選択: HTML5 Android iOS tvOS

セキュア シグナルは、クライアント デバイスで収集され、選択したビッダーと共有されるエンコードされたデータです。このガイドでは、IMA SDK を使用してセキュア シグナルを収集し、Google アド マネージャーに送信する方法について説明します。

セキュア シグナル API には、IMA SDK for Android バージョン 3.29.0 以降が必要です。

シグナルとビッダーを選択し、セキュア シグナルの共有を有効にする方法については、ビッダーとセキュア シグナルを共有するをご覧ください。

サードパーティのシグナル プロバイダを使用する

セキュア シグナルを使用するには、アプリにシグナル コレクタ アダプタ クラスをデプロイして、シグナルを収集、エンコードし、IMA SDK に渡す必要があります。

サードパーティ プロバイダの手順に沿って、アカウントを設定し、 ビルド依存関係を追加して、 アプリにセキュア シグナル アダプタを設定します。

IMA SDK for Android は、コードを変更しなくても、各セキュア シグナル アダプタを自動的に初期化します。

プロジェクトにセキュア シグナル アダプタを追加する方法の例を次に示します。

カスタムデータを送信する

サードパーティのシグナル プロバイダを使用するだけでなく、カスタムデータを使用してシグナルを収集、エンコード、送信することもできます。カスタムデータを含むセキュア シグナルを送信するには、アド マネージャーでカスタム シグナルを有効にする必要があります。

ストリーム リクエストごとに、次の操作を行います。

  1. エンコードされたカスタムデータを含む SecureSignals オブジェクトを文字列として作成します。
  2. SecureSignals オブジェクトを ストリーム リクエスト に streamRequest.setSecureSignals() メソッドを呼び出して追加します。

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);
  }