

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

# MediaTailor 収益化関数の使用
<a name="monetization-functions"></a>

MediaTailor 収益化関数 (関数) を使用すると、 がセッションデータ AWS Elemental MediaTailor を管理し、広告挿入中に広告リクエストを構築する方法をカスタマイズできます。関数を使用すると、外部 APIs呼び出し、式を使用したデータの変換、広告決定サーバー (ADS) リクエストパラメータまたはプレイヤーパラメータの変更を行うことができます。カスタムインフラストラクチャをデプロイまたは管理する必要はありません。

関数は、JSON データの軽量クエリおよび変換言語である *JSONata* を使用して式を評価します。セッションデータの読み取り、値の変換、出力の定義を行う JSONata 式を記述します。サポートされている JSONata 関数の完全なリストについては、「」を参照してください[JSONata 式リファレンス](monetization-functions-jsonata.md)。

以下の必要がある場合は、 関数を使用します。
+ **ビューワーデータで広告リクエストを強化します。**セッションの開始時に ID サービスを呼び出し、パーソナライズされた広告ターゲティングのためにすべての ADS リクエストに解決された ID を含めます。
+ **ADS リクエストパラメータをカスタマイズします。**セッションデータ、SCTE-35 シグナル、または外部 API レスポンスに基づいて、ADS URL、ヘッダー、または本文を動的に設定します。
+ **広告サーバー間で A/B テストを実行します。**セッション属性またはランダム割り当てに基づいて、異なる ADS エンドポイント間でトラフィックを分割します。
+ **マルチステップエンリッチメントパイプラインを構築します。**複数の関数を連結して 1 つの API からデータを取得し、変換して、結果を次のステップに渡します。

## 関数が MediaTailor ワークフローにどのように適合するか
<a name="monetization-functions-workflow"></a>

視聴者が再生セッションを開始すると、MediaTailor は*ライフサイクルフック*と呼ばれる広告挿入フローの特定の時点で関数を評価します。

1. 関数を定義し、関数マッピングを通じて再生設定にアタッチします。

1. MediaTailor は、指定されたライフサイクルフックで関数を実行します。

1. この関数は、セッションデータを読み取り、オプションで外部 API を呼び出し、MediaTailor が再生処理中に使用する結果を書き込みます。

**ヒント**  
Functions を初めて使用する場合は、 から始め[「クイックスタートガイド」](monetization-functions-quickstart.md)て、 を読んでください[ライフサイクルフック](monetization-functions-hooks.md)。式の構文と完全な例については、[JSONata 式リファレンス](monetization-functions-jsonata.md)「」および「」を参照してください[関数の例](monetization-functions-examples.md)。

**Topics**
+ [関数が MediaTailor ワークフローにどのように適合するか](#monetization-functions-workflow)
+ [関数クイックスタートガイド](monetization-functions-quickstart.md)
+ [関数ライフサイクルフック](monetization-functions-hooks.md)
+ [関数のタイプと構成](monetization-functions-types.md)
+ [関数の作成と管理](monetization-functions-managing.md)
+ [Functions の JSONata 式リファレンス](monetization-functions-jsonata.md)
+ [関数の例](monetization-functions-examples.md)
+ [Functions のトラブルシューティングとモニタリング](monetization-functions-troubleshooting.md)
+ [関数の制限](monetization-functions-limits.md)