Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios da DT Exchange usando a Mediação da AdMob, incluindo integrações em hierarquia. Ele explica como adicionar a DT Exchange à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da DT a um app Android.
Integrações e formatos de anúncio aceitos
O adaptador de mediação da DT Exchange tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | 1 |
| Cascata | |
| Formatos | |
| Banner | |
| Intersticial | |
| Premiado | |
| Nativo | |
1 A integração de lances está em Beta fechado. Entre em contato com seu gerente de contas para solicitar acesso.
Requisitos
- API Android nível 24 ou mais recente.
Última GMA Next-Gen SDK.
Leia todo o guia para iniciantes da mediação.
Etapa 1: definir as configurações na interface da DT Exchange
Adicionar um novo app e posicionamento de anúncio
Inscreva-se ou faça login no Console da DT Exchange.
Clique em Adicionar app.
Escolha sua plataforma e seus canais, preencha o restante do formulário e clique em Criar app.
Insira os nomes e selecione os tipos de veiculação. Em seguida, clique em Salvar posição.
ID do app e ID da posição
Passe o cursor sobre a barra de navegação à esquerda para abrir e clique em Gerenciamento de apps.
Na página Gerenciamento de apps, anote o ID do app ao lado do seu app.
Selecione seu app e navegue até a guia Canais. Anote o ID da posição.
ID do publisher, chave do cliente e segredo do consumidor
Clique no seu nome de usuário no menu à esquerda e selecione Perfil do usuário.
Anote o ID do publisher, o token do cliente e o segredo do consumidor, porque eles serão necessários na próxima etapa.
Atualizar o app-ads.txt
Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt.
Se ainda não fez isso, configure um arquivo app-ads.txt para seu app.
Para implementar o app-ads.txt na DT Exchange,
adicione a DT ao seu arquivo app-ads.txt.
Etapa 2: configurar a demanda de DT Exchange na interface da AdMob
Definir as configurações de mediação do bloco de anúncios
Adicione a DT Exchange à configuração de mediação do seu bloco de anúncios.
Primeiro, faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar a DT Exchange como uma origem de anúncios.
Para criar um grupo de mediação, selecione Criar grupo de mediação.
Insira o formato e a plataforma do anúncio, depois clique em Continuar.
Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.
Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios da AdMob. Em seguida, clique em Concluído.
O card "Blocos de anúncios" vai aparecer com os blocos selecionados:
Adicionar a DT Exchange como uma origem de anúncios
Lances
No card Lances da seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione DT Exchange.
Clique em Como assinar um contrato de parceria e estabeleça uma parceria de lances com a DT Exchange.
Clique em Confirmar e concordar e em Continuar.
Se você já tiver um mapeamento para a DT Exchange, selecione-o. Caso contrário, clique em Adicionar mapeamento.
Em seguida, insira o ID do aplicativo e o ID da posição obtidos na seção anterior. Em seguida, clique em Concluído.
Cascata
No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.
Selecione DT Exchange e ative a chave Otimizar. Insira o ID do publisher, a chave secreta do consumidor e a chave do consumidor obtidos na seção anterior para configurar a otimização da origem de anúncios para a DT Exchange. Em seguida, insira um valor de eCPM para a DT Exchange e clique em Continuar.
Se você já tiver um mapeamento para a DT Exchange, selecione-o. Caso contrário, clique em Adicionar mapeamento.
Em seguida, insira o ID do aplicativo e o ID da posição obtidos na seção anterior. Em seguida, clique em Concluído.
Adicionar a DT Exchange (monetização da Fyber) à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA
Siga as etapas em Configurações das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar a DT Exchange (monetização da Fyber) à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface da AdMob.
Etapa 3: importar o SDK e o adaptador da DT
Integração com o Android Studio (recomendada)
No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02") implementation("com.google.ads.mediation:fyber:8.4.3.0") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02' implementation 'com.google.ads.mediation:fyber:8.4.3.0' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
Integração manual
- Faça o download da versão mais recente do
SDK da DT para Android e
adicione
fyber-marketplace-x.y.z.aarao seu projeto. - Navegue até os artefatos do adaptador da DT Exchange no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo
.aardo adaptador da DT Exchange e adicione-o ao projeto.
Etapa 4: implementar configurações de privacidade no SDK da DT
Consentimento para a UE e o GDPR
Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer determinadas declarações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de receber o consentimento deles para o uso de cookies ou outros armazenamentos locais quando exigido por lei e para a coleta, o compartilhamento e o uso de dados pessoais para a personalização de anúncios. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação. O Google não consegue transmitir automaticamente a escolha de consentimento do usuário para essas redes.
A partir da versão 8.3.0 do SDK da DT Exchange, a DT Exchange lê automaticamente o consentimento do GDPR definido por plataformas de gestão de consentimento que aceitam a especificação de consentimento adicional do Google. Para mais informações, consulte o guia de implementação do GDPR da DT Exchange.
Leis Estaduais de Privacidade dos EUA
As leis de privacidade dos estados dos EUA exigem que os usuários tenham o direito de recusar a "venda" das próprias "informações pessoais" (conforme a definição desses termos na lei). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de conformidade com as leis estaduais de privacidade dos EUA oferece a opção de ativar o tratamento de dados restrito para a veiculação de anúncios do Google, mas não é possível aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, identifique cada rede de publicidade que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.
A DT Exchange tem uma API que permite encaminhar o consentimento do usuário para o SDK. O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK do DT manualmente. Se você optar por transmitir informações de consentimento para o SDK da DT manualmente, recomendamos que esse código seja chamado antes de solicitar anúncios por GMA Next-Gen SDK.
Java
Kotlin
Substitua US_PRIVACY_STRING pela sua string de privacidade dos EUA.
Acesse o guia de implementação da CCPA da DT Exchange para mais detalhes e os valores que podem ser fornecidos no método.
Etapa 5: adicionar o código necessário
Carregar o anúncio com o contexto da atividade
Transmita o contexto Activity ao carregar formatos de anúncio intersticial. Sem contexto de atividade, o carregamento de anúncios falhará.
Etapa 6: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste na AdMob.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da DT Exchange, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios DT Exchange (lances) e DT Exchange (hierarquia).
Etapas opcionais
Parâmetros específicos da rede
O adaptador da DT Exchange é compatível com outros parâmetros de solicitação que podem ser transmitidos ao adaptador como um pacote do Android. O adaptador procura as seguintes chaves no pacote:
| Parâmetros e valores de solicitação | |
|---|---|
InneractiveMediationDefs.KEY_AGE
|
Número inteiro. A idade do usuário |
FyberMediationAdapter.KEY_MUTE_VIDEO
|
Boolean. Ativar ou desativar o som do vídeo |
Confira um exemplo de código de como definir esses parâmetros de solicitação de anúncio:
Java
Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);
AdRequest request =
new AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter.class, extras).build();
Kotlin
val extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)
val request =
AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras).build()
Códigos de erro
Se o adaptador não receber um anúncio da DT Exchange, verifique o erro subjacente na resposta do anúncio usando ResponseInfo.getAdSourceResponses() na seguinte classe:
com.google.ads.mediation.fyber.FyberMediationAdapter
Confira os códigos e as mensagens correspondentes gerados pelo adaptador da DT Exchange quando um anúncio não é carregado:
| Código do erro | Motivo |
|---|---|
| 101 | Os parâmetros do servidor da DT Exchange configurados na interface da AdMob estão ausentes ou são inválidos. |
| 103 | O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com a DT Exchange. |
| 105 | O SDK do DT carregou um anúncio, mas retornou um controlador inesperado. |
| 106 | O anúncio não está pronto para ser exibido. |
| 107 | O contexto não é uma instância de atividade. |
| 200-399 | O SDK da DT retornou um erro. Consulte o código para mais detalhes. |