Integrar o DT Exchange à mediação

Observação: o Fyber Marketplace agora é o DT Exchange.

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 hierarquia. 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

• Android API de nível 21 ou mais recente

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

• Leia o Guia explicativo 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 aplicativo e 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 Ad Manager interface

Adicionar DT Exchange (Fyber Monetization) à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA

Importante: verifique se você tem permissão de gerenciamento de conta para concluir a configuração do consentimento da UE e do GDPR, da CPRA e da plataforma de mensagens do usuário. Consulte Gerenciar o acesso do usuário à sua conta para mais detalhes.

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 da AdMob.

Etapa 3: importar o SDK e o adaptador do DT Exchange

Observação: a falha na integração das versões compatíveis do DT Exchange e do SDK dos anúncios para dispositivos móveis do Google pode causar problemas de build.

Integração com o Android Studio (recomendado)

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.5.0")
    implementation("com.google.ads.mediation:fyber:8.3.2.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 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 da DT Exchange e o 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

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 lei define esses termos), com a opção de recusa oferecida 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, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode 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 manualmente as informações de consentimento para o SDK do DT Exchange, recomendamos que esse código seja chamado 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 o 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 necessá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 na AdMob.

Importante: desative o modo de teste da AdMob e da DT Exchange antes de lançar o app.

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

Parâmetros e valores de solicitação
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);

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, 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 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. 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.2.0

• Verificamos a compatibilidade 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

• Verificamos a compatibilidade 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 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 do Fyber versão 8.1.5.

Versão 8.1.4.0

• Verificamos a compatibilidade 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 do Fyber versão 8.1.4.

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.
• 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 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 da Fyber versão 8.1.3.

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.
• 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 duplicado ou mais de um ID exclusivo das 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 da 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 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 do Fyber versão 7.8.1.

Versão 7.8.0.0

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