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 mostrar anúncios do DT Exchange usando a 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:

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

Configurar as configurações de mediação do 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 a DT Exchange como uma origem de anúncios

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

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.

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

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

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:

Confira um exemplo de código sobre como 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 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:

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