Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios da DT Exchange usando mediação, cobrindo integrações de hierarquia. Ele aborda como adicionar o DT Exchange a um anúncio configuração de mediação da unidade e como integrar o SDK do DT Exchange e adaptador em um Android app.
Integrações e formatos de anúncio compatíveis
O adaptador de mediação para o DT Exchange tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | |
Formatos | |
Banner | |
Intersticial | |
Premiado | |
Nativo |
Requisitos
- Android API de nível 21 ou mais recente
SDK dos anúncios para dispositivos móveis do Google mais recente
Concluir a mediação Guia explicativo
Etapa 1: definir as configurações na interface do DT Exchange
Adicionar novo app e posicionamento do anúncio
Inscreva-se ou faça login no DT Exchange Console.
Clique no botão Add App para adicionar seu aplicativo.
Selecione a plataforma, preencha o restante do formulário e clique em Adicionar canais.
Digite um nome para a nova posição no campo Nomeie sua posição e selecione o Tipo de posição desejado na lista suspensa. Por fim, clique em Salvar posição.
ID do aplicativo e da posição
Abra a barra de navegação à esquerda passando o mouse sobre ela. Em seguida, clique em Apps no menu à esquerda.
Na página Gerenciamento de aplicativos, anote o ID do aplicativo ao lado dele.
Selecione seu aplicativo, navegue até a guia Canais e clique no ícone de cópia ao lado de Nome da posição. Anote o ID da posição.
ID do editor, chave do cliente e segredo do cliente
Clique no seu nome de usuário no menu à esquerda e selecione Perfil de usuário.
Anote o ID do editor, a Chave do cliente e a Chave secreta do cliente, porque eles serão necessários na próxima etapa.
Etapa 2: configurar a demanda do DT Exchange na Ad Manager interface
Definir as configurações de mediação para seu bloco de anúncios
Faça login na sua conta do Ad Manager.
Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento.
Insira um Nome exclusivo para o grupo de rendimento, defina o Status como Ativo, selecione o Formato do anúncio e o Tipo de inventário como App para dispositivos móveis. Na seção Segmentação > Inventário, selecione o bloco de anúncios em Inventário e Aplicativo para dispositivos móveis ao qual você quer adicionar a mediação.
Em seguida, clique no botão Adicionar parceiro de rendimento.
Se você já tiver um Parceiro de rendimento para DT Exchange, selecione-o. Caso contrário, selecione Criar um novo parceiro de rendimento.
Selecione DT Exchange como a Rede de publicidade, insira um Nome exclusivo e ative a Mediação.
Ative a Coleta de dados automática e insira o Publisher ID, Consumer Secret and Consumer Key recebido na seção anterior.
Depois de selecionar o Parceiro de rendimento, escolha Mediação do SDK para dispositivos móveis como o Tipo de integração, Android como Plataforma e Ativo como o Status. Insira o Application ID and Placement ID obtido na seção anterior. Em seguida, insira um valor de CPM padrão.
Clique em Salvar na parte inferior da página quando terminar.
Adicionar Fyber ao GDPR e à lista de parceiros de publicidade das regulamentações estaduais dos EUA
Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar Fyber à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na Ad Manager IU.
Etapa 3: importar o SDK e o adaptador do DT Exchange
Integração com o Android Studio (recomendado)
No arquivo build.gradle.kts
no nível do app, adicione a seguinte implementação:
dependências e configurações. Usar as versões mais recentes do SDK do DT Exchange
e adaptador:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:fyber:8.3.0.0")
}
Integração manual
- Faça download da versão mais recente do
SDK do DT Exchange para Android e adicione
os seguintes arquivos ao seu projeto:
ia-mraid-kit-release-x.y.z.aar
ia-sdk-core-release-x.y.z.aar
ia-video-kit-release-x.y.z.aar
- Acesse o
Artefatos do adaptador do DT Exchange
no repositório Maven do Google. Selecionar a versão mais recente, fazer o download da DT
Troque o arquivo
.aar
do adaptador do Exchange e adicione-o ao projeto.
Etapa 4: implementar configurações de privacidade no SDK do DT Exchange
Consentimento da UE e GDPR
De acordo com o Consentimento dos usuários da UE do Google política, você precisa garantir que determinadas divulgações sejam fornecidas e consentimentos de usuários no Espaço Econômico Europeu (EEE) em relação a: o uso de identificadores de dispositivos e dados pessoais. Essa política reflete requisitos da Diretiva de privacidade eletrônica da UE e da Lei Geral de Proteção de Dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que podem coletar, receber ou usar dados pessoais. que oferecem informações sobre o uso de cada rede. No momento, o Google não pode repassar a opção de consentimento do usuário a essas redes automaticamente.
O DT Exchange tem uma API que permite encaminhar o consentimento do usuário para o SDK. O o exemplo de código a seguir mostra como transmitir informações de consentimento para a DT Exchange. SDK manualmente. Se você optar por passar informações de consentimento para a DT Exchange manualmente, é recomendável chamar esse código antes da solicitação de anúncios pelo SDK dos anúncios para dispositivos móveis do Google.
Java
import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...
InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");
Kotlin
import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...
InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")
Acesse a página de recursos do GDPR do DT Exchange e as Guia de implementação do GDPR para mais detalhes e os valores que podem ser fornecidos no método.
Leis Estaduais de Privacidade dos EUA
Estados Unidos leis estaduais de privacidade exigem que os usuários tenham para desativar a "promoção" das suas "informações pessoais" (como a lei define esses termos), com a opção de desativação oferecida por um aviso "Não vender meus dados pessoais" Informações" na página "vendas" na página inicial de seu grupo. O Estados Unidos define a privacidade guia de conformidade com as leis, permite ativar processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não consegue aplicar essa configuração a cada anúncio rede na sua cadeia de mediação. Portanto, você deve identificar cada rede de anúncios na sua cadeia de mediação que possam participar da venda de e seguir as orientações de cada uma dessas redes para garantir compliance.
O DT Exchange tem uma API que permite encaminhar o consentimento do usuário para o SDK. O o exemplo de código a seguir mostra como transmitir informações de consentimento para a DT Exchange. SDK manualmente. Se você optar por passar informações de consentimento para a DT Exchange manualmente, é recomendável chamar esse código antes da solicitação de anúncios pelo SDK dos anúncios para dispositivos móveis do Google.
Java
import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...
InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");
Kotlin
import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...
InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")
Acesse a página de recursos da CCPA da DT Exchange e Guia de implementação da CCPA para mais detalhes e os valores que podem ser fornecidos no método.
Etapa 5: adicionar o código obrigatório
Nenhum código adicional é necessário para a integração do DT Exchange.
Etapa 6: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste em Ad Manager
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do DT Exchange, ative os testes de uma única origem no Ad Inspector usando as DT Exchange (Waterfall) origens de anúncios.
Etapas opcionais
Parâmetros específicos de rede
O adaptador DT Exchange aceita parâmetros de solicitação adicionais que podem ser passados para o adaptador como um Android Bundle. O adaptador procura o seguinte 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 |
Veja um exemplo de código que explica 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
var 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 do DT Exchange, você poderá verificar
o erro subjacente da resposta do anúncio usando
ResponseInfo.getAdapterResponses()
na seguinte classe:
com.google.ads.mediation.fyber.FyberMediationAdapter
Aqui estão os códigos e as mensagens correspondentes gerados pelo adaptador do DT Exchange quando ocorre uma falha no carregamento de um anúncio:
Código do erro | Motivo |
---|---|
101 | Os parâmetros do servidor do DT Exchange configurados na Ad Manager interface estão ausentes/inválidos. |
103 | O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com o DT Exchange. |
105 | O SDK do DT Exchange carregou um anúncio, mas retornou um controlador inesperado. |
106 | O anúncio não está pronto para ser exibido. |
200-399 | O SDK do DT Exchange retornou um erro. Veja o código para mais detalhes. |
Registro de alterações do adaptador de mediação para Android do DT Exchange
Versão 8.3.0.0
- Agora é possível transmitir a versão do SDK dos anúncios para dispositivos móveis do Google ao SDK do DT Exchange.
- Verificamos a compatibilidade com o SDK do DT Exchange 8.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.2.0.
- SDK do DT Exchange versão 8.3.0.
Versão 8.2.7.0
- Verificamos a compatibilidade com o SDK do DT Exchange 8.2.7.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
- SDK do DT Exchange versão 8.2.7.
Versão 8.2.6.1
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 23.0.0.
- Verificamos a compatibilidade com o SDK do DT Exchange 8.2.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
- SDK do DT Exchange versão 8.2.6.
Versão 8.2.6.0
- Verificamos a compatibilidade com o SDK do DT Exchange 8.2.6.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.6.0.
- SDK do DT Exchange versão 8.2.6.
Versão 8.2.5.0
- Verificamos a compatibilidade com o SDK do DT Exchange 8.2.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.5.0.
- SDK do DT Exchange versão 8.2.5.
Versão 8.2.4.0
- Verificamos a compatibilidade com o SDK do DT Exchange 8.2.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
- SDK do DT Exchange versão 8.2.4.
Versão 8.2.3.0
- O adaptador foi atualizado para usar a nova classe
VersionInfo
. - Atualização da versão mínima exigida do SDK dos anúncios para dispositivos móveis do Google para a 22.0.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 22.0.0.
- SDK do DT Exchange versão 8.2.3.
Versão 8.2.2.1
- Foi adicionado suporte à transmissão da chave
muteVideo
no extra de mediação para desativar anúncios intersticiais.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
- SDK do DT Exchange versão 8.2.2.
Versão 8.2.2.0
- Verificamos a compatibilidade com o SDK do DT Exchange 8.2.2.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 21.5.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.5.0.
- SDK do DT Exchange versão 8.2.2.
Versão 8.2.1.0
- O nome do adaptador foi renomeado como "DT Exchange".
- Verificamos a compatibilidade com o SDK do DT Exchange 8.2.1.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 21.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.3.0.
- SDK do DT Exchange versão 8.2.1.
Versão 8.2.0.0
- Compatibilidade verificada com o SDK da Fyber 8.2.0.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 21.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.1.0.
- SDK da Fyber versão 8.2.0.
Versão 8.1.5.0
- Compatibilidade verificada com o SDK da Fyber 8.1.5.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK da Fyber versão 8.1.5.
Versão 8.1.4.0
- Compatibilidade verificada com o SDK da Fyber 8.1.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK da Fyber versão 8.1.4.
Versão 8.1.3.1
compileSdkVersion
etargetSdkVersion
foram atualizados para a API 31.- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 21.0.0.
- O nível mínimo necessário da API do Android foi atualizado para 19.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK da Fyber versão 8.1.3.
Versão 8.1.3.0
- Compatibilidade verificada com o SDK da Fyber 8.1.3.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.6.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
- SDK da Fyber versão 8.1.3.
Versão 8.1.2.0
- Compatibilidade verificada com o SDK da Fyber 8.1.2.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.5.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
- SDK da Fyber versão 8.1.2.
Versão 8.1.0.0
- Compatibilidade verificada com o SDK da Fyber 8.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.4.0.
- SDK da Fyber versão 8.1.0.
Versão 7.8.4.1
- Correção de um problema em que o adaptador não inicializava se houvesse um ID de app duplicado ou mais exclusivo das configurações de mediação.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.4.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.4.0.
- SDK da Fyber versão 7.8.4.
Versão 7.8.4.0
- Compatibilidade verificada com o SDK da Fyber 7.8.4.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.3.0.
- Correção de um problema com anúncios de display premiados, em que
onVideoComplete()
não era chamado. - A Fyber agora exige um contexto de atividade para mostrar anúncios.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.3.0.
- SDK da Fyber versão 7.8.4.
Versão 7.8.3.0
- Compatibilidade verificada com o SDK da Fyber 7.8.3.
- Foram adicionados códigos de erro e mensagens padronizados do adaptador.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.1.0.
- SDK da Fyber versão 7.8.3.
Versão 7.8.2.0
- Compatibilidade verificada com o SDK da Fyber 7.8.2.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.0.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.0.0.
- SDK da Fyber versão 7.8.2.
Versão 7.8.1.0
- Compatibilidade verificada com o SDK da Fyber 7.8.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.7.0.
- SDK da Fyber versão 7.8.1.
Versão 7.8.0.0
- Compatibilidade verificada com o SDK da Fyber 7.8.0.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 19.7.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.7.0.
- SDK da Fyber versão 7.8.0.
Versão 7.7.4.0
- Compatibilidade verificada com o SDK da Fyber 7.7.4.
- Correção de um problema em que
onUserEarnedReward()
era encaminhado duas vezes em anúncios premiados.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.5.0.
- SDK da Fyber versão 7.7.4.
Versão 7.7.3.0
- Compatibilidade verificada com o SDK da Fyber 7.7.3.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.5.0.
- SDK da Fyber versão 7.7.3.
Versão 7.7.2.0
- Compatibilidade verificada com o SDK da Fyber 7.7.2.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 19.5.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.5.0.
- SDK da Fyber versão 7.7.2.
Versão 7.7.1.0
- Compatibilidade verificada com o SDK da Fyber 7.7.1.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 19.4.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.4.0.
- SDK da Fyber versão 7.7.1.
Versão 7.7.0.0
- Compatibilidade verificada com o SDK da Fyber 7.7.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.3.0.
- SDK da Fyber versão 7.7.0.
Versão 7.6.1.0
- Compatibilidade verificada com o SDK da Fyber 7.6.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.3.0.
- SDK da Fyber versão 7.6.1.
Versão 7.6.0.0
- Compatibilidade verificada com o SDK da Fyber 7.6.0.
- O adaptador foi atualizado para oferecer suporte a solicitações de banner adaptativo inline.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 19.3.0.
- Correção de um bug em que os métodos onAdOpened()/onAdClosed() não eram chamados para anúncios de banner.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.3.0.
- SDK da Fyber versão 7.6.0.
Versão 7.5.4.0
- Compatibilidade verificada com o SDK da Fyber 7.5.4.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 19.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.1.0.
- SDK da Fyber versão 7.5.4.
Versão 7.5.3.0
- Compatibilidade verificada com o SDK da Fyber 7.5.3.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.0.1.
- SDK da Fyber versão 7.5.3.
Versão 7.5.2.0
- Compatibilidade verificada com o SDK da Fyber 7.5.2.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 19.0.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.0.1.
- SDK da Fyber versão 7.5.2.
Versão 7.5.0.0
- Compatibilidade verificada com o SDK da Fyber 7.5.0.
- Correção da falha de NullPointerException durante o carregamento de anúncios da Fyber.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 18.3.0.
- SDK da Fyber versão 7.5.0.
Versão 7.4.1.0
- Compatibilidade verificada com o SDK da Fyber 7.4.1.
- Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 18.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 18.3.0.
- SDK da Fyber versão 7.4.1.
Versão 7.3.4.0
- Versão inicial.
- Compatível com anúncios intersticiais, premiados e de banner.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 18.2.0.
- SDK da Fyber versão 7.3.4.