MediaTailor 광고 삽입 시작하기 - AWS Elemental MediaTailor

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

MediaTailor 광고 삽입 시작하기

사용하려면 MediaTailor 구성에 액세스하고 AWS Elemental MediaTailor, 보고, 수정할 수 있는 AWS 계정 및 권한이 필요합니다. 이렇게 하는 방법에 대한 정보는 설 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-VERSION3 이상이어야 합니다.

  • 라이브 콘텐츠의 경우 매니페스트는 광고 시간을 규정하기 위해 마커를 포함해야 합니다. 이는 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, BANDWIDTHCODEC 필드가 포함되어야 합니다.

스트림을 구성한 후에는 마스터 매니페스트의 콘텐츠 오리진 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>
  • 광고 시간에는 콘텐츠 스트림으로 동일한 AdaptationSetRepresentation 설정이 있어야 합니다. 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으로의 요청에서 키-값 페어를 구성하는 방법에 대한 자세한 내용은 에서 동적 광고 변수 사용 AWS Elemental MediaTailor 단원을 참조하십시오.

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

테스트

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

4단계: 구성 생성

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

구성을 만들려면(콘솔)
  1. 에서 MediaTailor 콘솔을 엽니다 https://console.aws.amazon.com/mediatailor/.

  2. Configurations(구성) 페이지에서 Create configuration(구성 생성)을 선택합니다.

  3. 페이지 하단의 구성 단원에서 구성 이름에 구성을 설명하는 고유한 이름을 입력합니다. 이름은 구성의 기본 식별자입니다. 허용된 최대 길이는 512자입니다.

  4. 비디오 콘텐츠 소스의 경우 이 스트림의 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 않으면 콘텐츠 오리진에 연결할 수 없고 플레이어 요청에 대한 응답으로 매니페스트를 제공할 수 없습니다.

  5. 광고 의사 결정 서버의 경우 URL y를 입력하십시오. ADS 이 변수는 에 3단계: ADS 요청 URL 및 쿼리 파라미터 구성 설명된 URL with 변수이거나 테스트용으로 VAST URL 사용하는 정적 변수입니다. 최대 길이는 25,000자입니다.

    참고

    ADS사용하는 HTTPS 경우 해당 인증서는 잘 알려진 인증 기관에서 발급한 것이어야 합니다. (자체 서명된 인증서는 사용할 수 없습니다.) 에서 URLs 반품한 메자닌 광고의 경우도 마찬가지입니다. ADS 그렇지 MediaTailor 않으면 콘텐츠 오리진에서 광고를 검색하고 매니페스트에 연결할 수 없습니다.

  6. (필요에 따라 선택 사항DASH) 위치의 DISABLED경우 MediaTailor 매니페스트 액세스를 위한 CDN 라우팅 규칙이 설정되어 있고 클라이언트 측 보고를 사용하거나 플레이어가 고정 리디렉션을 지원하는지 여부를 선택합니다. HTTP

    위치 기능에 대한 자세한 내용은 DASH위치 기능 단원을 참조하십시오.

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

  8. 구성 생성을 선택합니다.

    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 계정 ID입니다.

    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

다운스트림 플레이어를 구성하거나 에서 AWS Elemental MediaTailor제공된 구성의 재생 엔드포인트로 재생 요청을 CDN 보내도록 합니다. 요청에서 사용한 모든 플레이어 정의 동적 변수는 플레이어의 매니페스트 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. 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 참조하십시오. 에서 동적 광고 변수 사용 AWS Elemental MediaTailor

7단계 (선택 사항): 활동 모니터링 AWS Elemental MediaTailor

Amazon CloudWatch 및 Amazon CloudWatch Logs를 사용하여 요청 수, 오류 수, 채워진 광고 요청 수와 같은 AWS Elemental MediaTailor 활동을 추적할 수 있습니다.

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

CloudWatch (콘솔) 에 AWS Elemental MediaTailor 대한 액세스를 허용하려면
  1. 에서 IAM 콘솔을 엽니다 https://console.aws.amazon.com/iam/.

  2. IAM콘솔의 탐색 창에서 역할을 선택한 다음 역할 생성을 선택합니다.

  3. 다른 AWS 계정 역할 유형을 선택합니다.

  4. 계정 ID에 AWS 계정 ID를 입력합니다.

  5. Require external ID(외부 ID 필요)를 선택하고 midas를 입력합니다. 이 옵션은 요청에 올바른 sts:ExternalID가 포함된 경우에만 서비스가 역할을 맡을 수 있도록 허용하는 조건을 신뢰 정책에 자동으로 추가합니다.

  6. 다음: 권한을 선택합니다.

  7. 역할이 완료할 수 있는 작업을 지정하는 권한 정책을 추가합니다. 다음 옵션 중 하나를 선택한 다음 Next: Review(다음: 검토)를 선택합니다.

    • CloudWatchLogsFullAccessAmazon CloudWatch Logs에 대한 전체 액세스 권한 제공

    • CloudWatchFullAccessAmazon에 대한 전체 액세스 권한 제공 CloudWatch

  8. 역할 이름MediaTailorLogger를 입력한 다음 역할 생성을 선택합니다.

  9. 역할 페이지에서 방금 생성한 역할을 선택합니다.

  10. 보안 주체를 업데이트하도록 신뢰 관계를 편집합니다.

    1. 역할의 요약 페이지에서 신뢰 관계 탭을 선택합니다.

    2. 신뢰 관계 편집을 선택합니다.

    3. 정책 문서에서 보안 주체부터 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" } } } ] }
    4. 신뢰 정책 업데이트를 선택합니다.

8단계: 정리

관련 없는 요금을 방지하려면 모든 불필요한 구성을 삭제합니다.

구성을 삭제하려면(콘솔)
  1. AWS Elemental MediaTailor 구성 페이지에서 다음 중 하나를 수행하십시오.

    • 삭제할 구성의 구성 이름을 선택합니다.

    • 구성 이름 열에서 라디오 버튼을 선택한 다음 삭제를 선택합니다.

  2. 구성 삭제 확인 상자에 Delete을 입력한 다음 다시 삭제를 선택합니다.

    AWS Elemental MediaTailor 구성을 제거합니다.