Integrar o DT Exchange com mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da DT Exchange usando a mediação da AdMob, abordando integrações em cascata. Ele aborda como adicionar a DT Exchange à configuração de mediação de uma unidade de anúncio e como integrar o SDK e o adaptador da DT Exchange a um app Android.

Integrações e formatos de anúncio aceitos

O adaptador de mediação da DT Exchange tem os seguintes recursos:

Requisitos

• API do Android de nível 23 ou mais recente

• SDK dos anúncios para dispositivos móveis do Google mais recente

• Conclua o Guia de primeiros passos da mediação.

Etapa 1: definir 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 das suas veiculações. 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 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.

Atualizar o app-ads.txt

O app-ads.txt de vendedores autorizados para apps é 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 da DT Exchange na interface da AdMob

Configurar 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. Em seguida, 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úncio.

Para criar um grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio e 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. 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

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 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 da DT Exchange:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.4.0")
    implementation("com.google.ads.mediation:fyber:8.3.7.0")
}

Integração manual

• Baixe a versão mais recente do SDK do DT Exchange para Android e adicione fyber-marketplace-x.y.z.aar ao seu projeto.
• Navegue até os artefatos do adaptador do DT Exchange no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador DT Exchange e adicione-o ao seu projeto.

Etapa 4: implementar configurações de privacidade no SDK do DT Exchange

Consentimento para a UE e GDPR

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que determinadas divulgações sejam feitas e que os consentimentos sejam obtidos dos usuários no Espaço Econômico Europeu (EEE) em relação ao 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 sua cadeia de mediação que possa coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada rede. No momento, o Google não consegue transmitir automaticamente a opção de consentimento do usuário para essas redes.

A DT Exchange tem uma API que permite encaminhar o consentimento do usuário para o SDK. O código de exemplo a seguir mostra como transmitir informações de consentimento para o SDK do DT Exchange manualmente. Se você optar por transmitir informações de consentimento ao SDK da 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.

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")

Acesse 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 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 legal desses termos). Essa opção é disponibilizada por um link em destaque com a mensagem "Não vender minhas informações pessoais" na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados 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 anúncios na sua cadeia de mediação. Portanto, identifique cada rede de publicidade na sua cadeia de mediação 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 código de exemplo a seguir mostra como transmitir informações de consentimento para o SDK do DT Exchange manualmente. Se você optar por transmitir informações de consentimento ao SDK da 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.

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

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 anúncio com contexto de atividade

Transmita o contexto Activity ao carregar formatos de anúncio intersticial. Sem contexto de atividade, o carregamento do anúncio vai falhar.

Etapa 6: testar a implementação

Ativar anúncios de teste

