Este guia mostra como usar o Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da rede de publicidade LY usando a mediação, incluindo integrações em hierarquia. Ele explica como adicionar a rede de publicidade 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 Flutter.
Integrações e formatos de anúncio aceitos
O adaptador de mediação do Ad Manager para a LY Ads Network tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Banner | |
| Intersticial | |
| Premiado | |
| Nativo | |
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 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.
Etapa 1: definir as configurações na interface da rede de publicidade LY Ads
Crie uma conta e faça login na 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 registration.
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 esse espaço para mediação em hierarquia ou Lances do SDK do Google para configurar esse espaço para lances. Clique em Criar depois de preencher o formulário.
Anote o ID do slot.
Depois de criar o primeiro espaço, clique em Revisar na página de detalhes do app para receber a aprovação da rede de publicidade LY. Isso pode levar algum tempo. Entre em contato com seu representante da rede de publicidade LY se tiver alguma dúvida.
Criar uma chave de API Reporting
Acesse a guia Gerenciar chaves de API de relatórios 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 segredo 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 publicidade da LY na interface do Ad Manager
Definir as configurações de mediação do bloco de anúncios
Android
Para ver as 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 publicidade LY Ads
Integração pelo pub.dev
Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador da rede de anúncios da LY ao arquivo pubspec.yaml do pacote:
dependencies:
gma_mediation_line: ^2.2.1
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 a
rede de publicidade LY,
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_line:
path: path/to/local/package
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 publicidade LY para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu 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 publicidade LY, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios da rede de publicidade LY.
Etapas opcionais
Parâmetros específicos da rede
O plug-in de mediação do Flutter da rede LY Ads é compatível com o seguinte
parâmetro de solicitação adicional, que pode ser transmitido ao adaptador pela classe
LineMediationExtras:
-
enableAdSound: especifica o estado inicial de som padrão dos anúncios de banner, intersticiais e premiados.
Confira um exemplo de código de como criar uma solicitação de anúncio que define esses parâmetros:
LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [lineExtras],
);
Códigos de erro
Se o adaptador não receber um anúncio da rede de publicidade LY,
os publishers poderão verificar o erro 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 rede de publicidade 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 Ads retornou um erro específico do SDK. Consulte a documentação da LY Ads Network 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 espaço 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 aceito pela rede de publicidade LY. |
| 104 | com.google.ads.mediation.line | Falha ao carregar um anúncio intersticial ou premiado devido à falta de contexto da atividade. |
| 105 | com.google.ads.mediation.line | O SDK da rede de publicidade 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 à falta de recursos. |
| 107 | com.google.ads.mediation.line | O SDK da FiveAd retornou um carregador de anúncios nulo. |
iOS
| Código do erro | Domínio | Motivo |
|---|---|---|
| 1-10 | Enviado pelo SDK da rede de publicidade LY. | O SDK da rede de publicidade LY Ads retornou um erro específico do SDK. Consulte a documentação da LY Ads Network 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 | Falha ao carregar um recurso de imagem do ícone de informações no anúncio nativo. |
| 104 | com.google.ads.mediation.line | Não foi possível coletar indicadores para lances. |
| 105 | com.google.ads.mediation.line | Falha ao inicializar o carregador de anúncios do SDK de anúncio da LINE Ads. |
Registro de alterações do adaptador de mediação do Flutter da Line
Versão 2.2.2 (em andamento)
- Agora requer a versão mínima 15.0 do iOS.
Versão 2.2.1
- Compatível com a versão 3.1.1.2 do adaptador do Line para Android.
- Compatível com a versão 3.1.1.0 do adaptador do Line para iOS.
- Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
Versão 2.2.0
- Compatível com a versão 3.1.1.1 do adaptador Line Android.
- Compatível com a versão 3.1.0.0 do adaptador do Line para iOS.
- Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
Versão 2.1.3
- Atualizamos para oferecer suporte à versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.
- Adicionamos suporte ao Gerenciador de pacotes do Swift.
- Compatível com a versão 3.1.1.1 do adaptador Line Android.
- Compatível com a versão 3.0.1.2 do adaptador do Line para iOS.
- Criado e testado com a versão 9.1.0 do plug-in do Google Mobile Ads para Flutter.
Versão 2.1.2
- Compatível com a versão 3.1.1.1 do adaptador do Line para Android.
- Compatível com a versão 3.0.1.2 do adaptador do Line para iOS.
- Criado e testado com a versão 9.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 2.1.1
- Compatível com a versão 3.1.1.0 do adaptador do Line para Android.
- Compatível com a versão 3.0.1.2 do adaptador do Line para iOS.
- Criado e testado com a versão 9.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 2.1.0
- Atualizamos a versão mínima do Flutter para 3.38.1
- Atualização para oferecer suporte à versão 8.0.0 do plug-in do Google Mobile Ads para Flutter
- Compatível com a versão 3.1.0.0 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 8.0.0 do plug-in do Google Mobile Ads para Flutter
Versão 2.0.0
- Atualizamos a versão mínima do Flutter para 3.35.1.
- Atualizado para oferecer suporte à versão 7.0.0 do plug-in do Google Mobile Ads para Flutter.
- Compatível com a versão 3.0.1.0 do adaptador do Android do Line.
- Compatibilidade com a versão 3.0.0.0 do adaptador do Line para iOS.
- Criado e testado com a versão 7.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.0.6
- Compatível com a versão 2.9.20251028.0 do adaptador do LINE para Android.
- Compatível com a versão 2.9.20251119.0 do adaptador do Line para iOS.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.0.5
- Compatível com a versão 2.9.20250924.1 do adaptador do Android da Line.
- Compatível com a versão 2.9.20250930.0 do adaptador do Line para iOS.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.0.4
- Compatível com a versão 2.9.20250718.0 do adaptador do Android do Line.
- Compatível com a versão 2.9.20250512.0 do adaptador do iOS do Line.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter
Versão 1.0.3
- 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 6.0.0 do plug-in do Google Mobile Ads para Flutter.
Versão 1.0.2
- Compatível 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 da Line.
- Criado e testado com a versão 6.0.0 do plug-in do Google Mobile Ads para Flutter
Versão 1.0.1
- Compatível com a versão 2.9.20250110.1 do adaptador do Line para Android.
- Compatível com a versão 2.9.20241106.2 do adaptador do Line para iOS.
- Criado e testado com a versão 5.3.1 do plug-in do Google Mobile Ads para Flutter.
Versão 1.0.0
- Versão inicial.
- Compatível com a versão 2.9.20250110.0 do adaptador do Line para Android.
- Compatível com a versão 2.9.20241106.1 do adaptador do Line para iOS.
- Criado e testado com a versão 5.3.1 do plug-in dos anúncios para dispositivos móveis do Google para Flutter.