Autentique pedidos de stream de vídeo de DAI

As chaves de autenticação de Inserção de anúncios dinâmicos (DAI) são utilizadas para provar que os pedidos de stream de vídeo são feitos por si. Proporcionam maior segurança durante a publicação de anúncios. Uma chave é uma string ininterrupta de 64 carateres e números. Algumas chaves mais antigas podem ter 25 carateres ou números.

Exemplo

0L94DEA6C87B0F3D2407018ACF88ECDE77DK38AD1DX01957311A50E9D1O3F15B

Chaves da API estáticas: as chaves da API têm precedência sobre as chaves HMAC quando ambas estão incluídas. As chaves da API são menos seguras do que as chaves HMAC. Por conseguinte, é recomendada a utilização de chaves HMAC.

HMAC: a autenticação de tokens com base em HMAC proporciona mais segurança do que as chaves da API estáticas. Os símbolos HMAC utilizam uma chave secreta e uma duração limitada para garantir que o símbolo não pode ser partilhado facilmente entre utilizadores ou sessões.

Dica: antes de autenticar pedidos de streams, certifique-se de que tem o seguinte:

• Chave de autenticação DAI com o tipo HMAC
• Stream em direto configurada para DAI

Adicione uma nova chave de autenticação de DAI HMAC

Gere e adicione uma nova chave de autenticação de DAI do tipo HMAC:

1. Inicie sessão no Google Ad Manager.
2. Clique em Admin, e, de seguida, em Vídeo e áudio.
3. Selecione "Chaves de autenticação DAI".
4. Clique em Nova chave de autenticação DAI.
5. Introduza o nome da nova chave. Selecione o tipo "HMAC".
6. Clique em Guardar.

Esta chave é associada à sua stream em direto quando ativa a autenticação.

Ative a autenticação para pedidos às APIs DAI

Associe a sua chave HMAC à stream:

1. Inicie sessão no Google Ad Manager.
2. Clique em Vídeo e, de seguida, em Streams em direto.
3. Selecione a stream em direto na lista ou clique em Nova stream em direto. Saiba mais sobre a criação de uma nova stream em direto.
4. Em Definições gerais,
   1. Selecione "Ativado" para "Chaves de autenticação de recursos de agrupamentos" para autenticar pedidos de agrupamentos de anúncios e/ou
   2. Selecione "Ativado" para "Stream para criar chaves de autenticação" para autenticar pedidos de sessão de stream
5. Selecione a chave HMAC que criou.
6. Clique em Guardar.

Para ver e copiar a sua chave, regresse à página de detalhes. Depois de criar uma chave de autenticação de DAI ativa, pode utilizá-la de imediato. Incorpore a chave na app de vídeo do cliente, onde faz pedidos de stream de DAI.

Dica: uma prática recomendada inclui a geração de chaves de autenticação DAI separadas para cada uma das suas plataformas de cliente (por exemplo, iOS, Android e Web).

As chaves são automaticamente definidas como "Ativas" depois de guardar. Apenas as chaves "Ativas" implementadas corretamente podem validar pedidos.

Os pedidos que utilizam chaves desativadas são recusados. Desative uma chave se esta ficar comprometida ou se não deve ser utilizada.

Desative uma chave de autenticação existente

Siga estes passos para desativar uma chave de autenticação:

1. Inicie sessão no Google Ad Manager.
2. Clique em Admin, Vídeo e áudio e, de seguida, em "Chaves de autenticação DAI".
3. Na lista, selecione a chave que quer desativar.
4. Selecione o estado "Inativo".
5. Clique em Guardar.

Implemente uma chave de autenticação

Chaves HMAC

Saiba como implementar a autenticação HMAC.

Chaves da API

Utilize o SDK para IMA para definir a propriedade apiKey no objeto IMAStreamRequest. Veja a documentação para programadores do iOS, Android, Chromecast ou tvOS para obter mais informações.

Para beacons do lado do servidor (SSB), utilize o parâmetro de consulta api-key:

curl "https://dai.google.com/ondemand/hls/content/CMS_ID/vid/VIDEO_ID/master.m3u8?api-key=<api-authentication-key>"

Para problemas relacionados com as indisponibilidades ou a resolução de problemas da DAI, contacte o apoio técnico para publicadores.