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 do Line usando Mediação da AdMob, abrangendo integrações de 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 Android app.

A interface do painel da Linha usa texto em japonês nos rótulos, botões e descrições. As capturas de tela deste 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:

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

1 A integração em cascata está na versão Beta aberta.

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 slots de 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 veiculação de anúncios. Em seguida, selecione 詳細 (Detalhe).

Clique em ▾Resizeット 追加 (Adicionar slot).

Preencha o formulário e, quando tiver concluído, clique em (potenciais) Register.

Anote o ID do slot.

Etapa 2: configurar a demanda de linha na interface AdMob

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

Você precisa adicionar Line à configuração de mediação do seu bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, acesse a guia Mediação. Se você quiser modificar um grupo de mediação, clique no nome dele para editá-lo e prossiga para Adicionar Line como uma origem de anúncios.

Para criar um novo grupo de mediação, selecione Criar grupo de mediação.

Insira a plataforma e o formato do anúncio e clique em Continuar.

Atribua um nome ao seu grupo de mediação e selecione locais para segmentar. 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únciosAdMob existentes. Em seguida, clique em Concluído.

Agora você verá o card de blocos de anúncios preenchido com os blocos selecionados:

Adicionar Line como uma origem de anúncios

No card Cascata, na seção Origens de anúncios, selecione Adicionar origem do anúncio. Em seguida, selecione Line.

Selecione Line. Em seguida, insira um valor de eCPM para Line e clique em Continuar.

Se você já tem um mapeamento para Line, pode selecioná-lo. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o Application ID and Slot ID recebido na seção anterior. Em seguida, clique em Concluído.

Etapa 3: importar o SDK do Line e o Adapter

No arquivo build.gradle.kts no nível do app, adicione as dependências e configurações de implementação abaixo. 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é 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 em AdMob

Siga as instruções na Documentação do Line sobre como ativar anúncios de teste de linha.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do Line, ative os testes de uma única origem no Ad Inspector usando as Line (Waterfall) origens de anúncios.

Etapas opcionais

Parâmetros específicos de rede

O adaptador de linha oferece suporte a um parâmetro de solicitação extra 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:

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()

Usar anúncios nativos

Renderização do anúncio

O adaptador de linha preenche os seguintes descrições de campos avançados de anúncios nativos para um NativeAd.

Campo Recursos sempre incluídos pelo adaptador de linha
Título
Imagem
Corpo
Ícone do app 1
Call-to-action
Star rating
Loja
Preço

1 Para anúncios nativos, o SDK do Line não fornece um recurso de ícone do 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 da 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

Veja a seguir os códigos e as mensagens correspondentes gerados pelo adaptador de linha quando um anúncio não é carregado:

Código do erro Domínio Motivo
1-10 com.five_corp.ad O SDK de linha retornou um erro específico do SDK. Consulte a documentação do Line para mais detalhes.
101 com.google.ads.mediation.line ID do aplicativo ausente ou inválido.
102 com.google.ads.mediation.line ID do slot ausente ou inválido.
103 com.google.ads.mediation.line O tamanho do anúncio solicitado não corresponde a um tamanho de anúncio de banner compatível com linha.
104 com.google.ads.mediation.line Falha ao carregar um anúncio intersticial ou premiado devido à falta de contexto de atividade.
105 com.google.ads.mediation.line O SDK de linha 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 para Android no LINE

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.
  • AdLoader foi implementado para ativar RTB para anúncios premiados.

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

  • Verificamos a compatibilidade 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.
  • Verificamos a compatibilidade com a versão 2.7.20240112 do SDK do 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:

  • 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

  • A classe LineExtras foi adicionada para que os editores definam configurações de som padrão para formatos de anúncios de banner, intersticiais e premiados.
  • 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.
  • Adiciona compatibilidade com os formatos de banner, intersticial, premiado e nativo.
  • Verificamos a compatibilidade com a versão 2.6.20230607 do SDK do FiveAd.

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.