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

# PRE\_ADS\_REQUEST
<a name="monetization-functions-hooks-pre-ads"></a>

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

MediaTailor는 ADS에 요청을 보내기 직전에 광고 중단당 `PRE_ADS_REQUEST` 한 번에 매핑된 함수를 실행합니다. 함수는 매니페스트 처리 중에 광고 기회가 발생할 때마다 실행됩니다.

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

`PRE_SESSION_INITIALIZATION`, , 및의 모든 필드`avail.*``scte.*``adsRequest.*`(url, 메서드, 헤더, 본문). 사용 가능한 모든 필드는 섹션을 참조하세요[입력 필드 참조](monetization-functions-hooks.md#monetization-functions-hooks-input-ref).

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


| 네임스페이스 | 허용되는 유형 | 출력 사용 방법 | 
| --- | --- | --- | 
| player\_params.\* | 문자열, 숫자, 부울 | 이 광고 시간에 대한 세션 플레이어 파라미터를 재정의합니다. 를 통해 ADS 요청 URL에 사용할 수 있습니다[ADS 요청에 대한 MediaTailor 동적 광고 변수](variables.md). | 
| session.\* | 문자열, 숫자, 부울 | 이 광고 시간에 대한 세션 변수를 재정의합니다. 동적 변수 대체를 통해 ADS 요청 URL에 사용할 수 있습니다. | 
| avail.\* | 문자열, 숫자, 부울 | 이 광고 시간에 대한 가용 변수를 재정의합니다. 동적 변수 대체를 통해 ADS 요청 URL에 사용할 수 있습니다. | 
| scte.\* | 문자열, 숫자, 부울 | 이 광고 시간에 대한 SCTE 변수를 재정의합니다. 동적 변수 대체를 통해 ADS 요청 URL에 사용할 수 있습니다. | 
| adsRequest.\* | 문자열 | 이 광고 시간에 대한 ADS 요청만 재정의합니다. 지원되는 필드: url, method, headers.<name>, body. url 값은 템플릿으로 취급되며 함수가 실행된 [ADS 요청에 대한 MediaTailor 동적 광고 변수](variables.md) 후를 지원합니다. 지속되지 않습니다. | 

**참고**  
`PRE_ADS_REQUEST` 후크의 모든 출력은 임시 재정의입니다. 이는 현재 광고 시간의 ADS 요청에만 적용되며 세션에 유지되지 않습니다.

**예 - ADS 요청 재작성:**

```
{
    "Output": {
        "adsRequest.url": "{%'https://ads.example.com/v1/vast?sid=' & session.id & '&genre=' & player_params.genre%}",
        "adsRequest.headers.X-Custom-Token": "{%player_params.auth_token%}"
    }
}
```

그러면 ADS URL이 대체되고 현재 광고 시간에 대한 사용자 지정 헤더가 추가됩니다.

## 일반적인 사용 사례
<a name="monetization-functions-hooks-pre-ads-use-cases"></a>
+ ADS 요청 URL을 다시 작성하여 A/B 테스트를 위해 서로 다른 광고 서버 간에 트래픽을 라우팅합니다.
+ ADS 요청 URL 또는 헤더에 보강 데이터(대상 세그먼트, 자격 증명 토큰)를 추가합니다.
+ SCTE-35 신호 데이터 또는 가용 인덱스를 기반으로 ADS 요청 파라미터를 조건부로 수정합니다.

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

어떤 이유로든에 연결된 함수가 `PRE_ADS_REQUEST` 실패하면 MediaTailor는 함수의 출력을 삭제하고 연결된 함수가 없는 것처럼 진행합니다. ADS 요청은 수정 없이 원래 세션 및 요청 파라미터를 사용하여 전송됩니다.