Com os SDKs do IMA, é fácil integrar anúncios multimídia aos seus sites e apps. Os SDKs do IMA podem solicitar anúncios de qualquer servidor de anúncios compatível com VAST e gerenciar a reprodução de anúncios nos seus apps. Com os SDKs de DAI do IMA, os apps fazem uma solicitação de stream para anúncios e vídeos de conteúdo, seja VOD ou conteúdo ao vivo. Em seguida, o SDK retorna um stream de vídeo combinado para que você não precise gerenciar a troca entre o anúncio e o vídeo de conteúdo no app.
Selecione a solução de DAI de seu interesse
DAI de veiculação de conjunto
Este guia aborda a integração do SDK DAI do IMA em um app player de vídeo. Se você quiser conferir ou acompanhar um exemplo de integração concluído, baixe o PodServingExample do GitHub.
Visão geral da DAI do IMA
A implementação da DAI do IMA envolve quatro componentes principais do SDK, conforme demonstrado neste guia:
IMAAdDisplayContainer: um objeto contêiner que fica acima do elemento de reprodução de vídeo e abriga os elementos da interface do anúncio.IMAAdsLoader: um objeto que solicita streams e processa eventos acionados por objetos de resposta de solicitação de stream. Você só precisa instanciar um carregador de anúncios, que pode ser reutilizado durante toda a vida útil do aplicativo.IMAStreamRequest– umIMAPodVODStreamRequestou umIMAPodStreamRequest.IMAStreamManager: um objeto que processa fluxos de inserção de anúncios dinâmicos e interações com o back-end da DAI. O gerenciador de stream também processa pings de rastreamento e encaminha eventos de stream e de anúncio para o publisher.
Além disso, para reproduzir streams de veiculação de pods, implemente um processador de VTP personalizado. Esse gerenciador personalizado da VTP envia o ID do stream ao seu parceiro técnico de vídeo (VTP) junto com outras informações necessárias para retornar um manifesto de stream que contenha conteúdo e anúncios combinados. Seu VTP fornece instruções sobre como implementar o manipulador de VTP personalizado.
Pré-requisitos
Antes de começar, os seguintes itens são necessários:
- Xcode 13 ou versões mais recentes
- Método para instalar o SDK do IMA:
- Gerenciador de pacotes do Swift (preferencial)
- Uma cópia para download do SDK do IMA para iOS
Você também precisa dos parâmetros para solicitar o stream do SDK do IMA.
| Parâmetros de transmissão ao vivo | |
|---|---|
| Código da rede |
O código de rede da sua conta do Ad Manager 360. |
| Chave de recurso personalizada |
A chave de recurso personalizada que identifica seu evento de veiculação de pod no Ad Manager 360. Ele é criado pelo manipulador de manifesto ou pelo parceiro de veiculação de conjunto terceirizado. |
| Parâmetros de stream de VOD | |
| Código da rede |
O código de rede da sua conta do Ad Manager 360. |
Criar um projeto do Xcode
No Xcode, crie um projeto iOS usando Objective-C chamado "PodServingExample".
Adicionar o SDK do DAI do IMA ao projeto do Xcode
Para instalar o SDK do IMA, escolha um método preferido.
Recomendado: instale o SDK usando o Swift Package Manager
O SDK do Interactive Media Ads é compatível com o Swift Package Manager a partir da versão 3.18.4. Siga estas etapas para importar o pacote Swift.
No Xcode, instale o pacote Swift do SDK de DAI do IMA: navegue até File > Add Packages.
No comando que aparece, pesquise o repositório do GitHub do pacote Swift do SDK DAI do IMA:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-iosSelecione a versão do pacote Swift do SDK da DAI do IMA que você quer usar. Para novos projetos, use a opção Up to Next Major Version.
Quando terminar, o Xcode vai resolver as dependências do pacote e fazer o download delas em segundo plano. Para mais detalhes sobre como adicionar dependências de pacote, consulte o artigo da Apple.
Baixar e instalar o SDK manualmente
Se você não quiser usar o Swift Package Manager, faça o download e adicione manualmente o SDK da IMA ao seu projeto.
Criar um player de vídeo
Implemente um player de vídeo no controlador de visualização principal. Encapsule um player AV em uma visualização da interface. O SDK do IMA usa a visualização da interface para mostrar elementos da interface do anúncio.
Objective-C
Swift
Inicializar o carregador de anúncios
Importe o SDK do IMA para seu controlador de visualização e adote os protocolos
IMAAdsLoaderDelegate
e
IMAStreamManagerDelegate
para processar eventos do carregador de anúncios e do gerenciador de streams.
Adicione estas propriedades particulares para armazenar os principais componentes do SDK do IMA:
IMAAdsLoader- Gerencia solicitações de stream durante todo o ciclo de vida do app.
IMAAdDisplayContainer- Lida com a inserção e o gerenciamento de elementos da interface do usuário de anúncios.
IMAAVPlayerVideoDisplay: se comunica entre o SDK do IMA e seu player de mídia e processa metadados com carimbo de data/hora.IMAStreamManager: gerencia a reprodução de stream e aciona eventos relacionados a anúncios.
Inicialize o carregador de anúncios, o contêiner de exibição de anúncios e a exibição de vídeo depois que a visualização for carregada.
Objective-C
Swift
Fazer uma solicitação de stream
Quando um usuário pressiona o botão de reprodução, faça uma nova solicitação de stream.
Use a classe
IMAPodStreamRequest
para transmissões ao vivo. Para transmissões de VOD, use a classe
IMAPodVODStreamRequest.
A solicitação de stream exige seus parâmetros de stream, bem como uma referência ao seu contêiner de exibição de anúncios e exibição de vídeo.
Objective-C
Swift
Detectar eventos de carregamento de stream
A classe IMAAdsLoader
chama os métodos
IMAAdsLoaderDelegate
em caso de inicialização bem-sucedida ou falha da solicitação de stream.
No método delegado adsLoadedWithData, defina seu
IMAStreamManagerDelegate.
Transmita o ID da transmissão para seu gerenciador de VTP personalizado e recupere o URL do manifesto da transmissão. Para transmissões ao vivo, carregue o URL do manifesto na tela de vídeo e inicie a reprodução. Para transmissões de VOD, transmita o URL do manifesto ao método
loadThirdPartyStream
do gerenciador de
transmissões. Esse método solicita dados de eventos de anúncios do Ad Manager 360, carrega o URL do manifesto e inicia a reprodução.
No método delegado
failedWithErrorData, registre o erro. Se quiser, reproduza o fluxo de backup. Consulte as práticas recomendadas da DAI.
Objective-C
Swift
Implementar seu manipulador personalizado do VTP
O gerenciador de VTP personalizado envia o ID do fluxo do espectador ao seu parceiro técnico de vídeo (VTP) junto com outras informações necessárias para que o VTP retorne um manifesto de fluxo que contenha conteúdo e anúncios combinados. Seu VTP fornece instruções específicas sobre como implementar seu manipulador de VTP personalizado.
Por exemplo, um VTP pode incluir um URL de modelo de manifesto que contém a macro
[[STREAMID]]. Neste exemplo, o gerenciador insere o ID do fluxo no lugar da macro e retorna o URL do manifesto resultante.
Objective-C
Swift
Detectar eventos de anúncios
O IMAStreamManager
chama os métodos
IMAStreamManagerDelegate
para transmitir eventos e erros ao seu aplicativo.
Neste exemplo, registre os eventos de anúncio principais no console:
Objective-C
Swift
Limpar recursos da DAI do IMA
Para interromper a reprodução do stream, parar todo o rastreamento de anúncios e liberar todos os recursos de stream carregados, chame IMAStreamManager.destroy().
Execute o app. Se tudo der certo, solicite e reproduza streams de DAI do Google com o SDK do IMA. Para saber mais sobre recursos avançados do SDK, consulte outros guias listados na barra lateral esquerda ou exemplos no GitHub.