Integrar o Unity Ads com a mediação

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

Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios da Unity Ads usando a mediação, incluindo integrações de lances e em hierarquia. Ele explica como adicionar a Unity Ads à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da Unity Ads a um app Android.

Integrações e formatos de anúncio aceitos

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

Requisitos

• API Android nível 24 ou mais recente.

• [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o adaptador da Unity 4.16.0.1 ou uma versão mais recente (recomendamos usar a última versão).

• Mais recentes de GMA Next-Gen SDK

• Leia todo o guia para iniciantes da 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 Projetos e clique em Novo.

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

Acesse Monetização do Unity Ads e clique em Começar.

No modal New Project, selecione I will use Mediation e Google Admob para Mediation Partner e clique em Next.

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

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

Preencha o formulário e clique em Adicionar projeto.

Anote o ID do jogo.

Criar blocos de anúncios e posições

Acesse Monetização do Unity Ads > Canais, selecione seu projeto e clique em Adicionar bloco de anúncios.

Insira um Nome do bloco de anúncios e selecione sua Plataforma e o Formato do anúncio.

Acesse Monetização > Canais 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.

Selecione Hierarquia para a Configuração. Em Posicionamento, insira o Nome do posicionamento, a Geomarcação e o Destino.

Anote o ID da posição.

Por fim, clique em Adicionar bloco de anúncios para salvar o bloco e o posicionamento.

Localizar a chave de API Reporting do Unity Ads

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 no 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 Monetização do Unity Ads > Testes.

Para forçar o modo de teste no seu app, clique no botão de edição ao lado de Google Play Store , 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) em todos os dispositivos.

Você também 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 do Unity Ads na interface do Ad Manager

Faça login na sua conta do Ad Manager.

Adicionar o Unity Ads em "Empresas"

Ativar o compartilhamento de indicador seguro

Compartilhar indicadores seguros em solicitações de lance

Permitir o compartilhamento de indicadores seguros para Lances do SDK

Configurar os lances da Unity Ads

Configurar o mapeamento de blocos de anúncios

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 com o Android Studio (recomendada)

No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.unity3d.ads:unity-ads:4.16.5")
    implementation("com.google.ads.mediation:unity:4.16.6.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.unity3d.ads:unity-ads:4.16.5'
    implementation 'com.google.ads.mediation:unity:4.16.6.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integração manual

1. Faça o download da versão mais recente do SDK do Unity Ads (unity-ads.aar) no repositório do GitHub e adicione ao seu projeto.

2. Navegue até os artefatos do adaptador do Unity Ads no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador do Unity Ads e adicione-o ao projeto.

Etapa 4: implementar configurações de privacidade no SDK do Unity Ads

Consentimento para a UE e o GDPR

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer determinadas declarações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça, além de receber o consentimento deles para o uso de cookies ou outros armazenamentos locais quando exigido por lei e para a coleta, o compartilhamento e o uso de dados pessoais para a 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. O Google não consegue transmitir automaticamente a escolha de consentimento do usuário para essas redes.

Na versão 2.0.0 do SDK, o Unity Ads adicionou uma API para oferecer suporte às configurações de privacidade. O exemplo de código a seguir mostra como transmitir essas informações de consentimento para o SDK do Unity Ads. Se você optar por transmitir informações de consentimento ao SDK do Unity Ads manualmente, recomendamos que esse código seja chamado antes de solicitar anúncios pelo GMA Next-Gen SDK.

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
UnityAdsMediationSnippets.java

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
UnityAdsMediationSnippets.kt

Consulte a página de conformidade com a GDPR da Unity Ads para mais detalhes e os valores que podem ser fornecidos em cada método.

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.

Na versão 2.0.0 do SDK, o Unity Ads adicionou uma API para oferecer suporte às configurações de privacidade. O exemplo de código a seguir mostra como transmitir essas informações de consentimento para o SDK do Unity Ads. Se você optar por transmitir informações de consentimento ao SDK da Unity Ads manualmente, recomendamos que esse código seja chamado antes de solicitar anúncios pelo GMA Next-Gen SDK.

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
UnityAdsMediationSnippets.java

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
UnityAdsMediationSnippets.kt

Consulte a conformidade com a Lei de Privacidade do Consumidor da Unity Ads para mais detalhes e os valores que podem ser fornecidos em cada método.

Etapa 5: adicionar o código necessário

Carregar o anúncio com o contexto da atividade

Transmita o contexto Activity ao carregar formatos de anúncio de banner, intersticial e nativo. Sem informações sobre a atividade, haverá falha no carregamento.

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 da 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 da Unity Ads, os editores poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo.getAdSourceResponses() nas seguintes classes:

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

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