Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios do Line usando a mediação, cobrindo integrações em cascata. 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 plataforma Line tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | 1 |
Formatos | |
Banner | |
Intersticial | |
Premiado | |
Nativo |
1 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 para iniciantes 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 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 de linha na interface do Ad Manager
Faça login na sua conta do Ad Manager.
Adicionar linha em empresas
Lances
Esta etapa não é necessária para integrações de lances.
Cascata
Acesse Administrador > Empresas e clique no botão Nova empresa na guia Todas as empresas. Selecione Rede de publicidade.
Selecione Linha como a Rede de publicidade, insira um Nome exclusivo e ative a Mediação.
Não é necessário inserir um Nome de usuário ou uma Senha. Clique em Salvar quando terminar.
Ativar o compartilhamento de indicador seguro
Lances
Acesse Administrador > Configurações globais. Acesse a guia Configurações da conta do Ad Exchange e ative o Compartilhamento de indicadores seguros. Clique em Salvar.
Cascata
Esta etapa não é necessária para integrações em hierarquia.
Configurar os lances de linha
Lances
Navegue até Exibição > Bidders e clique em Novo bidder na guia Lances do SDK.
Selecione Linha como o bidder.
Ative Adicionar a biblioteca de indicadores deste bidder à lista de indicadores permitidos e Permitir que os indicadores sejam compartilhados com este bidder. Em seguida, clique em Continuar.
Clique em Continuar.
Clique em Concluído.
Cascata
Esta etapa não é necessária para integrações em hierarquia.
Configurar o mapeamento de blocos de anúncios
Lances
Navegue até Envio > Bidders e selecione a empresa para a linha na guia Lances do SDK.
Acesse a guia Mapeamento de bloco de anúncios e clique em Novo mapeamento de bloco de anúncios.
Escolha Bloco de anúncios específico. Selecione um bloco de anúncios e formato, App para dispositivos móveis como o Tipo de inventário e seu Aplicativo para dispositivos móveis. Em seguida, insira o ID do aplicativo e o ID do slot recebidos na seção anterior. Por fim, clique em Salvar.
Cascata
Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento. Selecione o aplicativo para dispositivos móveis.
Role a tela para baixo e clique em Adicionar parceiro de rendimento.
Selecione a empresa que você criou para a linha na seção anterior. Escolha Mediação do SDK para dispositivos móveis como o tipo de integração, Android como a plataforma e Ativo como o status.
Insira o ID do aplicativo e o ID do slot recebidos na seção anterior e o valor do CPM padrão. Clique em Salvar.
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.6.0")
implementation("com.google.ads.mediation:line:2.8.20240827.0")
}
Integração manual
Faça o download da versão mais recente do arquivo
.aar
do SDK do Line e adicione-o ao projeto.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 Google, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Line (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:
Java
LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
Kotlin
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
campos
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 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 enviadas 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 do Line retornou um erro específico do SDK. Consulte a documentação da linha 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 o 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 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 do Android do LINE
Próxima versão
- Implementação do AdLoader 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 uso de
FiveAdViewEventListener
foi descontinuado em favor deFiveAdCustomLayoutEventListener
,FiveAdVideoRewardEventListener
,FiveAdInterstitialEventListener
eFiveAdNativeEventListener
. - 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.