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 do Unity Ads usando Mediação da AdMob, 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 e o adaptador do 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 da API 24 ou mais recente.

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

• Mais recente 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 Projects e clique em New.

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

Acesse Unity Ads Monetization e clique em Get started.

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úncios e clique em Next.

Selecione a configuração do canal e clique em Next.

Preencha o formulário e clique em Add project.

Anote o Game ID.

Criar blocos de anúncios e canais

Acesse Unity Ads Monetization > Placements, selecione seu projeto e clique em Adicionar bloco de anúncios.

Insira um bloco de anúncios, selecione sua Platform e formato do anúncio.

Por fim, clique em Add ad unit para salvar o bloco de anúncios e o canal.

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, configure um arquivo app-ads.txt para seu app.

Para implementar o app-ads.txt no Unity Ads, consulte 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.

Você pode forçar o modo de teste para seu app clicando no botão de edição ao lado de Google Play Store , ativando Override client test mode e selecionando Force test mode ON (i.e. use test ads) for all devices.

Como alternativa, você pode ativar o modo de teste para dispositivos específicos clicando em Add Test Device.

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

Etapa 2: configurar a demanda do Unity Ads na interface da AdMob

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

Adicione o Unity Ads à configuração de mediação do seu bloco de anúncios.

Faça login na sua conta do AdMob. Navegue até a guia Mediação. Caso queira modificar um grupo de mediação, clique no nome dele para editar e pule para Adicionar o Unity Ads como uma origem de anúncios.

Para criar um novo grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio, depois clique em Continuar.

Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.

Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios da AdMob. Em seguida, clique em Concluído.

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar o Unity Ads como uma origem de anúncios

Lances

No card Lances da seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione Unity Ads.

Clique em Como assinar um contrato de parceria e estabeleça uma parceria de lances com o Unity Ads.



Clique em Confirmar e concordar e em Continuar.



Se você já tiver um mapeamento para o Unity Ads, selecione-o. Caso contrário, clique em Adicionar mapeamento.



Em seguida, insira o Game ID e Placement ID obtidos na seção anterior. Em seguida, clique em Concluído.

Cascata

No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.

Selecione Unity Ads e ative a chave Otimizar. Insira a API Key e o Organization core ID obtidos na seção anterior para configurar a otimização da origem de anúncios para o Unity Ads. Em seguida, insira um valor de eCPM para o Unity Ads e clique em Continuar.



Se você já tiver um mapeamento para o Unity Ads, selecione-o. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o Game ID e o Placement ID obtidos na seção anterior. Em seguida, clique em Concluído.

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 Unity Ads à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface da AdMob.

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.25.0-beta01")
    implementation("com.unity3d.ads:unity-ads:4.16.5")
    implementation("com.google.ads.mediation:unity:4.17.0.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.25.0-beta01'
    implementation 'com.unity3d.ads:unity-ads:4.16.5'
    implementation 'com.google.ads.mediation:unity:4.17.0.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 do SDK mais recente do Unity Ads (unity-ads.aar) no repositório do GitHub e adicione-o 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 para o 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 Conformidade 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

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 na sua cadeia de mediação que possa participar da venda de informações pessoais e siga as orientações de cada uma dessas redes 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 para o SDK do Unity Ads manualmente, recomendamos que esse código seja chamado antes de solicitar anúncios por meio de 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 Conformidade com a Lei de Privacidade do Consumidor da Califórnia do 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 de anúncios.

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