기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# PRE\_SESSION\_초기화
<a name="monetization-functions-hooks-pre-session"></a>

## 실행 시
<a name="monetization-functions-hooks-pre-session-when"></a>

MediaTailor는 새 재생 세션이 시작될 때에 매핑된 함수를 `PRE_SESSION_INITIALIZATION` 한 번 실행합니다. MediaTailor가 초기 매니페스트 응답을 구성하기 전에 함수가 실행됩니다.

## Input
<a name="monetization-functions-hooks-pre-session-input"></a>

`session.*`, `player_params.*` 및 `event.*`. 사용 가능한 모든 필드는 섹션을 참조하세요[입력 필드 참조](monetization-functions-hooks.md#monetization-functions-hooks-input-ref).

## 허용된 출력 네임스페이스
<a name="monetization-functions-hooks-pre-session-output"></a>


| 네임스페이스 | 허용되는 유형 | 
| --- | --- | 
| player\_params.\* | 문자열, 숫자, 부울 | 

에 기록된 값은 세션에 `player_params.*` 유지됩니다. 다음과 같이 사용할 수 있습니다.
+ 를 통해 `PRE_ADS_REQUEST` 수명 주기 후크의 입력으로 `player_params.*`
+ 를 통한 ADS 요청 URLs에서[ADS 요청에 대한 MediaTailor 동적 광고 변수](variables.md)(예: `[player_params.deviceType]`)
+ 모든 광고 시간에 걸쳐 세션의 수명 동안

**참고**  
모든 `player_params` 출력 키 및 값의 직렬화된 총 크기는 1,000자를 초과할 수 없습니다. 합계가이 제한을 초과하면 함수 출력이 삭제됩니다. 자세한 내용은 [함수 제한](monetization-functions-limits.md) 단원을 참조하십시오.

## 일반적인 사용 사례
<a name="monetization-functions-hooks-pre-session-use-cases"></a>
+ 외부 서비스에서 자격 증명 또는 대상 데이터를 가져와 나중에 ADS 요청에 사용할 수 있도록 플레이어 파라미터에 저장합니다.
+ 사용자 에이전트를 기반으로 디바이스 유형을 분류하고 플레이어 파라미터에 분류를 작성합니다.
+ 다운스트림 광고 중단 처리가 의존하는 기본 플레이어 파라미터 값을 설정합니다.
+ 를 통해 ADS URL에 포함된 플레이어 파라미터에 값을 저장합니다[ADS 요청에 대한 MediaTailor 동적 광고 변수](variables.md).

## 실패 특성
<a name="monetization-functions-hooks-pre-session-failure"></a>

어떤 이유로든에 연결된 함수가 `PRE_SESSION_INITIALIZATION` 실패하면 MediaTailor는 함수의 출력을 삭제하고 연결된 함수가 없는 것처럼 진행합니다. 세션은 함수의 플레이어 파라미터 값 없이 정상적으로 시작됩니다.