前提条件ステップ 1: コンソールで yield Optimization を有効にするステップ 2: OpenRTB テンプレートを設定するステップ 3: セッションを開始して確認するステップ 2 (代替): API を使用してを設定する次の手順

歩留まりの最適化クイックスタートガイド

このガイドでは、再生設定で収量最適化を有効にし、それが機能することを確認する方法について説明します。

目標: このガイドの最後に、未入力の広告インベントリを APS からのプログラム広告で自動的に埋める再生設定があります。

前提条件

ライブコンテンツソースを含む既存の MediaTailor 再生設定。
APS パブリッシャー ID。持っていない場合はAPS との統合、「」を参照してください。

ステップ 1: コンソールで yield Optimization を有効にする

MediaTailor コンソールを開きます。
左側のナビゲーションペインで、設定を選択します。
更新する再生設定を選択します。
[編集] を選択します。
yield Optimization Settings セクションを展開します (起動時に新しいバッジでマークされています）。セクションの説明には、「パブリッシャー ID、広告期間の制限、リージョンのターゲティングを含む」と記載されています。
有効化ドロップダウンを有効に設定します。
以下のフィールドに入力します。
- APS パブリッシャー ID: パブリッシャーアカウントに関連付けられている APS パブリッシャー ID (例: 8caf35b3-402b-4d75-bab2-f2aef63a66d3)。これを取得する方法については、APS との統合「」を参照してください。
- Minimum Unfilled Duration: yield Optimization が埋めようとする秒単位の最小未入力期間。これを 15 以上に設定します。APS 広告クリエイティブは通常 15 秒以上であるため、15 秒未満の値は広告を返しません。
- Amazon 広告リージョン: 入札リクエストをルーティングする Amazon 広告リージョン。プライマリオーディエンスAsia Pacificに基づいてAmericas、、Europe、またはのいずれかを選択します。これは YieldOptimizationConfiguration API モデルの Regionフィールドにマッピングされ、リージョン名はで説明されている APS リージョンに対応しますAPS との統合。
- OpenRTB テンプレート設定: JSON テンプレート。開始点テンプレートの例については、「」を参照してください。コンソールは JSON 構文を検証し、エラーと警告をインラインで表示します。デフォルトのテンプレートには、コンソールのスターターテンプレートがあらかじめ入力されています。「入札の構築とテンプレート化」を参照してください。
[保存] を選択します。

ステップ 2: OpenRTB テンプレートを設定する

コンソールには、OpenRTB テンプレート用の JSON エディタが用意されています。少なくとも、テンプレートには以下が含まれている必要があります。


{
  "app": {
    "bundle": "your.app.bundle.id",
    "storeurl": "https://your-app-store-url",
    "content": {}
  },
  "device": {
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}"
  },
  "imp": [
    {
      "video": {
        "mimes": ["video/mp4"],
        "protocols": [2, 3, 5, 6],
        "ext": {
          "slotId": "your-aps-slot-id"
        }
      },
      "bidfloor": 1.0
    }
  ]
}

必須フィールドがない場合、コンソールから警告が表示されます。

ステップ 3: セッションを開始して確認する

プレイヤーパラメータ (ユーザーエージェント、IP アドレスなど) を含む再生セッションを開始します。
時間未入力の広告時間枠を待ちます。
YieldOptimization.BidRequest およびの CloudWatch メトリクスを確認しますYieldOptimization.AdsInserted。

BidRequest が出力しているが 0 AdsInsertedの場合は、のRAW_BID_REQUESTイベントをチェックads_interaction_logして、テンプレートが有効な入札リクエストを生成していることを確認します。

ステップ 2 (代替): API を使用してを設定する

YieldOptimizationConfiguration パラメータで PutPlaybackConfiguration API を使用します。


aws mediatailor put-playback-configuration \
  --name "MyStreamingService" \
  --ad-decision-server-url "https://ads.example.com/vast" \
  --video-content-source-url "https://origin.example.com/hls/" \
  --yield-optimization-configuration '{
    "MinimumUnfilledDuration": 15,
    "PublisherId": "your-aps-publisher-id",
    "Region": "AMERICAS",
    "OpenRtbTemplate": "{\"app\":{\"bundle\":\"your.app.bundle\",\"storeurl\":\"https://store-url\",\"content\":{}},\"device\":{\"ua\":\"{{session.user_agent}}\",\"ip\":\"{{session.client_ip}}\"},\"imp\":[{\"video\":{\"mimes\":[\"video/mp4\"],\"protocols\":[2,3,5,6],\"ext\":{\"slotId\":\"your-slot-id\"}},\"bidfloor\":1.0}]}"
  }'

次の手順

APS に登録してパブリッシャー ID を取得するには、「」を参照してくださいAPS との統合。
MediaTailor が入札リクエストを行うタイミングを決定する方法については、「」を参照してください収量最適化の仕組み。
テンプレートの完全な例については、「」を参照してくださいテンプレートの例。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

歩留まりの最適化

APS との統合