Integrar o Unity Ads com a mediação

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

Este guia mostra como usar o Google Mobile Ads Flutter Plugin para carregar e exibir anúncios do Unity Ads com a mediação, incluindo integrações de lances e em hierarquia. Ele explica como adicionar o Unity Ads à configuração de mediação de um bloco de anúncios e como integrar o SDK de anúncio e o adaptador do Unity Ads a um app Flutter.

Integrações e formatos de anúncio aceitos

O adaptador de mediação do Ad Manager para o Unity Ads tem os seguintes recursos:

Integração
Lances
Cascata  1
Formatos
Banner
Intersticial
Premiado

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads Flutter Plugin.
  • Versão 3.7.0 ou mais recente do framework do Flutter.
  • [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o plug-in de mediação dos anúncios para dispositivos móveis do Google para o Unity Ads 1.1.0 ou mais recente (recomendamos usar a versão mais recente).
  • Para implantar no Android
    • API Android nível 24 ou mais recente.
  • Para implantar no iOS
    • Destino de implantação do iOS 13.0 ou mais recente.
  • Um projeto do Flutter em funcionamento configurado com Google Mobile Ads Flutter Plugin. Consulte Configurar o Google Mobile Ads Flutter Plugin para mais detalhes.
  • Configure a mediação.

    • Etapa 1: definir as configurações na interface do Unity Ads

    Inscreva-se ou faça login no Unity Ads.

    Criar um projeto

    No painel do Unity Ads, acesse Projects e clique em New.

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

    Acesse Unity Ads Monetization e clique em Get started.

    No modal Novo projeto, selecione Vou usar a Mediação e Google AdMob para Parceiro de mediação e clique em Próxima.

    Selecione a opção de configurações de anúncios e clique em Próxima.

    Selecione a configuração de posicionamento e clique em Próxima.

    Lances

    Cascata

    Preencha o formulário e clique em Adicionar projeto.

    Anote o ID do jogo.

    Criar blocos de anúncios e posições

    Acesse Unity Ads Monetization > Placements, selecione seu projeto 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

    Acesse Monetização > Posições 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

    Selecione Hierarquia para a Configuração. Em Posição, insira o Nome da posição, a Segmentação geográfica e o Destino.

    Anote o ID de lugar.

    Por fim, clique em Adicionar bloco de anúncios para salvar o bloco e a posição.

    Localizar a chave de API Reporting do Unity Ads

    Lances

    Essa etapa não é necessária para integrações de lances.

    Cascata

    Acesse Unity Ads Monetization > API management e anote a chave de API em Monetization Stats API Access.

    Em seguida, acesse Unity Ads Monetization > Organization Settings e anote o Organization core ID.

    Atualizar o app-ads.txt

    Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, crie um arquivo app-ads.txt para o Ad Manager.

    Para implementar o app-ads.txt para Unity Ads, consulte como configurar o app-ads.txt pela primeira vez.

    Ativar o modo de teste

    O modo de teste pode ser ativado no painel do Unity Ads. Acesse Unity Ads Monetization > Testing.

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

    Android

    iOS

    Como alternativa, você pode ativar o modo de teste para dispositivos específicos clicando em Adicionar dispositivo de teste.

    Insira os detalhes do dispositivo de teste e clique em Salvar.

    Etapa 2: configurar a demanda de anúncios do Unity Ads na interface do Ad Manager

    Definir 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 instruções, consulte a etapa 2 no guia para iOS.

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

    Siga as etapas em Configurações das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar o Unity Ads à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface do Ad Manager.

    Etapa 3: importar o SDK e o adaptador do Unity Ads

    Integração pelo pub.dev

    Adicione a seguinte dependência com as versões mais recentes do SDK de anúncio e do adaptador da Unity Ads no arquivo pubspec.yaml do seu pacote:

    dependencies:
  gma_mediation_unity: ^1.11.1

    Integração manual

    Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para o 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 configurações de privacidade no SDK de anúncio da Unity

    Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer certas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, e obter o consentimento deles para usar cookies ou outra forma de armazenamento local, quando exigido por lei, e para coletar, compartilhar e usar dados pessoais para personalização de anúncios. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação.

    A versão 1.10.0 e mais recentes do adaptador do Flutter para Unity Ads são compatíveis com a transmissão de indicadores de consentimento do GDPR de plataformas de gestão de consentimento que se integram à Estrutura de Transparência e Consentimento (TCF) do IAB para o SDK de anúncio do Unity Ads. Para mais informações, consulte Definir uma configuração de consentimento da TCF ou não.

    Leis Estaduais de Privacidade dos EUA

    As leis de privacidade dos estados 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). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de conformidade com as leis estaduais de privacidade dos EUA oferece a opção de ativar o tratamento de dados restrito para a veiculação de anúncios do Google, mas não é possível aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, identifique cada rede de publicidade que possa participar da venda de informações pessoais e siga as orientações de cada uma delas 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 a seguir mostra como transmitir informações de consentimento para o SDK de anúncio da Unity. Se você optar por chamar esse método, recomendamos fazer isso antes de solicitar anúncios pelo Google Mobile Ads Flutter Plugin.

    import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

    Definir o tratamento por idade

    A versão 1.6.5 e mais recentes do plug-in de mediação do Unity Ads encaminham a configuração de direcionamento para crianças e a configuração de usuários abaixo da idade de consentimento para o Unity Ads.

    Para processar esses indicadores por usuário, o Unity Ads exige que você ative a designação de Público misto no painel de monetização do Unity. Para mais informações sobre como ativar uma designação de público misto no seu projeto, consulte Definir designações de idade no nível do jogo.

    Etapa 5: adicionar o código necessário

    Android

    Não é necessário nenhum código adicional para as integrações do Unity Ads com o Android.

    iOS

    Integração da SKAdNetwork

    Siga a documentação do Unity Ads (em inglês) para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto.

    Etapa 6: testar a implementação

    Ativar anúncios de teste

    Não se esqueça de registrar seu dispositivo de teste no Ad Manager e ativar o modo de teste na interface do Unity Ads.

    Verificar anúncios de teste

    Para verificar se você está recebendo anúncios de teste da 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 publishers poderão verificar o erro subjacente na 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 correspondentes gerados pelo adaptador do UnityAds quando um anúncio não é carregado:

    Android

    Código do erro Motivo
    0-10 O SDK da UnityAds retornou um erro. Consulte o código para mais detalhes.
    101 Os parâmetros do servidor da UnityAds configurados na interface da AdMob estão ausentes ou são inválidos.
    102 A UnityAds retornou um canal com o estado NO_FILL.
    103 A UnityAds retornou um canal com o estado DESATIVADO.
    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 A UnityAds não é compatível com o dispositivo.
    108 A UnityAds só pode carregar um anúncio por posição de cada vez.
    109 O UnityAds foi concluído com um estado de ERRO.
    110 O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela UnityAds.
    111 A UnityAds retornou um erro de inicialização.
    112 O Unity Ads retornou um token de lance nulo ou vazio.
    200-204 UnityAds Banner: um erro específico. Consulte o código para mais detalhes.

    iOS

    0-9 O SDK da 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 Ad Manager estão ausentes ou são inválidos.
    102 O dispositivo não é compatível com o UnityAds.
    103 A UnityAds terminou de apresentar o estado de erro kUnityAdsFinishStateError.
    104 O objeto de anúncio do Unity é nulo depois de chamar o inicializador.
    105 Falha ao mostrar o Unity Ads porque o anúncio não está pronto.
    107 O UnityAds chamou um callback de mudança de posição com o estado de posição kUnityAdsPlacementStateDisabled.
    108 Um anúncio já foi carregado para essa posição. O SDK da Unity Ads não permite carregar vários anúncios para o mesmo canal.
    109 O anúncio de banner retornado pela UnityAds não corresponde ao tamanho solicitado.
    110 A UnityAds retornou um erro de inicialização.
    111 Formato de anúncio incompatível.
    112 A UnityAds retornou um token de lance nulo ou vazio.

    Registro de alterações do adaptador de mediação do Flutter do Unity Ads

    Versão 1.12.0 (em andamento)

    Versão 1.11.1

    Versão 1.11.0

    Versão 1.10.0

    Versão 1.9.0

    Versão 1.8.1

    Versão 1.8.0

    Versão 1.7.0

    Versão 1.6.5

    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.6.4

    Versão 1.6.3

    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.6.2

    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.6.1

    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.6.0

    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.5.1

    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.5.0

    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.4.1

    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.4.0

    • Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.3.0

    • Criado e testado com a versão 5.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

    Versão 1.2.0

    • Criado e testado com a versão 5.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.

    Versão 1.1.0

    • Criado e testado com a versão 5.2.0 do plug-in do Google Mobile Ads para Flutter.

    Versão 1.0.0

    • Criado e testado com a versão 5.0.0 do plug-in do Google Mobile Ads para Flutter.