Integrar a rede de anúncios da LINE à mediação

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 da AdMob, incluindo as 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 Android.

A interface do painel da rede de anúncios do LINE usa texto em japonês para rótulos, botões e descrições. As capturas de tela neste guia não foram traduzidas. No entanto, nas descrições e instruções deste guia, os rótulos e botões são traduzidos com os equivalentes em inglês entre parênteses.

Integrações e formatos de anúncio aceitos

O adaptador de mediação da LINE Ads Network tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo	^1

¹ Os anúncios nativos (para lances) estão em Beta fechado. Entre em contato com seu gerente de contas para pedir acesso.

Requisitos

• API Android nível 23 ou mais recente.

• SDK dos anúncios para dispositivos móveis do Google mais recente

• 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.

Observação: não é possível mudar o フォーマット (Formato) e o Bidding Type depois de registrar o slot. Entre em contato com seu gerente de contas da rede de publicidade LINE para acessar a criação de posições de anúncios nativos na interface da rede de publicidade LINE.

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

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 da AdMob

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

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

Primeiro, faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar a rede de anúncios da LINE como uma origem de anúncios.

Para criar um 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. Clique em Concluído.

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

Adicionar a rede de anúncios da LINE 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 Rede de anúncios do LINE.

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



Clique em Confirmar e concordar e em Continuar.



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



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

Importante: o ID do aplicativo precisa estar associado ao app segmentado, como na interface da LINE Ads Network.

Cascata

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

Selecione Rede de anúncios do LINE e ative a chave Otimizar. Insira o nome de login e a senha obtidos na seção anterior para configurar a otimização da origem de anúncios para a LINE Ads Network. Em seguida, insira um valor de eCPM para a LINE Ads Network e clique em Continuar.

Observação: só é necessário configurar a otimização da origem de anúncios uma vez por rede.

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

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

Importante: o ID do aplicativo precisa estar associado ao app segmentado, como na interface da LINE Ads Network.

Observação: a otimização da origem de anúncios leva alguns dias para coletar dados suficientes e calcular com precisão o eCPM de uma rede de mediação. Enquanto isso, o status da otimização é PENDING. Portanto, você precisa definir manualmente um valor de eCPM para a rede. Depois que o eCPM for calculado, a origem de anúncios começará a atualizá-lo automaticamente em seu nome.

Etapa 3: importar o SDK e o adaptador da LINE Ads Network

Observação: a falha na integração das versões compatíveis do SDK dos anúncios para dispositivos móveis do Google e da rede de anúncios da LINE pode causar problemas de build.

Integração com o Android Studio (recomendada)

No arquivo build.gradle.kts do app, adicione as seguintes dependências e configurações de implementação. Use as versões mais recentes do SDK e do adaptador da LINE Ads Network:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.5.0")
    implementation("com.google.ads.mediation:line:2.9.20250718.0")
}

Integração manual

1. Faça o download da versão mais recente do arquivo .aar do SDK da rede de anúncios do LINE e adicione ao seu projeto.

2. Navegue até os artefatos do adaptador da rede de anúncios da LINE no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador da LINE Ads Network e adicione-o ao projeto.

Etapa 4: adicionar o código necessário

Nenhum código adicional é necessário para a integração da rede de anúncios do LINE.

Etapa 5: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob.

Importante: desative o modo de teste para a AdMob e a LINE Ads Network antes de lançar o app.

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 adaptador da rede de anúncios da LINE é compatível com um parâmetro de solicitação adicional que pode ser transmitido ao adaptador usando a classe LineExtras. Esse construtor de classe inclui os seguintes parâmetros:

enableAdSound

Um boolean para especificar o estado inicial padrão do som de 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:

Java

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

AdRequest request = new AdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter.class, extras)
   .build();

Kotlin

val lineExtras = LineExtras(true)
val extras = lineExtras.build()

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
   .build()

Como usar anúncios nativos

Renderização de anúncios

O adaptador da rede de anúncios do LINE preenche as seguintes descrições de campos avançados de anúncios nativos para um NativeAd.

Campo	Recursos sempre incluídos pelo adaptador da rede de anúncios da LINE
Título
Imagem
Corpo
Ícone do app	^1
Call-to-action
Star rating
Loja
Preço

¹ Para anúncios nativos, o SDK da rede de anúncios da LINE não fornece um recurso de ícone do app. Em vez disso, o adaptador da LINE Ads Network preenche o ícone do app com uma imagem transparente.

Códigos de erro

Se o adaptador não receber um anúncio da LINE Ads Network, verifique o erro subjacente na resposta do anúncio usando ResponseInfo.getAdapterResponses() nas seguintes classes:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

Confira os códigos e as mensagens geradas pelo adaptador da LINE Ads Network quando um anúncio não é carregado:

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.

