동영상 스트림 및 광고가 서로 독립적으로 요청되는 클라이언트 측 동영상 구현과 달리 동적 광고 삽입(DAI)에 사용되는 서버 측 구현에서는 광고가 동영상 콘텐츠에 동적으로 연결된 하나의 스트림만을 요청합니다. 서버 오류가 발생하는 경우 스트림이 차단되어 열악한 사용자 환경을 유발하고 수익을 잃을 수 있습니다.
Ad Manager DAI는 스트림을 생성할 때 또는 스트림을 실행하는 중에 HTTP 오류를 발생시키며, 서버에서 유효한 응답을 받지 못하는 경우 백업 스트림을 지정하도록 허용합니다.
스트림 생성 시 감지된 HTTP 오류 처리
| 오류 유형 | 권장사항 |
|---|---|
| 4XX 오류 (429 제외) |
HTTP 4XX 오류가 표시되는 경우 클라이언트에 오류가 발생한 것일 수 있으므로 원시 스트림으로 대체해서는 안 됩니다. 서버로 전송하는 요청이 올바르고 필요한 모든 매개변수를 포함하고 있는지 확인합니다. |
| 429 또는 5XX 오류 | HTTP 429 또는 HTTP 5XX 오류가 표시되는 경우 수익을 창출하지 않고 원시 백업 스트림으로 대체해야 합니다. IMA SDK에서 오류 핸들러를 사용하여 이러한 오류를 확인할 수 있으며, 기본 스트림을 백업 스트림으로 전환할 수 있습니다. |
TVOS
static NSString *const kBackupContentPath =
@"http://googleimadev‑vh.akamaihd.net/i/big_buck_bunny/bbb‑,480p,720p,1080p,.mov.csmil/"
@"master.m3u8";
- (void)streamManager:(IMAStreamManager *)streamManager
didReceiveError:(NSError *)error {
NSLog(@"Error: %@", error);
[self playBackupStream];
}
- (void)playBackupStream {
NSURL *contentURL = [NSURL URLWithString:kBackupContentPath];
self.playerViewController.player = [[AVPlayer alloc] initWithURL:contentURL];
[self.playerViewController.player play];
}VOD 또는 실시간 스트림에 사용할 백업 스트림 URL 가져오기
앱에는 VOD 및 라이브 선형 스트림에 사용할 백업 URL을 가져오는 메커니즘이 있어야 합니다. VOD의 경우 백업 스트림은 MRSS 피드에 제공되는 ingestURL이어야 합니다. 실시간 선형의 경우 백업 스트림은 Ad Manager UI에 지정된 콘텐츠 스트림이어야 합니다.
스트림 실행 중에 HTTP 오류 처리
스트림을 실행하는 중에 오류가 발생하면 원시 스트림으로 되돌아가지 않는 것이 좋습니다. Ad Manager는 발생하는 대부분의 오류를 자동으로 수정하려고 시도합니다. 하지만 서버에서 오류를 처리할 수 없는 경우에는 스트림의 재생이 중지됩니다. 스트림이 중지되면 앱에서 새로운 스트림을 시작해야 합니다. 오류가 계속되면 원시 스트림으로 대체해야 합니다.
대체 구현의 유효성 검사하기
다음 샘플 스트림을 사용하여 대체 구현의 유효성을 검사할 수 있습니다.
| 스트림 형식 | 광고 애셋 키 |
|---|---|
| HLS | MSQJlB9VSgqJkGNv1mB0FA |
| DASH | TrhaCde0R_uKzG_psucTww |
이러한 스트림은 테스트용이며 항상 HTTP 429 오류를 생성합니다.
DAI 선형 스트림의 자동 장애 조치
드물지만 예기치 않게 시스템에 많은 트래픽이 발생하는 경우 일부 사용자는 광고가 없는 스트림으로 대체될 수 있습니다. 이 경우 시청자에게는 기본 콘텐츠가 표시됩니다.
대체 스트림을 게재할 수 없는 경우(예: 인증 또는 출처 전달이 지정된 경우 또는 스트림에 대안 제외가 요청된 경우)에는 HTTP 429 응답 코드가 게재되며 애플리케이션에서는 로컬에서 원시 스트림으로 대체해야 합니다.