パブリッシャー提供のシグナル

オーディエンス データとコンテキスト データは、広告リクエストでパブリッシャー提供のシグナル（PPS）として送信できます。PPS では、ユーザー ID を共有することなく、標準の分類を使用してすべてのトランザクション タイプの入札者にオーディエンスの特性を伝えることで、ユーザーデータを使用してプログラマティックな収益化を改善できます。オーディエンス特性には、行動およびインタレスト ベースのデータ（IAB オーディエンス分類 1.1）やコンテキスト データ（IAB コンテンツの分類 2.2）などがあります。Google が定義したパブリッシャー提供の構造化シグナルを送信し、追加のシグナルの送信を許可することもできます。

ユーザーシグナルの JSON を作成する

最上位レベルで、単一の Key-Value ペアを含む JSON オブジェクトを作成します。キーは PublisherProvidedTaxonomySignals で、その値はオブジェクトの配列である必要があります。配列内の各オブジェクトには、2 つの Key-Value ペアが必要です。

  • taxonomy キー。次の IAB 公開仕様にマッピングされた次の値を使用できます。

    • IAB_AUDIENCE_1_1（オーディエンス分類 1.1 用）
    • IAB_CONTENT_2_2: コンテンツの分類 2.2

  • values キーと、対応する文字列分類値の配列。

構造化シグナル配列を作成する

構造化シグナルの場合は、PublisherProvidedStructuredSignals キーとオブジェクト配列の値を追加します。次のシグナルの Key-Value リストに基づいてオブジェクトを作成します。

構造化シグナルの表の表示を切り替える

シグナル <code" dir="ltr" translate="no">"type" 値</code"> "single_value" に指定可能な値 有効な "values" の値
音声フィードタイプ "audio_feed"
  • "af_1": 音楽
  • "af_2": ブロードキャスト
  • "af_3": ポッドキャスト
 なし
コンテンツのレーティング "content_rating"
  • "cr_1": G
  • "cr_2": PG
  • "cr_3": T
  • "cr_4": MA
 なし
コンテンツ配信 "delivery" なし
  • "cd_1": ストリーミング
  • "cd_2": プログレッシブ
  • "cd_3": ダウンロード
制作品質 "prodq"
  • "pq_1": プロが制作
  • "pq_2": プロシューマー
  • "pq_3": ユーザー作成コンテンツ（UGC）
 なし

分類シグナルに IAB_AUDIENCE_1_1 と IAB_CONTENT_2_2 を使用し、構造化シグナルを含める次の例をご覧ください。

const userSignals = {
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["6", "284"]
     // '6' = 'Demographic | Age Range | 30-34'
     // '284' = 'Interest | Business and Finance |  Mergers and Acquisitions'
  },
  {
     "taxonomy": "IAB_CONTENT_2_2",
     "values": ["49", "138"]
     // '49' = 'Books and Literature | Poetry'
     // '138' = 'Education | College Education | College Planning'
  }],
  "PublisherProvidedStructuredSignals": [{
      "type": "audio_feed",
      "single_value": "af_1",
    },
    {
      "type": "delivery",
      "values": ["cd_1", "cd_3"],
    },
  ],
};

広告リクエストを構成する

IMAAdsRequest を使用して PPS を送信する手順は次のとおりです。

  • ユーザーの関心、行動、コンテキスト データを含む JSON 文字列を作成します。
  • 上記の JSON 文字列から、Base64 でエンコードされた ASCII 文字列を作成します。
  • エンコードされた文字列を &ppsj= パラメータを使用して広告タグの URL に追加します。
let userSignals = """
{
   "PublisherProvidedTaxonomySignals": [
    {
      "taxonomy": "IAB_AUDIENCE_1_1",
      "values": [
        "1",
        "284"
      ]
    }
  ],
}
"""
let base64Signals = Data(userSignals.utf8).base64EncodedString()
var encodedSignals = base64Signals.replacingOccurrences(of: "+", with: "%2B")
encodedSignals = encodedSignals.replacingOccurrences(of: "/", with: "%2F")
encodedSignals = encodedSignals.replacingOccurrences(of: "=", with: "%3D")


let finalAdTag = sampleAdTag + "&ppsj=" + encodedSignals