Registro de alterações do adaptador de mediação do LINE para Android

Versão 2.9.20250718.0

• Compatibilidade verificada com a versão 2.9.20250718 do SDK da FiveAd.

Criado e testado com:

• Versão 24.3.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.9.20250718.0 do SDK da FiveAd.

Versão 2.9.20250519.0

• Compatibilidade verificada com a versão 2.9.20250519 do SDK da FiveAd.

Criado e testado com:

• Versão 24.3.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.9.20250519.0 do SDK da FiveAd.

Versão 2.9.20250317.1

• Corrige as dimensões de carregamento de banner para anúncios de lances com a nova API FiveAd.

Criado e testado com:

• Versão 24.1.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.9.20250317.0 do SDK da FiveAd

Versão 2.9.20250317.0

• Compatibilidade verificada com a versão 2.9.20250317 do SDK da FiveAd.

Criado e testado com:

• Versão 24.1.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.9.20250317.0 do SDK da FiveAd

Versão 2.9.20250110.1

• Atualizamos o nível mínimo necessário da API Android para 23.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 24.0.0.

Criado e testado com:

• Versão 24.0.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.9.20250110.0 do SDK da FiveAd

Versão 2.9.20250110.0

• A classe UnifiedNativeAdMapper obsoleta foi removida em favor de NativeAdMapper.
• Processo de coleta de indicadores corrigido.
• Corrigimos o processo de inicialização para formatos de anúncio intersticial e premiado em hierarquia.
• Compatibilidade verificada com a versão 2.9.20250110 do SDK da FiveAd.

Criado e testado com:

• Versão 23.6.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.9.20250110.0 do SDK da FiveAd

Versão 2.9.20241129.0

• Adicionamos suporte a lances para formatos de anúncio de banner, intersticial, premiado e nativo.
• Compatibilidade verificada com a versão 2.9.20241129 do SDK da FiveAd.

Criado e testado com:

• Versão 23.5.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.9.20241129.0 do SDK da FiveAd

Versão 2.8.20240827.0

• Compatibilidade verificada com a versão 2.8.20240827 do SDK da FiveAd.

Criado e testado com:

• Versão 23.3.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.8.20240827.0 do SDK da FiveAd.

Versão 2.8.20240808.0

• Compatibilidade verificada com a versão 2.8.20240808 do SDK da FiveAd.

Criado e testado com:

• Versão 23.2.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.8.20240808.0 do SDK da FiveAd.

Versão 2.8.20240722.0

• Compatibilidade verificada com a versão 2.8.20240722 do SDK da FiveAd.

Criado e testado com:

• Versão 23.2.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.8.20240722.0 do SDK da FiveAd.

Versão 2.7.20240515.0

• Compatibilidade verificada com a versão 2.7.20240515 do SDK da FiveAd.

Criado e testado com:

• Versão 23.1.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.7.20240515.0 do SDK da FiveAd

Versão 2.7.20240214.1

• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 23.0.0.
• Compatibilidade verificada com a versão 2.7.20240214 do SDK da FiveAd.

Criado e testado com:

• Versão 23.0.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.7.20240214.0 do SDK da FiveAd.

Versão 2.7.20240214.0

• Compatibilidade verificada com a versão 2.7.20240214 do SDK da FiveAd.

Criado e testado com:

• Versão 22.6.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.7.20240214.0 do SDK da FiveAd.

Versão 2.7.20240126.0

• Compatibilidade verificada com a versão 2.7.20240126 do SDK da FiveAd.

Criado e testado com:

• Versão 22.6.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.7.20240126.0 do SDK da FiveAd.

Versão 2.7.20240112.0

• O FiveAdViewEventListener descontinuado foi removido em favor de FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener e FiveAdNativeEventListener.
• Compatibilidade verificada com a versão 2.7.20240112 do SDK da FiveAd.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 22.6.0.

Criado e testado com:

• Versão 22.6.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.7.20240112 do SDK da FiveAd.

Versão 2.6.20230607.1

• Adicionamos a classe LineExtras para que os editores definam configurações de som padrão para formatos de anúncio de banner, intersticial e premiado.
• Atualizamos a versão mínima necessária do SDK dos anúncios para dispositivos móveis do Google para 22.4.0.

Criado e testado com:

• Versão 22.4.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.6.20230607 do SDK da FiveAd.

Versão 2.6.20230607.0

• Versão inicial.
• Adiciona suporte aos formatos de anúncio de banner, intersticial, premiado e nativo.
• Compatibilidade verificada com a versão 2.6.20230607 do SDK da FiveAd.

Criado e testado com:

• Versão 22.1.0 do SDK dos anúncios para dispositivos móveis do Google.
• Versão 2.6.20230607 do SDK da FiveAd.