Integrar o DT Exchange com 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 da AdMob, 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

• 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 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 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 de DT Exchange na interface AdMob

Configurar as configurações de mediação para o bloco de anúncios

É necessário adicionar o DT Exchange à configuração de mediação do bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, navegue até a guia Mediation. Se você tiver um grupo de mediação que gostaria de modificar, clique no nome dele para editá-lo e pule para Adicionar a DT Exchange como uma origem de anúncios.

Para criar um novo 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 blocos de anúncios da AdMob. Clique em Concluído.

O card "Blocos de anúncios" vai ser preenchido com os blocos que você selecionou:

Adicionar o DT Exchange como uma origem de anúncios

No card Hierarquia, na seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione DT Exchange.

Selecione DT Exchange e ative o interruptor Optimize. Insira o ID do editor, o secreto do consumidor e a chave do consumidor obtidos na seção anterior para configurar a otimização da origem de anúncios para o DT Exchange. Em seguida, insira um valor de eCPM para a DT Exchange e clique em Continuar.

Observação: só é necessário configurar a otimização da origem de anúncios uma vez por rede.

Se você já tiver um mapeamento para DT Exchange, selecione-o. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o ID do aplicativo e o ID do posicionamento recebidos na seção anterior. Em seguida, clique em Concluído.

Importante: o ID do aplicativo precisa ser associado ao app de destino, como na interface de troca de DT.

Observação: a otimização da origem de anúncios leva alguns dias para coletar dados suficientes para calcular o eCPM com precisão para uma rede de mediação. Enquanto isso, o status de otimização da origem de anúncios é PENDING. Portanto, é necessário definir manualmente um valor de eCPM para a rede. Depois que o eCPM for calculado, a origem de anúncios vai começar a atualizar o eCPM automaticamente.

Adicionar a DT Exchange (Fyber Monetization) à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Importante: verifique se você tem a permissão Gerenciamento de conta para concluir a configuração do consentimento para usuários 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 (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.5.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 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 definição legal desses termos). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" mostrado 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 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 com o 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:

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

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 associadas gerados pelo adaptador DT Exchange quando um anúncio não é carregado:

Código do erro	Motivo
101	Os parâmetros do servidor de DT Exchange configurados na interface AdMob estão ausentes ou são 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 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 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 inicializava se houvesse uma duplicação ou mais de um ID exclusivo do app 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.