사전 조건 1단계: 액세스 MediaTailor 2단계: 스트림 준비 3단계: ADS 요청 URL 및 쿼리 파라미터 구성 4단계: 구성 생성 5단계: 구성 테스트 6단계: 재생 요청을 다음으로 전송 MediaTailor (선택 사항) 7단계: 활동 모니터링 8단계: 정리

MediaTailor 광고 삽입 시작하기

사용하기 AWS Elemental MediaTailor, 필요하세요 AWS 계정 및 MediaTailor 구성을 액세스하고, 보고, 편집할 수 있는 권한 이렇게 하는 방법에 대한 정보는 설정 AWS Elemental MediaTailor 단원을 참조하십시오.

이 시작하기 자습서는 다음 작업의 수행 방법을 보여 줍니다.

HLS또는 DASH 콘텐츠 스트림을 준비하세요.
광고 의사결정 서버 (ADS) 템플릿 구성 URL
재생 엔드포인트가 포함된 MediaTailor 구성 만들기
플레이어 또는 콘텐츠 전송 네트워크 (CDN) 를 사용하여 다음으로 재생을 요청하십시오. MediaTailor

작업을 마치면 스트림의 개인화된 광고 콘텐츠에 MediaTailor 대한 재생 요청을 에 보낼 수 있습니다.

주제

사전 조건
1단계: 액세스 AWS Elemental MediaTailor
2단계: 스트림 준비
3단계: ADS 요청 URL 및 쿼리 파라미터 구성
4단계: 구성 생성
5단계: 구성 테스트
6단계: 재생 요청을 다음으로 전송 AWS Elemental MediaTailor
7단계 (선택 사항): 모니터링 AWS Elemental MediaTailor activity
8단계: 정리

사전 조건

시작하기 전에 먼저 설정 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 이상이어야 합니다.
라이브 콘텐츠의 경우 매니페스트는 광고 시간을 규정하기 위해 마커를 포함해야 합니다. 이는 VMAP 타임오프셋을 대신 사용할 수 있는 VOD 콘텐츠의 경우 선택 사항입니다.

