翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

入札の構築とテンプレート化

このページでは、MediaTailor がテンプレートから OpenRTB 入札リクエストを構築する方法、変数補間の仕組み、MediaTailor が自動的に設定する値について説明します。

設定フィールド

再生設定で収量最適化を有効にする場合は、次の 4 つのフィールドを指定します。

入札リクエストの構築方法

広告時間枠に未入力の期間が残っている場合、MediaTailor は次のステップで入札リクエストを作成します。

コンソールのデフォルトテンプレート

MediaTailor コンソールで yield Optimization を有効にすると、開始点として次の事前入力済みテンプレートが提供されます。アプリケーションの値をカスタマイズする必要があります。

{
  "imp": [
    {
      "bidfloor": 5
    }
  ],
  "app": {
    "id": "{{player_params.app_id}}",
    "name": "{{player_params.app_name}}",
    "bundle": "{{player_params.bundle}}",
    "storeurl": "{{player_params.storeurl}}",
    "domain": "{{player_params.domain}}",
    "content": {
      "genre": "{{asset.genre}}",
      "contentrating": "{{asset.content_rating}}"
    }
  },
  "device": {
    "dnt": "{{player_params.dnt}}",
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}",
    "ifa": "{{player_params.device_ifa}}",
    "w": "{{player_params.device_width}}",
    "h": "{{player_params.device_height}}",
    "language": "{{player_params.language}}",
    "model": "{{player_params.model}}",
    "os": "{{player_params.os}}",
    "osv": "{{player_params.osv}}",
    "devicetype": "{{player_params.devicetype}}",
    "make": "{{player_params.make}}"
  },
  "user": {
    "consent": "{{player_params.consent}}"
  },
  "regs": {
    "gdpr": "{{player_params.gdpr}}",
    "us_privacy": "{{player_params.us_privacy}}",
    "gpp": "{{player_params.gpp_consent}}",
    "gpp_sid": "{{player_params.gpp_sid}}"
  }
}

Field-by-field説明:

テンプレート補間 (Mustache テンプレート)

ORTB テンプレートは、動的値置換に Mustache テンプレート構文を使用します。プレースホルダーは二重括弧 を使用します{{ }}。

使用可能なテンプレート変数

ORTB テンプレートは、ADS URL テンプレートで使用できるのと同じ動的変数を使用できます。これには、セッション変数 (、 など{{session.client_ip}}){{session.user_agent}}、プレイヤーパラメータ ()、アセットメタデータ ({{player_params.*}})、可用性コンテキスト ({{asset.*}})、SCTE シグナルデータ ({{avail.*}}) が含まれます{{scte.*}}。

使用可能な変数の完全なリストとその説明については、「」を参照してくださいADS リクエストの MediaTailor 動的広告変数。MediaTailor がプレイヤーパラメータ値をテンプレートに置き換える前に URL でデコードする方法については、このページのエンコードとデコードの動作後半の「」を参照してください。

ORTB テンプレートで最も一般的に使用される変数は次のとおりです。

プレイヤーパラメータを渡す方法

セッションの初期化中にプレイヤーパラメータを渡すには、2 つの方法があります。

方法 1: JSON 本文を使用した POST リクエスト (推奨)

POST https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
Content-Type: application/json

{
  "playerParams": {
    "app_id": "558775_example",
    "slot_id": "608109df-2378-4bc5-8da5-24bc355f01a4",
    "os": "Tizen",
    "make": "Samsung",
    "model": "Tizen TV",
    "language": "en",
    "us_privacy": "1YNY"
  }
}

この方法は、ユーザーエージェント文字列などの複雑な値による URL エンコードの問題を回避するため、推奨されます。

方法 2: URL クエリパラメータ

GET https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
  ?playerParams.app_id=558775_example

この方法では、値は URL エンコードする必要があります。MediaTailor は、補間前に URL デコードします。

エンコードとデコードの動作

MediaTailor は、プレイヤーパラメータ値をテンプレートに補間する前に、1 レベルの URL デコードを実行します。これは、パラメータの受け渡し方法 (POST 本文または URL クエリパラメータ) に関係なく適用されます。

デコードされた値の例:

キーポイント:

変数が欠落している場合にどうなるか

プレイヤーがテンプレートで参照されているパラメータを送信しない場合 (たとえば、プレイヤーパラメータapp_nameに {{player_params.app_name}}がない場合）、プレースホルダーは空の文字列 に解決されます""。

影響: 空の文字列が必須フィールド ( などapp.bundle) にある場合、入札リクエストは で失敗しますBidRequestConfigurationError。オプションフィールドにある場合、APS は入札なし (HTTP 204) レスポンスを引き起こす可能性のある空の値を受け取ります。

MediaTailor が自動的に設定する内容

次のフィールドは常に、コンソール設定の値と現在の表示コンテキストを使用して MediaTailor によって設定されます。テンプレートにこれらを含めると、値は上書きされます。

次の手順