

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

# 수율 최적화 빠른 시작 안내서
<a name="yield-optimization-quickstart"></a>

이 가이드에서는 재생 구성에서 수율 최적화를 활성화하고 작동하는지 확인하는 방법을 안내합니다.

**목표:**이 가이드가 끝나면 APS의 프로그래밍 방식 광고로 채워지지 않은 광고 인벤토리를 자동으로 채우는 재생 구성을 갖게 됩니다.

## 사전 조건
<a name="yield-optimization-quickstart-prereqs"></a>
+ 라이브 콘텐츠 소스가 있는 기존 MediaTailor 재생 구성입니다.
+ APS 게시자 ID입니다. 없는 [APS와 통합](yield-optimization-integrating-aps.md) 경우을 참조하세요.

## 1단계: 콘솔에서 수율 최적화 활성화
<a name="yield-optimization-quickstart-step1"></a>

1. [MediaTailor 콘솔](https://console.aws.amazon.com/mediatailor/home)을 엽니다.

1. 왼쪽 탐색 창에서 **구성을** 선택합니다.

1. 업데이트할 재생 구성을 선택합니다.

1. **편집**을 선택합니다.

1. **수율 최적화 설정** 섹션을 확장합니다(시작 시 **새** 배지로 표시됨). 섹션 설명에는 "게시자 ID, 광고 기간 제한 및 리전별 타겟팅을 포함한 수율 최적화 설정 구성"이 나와 있습니다.

1. 활성화 드롭다운을 **활성화됨**으로 설정합니다.

1. 다음 필드를 입력합니다.
   + **APS 게시자 ID**: 게시자 계정과 연결된 APS 게시자 ID(예: `8caf35b3-402b-4d75-bab2-f2aef63a66d3`). 이를 얻는 방법은 [APS와 통합](yield-optimization-integrating-aps.md) 단원을 참조하십시오.
   + **최소 미충진 기간**: 수율 최적화가 채우려고 시도하는 초 단위의 최소 미충진 기간입니다. 이 값을 **15** 이상으로 설정합니다. APS 광고 크리에이티브는 일반적으로 15초 이상이므로 15초 미만의 값은 광고를 반환하지 않습니다.
   + **Amazon Ads 리전**: 입찰 요청을 라우팅할 Amazon Ads 리전입니다. 기본 대상에 `Asia Pacific` 따라 `Americas``Europe`, 또는 중 하나를 선택합니다. 이는 `YieldOptimizationConfiguration` API 모델의 `Region` 필드에 매핑되며 리전 이름은에 설명된 APS 리전에 해당합니다[APS와 통합](yield-optimization-integrating-aps.md).
   + **OpenRTB 템플릿 구성**: JSON 템플릿. 시작점은 섹션을 참조[템플릿 예제](yield-optimization-examples.md)하세요. 콘솔은 JSON 구문을 검증하고 오류 및 경고를 인라인으로 표시합니다. 기본 템플릿은 콘솔의 스타터 템플릿으로 미리 채워집니다. [입찰 구성 및 템플릿 지정](yield-optimization-bid-construction.md)을(를) 참조하세요.

1. **저장**을 선택합니다.

## 2단계: OpenRTB 템플릿 구성
<a name="yield-optimization-quickstart-step2"></a>

콘솔은 OpenRTB 템플릿에 대한 JSON 편집기를 제공합니다. 템플릿에는 최소한 다음이 포함되어야 합니다.

```
{
  "app": {
    "bundle": "your.app.bundle.id",
    "storeurl": "https://your-app-store-url",
    "content": {}
  },
  "device": {
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}"
  },
  "imp": [
    {
      "video": {
        "mimes": ["video/mp4"],
        "protocols": [2, 3, 5, 6],
        "ext": {
          "slotId": "your-aps-slot-id"
        }
      },
      "bidfloor": 1.0
    }
  ]
}
```

필수 필드가 누락된 경우 콘솔에서 경고를 표시합니다.

## 3단계: 세션 시작 및 확인
<a name="yield-optimization-quickstart-step3"></a>

1. 플레이어 파라미터(사용자 에이전트, IP 주소 등)가 포함된 재생 세션을 시작합니다.

1. 채워지지 않은 기간의 광고 시간을 기다립니다.

1. `YieldOptimization.BidRequest` 및에 대한 CloudWatch 지표를 확인합니다`YieldOptimization.AdsInserted`.

`BidRequest`가를 내보내지만 `AdsInserted`가 0인 경우에서 `RAW_BID_REQUEST` 이벤트를 확인하여 템플릿이 유효한 입찰 요청을 생성하고 `ads_interaction_log` 있는지 확인합니다.

## 2단계(대안): API를 사용하여 구성
<a name="yield-optimization-quickstart-step2-api"></a>

`YieldOptimizationConfiguration` 파라미터와 함께 `PutPlaybackConfiguration` API를 사용합니다.

```
aws mediatailor put-playback-configuration \
  --name "MyStreamingService" \
  --ad-decision-server-url "https://ads.example.com/vast" \
  --video-content-source-url "https://origin.example.com/hls/" \
  --yield-optimization-configuration '{
    "MinimumUnfilledDuration": 15,
    "PublisherId": "your-aps-publisher-id",
    "Region": "AMERICAS",
    "OpenRtbTemplate": "{\"app\":{\"bundle\":\"your.app.bundle\",\"storeurl\":\"https://store-url\",\"content\":{}},\"device\":{\"ua\":\"{{session.user_agent}}\",\"ip\":\"{{session.client_ip}}\"},\"imp\":[{\"video\":{\"mimes\":[\"video/mp4\"],\"protocols\":[2,3,5,6],\"ext\":{\"slotId\":\"your-slot-id\"}},\"bidfloor\":1.0}]}"
  }'
```

## 다음 단계
<a name="yield-optimization-quickstart-next-steps"></a>
+ APS에 등록하고 게시자 ID를 가져오려면 섹션을 참조하세요[APS와 통합](yield-optimization-integrating-aps.md).
+ MediaTailor가 입찰 요청 시기를 결정하는 방법을 알아보려면 섹션을 참조하세요[수율 최적화 작동 방식](yield-optimization-how-it-works.md).
+ 전체 템플릿 예제를 보려면 섹션을 참조하세요[템플릿 예제](yield-optimization-examples.md).