Este guia mostra como usar Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da LY Ads Network usando 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 Flutter.
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 | |
| Nativo | |
Requisitos
- Mais recente Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 ou versão mais recente
- Para implantação no Android
- API Android nível da API 23 ou mais recente
- Para implantação no iOS
- Destino de implantação do iOS 13.3 ou mais recente
- Um projeto do Flutter em funcionamento configurado com Google Mobile Ads Flutter Plugin. Consulte Configurar Google Mobile Ads Flutter Plugin para mais detalhes.
- Configurar a mediação.
Etapa 1: definir as configurações na interface da LY Ads Network
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 New registration.
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 Add.
Preencha o formulário com detalhes sobre o bloco. Em Bidding Type, selecione Standard para configurar esse bloco para mediação em hierarquia ou Google SDK Bidding para configurar esse bloco para Lances do SDK. Clique em Create depois de preencher o formulário.
Anote o ID do bloco.
Depois de criar seu primeiro bloco, clique em Review na página de detalhes do app para receber a aprovação da LY Ads Network. Isso pode levar algum tempo. Entre em contato com seu representante da LY Ads Network se tiver alguma dúvida.
Criar uma chave da API Reporting
Navegue até a guia Managing reporting API keys e clique no botão Create API key.
Preencha o formulário e clique em Save.
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 app-ads.txt na LY Ads Network, consulte
Sobre o app-ads.txt.
Etapa 2: configurar a demanda da LY Ads Network 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 LY Ads Network
Integração pelo pub.dev
Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador da LY Ads Network no arquivo pubspec.yaml do pacote:
dependencies:
gma_mediation_line: ^2.1.0
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
LY Ads Network,
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 LY Ads Network.
iOS
Integração da SKAdNetwork
Siga a documentação da LY Ads Network
para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.
Etapa 5: testar a implementação
Ativar anúncios de teste
Certifique-se de registrar seu dispositivo de teste para Ad Manager.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da LY Ads Network, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios LY Ads Network.
Etapas opcionais
Parâmetros específicos da rede
O plug-in de mediação do Flutter da LY Ads Network oferece suporte ao seguinte parâmetro de solicitação adicional, que pode ser transmitido ao adaptador pela classe LineMediationExtras:
-
enableAdSound: especifica o estado de início do som padrão de 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 LY Ads Network,
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 LY Ads Network retornou um erro específico do SDK. Consulte a documentação da LY Ads Network para mais detalhes. |
| 101 | com.google.ads.mediation.line | ID do aplicativo ausente ou inválido. |
| 102 | com.google.ads.mediation.line | ID do bloco 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 LY Ads Network. |
| 104 | com.google.ads.mediation.line | Não foi possível carregar um anúncio intersticial ou premiado devido à falta de contexto de atividade. |
| 105 | com.google.ads.mediation.line | O SDK da LY Ads Network 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. |
iOS
| Código do erro | Domínio | Motivo |
|---|---|---|
| 1-10 | Enviado pelo SDK da LY Ads Network | O SDK da LY Ads Network 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 bloco 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 LY Ads Network. |
| 103 | com.google.ads.mediation.line | Não foi possível carregar um recurso de imagem de ícone de informações no anúncio nativo. |
Registro de alterações do adaptador de mediação do Flutter da Line
Versão 2.1.1 (em andamento)
Versão 2.1.0
- Versão mínima do Flutter atualizada para 3.38.1
- Atualizado para oferecer suporte ao plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 8.0.0
- Oferece suporte ao adaptador do Android da Line versão 3.1.0.0.
- Oferece suporte ao adaptador do iOS da Line versão 3.0.1.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 8.0.0
Versão 2.0.0
- Versão mínima do Flutter atualizada para 3.35.1
- Atualizado para oferecer suporte ao plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 7.0.0
- Oferece suporte ao adaptador do Android da Line versão 3.0.1.0.
- Oferece suporte ao adaptador do iOS da Line versão 3.0.0.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 7.0.0
Versão 1.0.6
- Oferece suporte ao adaptador do Android da Line versão 2.9.20251028.0.
- Oferece suporte ao adaptador do iOS da Line versão 2.9.20251119.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 6.0.0
Versão 1.0.5
- Oferece suporte ao adaptador do Android da Line versão 2.9.20250924.1.
- Oferece suporte ao adaptador do iOS da Line versão 2.9.20250930.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 6.0.0
Versão 1.0.4
- Oferece suporte ao adaptador do Android da Line versão 2.9.20250718.0.
- Oferece suporte ao adaptador do iOS da Line versão 2.9.20250512.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 6.0.0
Versão 1.0.3
- Oferece suporte ao adaptador do Android da Line versão 2.9.20250519.0.
- Oferece suporte ao adaptador do iOS da Line versão 2.9.20250512.0.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 6.0.0
Versão 1.0.2
- Oferece suporte ao adaptador do Android da Line versão 2.9.20250317.1.
- Oferece suporte ao adaptador do iOS da Line versão 2.9.20241106.3.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 6.0.0
Versão 1.0.1
- Oferece suporte ao adaptador do Android da Line versão 2.9.20250110.1.
- Oferece suporte ao adaptador do iOS da Line versão 2.9.20241106.2.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.3.1.
Versão 1.0.0
- Versão inicial.
- Oferece suporte ao adaptador do Android da Line versão 2.9.20250110.0.
- Oferece suporte ao adaptador do iOS da Line versão 2.9.20241106.1.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Flutter versão 5.3.1.