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 em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte o artigo Começar para ver mais detalhes.
- Leia o Guia explicativo de mediação
Etapa 1: configurar 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 app.
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.
ID do aplicativo e da posição
Passe o cursor sobre a barra de navegação à esquerda para abri-la. Em seguida, clique em Apps no menu à esquerda.
Na página Gerenciamento de aplicativos, anote o ID do aplicativo ao lado dele.
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 do editor, chave do cliente e segredo do cliente
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.
Etapa 2: configurar a demanda do 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 à lista de parceiros de publicidade do GDPR e dos regulamentos 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.dtexchangeOpenUPM
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
Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecionar My Registries no menu suspenso.
Selecione o pacote Google Mobile Ads DT Exchange Mediation e clique em Install.
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 de projetos do Unity, selecione Assets > Import Package >
Custom Package e encontre o arquivo
GoogleMobileAdsDTExchangeMediation.unitypackage
que você salvou. Verifique se todos os arquivos estão selecionados e clique em
Import.
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 Unity.
Etapa 4: implementar as configurações de privacidade no SDK do DT Exchange
Consentimento para a UE e o GDPR
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 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.
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 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
Códigos de erro
Se o adaptador não receber um anúncio do DT Exchange, os editores poderão verificar o
erro subjacente da resposta do anúncio usando
ResponseInfo na
classe abaixo:
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 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 para trocas de DT
Próxima versão
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.2.0.
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 a versão 5.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
1.0.0
- Versão inicial.
- Foi verificada a compatibilidade com o adaptador do DT Exchange para Android versão 8.2.7.0.
- Foi verificada a compatibilidade com o adaptador do DT Exchange para iOS 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.