Integrar a DT Exchange à mediação

Este guia mostra como usar o Google Mobile Ads Unity Plugin para carregar e exibir anúncios da DT Exchange usando a mediação, incluindo integrações em hierarquia. Ele explica 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 da Unity para o DT Exchange tem os seguintes recursos:

Pré-requisitos

Antes de continuar, verifique o seguinte:

• Versão mais recente do Google Mobile Ads Unity Plugin.
• Unity Editor versão 4 ou mais recente.
• [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o plug-in de mediação dos anúncios para dispositivos móveis do Google para a DT Exchange 3.3.12 ou mais recente (recomendamos usar a versão mais recente).
• Para implantar no Android
  • API Android nível 24 ou mais recente.
• Para implantar no iOS
  • Destino de implantação do iOS 15.0 ou mais recente.
• Um projeto do Unity em funcionamento configurado com Google Mobile Ads Unity Plugin. Consulte Configurar o Google Mobile Ads Unity Plugin para mais detalhes.

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

Adicionar um novo app e posição do anúncio

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

Clique em Adicionar app.

Escolha a plataforma e as posições, preencha o restante do formulário e clique em Create App.

Insira os nomes e selecione os tipos de canais. Em seguida, clique em Salvar posição.

ID do app e ID da posição

Passe o cursor sobre a barra de navegação à esquerda para abri-la 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 de lugar.

ID do publisher, token do cliente e segredo do consumidor

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

Anote o ID do publisher, o token do cliente e o segredo do consumidor, porque eles serão necessários na próxima etapa.

Atualizar o app-ads.txt

Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é 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 fez isso, crie um arquivo app-ads.txt para o Ad Manager.

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

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

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

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 (Fyber Monetization) à 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 add com.google.ads.mobile.mediation.dtexchange

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

Consentimento para a UE e o GDPR

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer certas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, e obter o consentimento deles para usar cookies ou outra forma de armazenamento local, quando exigido por lei, e para coletar, compartilhar e usar dados pessoais para personalização de anúncios. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação.

O adaptador do Unity da DT Exchange versão 3.3.0 e mais recentes aceita a transmissão de indicadores de consentimento do GDPR de plataformas de gerenciamento de consentimento que se integram à Estrutura de Transparência e Consentimento (TCF) do IAB para o SDK da DT Exchange. Para mais informações, consulte a documentação do GDPR para Android e iOS.

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 desses termos na lei). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de conformidade com as leis estaduais de privacidade 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 publicidade na sua cadeia de mediação. Portanto, identifique cada rede de publicidade que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.

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

Etapa 5: adicionar o código necessário

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 (lances) e DT Exchange (hierarquia).

Códigos de erro

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

com.google.ads.mediation.fyber.FyberMediationAdapter

GADMediationAdapterFyber

Confira os códigos e as mensagens correspondentes gerados pelo adaptador da DT Exchange quando um anúncio não é carregado:

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

Versão 3.6.0 (em andamento)

Versão 3.5.13

• Compatível com a versão 8.4.7.1 do adaptador da DT Exchange para Android.
• Compatibilidade com a versão 8.4.10.0 do adaptador do iOS da DT Exchange.
• Criada e testada com a versão 11.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.12

• Compatível com a versão 8.4.7.0 do adaptador da DT Exchange para Android.
• Compatibilidade com a versão 8.4.10.0 do adaptador iOS da DT Exchange.
• Criada e testada com a versão 11.4.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.11

• Compatibilidade com a versão 8.4.6.0 do adaptador Android da DT Exchange.
• Compatibilidade com a versão 8.4.8.0 do adaptador do iOS da DT Exchange.
• Criada e testada com a versão 11.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.10

• Compatibilidade com a versão 8.4.5.1 do adaptador Android da DT Exchange.
• Compatível com a versão 8.4.8.0 do adaptador do iOS da DT Exchange.
• Criado e testado com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.9

• Compatível com a versão 8.4.5.0 do adaptador da DT Exchange para Android.
• Compatível com a versão 8.4.7.1 do adaptador iOS da DT Exchange.
• Criado e testado com a versão 11.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.8

• Compatível com a versão 8.4.5.0 do adaptador da DT Exchange para Android.
• Compatibilidade com a versão 8.4.7.0 do adaptador do iOS da DT Exchange.
• Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.7

