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 da DT Exchange usando a mediação, incluindo integrações em cascata. Ele aborda como adicionar a DT Exchange à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da DT Exchange a um app Unity.

Integrações e formatos de anúncio aceitos

O adaptador de mediação do Unity para a 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 versões mais recentes
  • Para fazer a implantação no Android,
    • API do Android de nível 23 ou mais recente
  • Para fazer a implantação no iOS:
    • Destino de implantação do iOS 12.0 ou mais recente
  • Um projeto do Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Conclua o Guia de primeiros passos da mediação.

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

Adicionar um novo app e posicionamento de anúncio

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

Clique em Adicionar app.

Gerenciar apps

Escolha sua plataforma e seus canais, preencha o restante do formulário e clique em Criar app.

Android

iOS

Insira os nomes e selecione os tipos das suas veiculações. Em seguida, 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 abrir e clique em Gerenciamento de apps.

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

Selecione seu app e navegue até a guia Canais. Anote o ID da posição.

ID da posição

ID do publisher, 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.

Perfil do usuário

Atualizar o app-ads.txt

O app-ads.txt de vendedores autorizados para apps é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não tiver feito isso, crie um arquivo app-ads.txt para o Ad Manager.

Para implementar o app-ads.txt na DT Exchange, adicione a DT ao seu arquivo app-ads.txt.

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

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 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 das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar a DT Exchange (monetização da Fyber) à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface do Ad Manager.

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

OpenUPM-CLI

Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação do DT Exchange dos anúncios para dispositivos móveis do Google no Unity executando o seguinte comando 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 Configurações do Unity Package Manager.

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

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopos: com.google

Detalhes do OpenUPM

Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

Registros do Unity

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

Instalar pelo OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para DT Exchange usando o link de download no Registro de alterações 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ê baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.

Importar do Unity

Em seguida, selecione Recursos > Gerenciador de dependências externas > Resolvedor do Android > Resolução forçada. A biblioteca do External Dependency Manager vai realizar a resolução de dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do seu app Unity.

Forçar resolução

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

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 feitas e que os consentimentos sejam obtidos dos usuários no Espaço Econômico Europeu (EEE) em relação ao 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 sua cadeia de mediação que possa coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada rede. No momento, o Google não consegue transmitir automaticamente a opção de consentimento do usuário para essas redes.

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

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

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

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

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

Leis estaduais de privacidade dos EUA

As leis de privacidade dos estados 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 em destaque com a mensagem "Não vender minhas informações pessoais" na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados dos EUA oferece a opção de ativar o tratamento de dados restrito para a veiculação de anúncios do Google, mas não é possível aplicar essa configuração a cada rede de anúncios na sua cadeia de mediação. Portanto, identifique cada rede de publicidade na sua cadeia de mediação que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para a DT Exchange versão 3.1.1 adicionou a classe Fyber com o método SetCCPAString(), permitindo que você transmita informações de consentimento para a DT Exchange manualmente. O exemplo de código a seguir demonstra como transmitir esses parâmetros ao adaptador da 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 da DT Exchange.

iOS

Integração da SKAdNetwork

Siga a documentação da 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 no Ad Manager.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da DT Exchange, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios 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 na 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 acompanhantes gerados pelo adaptador DT Exchange quando um anúncio não é carregado:

Android

Código do erro Motivo
101 Os parâmetros do servidor da DT Exchange configurados na interface do Ad Manager estão ausentes ou são inválidos.
103 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com a 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.
107 O contexto não é uma instância de atividade.
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 da DT Exchange configurados na interface do Ad Manager estão ausentes ou são inválidos.
102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com a DT Exchange.
103 Não foi possível mostrar o anúncio porque o objeto já foi usado.
104 Não foi possível mostrar anúncios da DT Exchange porque o anúncio não estava pronto.
105 O SDK da DT Exchange retornou um erro de inicialização.

Registro de alterações do plug-in de mediação do Unity da DT Exchange

Versão 3.3.11

Versão 3.3.10

Versão 3.3.9

Versão 3.3.8

Versão 3.3.7

Versão 3.3.6

Versão 3.3.5

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