기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
PRE_ADS_REQUEST
실행 시
MediaTailor는 ADS에 요청을 보내기 직전에 광고 중단당 PRE_ADS_REQUEST 한 번에 매핑된 함수를 실행합니다. 함수는 매니페스트 처리 중에 광고 기회가 발생할 때마다 실행됩니다.
Input
PRE_SESSION_INITIALIZATION, , 및의 모든 필드avail.*scte.*adsRequest.*(url, 메서드, 헤더, 본문). 사용 가능한 모든 필드는 섹션을 참조하세요입력 필드 참조.
허용된 출력 네임스페이스
| 네임스페이스 | 허용되는 유형 | 출력 사용 방법 |
|---|---|---|
player_params.* |
문자열, 숫자, 부울 | 이 광고 시간에 대한 세션 플레이어 파라미터를 재정의합니다. 를 통해 ADS 요청 URL에 사용할 수 있습니다ADS 요청에 대한 MediaTailor 동적 광고 변수. |
session.* |
문자열, 숫자, 부울 | 이 광고 시간에 대한 세션 변수를 재정의합니다. 동적 변수 대체를 통해 ADS 요청 URL에 사용할 수 있습니다. |
avail.* |
문자열, 숫자, 부울 | 이 광고 시간에 대한 가용 변수를 재정의합니다. 동적 변수 대체를 통해 ADS 요청 URL에 사용할 수 있습니다. |
scte.* |
문자열, 숫자, 부울 | 이 광고 시간에 대한 SCTE 변수를 재정의합니다. 동적 변수 대체를 통해 ADS 요청 URL에 사용할 수 있습니다. |
adsRequest.* |
문자열 | 이 광고 시간에 대한 ADS 요청만 재정의합니다. 지원되는 필드: url, method, headers.<name>, body. url 값은 템플릿으로 취급되며 함수가 실행된 ADS 요청에 대한 MediaTailor 동적 광고 변수 후를 지원합니다. 지속되지 않습니다. |
참고
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이 대체되고 현재 광고 시간에 대한 사용자 지정 헤더가 추가됩니다.
일반적인 사용 사례
-
ADS 요청 URL을 다시 작성하여 A/B 테스트를 위해 서로 다른 광고 서버 간에 트래픽을 라우팅합니다.
-
ADS 요청 URL 또는 헤더에 보강 데이터(대상 세그먼트, 자격 증명 토큰)를 추가합니다.
-
SCTE-35 신호 데이터 또는 가용 인덱스를 기반으로 ADS 요청 파라미터를 조건부로 수정합니다.
실패 특성
어떤 이유로든에 연결된 함수가 PRE_ADS_REQUEST 실패하면 MediaTailor는 함수의 출력을 삭제하고 연결된 함수가 없는 것처럼 진행합니다. ADS 요청은 수정 없이 원래 세션 및 요청 파라미터를 사용하여 전송됩니다.
