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 exibir anúncios do Unity usando a mediação, abrangendo integrações de 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 AdMob adaptador de mediação para anúncios do Unity tem os seguintes recursos:

¹ A integração de lances está na 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:
  • 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 Flutter 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 Unity Ads

Faça login ou inscreva-se no Unity Ads.

Criar um projeto

No Painel do Unity Ads, acesse Projects e clique em Criar projeto.

Preencha o formulário e clique em Criar projeto para adicionar o projeto.

Acesse Monetização > Começar e clique em Começar.

No modal Configuração do projeto, selecione Planejo usar a mediação e Google AdMob para Parceiro de mediação e clique em Próximo.

Selecione suas configurações de anúncios 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

Navegue até 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 do Unity Ads. Nas configurações do projeto, selecione a guia Teste.

Para forçar o modo de teste do app, clique no botão de edição de cada plataforma, marque Substituir modo de teste do cliente e selecione Forçar modo de teste ATIVADO (ou seja, usar anúncios de teste) para todos os dispositivos.

Se preferir, ative 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 dos anúncios do Unity na AdMob interface

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

Adicionar Unity Ads ao GDPR e à lista de parceiros de publicidade das regulamentações estaduais dos EUA

Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar o 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 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 configurações de privacidade no SDK de anúncios do Unity

Consentimento da UE e GDPR

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que algumas divulgações sejam fornecidas aos usuários no Espaço Econômico Europeu (EEE) e que eles tenham o consentimento deles em relação ao uso de identificadores de dispositivos 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 solicitar o consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode coletar, receber ou usar dados pessoais, além de 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 de 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 consentimento de privacidade e APIs de dados da Unity Ads e Conformidade com o GDPR 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 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 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, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode 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 de anúncios para dispositivos móveis do Google para Unity Ads inclui o método GmaMediationUnity.setCCPAConsent() . O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK de anúncios do Unity. Se você optar por chamar esse método, recomendamos que o faça antes de solicitar anúncios por meio do 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

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 classes abaixo:

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

GADMAdapterUnity
GADMediationAdapterUnity

Veja a seguir os códigos e as mensagens correspondentes gerados pelo adaptador do UnityAds quando um anúncio não é carregado:

Registro de alterações do adaptador de mediação do Flutter para anúncios do Unity

Versão 1.1.0

• Compatibilidade verificada com o adaptador do Unity para Android versão 4.12.3.0
• Compatibilidade verificada com a versão 4.12.3.1 do adaptador Unity para iOS.
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.2.0.

Versão 1.0.0

• Versão inicial.
• Compatibilidade verificada com o adaptador do Unity para Android versão 4.10.0.0
• Compatibilidade verificada com o adaptador iOS do Unity versão 4.10.0.0
• Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.0.0.