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

関数クイックスタートガイド

このガイドでは、最初の 関数を作成し、それを再生設定にアタッチして、実行されたことを確認する手順を説明します。最終的には、各ビューワーのデバイスタイプ (ctv、、または desktop) を分類しmobile、すべての ADS リクエストで使用できるプレイヤーパラメータとして保存する作業関数が作成されます。

前提条件

開始する前に、既存の MediaTailor 再生設定があることを確認してください。アカウントをお持ちでない場合は、「MediaTailor の使用開始」を参照してください。

ステップ 1: 関数を作成する

このステップでは、ユーザーエージェント文字列に基づいてビューワーのデバイスタイプを分類し、その結果をプレイヤーパラメータに保存する関数を作成します。関数は、カスタム出力タイプ (外部 API コールなし) とJSONata 式リファレンス式を使用してユーザーエージェントを評価します。

成功通知は、関数が作成されたことを確認し、関数の詳細ページにリダイレクトされます。

結果の関数設定は次のとおりです。

{
    "FunctionId": "myFirstFunction",
    "FunctionType": "CUSTOM_OUTPUT",
    "Description": "Classify device type from user agent",
    "CustomOutputConfiguration": {
        "Runtime": "JSONATA",
        "Output": {
            "player_params.deviceType": "{% $contains(session.user_agent, 'CTV') ? 'ctv' : $contains(session.user_agent, 'Mobile') ? 'mobile' : 'desktop' %}"
        }
    }
}

ステップ 2: 関数を再生設定にアタッチする

関数を再生設定のライフサイクルフックにマッピングします。マッピングは、いつ関数を実行するかを MediaTailor に伝えます。

これにより、PRE_SESSION_INITIALIZATIONライフサイクルフックmyFirstFunctionにアタッチされます。結果の関数マッピングは次のとおりです。

{
    "FunctionMapping": {
        "PRE_SESSION_INITIALIZATION": "myFirstFunction"
    }
}

MediaTailor は、この再生設定のすべての新しいセッションの開始時に関数を 1 回実行します。

ステップ 3: セッションを開始し、関数が実行されたことを確認する

新しい再生セッションを開始して、 関数をトリガーします。再生設定のセッション初期化エンドポイントにセッション初期化リクエストを使用します。

MediaTailor は、関数の実行ごとに CloudWatch メトリクスを自動的に発行します。オプトインは必要ありません。セッションを開始したら、AWS/MediaTailor名前空間で次のメトリクスを確認して、関数が実行されたことを確認します。

関数が失敗した場合、MediaTailor はデフォルトでエラーログイベントをマニフェストログに出力します (設定は必要ありません）。

次の例は、 関数式の構文エラーのPRE_SESSION_INIT_FUNCTION_ERRORイベントを示しています。

{
    "eventTimestamp": "2024-01-01T12:00:00.076000000Z",
    "eventType": "PRE_SESSION_INIT_FUNCTION_ERROR",
    "eventDescription": "Function execution failed",
    "awsAccountId": "123456789012",
    "originId": "my-config",
    "sessionId": "session-123",
    "requestId": "req-abc",
    "eventId": "5dc6f040-0f72-4e8c-a64e-25eeef62708c",
    "functionId": "myFirstFunction",
    "functionType": "CUSTOM_OUTPUT",
    "executionTimeMs": 2,
    "errorType": "SYNTAX_ERROR",
    "cause": "Expected \")\" before end of expression",
    "input": {}
}

eventId フィールドを使用して、同じ実行のフックと関数のエラーイベントを関連付けます。errorType フィールドは失敗のクラスを示します。エラータイプと修正の完全なリストトラブルシューティングとモニタリングについては、「」を参照してください。

舞台裏で何が起こるか

先ほど作成した 関数の完全なリクエストフローは次のとおりです。

何らかの理由で関数が失敗した場合、MediaTailor は出力を破棄し、関数がアタッチされていないかのように続行します。ビューワーには、デバイスタイプのターゲティングなしで広告が表示されます。

推奨されるトピック

これで、再生設定に作業関数がアタッチされました。ここから: