Integrar a DT Exchange com a Mediação

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

Neste guia, mostramos 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, que abrange integrações em hierarquia. Ele aborda como adicionar o DT Exchange à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do DT Exchange a um Android app.

Integrações e formatos de anúncio compatíveis

O Ad Manager adaptador de mediação do DT Exchange tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

• Android API de nível 19 ou mais recente

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

• Concluir o Guia explicativo de mediação

Etapa 1: definir configurações na interface do DT Exchange

Adicionar novo app e posicionamento do anúncio

Inscreva-se ou faça login no DT Exchange Console.

Clique no botão Add App para adicionar seu aplicativo.

Selecione a plataforma, preencha o restante do formulário e clique em Adicionar canais.

Digite um nome para a nova posição no campo Nomeie sua posição e selecione o Tipo de posição desejado na lista suspensa. Por fim, clique em Salvar posição.

ID do aplicativo e da posição

Abra a barra de navegação à esquerda passando o mouse sobre ela. Em seguida, clique em Apps no menu à esquerda.

Na página Gerenciamento de aplicativos, anote o ID do aplicativo ao lado dele.

Selecione seu aplicativo, navegue até a guia Canais e clique no ícone de cópia ao lado de Nome da posição. Anote o ID da posição.

ID do editor, chave do cliente e segredo do cliente

Clique no seu nome de usuário no menu à esquerda e selecione Perfil de usuário.

Anote o ID do editor, a Chave do cliente e a Chave secreta do cliente, porque eles serão necessários na próxima etapa.

Etapa 2: configurar a demanda do DT Exchange na Ad Manager interface

Definir as configurações de mediação para seu 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 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 Aplicativo para dispositivos móveis ao qual você quer adicionar a mediação.

Em seguida, clique no botão Adicionar parceiro de rendimento.

Se você já tiver um Parceiro de rendimento para 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 Publisher ID, Consumer Secret and Consumer Key recebido 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 Plataforma e Ativo como o Status. Insira o Application ID and Placement ID obtido na seção anterior. Em seguida, insira um valor de CPM padrão.

Importante: o Application ID precisa estar associado ao app de destino, como na DT Exchange interface.

Clique em Salvar na parte inferior da página quando terminar.

Observação :a coleta de dados automática leva alguns dias para coletar dados antes de calcular com precisão um valor de CPM dinâmico para uma rede de mediação. Assim que for possível calcular o eCPM, ele será atualizado automaticamente.

Adicionar Fyber à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Importante :verifique se você tem a permissão de gerenciamento de conta para concluir a configuração de consentimento da UE e GDPR, CPRA e 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 Configurações das regulamentações estaduais dos EUA para adicionar Fyber à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na Ad Manager IU.

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

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

Integração com o Android Studio (recomendada)

No arquivo build.gradle.kts no nível 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.0.0")
    implementation("com.google.ads.mediation:fyber:8.2.6.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 do DT Exchange no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador do DT Exchange e adicione-o ao projeto.

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

Consentimento da UE e o 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 fornecidas aos usuários no Espaço Econômico Europeu (EEE) e recebam os consentimentos deles em relação ao uso de identificadores de dispositivos 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 solicitar 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 uma delas. No momento, o Google não pode transmitir automaticamente a escolha de consentimento do usuário a essas redes.

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

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) com um link "Não vender minhas informações pessoais" destacado na página inicial do vendedor. O guia de conformidade com as leis de privacidade dos EUA oferece a capacidade de ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de publicidade 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 ao SDK dele. O exemplo de código a seguir mostra como transmitir informações de consentimento manualmente para o SDK do DT Exchange. Se você optar por transmitir informações de consentimento manualmente ao SDK do DT Exchange, 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 em Ad Manager

Importante: desative o modo de teste para Ad Manager e 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 os testes de uma única origem no Ad Inspector usando as DT Exchange (Waterfall) origens de anúncios.

Etapas opcionais

Parâmetros específicos de rede

O adaptador DT Exchange oferece suporte a outros parâmetros de solicitação que podem ser transmitidos ao adaptador como um Android Bundle. O adaptador procura as seguintes chaves no pacote:

Parâmetros e valores de solicitação
InneractiveMediationDefs.KEY_AGE	Número inteiro. A idade do usuário
FyberMediationAdapter.KEY_MUTE_VIDEO	Boolean. Ativar ou desativar o som do vídeo