Verifique se você registrou 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 (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:

Confira um exemplo de código para definir esses parâmetros de solicitação de anúncio:

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();

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 da DT Exchange, verifique o erro subjacente na resposta do anúncio usando ResponseInfo.getAdapterResponses() na seguinte classe:

com.google.ads.mediation.fyber.FyberMediationAdapter

Confira os códigos e as mensagens acompanhantes gerados pelo adaptador DT Exchange quando um anúncio não é carregado:

Registro de alterações do adaptador de mediação do Android da DT Exchange

Próxima versão

• Refatoração dos códigos de erro em um novo arquivo DTExchangeErrorCodes.kt.

Versão 8.3.7.0

• Adaptador atualizado para oferecer suporte a lances para formatos de anúncio de banner e intersticial.
• Compatibilidade verificada com o SDK DT Exchange 8.3.7.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 24.1.0.
• Versão 8.3.7 do SDK do DT Exchange.

Versão 8.3.6.1

• Atualizamos o nível mínimo necessário da API do Android para 23.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 24.0.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 24.0.0.
• Versão 8.3.6 do SDK do DT Exchange.

Versão 8.3.6.0

• Compatibilidade verificada com o SDK DT Exchange 8.3.6.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 23.6.0.
• Versão 8.3.6 do SDK do DT Exchange.

Versão 8.3.5.0

• Compatibilidade verificada com o SDK DT Exchange 8.3.5.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 23.6.0.
• Versão 8.3.5 do SDK do DT Exchange.

Versão 8.3.4.0

• Compatibilidade verificada com o SDK da DT Exchange 8.3.4.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 23.6.0.
• Versão 8.3.4 do SDK do DT Exchange.

Versão 8.3.3.0

• Compatibilidade verificada com o SDK da DT Exchange 8.3.3.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 23.5.0.
• Versão 8.3.3 do SDK do DT Exchange.

Versão 8.3.2.0

• Compatibilidade verificada com o SDK da DT Exchange 8.3.2.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 23.4.0.
• Versão 8.3.2 do SDK do DT Exchange.

Versão 8.3.1.0

• Compatibilidade verificada com o SDK da DT Exchange 8.3.1.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 23.3.0.
• Versão 8.3.1 do SDK do DT Exchange.

Versão 8.3.0.0

• Adicionada compatibilidade para transmitir a versão do SDK dos anúncios para dispositivos móveis do Google ao SDK da DT Exchange.
• Compatibilidade verificada com o SDK DT Exchange 8.3.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 23.2.0.
• Versão 8.3.0 do SDK do DT Exchange.

Versão 8.2.7.0

• Compatibilidade verificada com o SDK DT Exchange 8.2.7.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 23.0.0.
• Versão 8.2.7 do SDK do DT Exchange.

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 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 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.
• Versão 8.2.5 do SDK do DT Exchange.

Versão 8.2.4.0

• Compatibilidade verificada com o SDK da DT Exchange 8.2.4.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 22.3.0.
• Versão 8.2.4 do SDK do DT Exchange.

Versão 8.2.3.0

• Adaptador 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 transmitir a 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

• Compatibilidade verificada com o SDK da 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

• Mudança do nome do adaptador para "DT Exchange".
• Compatibilidade verificada com o SDK da 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 da 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.
• Versão 8.2.0 do SDK da Fyber.

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.
• Versão 8.1.5 do SDK da Fyber.

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.
• Versão 8.1.4 do SDK da Fyber.

Versão 8.1.3.1

• compileSdkVersion e targetSdkVersion 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.
• Atualizamos o nível mínimo da API do Android necessário para 19.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 21.0.0.
• Versão 8.1.3 do SDK da Fyber.

Versão 8.1.3.0

• Compatibilidade verificada com o SDK da 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.
• Versão 8.1.3 do SDK da Fyber.

Versão 8.1.2.0

• Compatibilidade verificada com o SDK da 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.
• Versão 8.1.2 do SDK da Fyber.

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.
• Versão 8.1.0 do SDK da Fyber.

Versão 7.8.4.1

• Foi corrigido um problema em que o adaptador não era inicializado se houvesse um ID de app duplicado ou mais de um ID de app exclusivo 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.
• Versão 7.8.4 do SDK da Fyber.

Versão 7.8.4.0

• Compatibilidade verificada com o SDK da 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, a 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.
• Versão 7.8.4 do SDK da Fyber.

Versão 7.8.3.0

• Compatibilidade verificada com o SDK da Fyber 7.8.3.
• Adição de mensagens e códigos 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.
• Versão 7.8.3 do SDK da Fyber.

Versão 7.8.2.0

• Compatibilidade verificada com o SDK da 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 da Fyber.

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.
• Versão 7.8.1 do SDK da Fyber.

Versão 7.8.0.0

• Compatibilidade verificada com o SDK da 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.
• Versão 7.8.0 do SDK da Fyber.

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 para anúncios premiados.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 19.5.0.
• Versão 7.7.4 do SDK da Fyber.

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.
• Versão 7.7.3 do SDK da Fyber.

Versão 7.7.2.0

• Compatibilidade verificada com o SDK da 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.
• Versão 7.7.2 do SDK da Fyber.

Versão 7.7.1.0

• Compatibilidade verificada com o SDK da 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.
• Versão 7.7.1 do SDK da Fyber.

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.
• Versão 7.7.0 do SDK da Fyber.

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.
• Versão 7.6.1 do SDK da Fyber.

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 banners adaptativos in-line.
• 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.
• Versão 7.6.0 do SDK da Fyber.

Versão 7.5.4.0

• Compatibilidade verificada com o SDK da 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.
• Versão 7.5.4 do SDK da Fyber.

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.
• Versão 7.5.3 do SDK da Fyber.

Versão 7.5.2.0

• Compatibilidade verificada com o SDK da 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.
• Versão 7.5.2 do SDK da Fyber.

Versão 7.5.0.0

• Compatibilidade verificada com o SDK da Fyber 7.5.0.
• Correção de uma 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.
• Versão 7.5.0 do SDK do Fyber.

Versão 7.4.1.0

• Compatibilidade verificada com o SDK da 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.
• Versão 7.4.1 do SDK da Fyber.

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.
• Versão 7.3.4 do SDK da Fyber.