Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da Unity Ads usando mediação, cobrindo integrações em hierarquia. Ele aborda como adicionar o Unity Ads à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do Unity Ads a um app do Flutter.
Integrações e formatos de anúncio compatíveis
O adaptador de mediação da AdMob para a Unity Ads tem os seguintes recursos:
Integração | |
---|---|
Lances | 1 |
Cascata | |
Formatos | |
Banner | |
Intersticial | |
Premiado |
1 A integração de lances está em versão beta fechada. Entre em contato com seu gerente de contas para solicitar acesso.
Requisitos
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Flutter 3.7.0 ou mais recente
- [Para lances]: para integrar todos os formatos de anúncio com suporte nos lances, use o plug-in de mediação dos anúncios para dispositivos móveis do Google para Unity Ads 3.11.1 ou mais recente (recomendamos a versão 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 do Flutter configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Concluir o Guia para iniciantes de mediação
Etapa 1: configurar as configurações na interface do Unity Ads
Faça login ou inscreva-se no Unity Ads.
Criar um projeto
No Painel do Unity Ads, navegue até Projects e clique em Create Project.
Preencha o formulário e clique em Criar projeto para adicionar seu projeto.
Navegue até Monetização > Começar e clique em Começar.
No modal Project Setup, selecione I plan to use Mediation e Google Admob para Mediation Partner e clique em Next.
Selecione as configurações do anúncio e clique em Próxima.
Preencha o formulário e clique em Adicionar projeto.
Anote o ID do jogo.
Criar um bloco de anúncios
Acesse Monetização > Blocos de anúncios e clique em Adicionar bloco de anúncios.
Insira um nome do bloco de anúncios e selecione a plataforma e o formato do anúncio.
Android
iOS
Por fim, clique em Criar para salvar o bloco de anúncios.
Adicionar um canal
Lances
Entre em contato com seu gerente de contas do Google para criar posições de lances.
Cascata
Depois que o projeto for criado, navegue até Monetização > Posicionamentos. Para criar uma nova posição, clique em Adicionar posição no bloco de anúncios.
Preencha os detalhes necessários e clique em Adicionar posição.
Anote o ID da posição.
Android
iOS
Localizar a chave da API Unity Ads Reporting
Lances
Esta etapa não é necessária para integrações de lances.
Cascata
Além do ID do jogo e do ID do posicionamento, você também vai precisar da chave de API e do ID principal da organização do Unity Ads para configurar o ID do bloco de anúncios da AdMob.
Navegue até Monetização > Configuração > Gerenciamento de API e anote a chave de acesso da API Analytics Stats.
Em seguida, navegue até Monetização > Configurações da organização e anote o ID principal da organização.
Ativar o modo de teste
O modo de teste pode ser ativado no painel da Unity Ads. Nas configurações do projeto, selecione a guia Teste.
Para forçar o modo de teste no app, clique no botão de edição de cada plataforma, marque Override client test mode e selecione Force test mode ON (i.e. use test ads) for all devices.
Android
iOS
Você também pode ativar o modo de teste para dispositivos específicos clicando no botão Adicionar dispositivo de teste.
Preencha o formulário e clique em Salvar.
Etapa 2: configurar a demanda da Unity Ads na interface da AdMob
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 ver as instruções, consulte a etapa 2 no guia para iOS.
Adicionar a Unity Ads à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA
Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar a Unity Ads à 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 Unity Ads
Integração pelo pub.dev
Adicione a dependência abaixo com as versões mais recentes do
SDK e do adaptador do Unity Ads no arquivo
pubspec.yaml
do pacote:
dependencies:
gma_mediation_unity: ^1.0.0
Integração manual
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
Unity Ads,
extraia o arquivo baixado e adicione a pasta do plug-in extraído
(e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo
pubspec.yaml
adicionando a seguinte dependência:
dependencies:
gma_mediation_unity:
path: path/to/local/package
Etapa 4: implementar as configurações de privacidade no SDK do Unity Ads
Consentimento da UE e 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 Unity Ads
inclui o método
GmaMediationUnity.setGDPRConsent()
. O exemplo de código abaixo mostra como transmitir informações de consentimento para o
SDK do Unity Ads. Se você optar por chamar esse método, recomendamos que o faça
antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setGDPRConsent(true);
Consulte os guias APIs de consentimento e dados de privacidade e Compliance com o GDPR do Unity Ads para mais detalhes e os valores que podem ser fornecidos em cada método.
Leis Estaduais de Privacidade dos EUA
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 lei define esses termos), com a opção de recusa oferecida por um link "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados dos EUA oferece a capacidade de ativar o processamento de dados restrito para veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de anúncios na sua cadeia de mediação. Portanto, é necessário identificar cada rede de publicidade na sua 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 Unity Ads
inclui o método
GmaMediationUnity.setCCPAConsent()
. O exemplo de código abaixo mostra como transmitir informações de consentimento para o
SDK do Unity Ads. Se você optar por chamar esse método, recomendamos que o faça
antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setCCPAConsent(true);
Etapa 5: adicionar o código necessário
Android
Nenhum código adicional é necessário para integrações do Unity Ads no Android.
iOS
Integração da SKAdNetwork
Siga a documentação do Unity Ads
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 e ative o modo de teste na interface do Unity Ads.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do Unity Ads, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Unity Ads (lances) e Unity Ads (hierarquia).
Códigos de erro
Se o adaptador não receber um anúncio do Unity Ads, os editores poderão verificar o
erro subjacente da resposta do anúncio usando
ResponseInfo
nas
seguintes classes:
Android
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
iOS
GADMAdapterUnity
GADMediationAdapterUnity
Confira os códigos e as mensagens enviadas pelo adaptador UnityAds quando um anúncio não é carregado:
Android
Código do erro | Motivo |
---|---|
0-10 | O SDK do UnityAds retornou um erro. Consulte o código para mais detalhes. |
101 | Os parâmetros do servidor da UnityAds configurados na interface do AdMob estão ausentes ou inválidos. |
102 | A UnityAds retornou uma posição com um estado NO_FILL. |
103 | A UnityAds retornou uma posição com o estado DISABLED. |
104 | A UnityAds tentou mostrar um anúncio com um contexto nulo. |
105 | O contexto usado para inicializar, carregar e/ou mostrar anúncios do Unity Ads não é uma instância de atividade. |
106 | A UnityAds tentou mostrar um anúncio que não está pronto para ser exibido. |
107 | O UnityAds não é compatível com o dispositivo. |
108 | A UnityAds só pode carregar um anúncio por posição por vez. |
109 | A UnityAds terminou com um estado ERROR. |
200-204 | O UnityAds Banner apresenta um erro específico. Consulte o código para mais detalhes. |
iOS
0-9 | O SDK do UnityAds retornou um erro. Consulte a documentação do Unity para mais detalhes. |
101 | Os parâmetros do servidor da UnityAds configurados na interface do AdMob estão ausentes ou inválidos. |
102 | O dispositivo não é compatível com a UnityAds. |
103 | A UnityAds terminou a apresentação com o estado de erro kUnityAdsFinishStateError. |
104 | O objeto de anúncio do Unity é nulo após a chamada do inicializador. |
105 | Não foi possível mostrar os anúncios do Unity porque o anúncio não estava pronto. |
106 | O UnityAds chamou um callback de posição alterada com o estado de posição kUnityAdsPlacementStateNoFill. |
107 | O UnityAds chamou um callback de posição alterada com o estado de posição kUnityAdsPlacementStateDisabled. |
108 | Um anúncio já foi carregado para esse posicionamento. O SDK do UnityAds não oferece suporte ao carregamento de vários anúncios para a mesma posição. |
Registro de alterações do adaptador de mediação do Flutter do Unity Ads
Versão 1.1.0
- Compatibilidade verificada com a versão 4.12.3.0 do adaptador Unity Android
- Compatibilidade verificada com a versão 4.12.3.1 do adaptador Unity para iOS
- Criado e testado com a versão 5.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
Versão 1.0.0
- Versão inicial.
- Compatibilidade verificada com a versão 4.10.0.0 do adaptador Unity Android
- Compatibilidade verificada com o adaptador Unity para iOS versão 4.10.0.0
- Criado e testado com o plug-in de anúncios para dispositivos móveis do Google para Flutter versão 5.0.0.