Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir anúncios da DT Exchange que usam a mediação, incluindo integrações em hierarquia. Ele mostra como adicionar o DT Exchange à configuração configuração de mediação e como integrar o SDK e o adaptador do DT Exchange em um Unity app.
Integrações e formatos de anúncio compatíveis
O Ad Manager adaptador de mediação para DT Exchange tem a 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
- Android API de nível 21 ou mais recente
- Para implantar no iOS
- Destino de implantação do iOS de 12.0 ou mais recente
- Um projeto Unity em funcionamento configurado com o Google SDK de anúncios para dispositivos móveis. Consulte Acesse Primeiros passos para ver mais detalhes.
- Concluir a mediação Guia explicativo
Etapa 1: definir as configurações na interface do DT Exchange
Etapa 2: configurar a demanda do DT Exchange na Ad Manager 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 Fyber ao GDPR e à lista de parceiros de publicidade das regulamentações estaduais dos EUA
Etapa 3: importar o SDK e o adaptador do DT Exchange
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
Trocar pelo link de download no
Registro de alterações e extração
GoogleMobileAdsFyberMediation.unitypackage
do arquivo ZIP.
No editor de projetos do Unity, selecione Assets > Importar pacote > Personalizado
Package e localize o arquivo GoogleMobileAdsFyberMediation.unitypackage
que você
baixado. Verifique se todos os arquivos estão selecionados e clique em Import.
Em seguida, selecione Recursos > Resolvedor do Play Services > Resolvedor do Android > Forçar
Resolver. A biblioteca Unity Play Services Resolver vai executar dependências
do zero e copiar as dependências declaradas no
Assets/Plugins/Android
do seu app Unity.
Etapa 4: implementar configurações de privacidade no SDK do DT Exchange
Consentimento para a UE e o GDPR
De acordo com o Consentimento dos usuários da UE do Google política, você precisa garantir que determinadas divulgações sejam fornecidas e consentimentos de usuários no Espaço Econômico Europeu (EEE) em relação a: o uso de identificadores de dispositivos e dados pessoais. Essa política reflete requisitos da Diretiva de privacidade eletrônica da UE e da Lei Geral de Proteção de Dados (GDPR). Ao solicitar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que podem coletar, receber ou usar dados pessoais. que oferecem informações sobre o uso de cada rede. No momento, o Google não pode repassar a opção de consentimento do usuário a essas redes automaticamente.
Esta seção mostra como ativar ou desativar anúncios personalizados no DT Exchange.
O plug-in de mediação de anúncios para dispositivos móveis do Google para o DT Exchange versão 1.1.0 adicionou a opção
Classe Fyber
com os métodos SetGDPRRequired()
e SetGDPRConsentString()
.
Assim, você pode transmitir manualmente as informações de consentimento para o DT Exchange. O seguinte
exemplo de código demonstra como transmitir esses parâmetros para o DT Exchange
adaptador:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");
Visite o site da DT Exchange GDPR para mais informações e os valores que podem ser fornecidos no método.
Leis Estaduais de Privacidade dos EUA
Estados Unidos leis estaduais de privacidade exigem que os usuários tenham para desativar a "promoção" das suas "informações pessoais" (como a lei define esses termos), com a opção de desativação oferecida por um aviso "Não vender meus dados pessoais" Informações" na página "vendas" na página inicial de seu grupo. A Estados Unidos define a privacidade guia de conformidade com as leis, permite ativar processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não consegue aplicar essa configuração a cada anúncio rede na sua cadeia de mediação. Portanto, você deve identificar cada rede de anúncios na sua cadeia de mediação que possam participar da venda de e seguir as orientações de cada uma dessas redes para garantir compliance.
O plug-in de mediação de anúncios para dispositivos móveis do Google para o DT Exchange versão 3.1.1 adicionou a opção
Classe Fyber
com o método SetCCPAString()
, que permite transmitir o consentimento
para o DT Exchange manualmente. O código de exemplo a seguir demonstra
para transmitir esses parâmetros ao adaptador do 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 site da CCPA Open da DT Exchange Fonte para mais informações e os valores que podem ser fornecidos no método.
Etapa 5: adicionar o código obrigatório
Android
Nenhum código adicional é necessário para a integração do DT Exchange.
iOS
Integração com a SKAdNetwork
Siga as orientações da DT Exchange
documentação
para adicionar os identificadores SKAdNetwork ao arquivo Info.plist
do projeto.
Etapa 6: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste em Ad Manager
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do DT Exchange, ative os testes de uma única origem no Ad Inspector usando as DT Exchange (Waterfall) origens de anúncios.
Códigos de erro
Se o adaptador não receber um anúncio do DT Exchange, os editores poderão verificar o
o erro subjacente da resposta do anúncio usando
ResponseInfo
no
seguinte classe:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
Aqui estão os códigos e as mensagens correspondentes gerados pelo adaptador do DT Exchange quando ocorre uma falha no carregamento de um anúncio:
Android
Código do erro | Motivo |
---|---|
101 | Os parâmetros do servidor do DT Exchange configurados na Ad Manager interface estão ausentes/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. Veja 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 do DT Exchange configurados na Ad Manager interface estão ausentes/inválidos. |
102 | O tamanho do anúncio solicitado não corresponde a um tamanho de banner compatível com o DT Exchange. |
103 | Falha ao mostrar o anúncio porque o objeto de anúncio já foi usado. |
104 | Falha ao exibir 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 para Unity do DT Exchange
Versão 3.3.0
DummyClient
foi renomeado comoPlaceholderClient
- Oferece suporte ao Adaptador para Android do DT Exchange versão 8.3.0.0.
- Oferece suporte ao adaptador do DT Exchange para iOS versão 8.3.1.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.2.0.
Versão 3.2.1
- Oferece suporte ao Adaptador para Android do DT Exchange versão 8.2.7.0.
- Oferece suporte ao adaptador do DT Exchange para iOS versão 8.3.1.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.1.
Versão 3.2.0
- Oferece suporte ao Adaptador para Android do DT Exchange versão 8.2.7.0.
- Oferece suporte ao adaptador do DT Exchange para iOS versão 8.3.0.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.
Versão 3.1.12
- Oferece suporte ao Adaptador para Android do DT Exchange versão 8.2.7.0.
- Oferece suporte ao 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 Unity versão 9.1.0.
Versão 3.1.11
- Oferece suporte ao Adaptador para Android do DT Exchange versão 8.2.7.0.
- Compatível com o adaptador para iOS do DT Exchange versão 8.2.7.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.
Versão 3.1.10
- Oferece suporte ao Adaptador para Android do DT Exchange versão 8.2.6.1.
- Compatível com o adaptador para iOS do DT Exchange versão 8.2.7.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.0.0.
Versão 3.1.8
- Oferece suporte ao Adaptador para Android do DT Exchange versão 8.2.5.0.
- Oferece suporte ao adaptador do DT Exchange para iOS versão 8.2.6.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.6.0.
Versão 3.1.7
- Oferece suporte ao Adaptador para Android do DT Exchange versão 8.2.4.0.
- Oferece suporte ao adaptador do DT Exchange para iOS versão 8.2.4.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.5.2.
Versão 3.1.6
- Oferece suporte ao Adaptador para Android do DT Exchange versão 8.2.3.0.
- Oferece suporte ao adaptador do DT Exchange para iOS versão 8.2.3.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.4.1.
Versão 3.1.5
- O conteúdo do adaptador foi movido para
GoogleMobileAds/Mediation/DTExchange/
. - O namespace do adaptador foi refatorado para usar
GoogleMobileAds.Mediation.DTExchange
. - Oferece suporte ao Adaptador para Android do DT Exchange versão 8.2.3.0.
- Oferece suporte ao adaptador do DT Exchange para iOS versão 8.2.1.0.
- 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
- Oferece suporte ao Adaptador para Android do DT Exchange versão 8.2.2.0.
- Oferece suporte ao adaptador do DT Exchange para iOS versão 8.1.9.1.
- 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
- Oferece suporte ao Adaptador para Android do DT Exchange versão 8.2.1.0.
- Oferece suporte ao adaptador do DT Exchange para iOS versão 8.1.9.0.
- Criado e testado com o plug-in dos 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 de Unity foi renomeado como "DT Exchange".
- A classe
GoogleMobileAds.Api.Mediation.Fyber.Fyber
foi renomeada comoGoogleMobileAds.Api.Mediation.DTExchange.DTExchange
. - Oferece suporte ao Adaptador para Android do DT Exchange versão 8.2.1.0.
- Oferece suporte ao adaptador do DT Exchange para iOS versão 8.1.7.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.3.1.
Versão 3.1.1
- Os seguintes métodos foram adicionados à classe
Fyber
:SetCCPAString(string)
ClearCCPAString()
- Oferece suporte ao Adaptador para Android da Fyber versão 8.2.0.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 8.1.6.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.3.0.
Versão 3.1.0
- Oferece suporte ao Adaptador para Android da Fyber versão 8.2.0.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 8.1.5.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.2.0.
Versão 3.0.2
- Oferece suporte ao Adaptador para Android da Fyber versão 8.1.3.1.
- Oferece suporte ao adaptador para iOS da Fyber versão 8.1.5.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.2.
Versão 3.0.1
- Oferece suporte ao adaptador para Android da Fyber versão 8.1.3.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 8.1.4.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 7.0.0.
Versão 3.0.0
- Oferece suporte ao adaptador para Android da Fyber versão 8.1.2.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 8.1.2.0.
Versão 2.0.0
- Oferece suporte ao Adaptador para Android da Fyber versão 7.8.4.1.
- Oferece suporte ao adaptador para iOS da Fyber versão 8.0.0.0.
Versão 1.6.1
- Oferece suporte ao Adaptador para Android da Fyber versão 7.8.3.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.8.6.0.
Versão 1.6.0
- Oferece suporte ao Adaptador para Android da Fyber versão 7.8.2.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.8.5.0.
Versão 1.5.2
- Oferece suporte ao Adaptador para Android da Fyber versão 7.7.4.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.7.3.0.
Versão 1.5.1
- Oferece suporte ao adaptador para Android da Fyber versão 7.7.2.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.7.2.0.
Versão 1.5.0
- Oferece suporte ao adaptador para Android da Fyber versão 7.7.1.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.7.1.0.
Versão 1.4.0
- Oferece suporte ao adaptador para Android da Fyber versão 7.7.0.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.6.4.0.
Versão 1.3.0
- Oferece suporte ao Adaptador para Android da Fyber versão 7.6.0.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.6.0.0.
Versão 1.2.3
- Oferece suporte ao adaptador para Android da Fyber versão 7.5.4.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.5.6.0.
Versão 1.2.2
- Oferece suporte ao Adaptador para Android da Fyber versão 7.5.3.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.5.4.0.
Versão 1.2.1
- Oferece suporte ao adaptador para Android da Fyber versão 7.5.2.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.5.3.0.
Versão 1.2.0
- Oferece suporte ao adaptador para Android da Fyber versão 7.5.0.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.5.1.0.
Versão 1.1.0
- Os seguintes métodos foram adicionados à classe
Fyber
para atender aos requisitos do GDPR:SetGDPRConsent()
SetGDPRConsentString()
ClearGDPRConsentData()
- Oferece suporte ao adaptador para Android da Fyber versão 7.3.4.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.5.0.0.
Versão 1.0.0
- Primeira versão!
- Oferece suporte ao adaptador para Android da Fyber versão 7.3.4.0.
- Oferece suporte ao adaptador para iOS da Fyber versão 7.4.0.0.