Os SDKs do IMA facilitam a integração de 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 que você quer usar
DAI de veiculação de conjunto
Este guia demonstra como integrar o SDK DAI da IMA a um app player de vídeo simples. Se você quiser ver ou acompanhar uma integração de exemplo concluída, faça o download do PodServingExample no GitHub.
Visão geral da DAI da IMA
A implementação da DAI da 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 contém 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ó deve instanciar um carregador de anúncios, que pode ser reutilizado durante toda a vida útil do aplicativo.IMAStreamRequest
– umIMAPodVODStreamRequest
ou umIMAPodStreamRequest
.IMAStreamManager
: um objeto que processa streams 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 handler VTP personalizado. Esse manipulador de VTP personalizado 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 contém conteúdo e anúncios combinados. Seu VTP vai fornecer instruções sobre como implementar o manipulador personalizado.
Pré-requisitos
Antes de começar, os seguintes itens são necessários:
- Xcode 13 ou mais recente
- CocoaPods (preferencial), Swift Package Manager ou uma cópia baixada do SDK do IMA DAI para iOS
Você também precisa dos parâmetros usados para solicitar seu 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 pode ser criado pelo seu gerenciador de manifesto ou por um parceiro de veiculação de pods 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 IMA DAI ao projeto do Xcode
Use um destes três métodos para instalar o SDK DAI do IMA.
Instalar o SDK usando o CocoaPods (preferencial)
O CocoaPods é um gerenciador de dependências para projetos do Xcode e é o método recomendado para instalar o SDK da DAI do IMA. Para mais informações sobre como instalar ou usar o CocoaPods, consulte a documentação do CocoaPods. Depois de instalar o CocoaPods, use as instruções a seguir para instalar o SDK do IMA DAI:
No mesmo diretório do arquivo PodServingExample.xcodeproj, crie um arquivo de texto chamado Podfile e adicione a seguinte configuração:
No diretório que contém o Podfile, execute:
pod install --repo-update
Instalar o SDK usando o Gerenciador de pacotes do Swift
O SDK do Interactive Media Ads é compatível com o Gerenciador de pacotes do Swift a partir da versão 3.18.4. Siga estas etapas para importar o pacote Swift.
No Xcode, instale o pacote Swift do SDK do IMA DAI acessando Arquivo > Adicionar pacotes.
No prompt exibido, pesquise o repositório do GitHub do pacote Swift do SDK do IMA DAI:
https://github.com/googleads/swift-package-manager-google-interactive-media-ads-ios
Selecione a versão do pacote Swift do SDK do IMA DAI que você quer usar. Para novos projetos, recomendamos usar a opção Até a próxima versão principal.
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.
Fazer o download e instalar o SDK manualmente
Se você não quiser usar o Gerenciador de pacotes do Swift ou o CocoaPods, baixe o SDK do IMA DAI e adicione-o manualmente ao seu projeto.
Criar um player de vídeo simples
Implemente um player de vídeo no controlador de visualização principal usando um player AV encapsulado em uma visualização de interface. O SDK do IMA usa a visualização da interface para mostrar elementos da interface de anúncio.
Objective-C
Swift
Inicializar o carregador de anúncios
Importe o SDK do IMA para o 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 privadas para armazenar componentes principais 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 do stream para seu gerenciador de VTP personalizado e recupere o URL do manifesto do stream. 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 para o método
loadThirdPartyStream
do gerenciador de
transmissões. Esse método solicita dados de eventos de anúncio do Ad Manager 360, carrega o URL do manifesto e inicia a reprodução.
No método delegado
failedWithErrorData
, registre o erro. Opcionalmente, reproduza o stream de backup. Consulte as
práticas recomendadas da DAI.
Objective-C
Swift
Implementar seu gerenciador personalizado da VTP
O manipulador de VTP personalizado envia o ID do stream 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 stream com conteúdo e anúncios combinados. Seu VTP vai fornecer 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 manipulador insere o ID do stream 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 para seu aplicativo.
Neste exemplo, registre os eventos de anúncio principais no console:
Objective-C
Swift
Limpar recursos da DAI da IMA
Para interromper a reprodução do stream, pare todo o rastreamento de anúncios e libere todos os recursos de stream carregados. Para isso, chame IMAStreamManager.destroy()
.
Execute o app e, se tudo der certo, você poderá solicitar e reproduzir fluxos 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.