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

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.