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 do 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:

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

Por fim, clique em Criar para salvar o bloco de anúncios.

Adicionar um canal

Localizar a chave da API Unity Ads Reporting

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.

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 do bloco de anúncios

Adicionar Unity Ads à 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 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 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

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:

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

GADMAdapterUnity
GADMediationAdapterUnity

Confira os códigos e as mensagens enviadas pelo adaptador UnityAds quando um anúncio não é carregado:

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 Android do Unity
• 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.