Integração da rede de anúncios 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 a mediação da AdMob, 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 Rede de anúncios 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 compatíveis

O adaptador de mediação para a rede de anúncios do 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

  • Conclua o Guia para iniciantes da mediação.

Etapa 1: configurar a interface da rede de anúncios do LINE

Faça login na sua conta da Rede de anúncios 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 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 スロット 追加 (Adicionar slot).

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

Anote o ID do slot.

Etapa 2: configurar a demanda da rede de anúncios LINE na interface da AdMob

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

É necessário adicionar a Rede de anúncios do LINE à configuração de mediação do bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, navegue até a guia Mediation. Se você tiver um grupo de mediação que gostaria de modificar, clique no nome dele para editá-lo e pule para Adicionar a rede de publicidade do LINE como uma origem de anúncios.

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

Insira o formato e a plataforma do anúncio e 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 blocos de anúncios da AdMob. Clique em Concluído.

O card "Blocos de anúncios" vai ser preenchido com os blocos que você selecionou:

Adicionar a rede de anúncios do LINE como uma origem de anúncios

Lances


No card Lances, na 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 configure uma parceria de lances com a rede de publicidade da LINE.
Clique em Concordar e continuar e em Continuar.
Se você já tiver um mapeamento para a rede de anúncios da LINE, 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.

Cascata


No card Hierarquia, na seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione Rede de anúncios do LINE.

Selecione a LINE Ads Network. Em seguida, insira um valor de eCPM para a rede de publicidade do LINE e clique em Continuar.



Se você já tiver um mapeamento para a rede de anúncios LINE, selecione-o. Caso contrário, clique em Adicionar mapeamento.

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


Etapa 3: importar o SDK e o adaptador da rede de anúncios do LINE

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 rede de anúncios da LINE:

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

Integração manual

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

  2. Navegue até os artefatos do adaptador da rede de anúncios LINE no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar da adaptador de rede de anúncios do LINE 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.

Verificar anúncios de teste

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

Etapas opcionais

Parâmetros específicos da rede

O adaptador da rede de anúncios do LINE 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:

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 do anúncio

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 do LINE
Título
Imagem
Corpo
Ícone do app 1
Call-to-action
Star rating
Loja
Preço

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

Códigos de erro

Se o adaptador não receber um anúncio da rede de publicidade do LINE, verifique 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 da rede de anúncios da LINE quando um anúncio não é carregado:

Código do erro Domínio Motivo
1-10 com.five_corp.ad O SDK da rede de anúncios LINE retornou um erro específico do SDK. Consulte a documentação da rede de anúncios do LINE para saber mais.
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 ao tamanho de anúncio de banner aceito pela rede de anúncios da LINE.
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 da rede de anúncios 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 Android do LINE

Próxima versão

  • Processo de coleta de indicadores corrigido.

Versão 2.9.20241129.0

  • Foi adicionado suporte a lances para formatos de anúncios de banner, intersticial, premiado e nativo.
  • Compatibilidade verificada com o SDK do FiveAd versão 2.9.20241129.0

Criado e testado com:

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

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 uso de FiveAdViewEventListener foi descontinuado 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.