• Compatível com a versão 8.4.4.0 do adaptador da DT Exchange para Android.
• Compatível com a versão 8.4.6.0 do adaptador do DT Exchange para iOS.
• Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.6

• Compatibilidade com a versão 8.4.3.0 do adaptador Android da DT Exchange.
• Compatibilidade com a versão 8.4.5.0 do adaptador iOS da DT Exchange.
• Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.5

• Compatível com a versão 8.4.2.2 do adaptador do DT Exchange para Android.
• Compatível com a versão 8.4.4.1 do adaptador iOS da DT Exchange.
• Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.4

• Compatibilidade com a versão 8.4.2.1 do adaptador do Android da DT Exchange.
• Compatibilidade com a versão 8.4.4.0 do adaptador iOS da DT Exchange.
• Criada e testada com a versão 10.7.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.3

• Compatível com a versão 8.4.2.0 do adaptador da DT Exchange para Android.
• Compatibilidade com a versão 8.4.3.0 do adaptador iOS da DT Exchange.
• Criada e testada com a versão 10.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.2

• Compatibilidade com a versão 8.4.1.0 do adaptador Android da DT Exchange.
• Compatível com a versão 8.4.2.1 do adaptador do iOS da DT Exchange.
• Criado e testado com a versão 10.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.1

• Compatível com a versão 8.4.0.1 do adaptador da DT Exchange para Android.
• Compatível com a versão 8.4.2.0 do adaptador do iOS da DT Exchange.
• Criado e testado com a versão 10.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.5.0

• Compatibilidade com a versão 8.4.0.0 do adaptador Android da DT Exchange.
• Compatibilidade com a versão 8.4.1.0 do adaptador do iOS da DT Exchange.
• Criada e testada com a versão 10.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.4.0

• Compatibilidade com a versão 8.4.0.0 do adaptador do Android da DT Exchange.
• Compatível com a versão 8.3.8.0 do adaptador da DT Exchange para iOS.
• Criada e testada com a versão 10.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.3.12

• Compatível com a versão 8.3.8.0 do adaptador da DT Exchange para Android.
• Compatível com a versão 8.3.8.0 do adaptador do iOS da DT Exchange.
• Criado e testado com a versão 10.3.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.

Versão 3.3.11

• Compatibilidade com a versão 8.3.7.0 do adaptador Android da DT Exchange.
• Compatível com a versão 8.3.7.0 do adaptador da DT Exchange para iOS.
• Criada e testada com a versão 10.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.3.10

• Compatibilidade com a versão 8.3.7.0 do adaptador Android da DT Exchange.
• Compatível com a versão 8.3.6.0 do adaptador da DT Exchange para iOS.
• Criada e testada com a versão 10.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.3.9

• Compatível com a versão 8.3.6.1 do adaptador da DT Exchange para Android.
• Compatibilidade com a versão 8.3.6.0 do adaptador do iOS da DT Exchange.
• Criada e testada com a versão 10.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.3.8

• Compatível com a versão 8.3.5.0 do adaptador da DT Exchange para Android.
• Compatibilidade com a versão 8.3.4.0 do adaptador iOS da DT Exchange.
• Criado e testado com a versão 9.5.0 do plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.

Versão 3.3.7

• Compatível com a versão 8.3.4.0 do adaptador da DT Exchange para Android.
• Compatível com a versão 8.3.4.0 do adaptador do iOS da DT Exchange.
• Criada e testada com a versão 9.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.3.6

• Compatível com a versão 8.3.3.0 do adaptador da DT Exchange para Android.
• Compatível com a versão 8.3.4.0 do adaptador do iOS da DT Exchange.
• Criado e testado com a versão 9.5.0 do plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.

Versão 3.3.5

• Compatibilidade com a versão 8.3.3.0 do adaptador Android da DT Exchange.
• Compatível com a versão 8.3.3.0 do adaptador do iOS da DT Exchange.
• Criado e testado com a versão 9.4.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.3.4

• Compatibilidade com a versão 8.3.3.0 do adaptador Android da DT Exchange.
• Compatível com a versão 8.3.2.1 do adaptador do iOS da DT Exchange.
• Criado e testado com a versão 9.4.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.3.3

