Este guia mostra como usar Google Mobile Ads Unity Plugin para carregar e exibir anúncios da LY Ads Network usando a mediação, incluindo integrações em hierarquia. Ele explica como adicionar a LY Ads Network à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da LY Ads Network a um app Unity.
Integrações e formatos de anúncio aceitos
O adaptador de mediação do Ad Manager para LY Ads Network tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Banner | |
| Intersticial | |
| Premiado | |
Requisitos
- Mais recentes de Google Mobile Ads Unity Plugin
- Unity 4 ou versões mais recentes
- [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 SDK da rede de anúncios da LY 1.5.0 ou mais recente (recomendamos usar a última versão).
- Para implantar no Android
- API Android nível da API 23 ou mais recente
- Para implantar no iOS
- Destino de implantação do iOS 13.3 ou mais recente.
- Um projeto do Unity em funcionamento configurado com Google Mobile Ads Unity Plugin. Consulte Configurar Google Mobile Ads Unity Plugin para mais detalhes.
- Configure a mediação.
Etapa 1: definir as configurações na interface da rede de anúncios da LY
Inscreva-se e faça login na sua conta da LY Ads Network.
Adicionar um novo aplicativo
Navegue até a guia App e clique no botão Novo registro.
Preencha o formulário e clique em registro.
Anote o ID do app.
Android
iOS
Criar um espaço do anúncio
Na guia App, selecione seu app para conferir os detalhes dele. Na seção Slot, clique em Adicionar.
Preencha o formulário para saber mais sobre o horário. Em Tipo de lance, selecione Padrão para configurar este slot para mediação em hierarquia ou Lances do SDK do Google para configurar este slot para lances. Clique em Criar depois de preencher o formulário.
Anote o ID do slot.
Depois de criar o primeiro slot, clique em Analisar na página de detalhes do app para receber a aprovação da rede de anúncios da LY. Isso pode levar algum tempo. Entre em contato com seu representante da rede de anúncios da LY se tiver alguma dúvida.
Criar uma chave da API Reporting
Navegue até a guia Gerenciar chaves da API Reporting e clique no botão Criar chave de API.
Preencha o formulário e clique em Salvar.
Anote o ID da chave de API e o secret da chave de API.
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 na LY Ads Network, consulte Sobre o app-ads.txt.
Etapa 2: configurar a demanda da rede de anúncios da LY 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.
Etapa 3: importar o SDK e o adaptador da rede de anúncios da LY
OpenUPM-CLI
Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação da rede de anúncios LY do Google Mobile Ads para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:
openupm add com.google.ads.mobile.mediation.lineOpenUPM
No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do gerenciador de pacotes do Unity.
Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:
- Nome:
OpenUPM - URL:
https://package.openupm.com - Escopos:
com.google
Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.
Selecione o pacote Mediação de linha do Google Mobile Ads e clique em Instalar.
Pacote do Unity
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 a rede de anúncios da LY usando o link de download no Changelog e extraia o GoogleMobileAdsLineMediation.unitypackage do arquivo ZIP.
No editor do projeto do Unity, selecione Assets > Import Package >
Custom Package e encontre o arquivo
GoogleMobileAdsLineMediation.unitypackage
que você baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.
Em seguida, selecione Recursos > Gerenciador de dependências externas >
Resolvedor do Android > Resolução forçada. A biblioteca do External Dependency Manager
vai realizar a resolução de dependências do zero e copiar as
dependências declaradas no diretório Assets/Plugins/Android do seu
app Unity.
Etapa 4: adicionar o código necessário
Android
Nenhum código adicional é necessário para a integração da rede de anúncios da LY.
iOS
Integração da SKAdNetwork
Siga a documentação da rede de anúncios da LY
para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.
Etapa 5: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste no Ad Manager.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da rede de anúncios da LY, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios da rede de anúncios da LY.
Etapas opcionais
Parâmetros específicos da rede
O plug-in de mediação da LY Ads Network Unity é compatível com o seguinte
parâmetro de solicitação adicional, que pode ser transmitido ao adaptador pela classe
LineMediationExtras:
-
SetEnableAdSound(boolean): especifica o estado inicial de som padrão dos anúncios de banner, intersticiais e premiados.
Confira um exemplo de código para criar uma solicitação de anúncio que define esses parâmetros:
using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...
var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);
Códigos de erro
Se o adaptador não receber um anúncio da rede de publicidade da LY,
os editores poderão verificar o erro subjacente na resposta do anúncio usando
ResponseInfo nas seguintes classes:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
Confira os códigos e as mensagens geradas pelo adaptador da LY Ads Network quando um anúncio não é carregado:
Android
| Código do erro | Domínio | Motivo |
|---|---|---|
| 1-10 | com.five_corp.ad | O SDK da rede de publicidade LY retornou um erro específico do SDK. Consulte a documentação da rede de anúncios da LY para mais detalhes. |
| 101 | com.google.ads.mediation.line | O ID do aplicativo está ausente ou é inválido. |
| 102 | com.google.ads.mediation.line | O ID do slot está ausente ou é inválido. |
| 103 | com.google.ads.mediation.line | O tamanho de anúncio solicitado não corresponde a um tamanho de anúncio de banner compatível com a rede de anúncios da LY. |
| 104 | com.google.ads.mediation.line | Falha ao carregar um anúncio intersticial ou premiado devido à falta de contexto de atividade. |
| 105 | com.google.ads.mediation.line | O SDK da rede de anúncios LY não conseguiu mostrar um anúncio intersticial ou premiado. |
| 106 | com.google.ads.mediation.line | Não foi possível carregar um anúncio nativo devido à ausência de recursos. |
iOS
| Código do erro | Domínio | Motivo |
|---|---|---|
| 1-10 | Enviado pelo SDK da LY Ads Network. | O SDK da rede de publicidade LY retornou um erro específico do SDK. Consulte a documentação da rede de anúncios da LY para mais detalhes. |
| 101 | com.google.ads.mediation.line | Parâmetros de servidor inválidos (por exemplo, ID do aplicativo ou ID do slot ausente). |
| 102 | com.google.ads.mediation.line | O tamanho de anúncio solicitado não corresponde a um tamanho de anúncio de banner compatível com a rede de anúncios da LY. |
| 103 | com.google.ads.mediation.line | Não foi possível carregar um recurso de imagem de ícone de informações em um anúncio nativo. |
Registro de mudanças do plug-in de mediação da Line Unity
Versão 2.1.0
- Compatível com a versão 3.1.0.0 do adaptador do Android da Line.
- Compatível com a versão 3.0.1.0 do adaptador do Line para iOS.
- Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.0.2
- Compatível com a versão 3.0.1.1 do adaptador do Line para Android.
- Compatível com a versão 3.0.1.0 do adaptador do Line para iOS.
- Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.0.1
- Compatível com a versão 3.0.1.1 do adaptador do Line para Android.
- Compatível com a versão 3.0.0.1 do adaptador do iOS do Line.
- Criado e testado com a versão 11.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 2.0.0
- Compatível com a versão 3.0.1.0 do adaptador do Android do Line.
- Compatível com a versão 3.0.0.0 do adaptador do Line para iOS.
- Criado e testado com a versão 10.7.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.10
- Suporte para a versão 2.9.20251028.0 do adaptador Line Android.
- Compatível com a versão 2.9.20251119.0 do adaptador do iOS do Line.
- Criado e testado com a versão 10.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.9
- Suporte para a versão 2.9.20251028.0 do adaptador Line Android.
- Compatível com a versão 2.9.20250930.0 do adaptador do Line para iOS.
- Criado e testado com a versão 10.6.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.8
- Compatível com a versão 2.9.20250924.1 do adaptador Line Android.
- Compatível com a versão 2.9.20250930.0 do adaptador do Line para iOS.
- Criado e testado com a versão 10.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.7
- Compatível com a versão 2.9.20250924.0 do adaptador do Android da Line.
- Compatível com a versão 2.9.20250912.0 do adaptador do Line para iOS.
- Criado e testado com a versão 10.5.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.6
- Compatível com a versão 2.9.20250718.0 do adaptador Android do Line.
- Compatível com a versão 2.9.20250512.0 do adaptador do Line para iOS.
- Criado e testado com a versão 10.3.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.5
- Correção de um problema em que a instalação pelo OpenUPM fazia com que o plug-in não importasse os pacotes corretamente.
Versão 1.5.4
- Compatível com a versão 2.9.20250519.0 do adaptador do Line para Android.
- Compatível com a versão 2.9.20250512.0 do adaptador do Line para iOS.
- Criado e testado com a versão 10.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.3
- O plug-in do Unity agora é criado com o SDK do Android 35.
- Compatibilidade com a versão 2.9.20250317.1 do adaptador do Android do Line.
- Compatível com a versão 2.9.20241106.3 do adaptador do iOS do Line.
- Criado e testado com a versão 10.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.2
- Suporte para a versão 2.9.20250110.0 do adaptador Line Android.
- Compatível com a versão 2.9.20241106.2 do adaptador do iOS do Line.
- Criado e testado com a versão 10.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.5.1
- Suporte para a versão 2.9.20250110.0 do adaptador Line Android.
- Compatível com a versão 2.9.20241106.1 do adaptador do Line para iOS.
- Criado e testado com a versão 9.5.0 do plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.
Versão 1.5.0
- Compatível com a versão 2.9.20241129.0 do adaptador do Android para Line.
- Compatível com a versão 2.9.20241106.1 do adaptador do Line para iOS.
- Criado e testado com a versão 9.5.0 do plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.
Versão 1.4.0
- Compatibilidade com a versão 2.8.20240827.0 do adaptador Line Android.
- Compatível com a versão 2.9.20241106.1 do adaptador do Line para iOS.
- Criado e testado com a versão 9.4.0 do Plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.
Versão 1.3.1
- Compatível com a versão 2.8.20240808.0 do adaptador do Android do Line.
- Compatível com a versão 2.8.20240612.0 do adaptador do Line para iOS.
- Criado e testado com a versão 9.2.0 do plug-in de anúncios para dispositivos móveis do Google para Unity.
Versão 1.3.0
- Compatibilidade com a versão 2.8.20240722.0 do adaptador do Line para Android.
- Compatível com a versão 2.8.20240612.0 do adaptador do Line para iOS.
- Criado e testado com a versão 9.2.0 do plug-in de anúncios para dispositivos móveis do Google para Unity.
Versão 1.2.0
- Compatibilidade com a versão 2.7.20240515.0 do adaptador do Android do Line.
- Compatível com a versão 2.8.20240612.0 do adaptador do Line para iOS.
- Criado e testado com a versão 9.1.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.1.2
- Compatibilidade com a versão 2.7.20240515.0 do adaptador do Android do Line.
- Compatível com a versão 2.7.20240411.0 do adaptador do Line para iOS.
- Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.1.1
- Compatível com a versão 2.7.20240214.1 do adaptador do Android da Line.
- Compatível com a versão 2.7.20240411.0 do adaptador do Line para iOS.
- Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.1.0
- Adicionamos a classe
LineMediationExtrascom os seguintes métodos para oferecer suporte à transmissão de extras de mediação.SetEnabledAdSound(bool)
- Compatível com a versão 2.7.20240214.1 do adaptador do Android da Line.
- Compatível com a versão 2.7.20240318.0 do adaptador Line iOS.
- Criado e testado com a versão 9.0.0 do plug-in dos Anúncios para Dispositivos Móveis do Google para Unity.
Versão 1.0.0
- Versão inicial.
- Compatível com a versão 2.6.20230607.0 do adaptador do Line para Android.
- Compatível com a versão 2.6.20230609.0 do adaptador do Line para iOS.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.5.1.