기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
MediaTailor 광고 삽입 시작하기
를 사용하려면 MediaTailor 구성에 액세스하고, 구성을 보고, 편집할 수 있는 AWS 계정 및 권한이 AWS Elemental MediaTailor필요합니다. 이렇게 하는 방법에 대한 정보는 설정 AWS Elemental MediaTailor 단원을 참조하십시오.
이 시작하기 자습서는 다음 작업의 수행 방법을 보여 줍니다.
-
HLS 또는 DASH 콘텐츠 스트림 준비
-
광고 결정 서버(ADS) 템플릿 구성 URL
-
재생 엔드포인트가 포함된 MediaTailor 구성 생성
-
플레이어 또는 콘텐츠 전송 네트워크(CDN)를 사용하여 에 대한 재생 요청 MediaTailor
완료되면 스트림의 개인화된 광고 콘텐츠에 MediaTailor 대한 재생 요청을 에 보낼 수 있습니다.
주제
사전 조건
시작하기 전에 먼저 설정 AWS Elemental MediaTailor의 단계를 완료해야 합니다.
1단계: 액세스 AWS Elemental MediaTailor
IAM 자격 증명을 사용하여 에서 MediaTailor 콘솔에 로그인합니다https://console.aws.amazon.com/mediatailor/home
.
2단계: 스트림 준비
오리진 서버가 와 호환되는 HLS 또는 에 대한 매니페스트DASH를 생성하도록 구성합니다 AWS Elemental MediaTailor.
HLS 스트림 준비
HLS 매니페스트는 다음 요구 사항을 충족해야 합니다.
-
매니페스트는 퍼블릭 인터넷에서 액세스할 수 있어야 합니다.
-
매니페스트는 온디맨드 라이브 또는 비디오여야 합니다(VOD).
-
매니페스트는
EXT-X-VERSION
이3
이상이어야 합니다. -
라이브 콘텐츠의 경우 매니페스트는 광고 시간을 규정하기 위해 마커를 포함해야 합니다. 이는 VOD 콘텐츠의 경우 선택 사항이며, 대신 VMAP 시간 오프셋을 사용할 수 있습니다.
매니페스트 파일에는 다음 중 하나로 표시된 광고 슬롯이 있어야 합니다.
-
#EXT-X-CUE-OUT / #EXT-X-CUE-IN(보다 일반적) 및 다음 예제와 같은 기간.
#EXT-X-CUE-OUT:60.00 #EXT-X-CUE-IN
-
#EXT-X-(DATERANGE덜 흔함) 및 다음 예제와 같은 기간.
#EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF #EXT-X-DATERANGE:ID="",START-DATE="",DURATION=30.000,SCTE35-OUT=0xF
#EXT-X-DATERANGE
에 대해 표시된 모든 필드가 필요합니다.
매니페스트에서 광고 마커를 구성하는 방법은 광고가 스트림에 삽입되는지 또는 스트림에서 다른 조각을 대체하는지 여부에 영향을 줍니다. 자세한 내용은 MediaTailor 광고 삽입 행태에 대한 이해 단원을 참조하십시오.
-
-
HLS 마스터 매니페스트는 라이브 스트리밍에 설명된 HLS 사양인 마스터 재생 목록 태그 를 따라야 합니다. HTTP
특히 #EXT-X-STREAM-INF
에는RESOLUTION
,BANDWIDTH
및CODEC
필드가 포함되어야 합니다.
스트림을 구성한 후 마스터 매니페스트의 콘텐츠 오리진 URL 접두사를 기록해 둡니다. 이는 본 자습서에서 나중에 AWS Elemental MediaTailor에서 구성을 생성하는 데 필요합니다.
DASH 스트림 준비
DASH 매니페스트는 다음 요구 사항을 충족해야 합니다.
-
매니페스트는 퍼블릭 인터넷에서 액세스할 수 있어야 합니다.
-
매니페스트는 온디맨드 라이브 또는 비디오여야 합니다(VOD).
-
매니페스트는 스플라이스 삽입 마커 또는 시간 신호 마커를 사용하여 이벤트를 광고 시간으로 표시해야 합니다. 광고 마커를 투명 XML 또는 base64 인코딩 바이너리로 제공할 수 있습니다. 스플라이스 삽입의 out-of-network 경우 표시기를 활성화해야 합니다. 시간 신호 마커의 경우 분할 에 있는 분할 유형 ID는 에서 인식하는 큐아웃 값이어야 UPID합니다 AWS Elemental MediaTailor. 광고 시간은 이벤트 시작에서 시작하여, 이벤트가 지정된 경우 이벤트 지속 시간 동안, 또는 다음 이벤트가 시작될 때까지 지속됩니다.
다음 예제는 스플라이스 삽입 마커를 사용하여 광고 시간으로 지정된 이벤트를 표시합니다. 이 광고 시간의 지속 시간은 이벤트의 기간입니다.
<Period start="PT444806.040S" id="123586" duration="PT15.000S"> <EventStream timescale="90000" schemeIdUri="urn:scte:scte35:2013:xml"> <Event duration="1350000"> <scte35:SpliceInfoSection protocolVersion="0" ptsAdjustment="180832" tier="4095"> <scte35:SpliceInsert spliceEventId="4026531855" spliceEventCancelIndicator="false" outOfNetworkIndicator="true" spliceImmediateFlag="false" uniqueProgramId="1" availNum="1" availsExpected="1"> <scte35:Program><scte35:SpliceTime ptsTime="5672624400"/></scte35:Program> <scte35:BreakDuration autoReturn="true" duration="1350000"/> </scte35:SpliceInsert> </scte35:SpliceInfoSection> </Event> </EventStream> <AdaptationSet mimeType="video/mp4" ... </AdaptationSet> </Period>
-
광고 시간에는 콘텐츠 스트림으로 동일한
AdaptationSet
및Representation
설정이 있어야 합니다. AWS Elemental MediaTailor 은 이 둘 사이의 원활한 전환을 위해 이러한 설정을 사용하여 광고를 트랜스코딩하고 콘텐츠 스트림을 일치시킵니다.
스트림을 구성한 후 DASH 매니페스트의 콘텐츠 오리진 URL 접두사를 기록해 둡니다. 이 자습서의 뒷부분에 AWS Elemental MediaTailor있는 에서 구성을 생성하려면 구성이 필요합니다.
3단계: ADS 요청 URL 및 쿼리 파라미터 구성
에 ADS 필요한 쿼리 파라미터를 결정하려면 URL에서 광고 태그를 생성합니다ADS. 이는 에 대한 요청의 템플릿 URL 역할을 ADS하며 다음으로 구성됩니다.
-
정적 값
-
에서 생성한 값 AWS Elemental MediaTailor (
session
또는avail
쿼리 파라미터로 표시됨) -
플레이어가 생성하고 클라이언트 애플리케이션에서 가져온 값(
player_params.
쿼리 파라미터로 표시됨)
예 URL 의 광고 태그 ADS
https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params]
위치:
-
출력 및 content_id는 정적 값입니다.
-
playerSession=[session.id]는 에서 제공하는 동적 값입니다 AWS Elemental MediaTailor. [session.id] 값은 각 플레이어 세션에 대해 변경되며 각 세션URL의 VAST 요청에 대해 서로 다릅니다.
-
cust_params는 플레이어가 제공한 동적 값입니다.
플레이어의 마스터 매니페스트 요청은 ADS 요청 의 player_params.
쿼리 파라미터에 해당하는 키-값 페어를 제공해야 합니다URL. AWS Elemental MediaTailor으로의 요청에서 키-값 페어를 구성하는 방법에 대한 자세한 내용은 에서 동적 광고 변수 사용 MediaTailor 단원을 참조하십시오.
의 에서 오리진 서버/ADS매핑을 생성할 URL 때 구성된 '템플릿' MediaTailor을 입력합니다4단계: 구성 생성.
테스트
ADS 테스트 목적으로 의 정적 VAST 응답을 사용할 수 있습니다. 이상적으로는 VAST 응답이 트랜스코딩할 AWS Elemental MediaTailor 수 있는 메자닌 품질 MP4 변환을 반환합니다. 의 응답에 여러 재생 변환이 ADS 포함된 경우 는 최고 품질의 해상도 MP4 변환을 MediaTailor 피킹하여 트랜스코더로 전송합니다.
4단계: 구성 생성
AWS Elemental MediaTailor 구성에는 오리진 서버 및 에 대한 매핑 정보가 포함됩니다ADS.
구성을 만들려면(콘솔)
에서 MediaTailor 콘솔을 엽니다https://console.aws.amazon.com/mediatailor/
. -
Configurations(구성) 페이지에서 Create configuration(구성 생성)을 선택합니다.
-
페이지 하단의 구성 단원에서 구성 이름에 구성을 설명하는 고유한 이름을 입력합니다. 이름은 구성의 기본 식별자입니다. 허용된 최대 길이는 512자입니다.
-
비디오 콘텐츠 소스 에 이 스트림의 HLS 마스터 매니페스트 또는 매DASH니페스트 접두사에서 자산 ID를 뺀 URL 접두사를 입력합니다. 예를 들어 마스터 매니페스트URL가 인 경우 를
http://origin-server.com/a/master.m3u8
입력합니다http://origin-server.com/a/
. 또는http://origin-server.com
과 같은 더 짧은 접두사를 입력할 수 있지만, 콘텐츠에 대한 플레이어 요청에서/a/
를 자산 ID에 포함시켜야 합니다. 최대 길이는 512자입니다.참고
콘텐츠 오리진에서 를 사용하는 경우 HTTPS해당 인증서는 잘 알려진 인증 기관에서 발급한 것이어야 합니다. (자체 서명된 인증서는 사용할 수 없습니다.) 그렇지 않으면 가 콘텐츠 오리진에 연결 AWS Elemental MediaTailor 하지 못하고 플레이어 요청에 대한 응답으로 매니페스트를 제공할 수 없습니다.
-
광고 결정 서버 에 URL 의 를 입력합니다ADS. 이는 에 설명된 변수가 URL 있는 3단계: ADS 요청 URL 및 쿼리 파라미터 구성이거나 테스트 목적으로 사용 VAST URL 중인 정적 입니다. 최대 길이는 25,000자입니다.
참고
가 를 ADS 사용하는 경우 HTTPS인증서는 잘 알려진 인증 기관에서 발급한 것이어야 합니다. (자체 서명된 인증서는 사용할 수 없습니다.) 에서 URLs 반환한 메자닌 광고도 마찬가지입니다ADS. 그렇지 않으면 가 콘텐츠 오리진에서 매니페스트에 광고를 검색하고 연결 MediaTailor 하지 못합니다.
-
(의 경우 필요에 따라 선택 사항DASH) 위치 에서 MediaTailor 매니페스트에 액세스하기 위한 CDN 라우팅 규칙이 설정되어 있고 클라이언트 측 보고를 사용하거나 플레이어가 고정 HTTP리디렉션을 지원하는DISABLED지 선택합니다.
위치 기능에 대한 자세한 내용은 DASH 위치 기능 단원을 참조하십시오.
-
(선택 사항) 오리진 서버에서 단일 기간 매DASH니페스트를 생성하는 경우 DASH mpd 매니페스트 오리진 유형 을 선택한 다음 SINGLE_PERIOD를 선택합니다. 기본적으로 는 매DASH니페스트를 다중 기간 매니페스트로 MediaTailor 처리합니다. 자세한 내용은 MPEG-DASH 소스 통합 단원을 참조하십시오.
-
구성 생성을 선택합니다.
AWS Elemental MediaTailor 는 구성 페이지에 새 구성을 표시합니다.
5단계: 구성 테스트
구성을 저장한 후 스트리밍 프로토콜에 적합한 형식으로 URL를 사용하여 스트림을 테스트합니다.
-
예: HLS
playback-endpoint/v1/master/hashed-account-id/origin-id/master.m3u8
-
예: DASH
playback-endpoint/v1/dash/hashed-account-id/origin-id/manifest.mpd
위치:
-
playback-endpoint
는 구성 생성 시 AWS Elemental MediaTailor 에서 생성한 고유한 재생 엔드포인트입니다.예
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com
-
hashed-account-id
는 ID입니다 AWS 계정 .예
AKIAIOSFODNN7EXAMPLE
-
origin-id
는 구성 생성 시 부여한 이름입니다.예
myOrigin
-
master.m3u8
또는manifest.mpd
는 테스트 스트림과 파일 확장명에서의 매니페스트 이름입니다. 4단계: 구성 생성에서 구성한 비디오 콘텐츠 소스에 이를 추가할 때 전체 식별된 매니페스트를 가져오도록 이를 정의합니다.
위 예제의 값을 사용하여 전체 URLs 는 다음과 같습니다.
-
예: HLS
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8
-
예: DASH
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd
다음 방법 중 하나를 사용하여 스트림을 테스트할 수 있습니다.
-
이전 예제와 같이 독립형 플레이어URL에 를 입력합니다.
-
자체 플레이어 환경에서 스트림을 테스트합니다.
6단계: 재생 요청 전송 AWS Elemental MediaTailor
다운스트림 플레이어 또는 를 구성CDN하여 에서 제공하는 구성의 재생 엔드포인트로 재생 요청을 보냅니다 AWS Elemental MediaTailor. 의 ADS 요청에 사용한 플레이어 정의 동적 변수는 플레이어의 매니페스트 요청에 정의되어야 URL 3단계: ADS 요청 URL 및 쿼리 파라미터 구성 합니다.
예
템플릿ADSURL이 다음과 같다고 가정합니다.
https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=[session.id]&cust_params=[player_params.cust_params]
그런 다음 [player_params.cust_params]
가 아닌 ads.
오리진 서버에 선행하지 않는 파라미터를 ads.
. AWS Elemental MediaTailor passs 파라미터로 키-값 페어 앞에 붙여 플레이어 요청에 를 정의합니다ADS.
플레이어 요청은 다음 HLS 및 DASH 예제의 일부 변형URL입니다.
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/myOrigin/master.m3u8?ads.cust_params=viewerinfo
https://bdaaeb4bd9114c088964e4063f849065.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/myOrigin/manifest.mpd?ads.cust_params=viewerinfo
가 플레이어 요청을 AWS Elemental MediaTailor 수신하면 요청의 정보를 기반으로 플레이어 변수를 정의합니다. 그 결과 ADS 요청의 변형URL이 발생합니다.
https://my.ads.com/ad?output=vast&content_id=12345678&playerSession=<filled_in_session_id>&cust_params=viewerinfo
에 전달하도록 키-값 페어를 구성하는 방법에 대한 자세한 내용은 섹션을 ADS참조하세요에서 동적 광고 변수 사용 MediaTailor.
7단계(선택 사항): 활동 모니터링 AWS Elemental MediaTailor
Amazon CloudWatch 및 Amazon CloudWatch Logs를 사용하여 완료된 요청, 오류 및 광고 사용률 수와 같은 AWS Elemental MediaTailor 활동을 추적할 수 있습니다.
CloudWatch 와 함께 를 처음 사용하는 경우 서비스 간의 통신을 허용하는 AWS Identity and Access Management (IAM) 역할을 AWS Elemental MediaTailor생성합니다.
에 AWS Elemental MediaTailor 대한 액세스를 허용하려면 CloudWatch (콘솔)
에서 IAM 콘솔을 엽니다https://console.aws.amazon.com/iam/
. -
IAM 콘솔의 탐색 창에서 역할 을 선택한 다음 역할 생성 을 선택합니다.
-
다른 AWS 계정 역할 유형을 선택합니다.
-
계정 ID 에 AWS 계정 ID를 입력합니다.
-
Require external ID(외부 ID 필요)를 선택하고
midas
를 입력합니다. 이 옵션은 요청에 올바른sts:ExternalID
가 포함된 경우에만 서비스가 역할을 맡을 수 있도록 허용하는 조건을 신뢰 정책에 자동으로 추가합니다. -
다음: 권한을 선택합니다.
-
역할이 완료할 수 있는 작업을 지정하는 권한 정책을 추가합니다. 다음 옵션 중 하나를 선택한 다음 Next: Review(다음: 검토)를 선택합니다.
-
CloudWatchLogsFullAccess Amazon CloudWatch Logs에 대한 전체 액세스 권한을 제공하려면
-
CloudWatchFullAccess Amazon에 대한 전체 액세스 권한을 제공하려면 CloudWatch
-
-
역할 이름에
MediaTailorLogger
를 입력한 다음 역할 생성을 선택합니다. -
역할 페이지에서 방금 생성한 역할을 선택합니다.
-
보안 주체를 업데이트하도록 신뢰 관계를 편집합니다.
-
역할의 요약 페이지에서 신뢰 관계 탭을 선택합니다.
-
신뢰 관계 편집을 선택합니다.
-
정책 문서에서 보안 주체부터 AWS Elemental MediaTailor 서비스까지 바꾸어주십시오. 형식은 다음과 같아야 합니다.
"Principal": { "Service": "mediatailor.amazonaws.com" },
전체 정책은 다음과 같습니다.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "mediatailor.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "sts:ExternalId": "Midas" } } } ] }
-
신뢰 정책 업데이트를 선택합니다.
-
8단계: 정리
관련 없는 요금을 방지하려면 모든 불필요한 구성을 삭제합니다.
구성을 삭제하려면(콘솔)
-
AWS Elemental MediaTailor 구성 페이지에서 다음 중 하나를 수행합니다.
-
삭제할 구성의 구성 이름을 선택합니다.
-
구성 이름 열에서 라디오 버튼을 선택한 다음 삭제를 선택합니다.
-
-
구성 삭제 확인 상자에
Delete
을 입력한 다음 다시 삭제를 선택합니다.AWS Elemental MediaTailor 는 구성을 제거합니다.