기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
PRE_SESSION_초기화
실행 시
MediaTailor는 새 재생 세션이 시작될 때에 매핑된 함수를 PRE_SESSION_INITIALIZATION 한 번 실행합니다. MediaTailor가 초기 매니페스트 응답을 구성하기 전에 함수가 실행됩니다.
Input
session.*, player_params.* 및 event.*. 사용 가능한 모든 필드는 섹션을 참조하세요입력 필드 참조.
허용된 출력 네임스페이스
| 네임스페이스 | 허용되는 유형 |
|---|---|
player_params.* |
문자열, 숫자, 부울 |
에 기록된 값은 세션에 player_params.* 유지됩니다. 다음과 같이 사용할 수 있습니다.
-
를 통해
PRE_ADS_REQUEST수명 주기 후크의 입력으로player_params.* -
를 통한 ADS 요청 URLs에서ADS 요청에 대한 MediaTailor 동적 광고 변수(예:
[player_params.deviceType]) -
모든 광고 시간에 걸쳐 세션의 수명 동안
참고
모든 player_params 출력 키 및 값의 직렬화된 총 크기는 1,000자를 초과할 수 없습니다. 합계가이 제한을 초과하면 함수 출력이 삭제됩니다. 자세한 내용은 함수 제한 단원을 참조하십시오.
일반적인 사용 사례
-
외부 서비스에서 자격 증명 또는 대상 데이터를 가져와 나중에 ADS 요청에 사용할 수 있도록 플레이어 파라미터에 저장합니다.
-
사용자 에이전트를 기반으로 디바이스 유형을 분류하고 플레이어 파라미터에 분류를 작성합니다.
-
다운스트림 광고 중단 처리가 의존하는 기본 플레이어 파라미터 값을 설정합니다.
-
를 통해 ADS URL에 포함된 플레이어 파라미터에 값을 저장합니다ADS 요청에 대한 MediaTailor 동적 광고 변수.
실패 특성
어떤 이유로든에 연결된 함수가 PRE_SESSION_INITIALIZATION 실패하면 MediaTailor는 함수의 출력을 삭제하고 연결된 함수가 없는 것처럼 진행합니다. 세션은 함수의 플레이어 파라미터 값 없이 정상적으로 시작됩니다.