Integrar o DT Exchange à 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 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 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.

Gerenciar apps

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.

Configuraçã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.

Menu

Na página Gerenciamento de apps, anote o ID do app ao lado dele.

ID do app

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

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

Perfil do usuário

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

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

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

Código do erro Motivo
101 Os parâmetros do servidor DT Exchange configurados na interface do Ad Manager 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 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 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.