Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da LINE Ads Network usando a mediação, incluindo integrações em hierarquia. Ele explica como adicionar a LINE Ads Network à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da LINE Ads Network a um app Flutter.
Integrações e formatos de anúncio aceitos
O adaptador de mediação do Ad Manager para a rede de anúncios do LINE tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | |
| Cascata | |
| Formatos | |
| Banner | |
| Intersticial | |
| Premiado | |
| Nativo | 1 |
1 Os anúncios nativos (para lances) estão em Beta fechado. Entre em contato com seu gerente de contas para pedir acesso.
Requisitos
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Flutter 3.7.0 ou versão mais recente
- Para implantar no Android:
- API Android nível 23 ou mais recente.
- Para implantar no iOS:
- Destino de implantação do iOS 12.0 ou mais recente.
- Um projeto do Flutter em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Leia todo o guia para iniciantes da mediação.
Etapa 1: definir as configurações na interface da LINE Ads Network
Inscreva-se e faça login na sua conta da rede de publicidade LINE.
Adicionar um novo aplicativo
Clique em 広告枠管理 (Gerenciamento de espaço do anúncio) > メディア (Mídia). Em seguida, clique em 新規作成 (Criar novo).
Preencha o formulário e clique em 登録 (Registrar).
Anote o ID do aplicativo.
Criar uma posição de anúncio
Clique no ID do aplicativo em que você quer adicionar uma posição de anúncio. Em seguida, selecione 詳細 (Detalhes).
Clique em スロット 追加 (Adicionar espaço).
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 cascata ou Lances do SDK do Google para configurar este slot para lances. Clique em 登録 (Registrar) depois de preencher o formulário.
Anote o ID do slot.
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 LINE Ads Network, consulte
Sobre o app-ads.txt.
Etapa 2: configurar a demanda da LINE 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 LINE Ads Network
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 do LINE ao arquivo pubspec.yaml do pacote:
dependencies:
gma_mediation_line: ^
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 anúncios do LINE, 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 do LINE.
iOS
Integração da SKAdNetwork
Siga a documentação da rede de anúncios do LINE
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 do LINE, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Rede de anúncios do LINE (hierarquia).
Etapas opcionais
Parâmetros específicos da rede
O plug-in de mediação do Flutter da rede de anúncios da LINE é 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 para 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 LINE 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 LINE 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 LINE Ads Network retornou um erro específico do SDK. Consulte a documentação da rede de anúncios do LINE 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 LINE 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 rede de anúncios do LINE 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 rede de publicidade da LINE. | O SDK da LINE Ads Network retornou um erro específico do SDK. Consulte a documentação da rede de anúncios do LINE 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 LINE 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 mudanças do adaptador de mediação do Flutter da Line
Versão 1.0.4 (em andamento)
Versão 1.0.3
- Compatível com a versão 2.9.20250519.0 do adaptador do Android do Line.
- Compatível com a versão 2.9.20250512.0 do adaptador iOS do Line.
- Criado e testado com a versão 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.
Versão 1.0.2
- 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 6.0.0 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.
Versão 1.0.1
- Compatível com a versão 2.9.20250110.1 do adaptador do Android do Line.
- 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 Flutter dos anúncios para dispositivos móveis do Google.
Versão 1.0.0
- Versão inicial.
- 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 5.3.1 do plug-in do Flutter dos anúncios para dispositivos móveis do Google.