Integrar o DT Exchange com mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google com o objetivo de carregar e exibir anúncios do DT Exchange usando a mediação, abrangendo 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 app .

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

O adaptador de mediação para 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
  • Flutter 3.7.0 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 funcional configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Concluir o Guia explicativo 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 sua plataforma, preencha o restante do formulário e clique em Adicionar canais.

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 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 de DT Exchange na interface

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

Android

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

iOS

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

Adicionar ao GDPR e à lista de parceiros de publicidade 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 de troca de DT dos anúncios para dispositivos móveis do Google para Unity no seu projeto 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 Unity Package Manager Settings.

Na guia Registros com escopo, 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 pelo 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 External Dependency Manager vai executar a resolução do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do app 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.

O plug-in de mediação de anúncios para dispositivos móveis do Google para o DT Exchange não é compatível com a transmissão de informações de consentimento ao SDK do DT Exchange.

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 na lei) fornecendo uma opção de desativação pelo link "Não vender minhas informações pessoais" na página inicial da parte "vendedora". O Guia de conformidade com as leis de privacidade dos estados dos EUA permite ativar o processamento 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, é necessário identificar cada rede de publicidade na 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 dos anúncios para dispositivos móveis do Google para o DT Exchange não oferece suporte à transmissão de informações de consentimento para o SDK do DT Exchange.

Etapa 5: adicionar o código obrigató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

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

Android

Código do erro Motivo
101 Os parâmetros do servidor de DT Exchange configurados na interface 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 de DT Exchange configurados na interface 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 adaptador de mediação do Flutter do DT Exchange

Próxima versão

  • Criado e testado com a versão 5.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

1.1.0

  • Compatibilidade verificada com a versão 8.3.0.0 do adaptador Android DT Exchange.
  • Compatibilidade verificada com a versão 8.3.1.0 do adaptador DT Exchange para iOS.
  • Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.1.0.

1.0.0

  • Versão inicial.
  • Compatibilidade verificada com a versão 8.2.7.0 do adaptador Android DT Exchange.
  • Compatibilidade verificada com o adaptador iOS do DT Exchange versão 8.2.8.0.
  • Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.1.0.