Integrar o Unity Ads à mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios da Unity Ads usando mediação, cobrindo integrações em hierarquia. Ela 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 Flutter app.

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

O adaptador de AdMob mediação para a Unity Ads tem os seguintes recursos:

Integração
Lances	^1
Cascata
Formatos
Banner
Intersticial
Premiado

¹ 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 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 Flutter 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 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.

Acesse 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 de anúncios do Unity na AdMob interface

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

Android

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

iOS

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

Adicionar Unity Ads à lista de parceiros de publicidade do GDPR e dos regulamentos estaduais dos EUA

Importante: verifique se você tem a permissão Gerenciamento de conta para concluir a configuração do consentimento para usuários da UE e do GDPR, da CPRA e da plataforma de mensagens do usuário. Consulte Gerenciar o acesso do usuário à sua conta para mais detalhes.

Siga as etapas em Configurações do GDPR e 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

Observação: a falha na integração das versões compatíveis do SDK dos anúncios para dispositivos móveis do Google e do Unity Ads pode causar problemas de build.

Integração pelo pub.dev

Adicione a dependência abaixo com as versões mais recentes do SDK e do adaptadorUnity 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 de anúncios para dispositivos móveis do Google para Unity Ads, extraia o arquivo transferido 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 definição legal desses termos). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" mostrado 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 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.

Importante: desative o modo de teste da AdMob e do Unity Ads antes de lançar o app.

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 um 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	O 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.

Changelog 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 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.