기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# MediaTailor 구성 별칭 개요
AWS Elemental MediaTailor 구성 별칭을 사용하면 URL 도메인 및 기타 지원되는 필드에서 동적 변수 교체가 가능합니다. 이 기능을 사용하여 여러 도메인을 사용하고 세션 초기화 중에 URLs 동적으로 구성합니다.
## 사용 사례
구성 별칭을 사용하면 다음 시나리오에서 정교한 다중 구성 아키텍처를 사용할 수 있습니다.
+ **지리적 라우팅:** 리전별 별칭을 사용하여 최종 사용자 위치에 따라 요청을 다른 오리진 또는 광고 서버로 라우팅합니다. 구현 지침은 [CloudFront 오리진 장애 조치를 참조하세요](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/high_availability_origin_failover.html).
+ **콘텐츠 기반 라우팅:** 다양한 콘텐츠 유형을 특수 오리진 또는 처리 파이프라인으로 전달합니다. 라우팅 동작 구성은 섹션을 참조하세요[MediaTailor에 대한 CDN 라우팅 동작 설정](cdn-routing-behaviors.md).
+ **장애 조치 시나리오:** 별칭 전환을 사용하여 자동 장애 조치를 통해 백업 오리진 및 광고 서버를 구현합니다. 자세한 구현은 [MQAR을 사용하여 MediaTailor에 대한 다중 리전 복원력 구현](media-quality-resiliency.md) 및 섹션을 참조하세요[에 대한 CDN 통합 계획 AWS Elemental MediaTailor](planning-cdn-integration.md).
+ **A/B 테스트:** 플레이어 파라미터를 기반으로 트래픽을 라우팅하여 다양한 광고 서버, 오리진 또는 구성을 테스트합니다. 로드 테스트 지침은 [실제 사용자 모니터링을 사용하여 Amazon CloudFront에 대한 성능 테스트 준비 및 실행](https://aws.amazon.com/blogs/networking-and-content-delivery/prepare-and-run-performance-tests-for-amazon-cloudfront-with-real-user-monitoring/)을 참조하세요.
+ **디바이스별 최적화:** 다양한 디바이스 유형 또는 기능에 대한 콘텐츠 전송 및 광고 제공을 최적화합니다. 포괄적인 지침은 섹션을 참조하세요[MediaTailor, MediaPackage 및 CDN을 사용하여 매니페스트 필터링 설정](cdn-emp-manifest-filtering.md).
+ **로드 밸런싱:** 동적 라우팅을 사용하여 여러 오리진 또는 광고 서버에 로드를 분산합니다. 구현 지침은 [MQAR을 사용하여 MediaTailor에 대한 다중 리전 복원력 구현](media-quality-resiliency.md) 및 섹션을 참조하세요[에 대한 CDN 통합 계획 AWS Elemental MediaTailor](planning-cdn-integration.md).
## 지원되는 필드
다음 구성 필드에서 동적 변수를 사용할 수 있습니다.
+ `VideoContentSourceUrl`
+ `AdDecisionServerUrl`
+ `LivePreroll.AdDecisionServerUrl`
+ `AdSegmentUrlPrefix`
+ `ContentSegmentUrlPrefix`
+ `TranscodeProfileName`
+ `SlateAdUrl`
+ `StartUrl`
+ `EndUrl`
다음 섹션에서는 구성 별칭을 사용하는 방법을 설명합니다.
**Topics**
+ [사용 사례](#configuration-aliases-use-cases)
+ [지원되는 필드](#configuration-aliases-supported)
+ [생성 및 사용](creating-configuration-aliases.md)
+ [흐름 예](configuration-aliases-examples.md)
# MediaTailor를 사용하여 구성 별칭 생성 및 사용
도메인 변수를 사용하기 전에 구성에 대한 구성 별칭을 생성합니다. 세션 초기화 시 구성 별칭을 도메인 대체 변수로 사용합니다.
**제한 사항**
구성 별칭을 사용할 때 다음 제한 사항에 유의하세요.
+ 도메인에 사용되는 모든 동적 변수는 `ConfigurationAliases` 동적 변수로 정의되어야 합니다.
+ 플레이어 파라미터 변수에는 접두사가 붙어야 합니다`player_params.`. 예를 들어 `player_params.origin_domain`입니다.
+ 별칭이 지정된 값 목록은 중요한 URLs(`VideoContentSourceUrl`, `AdSegmentUrlPrefix`, `ContentSegmentUrlPrefix`)의 도메인 변수에 대해 포괄적이어야 합니다.
+ 동적 변수를 지정하지 않거나 잘못된 별칭을 사용하는 중요한 URLs의 도메인 변수에 대한 요청이 이루어진 경우 HTTP `400` 상태 코드와 함께 요청이 실패합니다. 중요하지 않은 필드(`SlateAdUrl`, `TranscodeProfileName`, 범퍼 URLs)는 경고를 로깅하지만 요청에 실패하지는 않습니다.
**누락된 별칭에 대한 대체 동작**
구성 별칭을 찾을 수 없거나 유효하지 않은 경우 MediaTailor는 다음 대체 동작을 구현합니다.
+ **도메인 변수:** 도메인 변수 별칭이 누락되거나 유효하지 않은 경우 HTTP 400 상태 코드와 함께 요청이 실패합니다. 모든 도메인 변수에는 유효한 별칭이 정의되어 있어야 합니다.
+ **비도메인 변수:** URLs의 비도메인 부분에 사용되는 변수(예: 경로 요소 또는 쿼리 파라미터)의 경우 별칭이 누락되면 빈 문자열이 대체됩니다.
+ **구성 검증:** MediaTailor는 구성 생성 및 업데이트 작업 중에 필요한 모든 별칭이 있는지 확인합니다.
## 1단계: 구성 별칭 생성
MediaTailor 콘솔을 사용하여 도메인 교체에 사용할 구성 별칭을 생성하려면 다음 절차를 수행합니다.
------
#### [ Console ]
**콘솔을 사용하여 구성 별칭을 생성하려면**
1. [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/) MediaTailor 콘솔을 엽니다.
1. **구성 페이지의 구성 별칭** 섹션에서 **플레이어 파라미터 추가**를 선택합니다. ****
1. **플레이어 파라미터**에 동적 변수로 사용할 플레이어 파라미터의 이름을 입력합니다. 예를 들어 `player_params.origin_domain`입니다.
1. **별칭**에 플레이어 파라미터에 사용할 별칭과 해당 값을 입력합니다.
1. **확인**을 선택합니다.
AWS Elemental MediaTailor 는 **구성 별칭** 섹션의 테이블에 새 파라미터를 표시합니다.
1. 이전 단계를 반복하여 플레이어 파라미터를 더 추가합니다.
1. **저장**을 선택합니다.
------
#### [ API ]
**API를 사용하여 구성 별칭을 생성하려면**
MediaTailor 구성을 생성하거나 업데이트할 때 다음 JSON 구조와 함께 `ConfigurationAliases` 파라미터를 사용합니다.
```
{
"ConfigurationAliases": {
"player_params.origin_domain": {
"pdx": "abc.mediapackage.us-west-2.amazonaws.com",
"iad": "xyz.mediapackage.us-east-1.amazonaws.com"
},
"player_params.ad_type": {
"customized": "abc12345",
"default": "defaultAdType"
}
}
}
```
------
## 2단계: 세션 초기화에서 구성 별칭 사용
구성 별칭을 설정한 후 세션 초기화 요청에서 도메인의 대체 변수로 사용할 수 있습니다. 이렇게 하면 세션의 도메인을 동적으로 구성할 수 있습니다.
**Example 기본 구성 별칭 예제**
다음은 구성 별칭과 동적 도메인 변수를 포함하는 구성의 기본 예제입니다.
```
PUT /playbackConfiguration
{
"Name": "aliasedConfig",
"AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]",
"VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]",
"ConfigurationAliases": {
"player_params.origin_domain": {
"pdx": "abc",
"iad": "xyz"
},
"player_params.region": {
"pdx": "us-west-2",
"iad": "us-east-1"
},
"player_params.endpoint_id": {
"pdx": "abcd",
"iad": "wxyz"
},
"player_params.ad_type": {
"customized": "abc12345",
"default": "defaultAdType"
}
}
}
```
**Example 별칭을 사용한 세션 초기화**
앞의 구성을 사용하면 플레이어 변수와 별칭을 사용한 세션 초기화 요청은 다음과 비슷합니다.
```
POST index.m3u8
{
"playerParams": {
"origin_domain": "pdx",
"region": "pdx",
"endpoint_id": "pdx",
"ad_type": "customized"
}
}
```
MediaTailor는 별칭 문자열을 구성 별칭 구성의 매핑된 값으로 바꿉니다.
ADS에 대한 요청은 다음과 같습니다.
```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
매니페스트의 오리진에 대한 요청은 다음과 같습니다.
```
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd
```
# MediaTailor를 사용한 구성 별칭 사용 예제
다음 예제에서는 구성 별칭이 있는 전체 MediaTailor 구성, 별칭이 있는 세션 초기화 요청 및 별칭에 대한 처리 흐름을 보여줍니다.
**Example 별칭을 사용하여 구성 완료**
다음 예제는 구성 별칭과 동적 도메인 변수를 포함하는 전체 구성을 보여줍니다.
```
PUT /playbackConfiguration
{
"Name": "aliasedConfig",
"AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]",
"VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]",
"AdSegmentUrlPrefix": "https://[player_params.ad_cdn_domain]/ads/",
"ContentSegmentUrlPrefix": "https://[player_params.content_cdn_domain]/content/",
"TranscodeProfileName": "[player_params.transcode_profile]",
"SlateAdUrl": "https://[player_params.slate_domain]/slate/[player_params.slate_type].mp4",
"StartUrl": "https://[player_params.tracking_domain]/start?session=[session.id]",
"EndUrl": "https://[player_params.tracking_domain]/end?session=[session.id]",
"ConfigurationAliases": {
"player_params.origin_domain": {
"pdx": "abc",
"iad": "xyz"
},
"player_params.region": {
"pdx": "us-west-2",
"iad": "us-east-1"
},
"player_params.endpoint_id": {
"pdx": "abcd",
"iad": "wxyz"
},
"player_params.ad_type": {
"customized": "abc12345",
"default": "defaultAdType"
},
"player_params.ad_cdn_domain": {
"pdx": "ads-west.cdn.example.com",
"iad": "ads-east.cdn.example.com"
},
"player_params.content_cdn_domain": {
"pdx": "content-west.cdn.example.com",
"iad": "content-east.cdn.example.com"
},
"player_params.transcode_profile": {
"mobile": "mobile_optimized",
"desktop": "high_quality",
"tv": "4k_profile"
},
"player_params.slate_domain": {
"pdx": "slate-west.example.com",
"iad": "slate-east.example.com"
},
"player_params.slate_type": {
"standard": "default_slate",
"branded": "brand_slate"
},
"player_params.tracking_domain": {
"pdx": "tracking-west.example.com",
"iad": "tracking-east.example.com"
}
}
}
```
**Example 별칭을 사용한 세션 초기화**
다음 예제에서는 플레이어 변수와 별칭을 지정하는 세션 초기화 요청을 보여줍니다.
```
POST master.m3u8
{
"playerParams": {
"origin_domain": "pdx",
"region": "pdx",
"endpoint_id": "pdx",
"ad_type": "customized",
"ad_cdn_domain": "pdx",
"content_cdn_domain": "pdx",
"transcode_profile": "mobile",
"slate_domain": "pdx",
"slate_type": "branded",
"tracking_domain": "pdx"
}
}
```
**Example 파라미터 처리 흐름**
다음 예제에서 MediaTailor는 별칭 문자열을 구성 별칭의 매핑된 값으로 바꿉니다. 처리 결과 다음과 같은 요청이 발생합니다.
+ ADS 요청:
```
https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345
```
+ VideoContentSource 요청:
```
https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd
```
+ AdSegmentUrlPrefix:
```
https://ads-west.cdn.example.com/ads/
```
+ ContentSegmentUrlPrefix:
```
https://content-west.cdn.example.com/content/
```
+ TranscodeProfileName:
```
mobile_optimized
```
+ SlateAdUrl:
```
https://slate-west.example.com/slate/brand_slate.mp4
```
+ StartUrl:
```
https://tracking-west.example.com/start?session=[session.id]
```
+ EndUrl:
```
https://tracking-west.example.com/end?session=[session.id]
```