• Compatibilidade com a versão 8.3.2.0 do adaptador do Android da DT Exchange.
• Compatível com a versão 8.3.2.1 do adaptador do iOS da DT Exchange.
• Criado e testado com a versão 9.3.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.

Versão 3.3.2

• Compatível com a versão 8.3.1.0 do adaptador da DT Exchange para Android.
• Compatível com a versão 8.3.2.1 do adaptador do iOS da DT Exchange.
• Criado e testado com a versão 9.3.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.

Versão 3.3.1

• Compatível com a versão 8.3.1.0 do adaptador do Android da DT Exchange.
• Compatível com a versão 8.3.2.0 do adaptador da DT Exchange para iOS.
• Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.3.0

• DummyClient foi renomeado como PlaceholderClient
• Compatível com a versão 8.3.0.0 do adaptador da DT Exchange para Android.
• Compatível com a versão 8.3.1.0 do adaptador da DT Exchange para iOS.
• Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.2.1

• Compatibilidade com a versão 8.2.7.0 do adaptador do Android da DT Exchange.
• Compatibilidade com a versão 8.3.1.0 do adaptador do iOS da DT Exchange.
• Criada e testada com a versão 9.1.1 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.

Versão 3.2.0

• Compatibilidade com a versão 8.2.7.0 do adaptador do Android da DT Exchange.
• Compatível com a versão 8.3.0.0 do adaptador iOS da DT Exchange.
• Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.1.12

• Compatibilidade com a versão 8.2.7.0 do adaptador do Android da DT Exchange.
• Compatibilidade com a versão 8.2.8.0 do adaptador do iOS da DT Exchange.
• Criada e testada com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.1.11

• Compatibilidade com a versão 8.2.7.0 do adaptador do Android da DT Exchange.
• Compatível com a versão 8.2.7.0 do adaptador da DT Exchange para iOS.
• Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.1.10

• Compatível com a versão 8.2.6.1 do adaptador da DT Exchange para Android.
• Compatibilidade com o adaptador iOS da DT Exchange versão 8.2.7.0.
• Criado e testado com a versão 9.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.1.8

• Compatibilidade com a versão 8.2.5.0 do adaptador Android da DT Exchange.
• Suporte à versão 8.2.6.0 do adaptador do iOS da DT Exchange.
• Criado e testado com a versão 8.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.1.7

• Compatibilidade com a versão 8.2.4.0 do adaptador Android da DT Exchange.
• Compatível com a versão 8.2.4.0 do adaptador do iOS da DT Exchange.
• Criada e testada com a versão 8.5.2 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.1.6

• Compatibilidade com a versão 8.2.3.0 do adaptador Android da DT Exchange.
• Compatível com a versão 8.2.3.0 do adaptador para iOS da DT Exchange.
• Criada e testada com a versão 8.4.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.1.5

• O conteúdo do adaptador foi movido para GoogleMobileAds/Mediation/DTExchange/.
• Refatoração do namespace do adaptador para usar GoogleMobileAds.Mediation.DTExchange.
• Compatível com a versão 8.2.3.0 do adaptador da DT Exchange para Android.
• Compatível com a versão 8.2.1.0 do adaptador do iOS da DT Exchange.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.1.0.

Versão 3.1.4

• Compatível com a versão 8.2.2.0 do adaptador da DT Exchange para Android.
• Compatibilidade com a versão 8.1.9.1 do adaptador do iOS da DT Exchange.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.4.1.

Versão 3.1.3

• Compatível com a versão 8.2.1.0 do adaptador do DT Exchange para Android.
• Compatível com a versão 8.1.9.0 do adaptador da DT Exchange para iOS.
• Criado e testado com o Plug-in de Anúncios para Dispositivos Móveis do Google para Unity versão 7.4.0.

Versão 3.1.2

• O nome do plug-in de mediação da Unity foi alterado para "DT Exchange".
• A classe GoogleMobileAds.Api.Mediation.Fyber.Fyber foi renomeada como GoogleMobileAds.Api.Mediation.DTExchange.DTExchange.
• Compatibilidade com a versão 8.2.1.0 do adaptador Android da DT Exchange.
• Compatibilidade com a versão 8.1.7.0 do adaptador iOS da DT Exchange.
• Criada e testada com a versão 7.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.1.1