Veja um exemplo de código que mostra 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)

var adrequest = AdRequest.Builder()
       .addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
       .build()

Códigos de erro

Se o adaptador não receber um anúncio do DT Exchange, é possível verificar o erro subjacente da resposta do anúncio usando ResponseInfo.getAdapterResponses() na seguinte classe:

com.google.ads.mediation.fyber.FyberMediationAdapter

Aqui estão os códigos e as mensagens que acompanham geradas pelo adaptador do DT Exchange quando um anúncio não é carregado:

Código do erro	Motivo
101	Os parâmetros do servidor do DT Exchange configurados na interface Ad Manager estão ausentes/inválidos.
103	O tamanho de 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. Confira o código para mais detalhes.
0-10	O SDK do DT Exchange retornou um erro. Consulte a documentação para mais detalhes.
101	Os parâmetros do servidor do DT Exchange configurados na interface Ad Manager estão ausentes/inválidos.
102	O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com o DT Exchange.
103	Falha ao exibir o anúncio porque o objeto de anúncio já foi usado.
104	Falha ao exibir anúncios do DT Exchange porque o anúncio não está pronto.
105	O SDK do DT Exchange retornou um erro de inicialização.

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

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.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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 à transmissão da chave muteVideo no extra de mediação para desativar o som de 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.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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

• Renomeação do nome do adaptador para "DT Exchange".
• Compatibilidade verificada com o SDK do DT Exchange 8.2.1.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 21.1.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 21.1.0.
• SDK da 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 da Fyber versão 8.1.5.

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

Versão 8.1.3.1

• compileSdkVersion e targetSdkVersion foram atualizados para o nível 31 da API
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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 da Fyber versão 8.1.3.

Versão 8.1.3.0

• Compatibilidade verificada com o SDK da Fyber 8.1.3.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 20.5.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 20.5.0.
• SDK da Fyber versão 8.1.2.

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.
• SDK da 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 quando havia uma cópia ou mais de um ID de app exclusivo nas configurações de mediação.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 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 da Fyber 7.8.4.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 20.3.0.
• Correção de um problema com anúncios de display premiados, em que onVideoComplete() não era chamado.
• A Fyber agora requer um contexto de atividade para exibir anúncios.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 20.3.0.
• SDK da Fyber versão 7.8.4.

Versão 7.8.3.0

• Compatibilidade verificada com o SDK da Fyber 7.8.3.
• Foram adicionados códigos de erro e mensagens de adaptador padronizados.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 20.1.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 20.1.0.
• SDK da Fyber versão 7.8.3.

Versão 7.8.2.0

• Compatibilidade verificada com o SDK da Fyber 7.8.2.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 20.0.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 20.0.0.
• SDK da Fyber versão 7.8.2.

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

Versão 7.8.0.0

• Compatibilidade verificada com o SDK da Fyber 7.8.0.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 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 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.
• SDK da Fyber versão 7.7.4.

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

Versão 7.7.2.0

• Compatibilidade verificada com o SDK da Fyber 7.7.2.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 19.5.0.

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

Versão 7.7.1.0

• Compatibilidade verificada com o SDK da Fyber 7.7.1.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para a 19.4.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 19.4.0.
• SDK da Fyber versão 7.7.1.

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

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 banner adaptativo inline.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada 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 da Fyber versão 7.6.0.

Versão 7.5.4.0

• Compatibilidade verificada com o SDK da Fyber 7.5.4.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada 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 da Fyber 7.5.3.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 19.0.1.
• SDK da Fyber versão 7.5.3.

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

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 19.0.1.
• SDK da Fyber versão 7.5.2.

Versão 7.5.0.0

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

Versão 7.4.1.0

• Compatibilidade verificada com o SDK da Fyber 7.4.1.
• A versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google foi atualizada para 18.3.0.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 18.3.0.
• SDK da Fyber versão 7.4.1.

Versão 7.3.4.0

• Versão inicial.
• Compatível com anúncios intersticiais, premiados e de banner.

Criado e testado com:

• SDK dos anúncios para dispositivos móveis do Google versão 18.2.0.
• SDK da Fyber versão 7.3.4.