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 exibir 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 um bloco de anúncios e como integrar o SDK e o adaptador do DT Exchange a um app Unity.

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

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

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 4 ou mais recente
  • Para implantar no Android
    • API do Android de nível 21 ou mais recente
  • Para implantar no iOS
    • Destino de implantação do iOS 12.0 ou mais recente
  • Um projeto do Unity configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • 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.

Gerenciar apps

Selecione a plataforma, preencha o restante do formulário e clique em Adicionar posições.

Android

iOS

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

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

Android

Para instruções, consulte a etapa 2 no guia para Android.

iOS

Para ver as instruções, consulte a etapa 2 no guia para iOS.

Adicionar a DT Exchange à 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

OpenUPM-CLI

Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação do Google Mobile Ads DT Exchange para Unity no seu projeto executando o comando abaixo no diretório raiz do projeto:

openupm add com.google.ads.mobile.mediation.dtexchange

OpenUPM

No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Unity Package Manager Settings.

Na guia Scoped Registries, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopo(s): com.google

Detalhes do OpenUPM

Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecionar My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Google Mobile Ads DT Exchange Mediation e clique em Install.

Instalar do OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação de anúncios para dispositivos móveis do Google para DT Exchange no link de download no Changelog e extraia o GoogleMobileAdsDTExchangeMediation.unitypackage do arquivo zip.

No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsDTExchangeMediation.unitypackage que você transferiu por download. Verifique se todos os arquivos estão selecionados e clique em Import.

Importar do Unity

Em seguida, selecione Assets > External Dependency Manager > Android Resolver > Force Resolve. A biblioteca do Gerenciador de dependências externas vai realizar a resolução de dependências do zero e copiar as dependências declaradas para o diretório Assets/Plugins/Android do app do Unity.

Forçar resolução

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.

Esta seção mostra como ativar ou desativar anúncios personalizados para o DT Exchange.

O plug-in de mediação de anúncios para dispositivos móveis do Google para a versão 1.1.0 do DT Exchange adicionou a classe Fyber com os métodos SetGDPRRequired() e SetGDPRConsentString(), permitindo que você transmita informações de consentimento para o DT Exchange manualmente. O exemplo de código a seguir demonstra como transmitir esses parâmetros para o adaptador de troca de DT:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");

Acesse o artigo GDPR do DT Exchange para mais informações 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 lei define esses termos), com a opção de recusa oferecida 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 sua 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 plug-in de mediação de anúncios para dispositivos móveis do Google para a versão 3.1.1 do DT Exchange adicionou a classe Fyber com o método SetCCPAString(), permitindo que você transmita informações de consentimento para o DT Exchange manualmente. O exemplo de código abaixo demonstra como transmitir esses parâmetros para o adaptador DT Exchange:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetCCPAString("myCCPAConsentString");

// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();

Acesse o artigo CCPA Open Source da DT Exchange para mais informações e os valores que podem ser fornecidos no método.

Etapa 5: adicionar o código necessário

Android

Nenhum código adicional é necessário para a integração com o DT Exchange.

iOS

Integração da SKAdNetwork

Siga a documentação do DT Exchange para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.

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

Códigos de erro

Se o adaptador não receber um anúncio da DT Exchange, os editores poderão verificar o erro subjacente da resposta do anúncio usando ResponseInfo na seguinte classe:

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

Confira os códigos e as mensagens que acompanham o adaptador DT Exchange quando não é possível carregar um anúncio:

Android

Código do erro Motivo
101 Os parâmetros do servidor DT Exchange configurados na interface do AdMob estão ausentes ou 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.

iOS

Código do erro Motivo
0-10 O SDK do DT Exchange retornou um erro. Consulte a documentação para mais detalhes.
101 Os parâmetros do servidor DT Exchange configurados na interface do AdMob estão ausentes ou inválidos.
102 O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com o DT Exchange.
103 Não foi possível mostrar o anúncio porque o objeto de anúncio já foi usado.
104 Não foi possível mostrar os 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 plug-in de mediação do DT Exchange para Unity

Versão 3.3.4

Versão 3.3.3

Versão 3.3.2

Versão 3.3.1

Versão 3.3.0

Versão 3.2.1

Versão 3.2.0

Versão 3.1.12

Versão 3.1.11

Versão 3.1.10

Versão 3.1.8

Versão 3.1.7

Versão 3.1.6

Versão 3.1.5

Versão 3.1.4

Versão 3.1.3

Versão 3.1.2

Versão 3.1.1

Versão 3.1.0

Versão 3.0.2

Versão 3.0.1

Versão 3.0.0

Versão 2.0.0

Versão 1.6.1

Versão 1.6.0

Versão 1.5.2

Versão 1.5.1

Versão 1.5.0

Versão 1.4.0

Versão 1.3.0

Versão 1.2.3

Versão 1.2.2

Versão 1.2.1

Versão 1.2.0

Versão 1.1.0

Versão 1.0.0