• Adição dos seguintes métodos à classe Fyber:
  • SetCCPAString(string)
  • ClearCCPAString()
• Compatível com a versão 8.2.0.0 do adaptador do Android da Fyber.
• Compatível com a versão 8.1.6.0 do adaptador do iOS da Fyber.
• Criada e testada com a versão 7.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.1.0

• Compatível com a versão 8.2.0.0 do adaptador da Fyber para Android.
• Compatível com a versão 8.1.5.0 do adaptador da Fyber para iOS.
• Criado e testado com o plug-in de anúncios para dispositivos móveis do Google para Unity versão 7.2.0.

Versão 3.0.2

• Compatibilidade com a versão 8.1.3.1 do adaptador do Android da Fyber.
• Compatível com a versão 8.1.5.0 do adaptador da Fyber para iOS.
• Criada e testada com a versão 7.0.2 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.0.1

• Compatível com a versão 8.1.3.0 do adaptador da Fyber para Android.
• Compatível com a versão 8.1.4.0 do adaptador da Fyber para iOS.
• Criado e testado com a versão 7.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.

Versão 3.0.0

• Compatível com a versão 8.1.2.0 do adaptador da Fyber para Android.
• Compatível com a versão 8.1.2.0 do adaptador da Fyber para iOS.

Versão 2.0.0

• Compatível com a versão 7.8.4.1 do adaptador do Android da Fyber.
• Compatível com a versão 8.0.0.0 do adaptador da Fyber para iOS.

Versão 1.6.1

• Compatível com a versão 7.8.3.0 do adaptador da Fyber para Android.
• Compatível com a versão 7.8.6.0 do adaptador do Fyber para iOS.

Versão 1.6.0

• Compatível com a versão 7.8.2.0 do adaptador da Fyber para Android.
• Compatível com a versão 7.8.5.0 do adaptador do iOS da Fyber.

Versão 1.5.2

• Suporte à versão 7.7.4.0 do adaptador do Android da Fyber.
• Compatível com a versão 7.7.3.0 do adaptador da Fyber para iOS.

Versão 1.5.1

• Compatível com a versão 7.7.2.0 do adaptador da Fyber para Android.
• Suporte à versão 7.7.2.0 do adaptador do Fyber para iOS.

Versão 1.5.0

• Compatível com a versão 7.7.1.0 do adaptador da Fyber para Android.
• Compatível com a versão 7.7.1.0 do adaptador da Fyber para iOS.

Versão 1.4.0

• Compatível com a versão 7.7.0.0 do adaptador do Android da Fyber.
• Suporte à versão 7.6.4.0 do adaptador do Fyber para iOS.

Versão 1.3.0

• Compatível com a versão 7.6.0.0 do adaptador da Fyber para Android.
• Compatível com a versão 7.6.0.0 do adaptador da Fyber para iOS.

Versão 1.2.3

• Compatível com a versão 7.5.4.0 do adaptador do Android da Fyber.
• Compatível com a versão 7.5.6.0 do adaptador da Fyber para iOS.

Versão 1.2.2

• Compatível com a versão 7.5.3.0 do adaptador do Android da Fyber.
• Compatível com a versão 7.5.4.0 do adaptador do Fyber para iOS.

Versão 1.2.1

• Compatível com a versão 7.5.2.0 do adaptador da Fyber para Android.
• Compatível com a versão 7.5.3.0 do adaptador da Fyber para iOS.

Versão 1.2.0

• Compatível com a versão 7.5.0.0 do adaptador do Android da Fyber.
• Compatível com a versão 7.5.1.0 do adaptador do Fyber para iOS.

Versão 1.1.0

• Adicionamos os seguintes métodos à classe Fyber para oferecer suporte aos requisitos do GDPR:
  • SetGDPRConsent()
  • SetGDPRConsentString()
  • ClearGDPRConsentData()
• Suporte à versão 7.3.4.0 do adaptador do Android da Fyber.
• Compatível com a versão 7.5.0.0 do adaptador da Fyber para iOS.

Versão 1.0.0

• Primeira versão!
• Suporte à versão 7.3.4.0 do adaptador do Android da Fyber.
• Compatível com a versão 7.4.0.0 do adaptador da Fyber para iOS.