Integrar o Line com a mediação (Beta)

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios da Line usando mediação, cobrindo integrações em hierarquia. Ele aborda como adicionar o Line à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do Line a um app Android .

A interface do painel da Linha usa texto em japonês nos 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 compatíveis

O adaptador de mediação para a Line tem os seguintes recursos:

¹ A integração em cascata está em Beta fechado. Entre em contato com seu gerente de contas para solicitar acesso.

Requisitos

• API do Android de nível 21 ou mais recente

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

• Concluir o Guia explicativo de mediação

Etapa 1: configurar as configurações na interface da linha

Faça login na sua conta do Line.

Adicionar um novo aplicativo

Clique em 広告枠管理 (Gerenciamento de espaços de anúncios) > メディア (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 do anúncio

Clique no ID do aplicativo em que você quer adicionar uma veiculação de anúncios. Em seguida, selecione 詳細 (Detalhe).

Clique em スロット 追加 (Adicionar slot).

Preencha o formulário e, quando terminar, clique em (登録) Register.

Anote o ID do slot.

Etapa 2: configurar a demanda de linha na interface Ad Manager

Faça login na sua conta do Ad Manager.

Adicionar linha em empresas

Ativar o compartilhamento de indicador seguro

Configurar os lances de linha

Configurar o mapeamento de blocos de anúncios

Etapa 3: importar o SDK e o adaptador da linha

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:

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

Integração manual

1. Faça o download da versão mais recente do arquivo .aar do SDK do Line e adicione-o ao projeto.

2. Navegue até os artefatos do adaptador de linha no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador de linha e adicione-o ao projeto.

Etapa 4: adicionar o código necessário

Nenhum código adicional é necessário para a integração com o Line.

Etapa 5: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste no Ad Manager.

Siga as instruções na documentação do Line para ativar os anúncios de teste do Line.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da Linha, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Linha (hierarquia).

Etapas opcionais

Parâmetros específicos da rede

O adaptador de linha oferece suporte a 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

Uma boolean para especificar o estado de início de som padrão 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:

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

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

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

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

Como usar anúncios nativos

Renderização do anúncio

O adaptador de linha preenche os seguintes de campo para um NativeAd.

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

Códigos de erro

Se o adaptador não receber um anúncio do Line, você poderá verificar o erro subjacente da 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 exibidas pelo adaptador de linha quando um anúncio não é carregado:

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

Próxima versão

• O AdLoader foi implementado para ativar o RTB para anúncios de banner.
• O AdLoader foi implementado para ativar o RTB para anúncios intersticiais.
• Implementamos o AdLoader para ativar o RTB para anúncios premiados.
• O AdLoader foi implementado para ativar o RTB para anúncios nativos.

Versão 2.8.20240827.0

• Compatibilidade verificada com o SDK do FiveAd versão 2.8.20240827.0

Criado e testado com:

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

Versão 2.8.20240808.0

• Compatibilidade verificada com o SDK do FiveAd versão 2.8.20240808.0

Criado e testado com:

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

Versão 2.8.20240722.0

• Compatibilidade verificada com o SDK do FiveAd versão 2.8.20240722.0

Criado e testado com:

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

Versão 2.7.20240515.0

• Compatibilidade verificada com o SDK do FiveAd versão 2.7.20240515.0

Criado e testado com:

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

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 o SDK do FiveAd versão 2.7.20240214.0.

Criado e testado com:

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

Versão 2.7.20240214.0

• Compatibilidade verificada com o SDK do FiveAd versão 2.7.20240214.0.

Criado e testado com:

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

Versão 2.7.20240126.0

• Compatibilidade verificada com o SDK do FiveAd versão 2.7.20240126.0.

Criado e testado com:

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

Versão 2.7.20240112.0

• O FiveAdViewEventListener descontinuado foi removido em favor de FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener e FiveAdNativeEventListener.
• Compatibilidade verificada com o SDK do FiveAd versão 2.7.20240112.
• 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:

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

Versão 2.6.20230607.1

• Adição da classe LineExtras para que os editores definam as 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:

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

Versão 2.6.20230607.0

• Versão inicial.
• Adição de suporte a formatos de anúncios de banner, intersticial, premiado e nativo.
• Compatibilidade verificada com o SDK do FiveAd versão 2.6.20230607.

Criado e testado com:

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