Ao contrário de uma implementação de vídeo do lado do cliente, em que o stream de vídeo e os anúncios são solicitados independentemente uns dos outros, a implementação do lado do servidor usada com a Inserção de anúncios dinâmicos (DAI) solicita somente um stream, com anúncios integrados de maneira dinâmica ao conteúdo de vídeo. Se ocorrer um erro no servidor, o stream poderá ser bloqueado, o que não só resulta em uma experiência de usuário insatisfatória, como também gera perda de receita.
A DAI do Ad Manager mostra erros de HTTP quando você cria um stream, bem como quando o stream está em execução, e permite que você especifique um stream de backup no caso de não receber uma resposta válida do servidor.
Gerenciar erros de HTTP detectados quando um stream é criado
Tipo de erro | Recomendação |
---|---|
Erros 4XX (exceto 429) |
Ao ver erros HTTP 4XX, não use os streams brutos porque o cliente provavelmente recebeu um erro nessas circunstâncias. Verifique se a solicitação que você está enviando ao servidor está correta e contém todos os parâmetros necessários. |
Erros 429 ou 5XX | Ao ver os erros HTTP 429 ou HTTP 5XX, use o stream de backup bruto, sem monetização. No SDK do IMA, esses erros podem ser capturados sem um manipulador de erro, e o stream padrão pode ser alternado para o stream de backup. |
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];
}
Ver o URL do stream de backup para um vídeo on demand (VOD) ou transmissão ao vivo
O app deve ter um mecanismo para encontrar o URL de backup tanto para VOD quanto para transmissões lineares ao vivo. No caso do VOD, o stream de backup deve ser o ingestURL fornecido no feed MRSS. No caso da transmissão linear ao vivo, o stream de backup deve ser o stream de conteúdo especificado na IU do Ad Manager.
Gerenciar erros de HTTP enquanto o stream está em execução
Não é recomendável usar stream bruto se você receber um erro enquanto o stream estiver em execução. O Ad Manager tenta automaticamente corrigir a maioria dos erros que encontra. No entanto, nos casos em que o servidor não consegue lidar com um erro, a execução do stream é interrompida. Se o stream for interrompido, o app precisa iniciar um novo. Se o erro persistir, use o stream bruto como substituto.
Validar sua implementação substituta
É possível validar sua implementação substituta usando os seguintes streams de amostra:
Formato de streaming | Chave de recurso |
---|---|
HLS | MSQJlB9VSgqJkGNv1mB0FA |
DASH | TrhaCde0R_uKzG_psucTww |
Esses streamings são para fins de teste e sempre mostrarão um erro HTTP 429.
Failover automático de streams lineares da DAI
Nos raros casos de um volume inesperadamente alto para o sistema, um stream sem anúncios pode ser usado como substituto para alguns usuários. Nesse caso, o espectador verá um conteúdo subjacente.
Se não foi possível veicular os streams substitutos, como no caso de a autenticação ou o encaminhamento de origem serem especificados ou a exclusão de variantes ser solicitada para o stream, um código de resposta HTTP 429 será exibido, e o aplicativo voltará ao stream bruto.