Integrar a DT Exchange com a Mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios da DT Exchange usando mediação, cobrindo integrações de hierarquia. Ele aborda como adicionar o DT Exchange a um anúncio configuração de mediação da unidade e como integrar o SDK do DT Exchange e adaptador em um Android app.

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

O adaptador de mediação para o DT Exchange tem os seguintes recursos:

Requisitos

• Android API de nível 21 ou mais recente

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

• Concluir a mediação Guia explicativo

Etapa 1: definir as 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.

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

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

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

Integração com o Android Studio (recomendado)

No arquivo build.gradle.kts no nível do app, adicione a seguinte implementação: dependências e configurações. Usar as versões mais recentes do SDK do DT Exchange e adaptador:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:fyber:8.3.0.0")
}

Integração manual

• Faça 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
• Acesse o Artefatos do adaptador do DT Exchange no repositório Maven do Google. Selecionar a versão mais recente, fazer o download da DT Troque o arquivo .aar do adaptador do Exchange e adicione-o ao projeto.

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

Consentimento da UE e GDPR

De acordo com o Consentimento dos usuários da UE do Google política, você precisa garantir que determinadas divulgações sejam fornecidas e consentimentos de usuários no Espaço Econômico Europeu (EEE) em relação a: o uso de identificadores de dispositivos e dados pessoais. Essa política reflete requisitos da Diretiva de privacidade eletrônica da UE e da Lei Geral de Proteção de Dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que podem coletar, receber ou usar dados pessoais. que oferecem informações sobre o uso de cada rede. No momento, o Google não pode repassar a opção de consentimento do usuário a essas redes automaticamente.

O DT Exchange tem uma API que permite encaminhar o consentimento do usuário para o SDK. O o exemplo de código a seguir mostra como transmitir informações de consentimento para a DT Exchange. SDK manualmente. Se você optar por passar informações de consentimento para a DT Exchange manualmente, é recomendável chamar esse código antes da solicitação de anúncios pelo SDK dos 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 do DT Exchange e as 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

Estados Unidos leis estaduais de privacidade exigem que os usuários tenham para desativar a "promoção" das suas "informações pessoais" (como a lei define esses termos), com a opção de desativação oferecida por um aviso "Não vender meus dados pessoais" Informações" na página "vendas" na página inicial de seu grupo. O Estados Unidos define a privacidade guia de conformidade com as leis, permite ativar processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não consegue aplicar essa configuração a cada anúncio rede na sua cadeia de mediação. Portanto, você deve identificar cada rede de anúncios na sua cadeia de mediação que possam participar da venda de e seguir as orientações de cada uma dessas redes para garantir compliance.

O DT Exchange tem uma API que permite encaminhar o consentimento do usuário para o SDK. O o exemplo de código a seguir mostra como transmitir informações de consentimento para a DT Exchange. SDK manualmente. Se você optar por passar informações de consentimento para a DT Exchange manualmente, é recomendável chamar esse código antes da solicitação de anúncios pelo SDK dos 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 da DT Exchange e 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 obrigató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 em Ad Manager

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 aceita parâmetros de solicitação adicionais que podem ser passados para o adaptador como um Android Bundle. O adaptador procura o seguinte chaves no pacote:

Veja um exemplo de código que explica 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, você poderá 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 correspondentes gerados pelo adaptador do DT Exchange quando ocorre uma falha no carregamento de um anúncio:

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

Versão 8.3.0.0

• Agora é possível transmitir a versão do SDK dos anúncios para dispositivos móveis do Google ao SDK do DT Exchange.
• Verificamos a compatibilidade 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

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

• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 23.0.0.
• Verificamos a compatibilidade 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

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

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

• Verificamos a compatibilidade 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.
• Atualização da versão mínima exigida do SDK dos anúncios para dispositivos móveis do Google 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 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.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 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 como "DT Exchange".
• Verificamos a compatibilidade com o SDK do DT Exchange 8.2.1.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google 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.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google 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 a API 31.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 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.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 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.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 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 inicializava se houvesse um ID de app duplicado ou mais exclusivo das configurações de mediação.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 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.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 20.3.0.
• Correção de um problema com anúncios de display premiados, em que onVideoComplete() não era chamado.
• A Fyber agora 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 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 padronizados do adaptador.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 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.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a versão 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.
• 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 da Fyber 7.7.4.
• Correção de um problema em que onUserEarnedReward() era encaminhado duas vezes em 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.
• 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 da 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 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.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 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.
• Atualização da versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para a 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.
• 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.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 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 da Fyber versão 7.5.0.

Versão 7.4.1.0

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