Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios do DT Exchange usando mediação, cobrindo integrações em cascata. Ele aborda como adicionar o DT Exchange à configuração de mediação de uma unidade de anúncio e como integrar o SDK e o adaptador do DT Exchange a um app Android.
Integrações e formatos de anúncio compatíveis
O adaptador de mediação para DT Exchange tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | |
Formatos | |
Banner | |
Intersticial | |
Premiado | |
Nativo |
Requisitos
- API do Android de nível 21 ou mais recente
SDK dos anúncios para dispositivos móveis do Google mais recente
Concluir o Guia para iniciantes de mediação
Etapa 1: configurar as configurações na interface do DT Exchange
Adicionar novos apps e posições de anúncios
Inscreva-se ou faça login no DT Exchange Console.
Clique no botão Add App para adicionar seu app.
Selecione a plataforma, preencha o restante do formulário e clique em Adicionar posições.
Insira um nome para o novo posicionamento no campo Nome do posicionamento e selecione o Tipo de posicionamento desejado na lista suspensa. Por fim, clique em Salvar posição.
ID do app e ID da posição
Passe o cursor sobre a barra de navegação à esquerda para abri-la. Em seguida, clique em Apps no menu à esquerda.
Na página Gerenciamento de apps, anote o ID do app ao lado dele.
Selecione seu app, navegue até a guia Veiculações e clique no ícone de cópia ao lado de Nome da veiculação. Anote o ID da posição.
ID do editor, chave do consumidor e secret do consumidor
Clique no seu nome de usuário no menu à esquerda e selecione Perfil do usuário.
Anote o ID do editor, a chave do consumidor e o secret do consumidor, porque eles serão necessários na próxima etapa.
Etapa 2: configurar a demanda do DT Exchange na interface do Ad Manager
Configurar as configurações de mediação do 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 defina 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 App para dispositivos móveis para adicionar a mediação.
Em seguida, clique no botão Adicionar parceiro de rendimento.
Se você já tiver um parceiro de rendimento para a 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 ID do editor, o secreto do consumidor e a chave do consumidor recebidos 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 a Plataforma e Ativo como o Status. Insira o ID do aplicativo e o ID do posicionamento recebidos na seção anterior. Em seguida, insira um valor de CPM padrão.
Clique em Salvar na parte de baixo da página quando terminar.
Adicionar a DT Exchange (Fyber Monetization) à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA
Siga as etapas em Configurações do GDPR e Regulamentações estaduais dos EUA para adicionar a DT Exchange (Fyber Monetization) à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA na interface do Ad Manager.
Etapa 3: importar o SDK e o adaptador do DT Exchange
Integração com o Android Studio (recomendada)
No arquivo build.gradle.kts
do app, adicione as seguintes dependências
e configurações de implementação. Use as versões mais recentes do SDK
e do adaptador do DT Exchange:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.6.0")
implementation("com.google.ads.mediation:fyber:8.3.3.0")
}
Integração manual
- Faça o 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
- Navegue até os
artefatos do adaptador DT Exchange
no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo
.aar
do adaptador DTExchange e adicione-o ao projeto.
Etapa 4: implementar as configurações de privacidade no SDK do DT Exchange
Consentimento da UE e GDPR
De acordo com a Política de consentimento para usuários da União Europeia do Google, é necessário garantir que algumas informações sejam fornecidas e que o consentimento seja obtido dos usuários no Espaço Econômico Europeu (EEE) sobre o uso de identificadores de dispositivo e dados pessoais. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Ao buscar consentimento, você precisa identificar cada rede de publicidade na cadeia de mediação que pode coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada rede. No momento, o Google não pode transmitir a escolha de consentimento do usuário para essas redes automaticamente.
O DT Exchange contém uma API que permite encaminhar o consentimento do usuário para o SDK. O exemplo de código abaixo mostra como transmitir informações de consentimento para o SDK do DT Exchange manualmente. Se você optar por transmitir informações de consentimento para o SDK do DT Exchange manualmente, recomendamos que esse código seja chamado antes de solicitar anúncios pelo SDK de 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 e o guia de implementação do GDPR da DT Exchange para mais detalhes e os valores que podem ser fornecidos no método.
Leis Estaduais de Privacidade dos EUA
As Leis Estaduais de Privacidade 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 "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados dos EUA oferece a capacidade de ativar o processamento de dados restrito para veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de anúncios na sua cadeia de mediação. Portanto, é necessário identificar cada rede de publicidade na cadeia de mediação que possa participar da venda de informações pessoais e seguir as orientações de cada uma dessas redes para garantir a conformidade.
O DT Exchange contém uma API que permite encaminhar o consentimento do usuário para o SDK. O exemplo de código abaixo mostra como transmitir informações de consentimento para o SDK do DT Exchange manualmente. Se você optar por transmitir informações de consentimento para o SDK do DT Exchange manualmente, recomendamos que esse código seja chamado antes de solicitar anúncios pelo SDK de 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 e 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
Nenhum código adicional é necessário para a integração com o DT Exchange.
Etapa 6: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste no Ad Manager.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do DT Exchange, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens DT Exchange (hierarquia).
Etapas opcionais
Parâmetros específicos da rede
O adaptador de troca de DT oferece suporte a outros parâmetros de solicitação que podem ser transmitidos ao adaptador como um pacote Android. O adaptador procura as seguintes chaves no pacote:
Solicitar parâmetros e valores | |
---|---|
InneractiveMediationDefs.KEY_AGE
|
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 sobre 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);
AdManagerAdRequest request = new AdManagerAdRequest.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 = AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
.build()
Códigos de erro
Se o adaptador não receber um anúncio do DT Exchange, verifique o
erro subjacente da resposta do anúncio usando
ResponseInfo.getAdapterResponses()
na seguinte classe:
com.google.ads.mediation.fyber.FyberMediationAdapter
Confira os códigos e as mensagens que acompanham o adaptador DT Exchange quando não é possível carregar um anúncio:
Código do erro | Motivo |
---|---|
101 | Os parâmetros do servidor DT Exchange configurados na interface do Ad Manager estão ausentes ou 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. Consulte o código para mais detalhes. |
Registro de alterações do adaptador de mediação do DT Exchange para Android
Versão 8.3.3.0
- Compatibilidade verificada com o SDK do DT Exchange 8.3.3.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.5.0.
- SDK do DT Exchange versão 8.3.3.
Versão 8.3.2.0
- Compatibilidade verificada com o SDK do DT Exchange 8.3.2.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.4.0.
- SDK do DT Exchange versão 8.3.2.
Versão 8.3.1.0
- Compatibilidade verificada com o SDK do DT Exchange 8.3.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 23.3.0.
- SDK do DT Exchange versão 8.3.1.
Versão 8.3.0.0
- Foi adicionado suporte para transmitir a versão do SDK dos anúncios para dispositivos móveis do Google ao SDK do DT Exchange.
- Compatibilidade verificada 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
- Compatibilidade verificada 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
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 23.0.0.
- Compatibilidade verificada 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
- Compatibilidade verificada 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
- Compatibilidade verificada 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
- Compatibilidade verificada 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
. - Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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 para a transmissão da chave
muteVideo
no extra de mediação para silenciar 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
- Compatibilidade verificada com o SDK do DT Exchange 8.2.2.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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 para "DT Exchange".
- Compatibilidade verificada com o SDK do DT Exchange 8.2.1.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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 do Fyber 8.2.0.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.1.0.
- SDK do Fyber versão 8.2.0.
Versão 8.1.5.0
- Compatibilidade verificada com o SDK 8.1.5 da Fyber.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK do Fyber versão 8.1.5.
Versão 8.1.4.0
- Compatibilidade verificada com o SDK do Fyber 8.1.4.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK do Fyber versão 8.1.4.
Versão 8.1.3.1
compileSdkVersion
etargetSdkVersion
foram atualizados para a API 31.- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 21.0.0.
- O nível mínimo de API do Android necessário foi atualizado para 19.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
- SDK do Fyber versão 8.1.3.
Versão 8.1.3.0
- Compatibilidade verificada com o SDK Fyber 8.1.3.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.6.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.6.0.
- SDK do Fyber versão 8.1.3.
Versão 8.1.2.0
- Compatibilidade verificada com o SDK do Fyber 8.1.2.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.5.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
- SDK do Fyber versão 8.1.2.
Versão 8.1.0.0
- Compatibilidade verificada com o SDK do Fyber 8.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.4.0.
- SDK do Fyber versão 8.1.0.
Versão 7.8.4.1
- Correção de um problema em que o adaptador não era inicializado se houvesse um ID de app exclusivo duplicado ou mais de um nas configurações de mediação.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.4.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.4.0.
- SDK do Fyber versão 7.8.4.
Versão 7.8.4.0
- Compatibilidade verificada com o SDK do Fyber 7.8.4.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.3.0.
- Correção de um problema com anúncios de display premiados, em que
onVideoComplete()
não era chamado. - Agora, o Fyber 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 do Fyber versão 7.8.4.
Versão 7.8.3.0
- Compatibilidade verificada com o SDK do Fyber 7.8.3.
- Foram adicionados códigos e mensagens de erro padronizados do adaptador.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.1.0.
- SDK do Fyber versão 7.8.3.
Versão 7.8.2.0
- Compatibilidade verificada com o SDK do Fyber 7.8.2.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 20.0.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 20.0.0.
- Versão 7.8.2 do SDK do Fyber.
Versão 7.8.1.0
- Compatibilidade verificada com o SDK do Fyber 7.8.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.7.0.
- SDK do Fyber versão 7.8.1.
Versão 7.8.0.0
- Compatibilidade verificada com o SDK do Fyber 7.8.0.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.7.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.7.0.
- SDK do Fyber versão 7.8.0.
Versão 7.7.4.0
- Compatibilidade verificada com o SDK do Fyber 7.7.4.
- Correção de um problema em que
onUserEarnedReward()
era encaminhado duas vezes para anúncios premiados.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.5.0.
- SDK do Fyber versão 7.7.4.
Versão 7.7.3.0
- Compatibilidade verificada com o SDK do Fyber 7.7.3.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.5.0.
- SDK do Fyber versão 7.7.3.
Versão 7.7.2.0
- Compatibilidade verificada com o SDK do Fyber 7.7.2.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.5.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.5.0.
- SDK do Fyber versão 7.7.2.
Versão 7.7.1.0
- Compatibilidade verificada com o SDK do Fyber 7.7.1.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.4.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.4.0.
- SDK do Fyber versão 7.7.1.
Versão 7.7.0.0
- Compatibilidade verificada com o SDK do Fyber 7.7.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.3.0.
- SDK do Fyber versão 7.7.0.
Versão 7.6.1.0
- Compatibilidade verificada com o SDK do Fyber 7.6.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.3.0.
- SDK do Fyber versão 7.6.1.
Versão 7.6.0.0
- Compatibilidade verificada com o SDK do Fyber 7.6.0.
- O adaptador foi atualizado para oferecer suporte a solicitações de banners adaptativos inline.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 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 do Fyber versão 7.6.0.
Versão 7.5.4.0
- Compatibilidade verificada com o SDK do Fyber 7.5.4.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.1.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.1.0.
- SDK do Fyber versão 7.5.4.
Versão 7.5.3.0
- Compatibilidade verificada com o SDK do Fyber 7.5.3.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.0.1.
- SDK do Fyber versão 7.5.3.
Versão 7.5.2.0
- Compatibilidade verificada com o SDK do Fyber 7.5.2.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 19.0.1.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 19.0.1.
- SDK do Fyber versão 7.5.2.
Versão 7.5.0.0
- Compatibilidade verificada com o SDK do Fyber 7.5.0.
- Correção da falha NullPointerException durante o carregamento de anúncios do Fyber.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 18.3.0.
- SDK do Fyber versão 7.5.0.
Versão 7.4.1.0
- Compatibilidade verificada com o SDK do Fyber 7.4.1.
- Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 18.3.0.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 18.3.0.
- SDK do Fyber versão 7.4.1.
Versão 7.3.4.0
- Versão inicial.
- Oferece suporte a anúncios de banner, intersticiais e premiados.
Criado e testado com:
- SDK dos anúncios para dispositivos móveis do Google versão 18.2.0.
- SDK do Fyber versão 7.3.4.