매니페스트 파일에는 다음 중 하나로 표시된 광고 슬롯이 있어야 합니다.
- 다음 예와 같이 지속 시간이 있는 # EXT EXT -X- CUE - -OUT/# -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마스터 매니페스트는 HTTP라이브 스트리밍에 설명된 HLS 사양인 마스터 재생목록 태그를 준수해야 합니다. 특히 #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>
```

광고 제공의 광고 Representation 설정은 콘텐츠 AdaptationSet 스트림과 동일해야 합니다. AWS Elemental MediaTailor 이 설정을 사용하여 콘텐츠 스트림과 일치하도록 광고를 트랜스코딩하므로 둘 사이를 원활하게 전환할 수 있습니다.

스트림을 구성한 후에는 매니페스트의 콘텐츠 오리진 URL 접두사를 기록해 두십시오. DASH 에서 구성을 생성하려면 이 정보가 필요합니다. AWS Elemental MediaTailor이 자습서의 뒷부분에서 설명합니다.

3단계: ADS 요청 URL 및 쿼리 파라미터 구성

필요한 쿼리 매개변수를 ADS 결정하려면 URL 에서 광고 태그를 생성하십시오ADS. 이는 에 대한 요청을 위한 템플릿 URL 역할을 ADS 하며 다음과 같이 구성됩니다.

정적 값
에 의해 생성된 값 AWS Elemental MediaTailor (session또는 avail 쿼리 매개변수로 표시)
플레이어가 생성하고 클라이언트 애플리케이션에서 가져온 값(player_params. 쿼리 파라미터로 표시됨)

예 URLa에서 가져온 광고 태그 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는 플레이어가 제공한 동적 값입니다.

플레이어의 마스터 매니페스트 요청은 요청의 쿼리 파라미터에 해당하는 키-값 쌍을 제공해야 합니다. player_params. ADS URL 요청에서 키-값 쌍을 구성하는 방법에 대한 자세한 내용은 다음을 참조하십시오. AWS Elemental MediaTailor, 를 참조하십시오. 에서 동적 광고 변수 사용 MediaTailor

에서 오리진 ADS 서버/매핑을 생성할 URL 때 구성된 “템플릿”을 입력합니다. MediaTailor 4단계: 구성 생성

테스트

의 정적 VAST 응답을 테스트 ADS 목적으로 사용할 수 있습니다. 이상적으로는 VAST 응답이 다음과 같은 메자닌 품질의 변환을 반환하는 것입니다. MP4 AWS Elemental MediaTailor 트랜스코딩할 수 있습니다. 의 응답에 여러 재생 렌디션이 ADS 포함된 경우 가장 높은 품질과 해상도의 MP4 렌디션을 선택하여 트랜스코더로 보냅니다. MediaTailor

4단계: 구성 생성

The AWS Elemental MediaTailor 구성에는 원본 서버 및 에 대한 매핑 정보가 들어 ADS 있습니다.

구성을 만들려면(콘솔)

에서 MediaTailor 콘솔을 엽니다 https://console.aws.amazon.com/mediatailor/.
Configurations(구성) 페이지에서 Create configuration(구성 생성)을 선택합니다.
페이지 하단의 구성 단원에서 구성 이름에 구성을 설명하는 고유한 이름을 입력합니다. 이름은 구성의 기본 식별자입니다. 허용된 최대 길이는 512자입니다.
비디오 콘텐츠 소스의 경우 이 스트림의 HLS 마스터 매니페스트 또는 DASH 매니페스트의 URL 접두사에서 에셋 ID를 뺀 값을 입력합니다. 예를 들어 마스터 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 y를 입력하십시오. ADS 이 변수는 에 3단계: ADS 요청 URL 및 쿼리 파라미터 구성 설명된 URL with 변수이거나 테스트용으로 VAST URL 사용하는 정적 변수입니다. 최대 길이는 25,000자입니다.

참고
ADS사용하는 HTTPS 경우 해당 인증서는 잘 알려진 인증 기관에서 발급한 것이어야 합니다. (자체 서명된 인증서는 사용할 수 없습니다.) 에서 URLs 반품한 메자닌 광고의 경우도 마찬가지입니다. ADS 그렇지 MediaTailor 않으면 콘텐츠 오리진에서 광고를 검색하고 매니페스트에 연결할 수 없습니다.
(필요에 따라 선택 사항DASH) 위치의 DISABLED경우 MediaTailor 매니페스트 액세스를 위한 CDN 라우팅 규칙이 설정되어 있고 클라이언트 측 보고를 사용하거나 플레이어가 고정 리디렉션을 지원하는지 여부를 선택합니다. HTTP

위치 기능에 대한 자세한 내용은 DASH위치 기능 단원을 참조하십시오.
(선택 사항) 오리진 서버에서 단일 기간 DASH 매니페스트를 생성하는 경우 DASHmpd manifest origin type을 선택한 다음 _를 선택합니다. SINGLE PERIOD 기본적으로 매니페스트를 다중 기간 MediaTailor DASH 매니페스트로 처리합니다. 자세한 내용은 MPEG- DASH 소스 통합 단원을 참조하십시오.
구성 생성을 선택합니다.

AWS Elemental MediaTailor 구성 페이지에 새 구성을 표시합니다.

5단계: 구성 테스트

구성을 저장한 후 스트리밍 프로토콜에 적합한 URL 형식의 a를 사용하여 스트림을 테스트합니다.

예: 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는 귀하의 것입니다. 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. ADSURL요청에서 사용한 모든 플레이어 정의 동적 변수는 플레이어의 매니페스트 요청에 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. AWS Elemental MediaTailor 앞에 붙지 않은 파라미터를 가 아닌 오리진 서버에 전달합니다. ads. ADS

플레이어 URL 요청은 다음 HLS 및 DASH 예제의 일부 변형입니다.


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 activity

아마존 CloudWatch 로그와 아마존 CloudWatch 로그를 사용하여 추적하세요 AWS Elemental MediaTailor 활동 (예: 요청 수, 오류, 채워진 광고 요청 수)

를 처음 사용하는 경우 CloudWatch AWS Elemental MediaTailor, 생성하세요 AWS Identity and Access Management 서비스 간 통신을 허용하는 (IAM) 역할

허용하려면 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(다음: 검토)를 선택합니다.
- CloudWatchLogsFullAccessAmazon CloudWatch Logs에 대한 전체 액세스 권한 제공
- CloudWatchFullAccessAmazon에 대한 전체 액세스 권한 제공 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 구성을 제거합니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

시작하기: MediaTailor

MediaTailor 채널 어셈블리 시작하기