Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios da rede de anúncios da LINE usando a mediação, incluindo integrações em cascata. Ele aborda como adicionar a rede de anúncios do LINE à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da rede de anúncios do LINE a um app Unity.
Integrações e formatos de anúncio aceitos
O adaptador de mediação da AdMob para a rede de anúncios do LINE tem os seguintes recursos:
| Integração | |
|---|---|
| Lances | 1 |
| Cascata | |
| Formatos | |
| Banner | |
| Intersticial | |
| Premiado | |
1 A integração de lances está em Beta fechado. Entre em contato com seu gerente de contas para solicitar acesso.
Requisitos
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Unity 4 ou versões mais recentes
- [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o plug-in de mediação dos anúncios para dispositivos móveis do Google para o SDK de anúncios da LINE 1.5.0 ou mais recente (versão mais recente recomendada).
- Para fazer a implantação no Android,
- API do Android de nível 23 ou mais recente
- Para fazer a implantação no iOS:
- Destino de implantação do iOS 12.0 ou mais recente
- Um projeto do Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Conclua o guia para iniciantes da mediação.
Etapa 1: definir 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.
Anote o ID do slot.
Atualizar o app-ads.txt
O
app-ads.txt de vendedores autorizados para apps é 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 rede de anúncios do LINE na interface da AdMob
Configurar as configurações de mediação do bloco de anúncios
Android
Para instruções, consulte a etapa 2 no guia para Android.
iOS
Para instruções, consulte a etapa 2 no guia para iOS.
Etapa 3: importar o SDK e o adaptador da rede de anúncios do LINE
OpenUPM-CLI
Se você tiver o OpenUPM-CLI instalado, execute o seguinte comando no diretório raiz do projeto para instalar o plug-in de mediação da rede de anúncios LINE dos anúncios para dispositivos móveis do Google no Unity:
openupm add com.google.ads.mobile.mediation.lineOpenUPM
No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do Unity Package Manager.
Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:
- Nome:
OpenUPM - URL:
https://package.openupm.com - Escopos:
com.google
Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.
Selecione o pacote Mediação de linha dos anúncios para dispositivos móveis do Google e clique em Instalar.
Pacote do Unity
Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para a
LINE Ads Network usando o link de download no
Registro de alterações
e extraia o
GoogleMobileAdsLineMediation.unitypackage do arquivo
ZIP.
No editor do projeto do Unity, selecione Assets > Import Package >
Custom Package e encontre o arquivo
GoogleMobileAdsLineMediation.unitypackage
que você baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.
Em seguida, selecione Recursos > Gerenciador de dependências externas >
Resolvedor do Android > Resolução forçada. A biblioteca do External Dependency Manager
vai realizar a resolução de dependências do zero e copiar as
dependências declaradas no diretório Assets/Plugins/Android do seu
app Unity.
Etapa 4: adicionar o código necessário
Android
Nenhum código adicional é necessário para a integração da rede de anúncios do LINE.
iOS
Integração da SKAdNetwork
Siga a documentação da rede de anúncios da LINE
para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do projeto.
Etapa 5: testar a implementação
Ativar anúncios de teste
Verifique se você registrou seu dispositivo de teste na AdMob.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da rede de anúncios da LINE, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Rede de anúncios da LINE (hierarquia).
Etapas opcionais
Parâmetros específicos da rede
O plug-in de mediação do Unity da rede de anúncios do LINE é compatível com o seguinte
parâmetro de solicitação adicional, que pode ser transmitido ao adaptador pela classe
LineMediationExtras:
-
SetEnableAdSound(boolean): especifica o estado inicial de som padrão dos 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:
using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...
var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);
Códigos de erro
Se o adaptador não receber um anúncio da rede de anúncios da LINE, os editores poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo nas seguintes classes:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
Confira os códigos e as mensagens acompanhantes gerados pelo adaptador da rede de anúncios do LINE quando um anúncio não é carregado:
Android
| Código do erro | Domínio | Motivo |
|---|---|---|
| 1-10 | com.five_corp.ad | O SDK da rede de anúncios da LINE 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 | ID do slot 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 rede de anúncios do LINE. |
| 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. |
iOS
| Código do erro | Domínio | Motivo |
|---|---|---|
| 1-10 | Enviado pelo SDK da rede de publicidade da LINE. | O SDK da rede de anúncios da LINE 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 | Parâmetros de servidor inválidos (por exemplo, ID do aplicativo ou ID do slot ausente). |
| 102 | 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 rede de anúncios do LINE. |
| 103 | com.google.ads.mediation.line | Não foi possível carregar um recurso de imagem de ícone de informações no anúncio nativo. |
Registro de mudanças do plug-in de mediação do Unity
Versão 1.5.5
- Correção de um problema em que a instalação pelo OpenUPM fazia com que o plug-in não importasse os pacotes corretamente.
Versão 1.5.4
- Compatível com a versão 2.9.20250519.0 do adaptador do Android do Line.
- Compatível com a versão 2.9.20250512.0 do adaptador iOS do Line.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.1.0.
Versão 1.5.3
- O plug-in do Unity agora é criado com o SDK do Android 35.
- Compatibilidade com a versão 2.9.20250317.1 do adaptador do Android do Line.
- Compatível com a versão 2.9.20241106.3 do adaptador do iOS da Line.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.1.0.
Versão 1.5.2
- Suporte para a versão 2.9.20250110.0 do adaptador Line Android.
- Compatível com a versão 2.9.20241106.2 do adaptador do Line para iOS.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 10.0.0.
Versão 1.5.1
- Suporte para a versão 2.9.20250110.0 do adaptador Line Android.
- Compatível com a versão 2.9.20241106.1 do adaptador do Line para iOS.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.5.0.
Versão 1.5.0
- Compatível com a versão 2.9.20241129.0 do adaptador do Line para Android.
- Compatível com a versão 2.9.20241106.1 do adaptador do Line para iOS.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.5.0.
Versão 1.4.0
- Compatibilidade com a versão 2.8.20240827.0 do adaptador Line Android.
- Compatível com a versão 2.9.20241106.1 do adaptador do Line para iOS.
- Criado e testado com a versão 9.4.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.3.1
- Compatível com a versão 2.8.20240808.0 do adaptador do Android do Line.
- Compatível com a versão 2.8.20240612.0 do adaptador do Line para iOS.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.2.0.
Versão 1.3.0
- Compatibilidade com a versão 2.8.20240722.0 do adaptador do Android do Line.
- Compatível com a versão 2.8.20240612.0 do adaptador do Line para iOS.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.2.0.
Versão 1.2.0
- Compatibilidade com a versão 2.7.20240515.0 do adaptador do Android do Line.
- Compatível com a versão 2.8.20240612.0 do adaptador do Line para iOS.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.1.
Versão 1.1.2
- Compatibilidade com a versão 2.7.20240515.0 do adaptador do Android do Line.
- Compatível com a versão 2.7.20240411.0 do adaptador iOS do Line.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.
Versão 1.1.1
- Compatível com a versão 2.7.20240214.1 do adaptador do Android da Line.
- Compatível com a versão 2.7.20240411.0 do adaptador iOS do Line.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.
Versão 1.1.0
- Adicionamos a classe
LineMediationExtrascom os seguintes métodos para oferecer suporte à transmissão de extras de mediação.SetEnabledAdSound(bool)
- Compatível com a versão 2.7.20240214.1 do adaptador do Android da Line.
- Compatível com a versão 2.7.20240318.0 do adaptador iOS do Line.
- Criado e testado com a versão 9.0.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.0.0
- Versão inicial.
- Compatível com a versão 2.6.20230607.0 do adaptador do Android do Line.
- Compatível com a versão 2.6.20230609.0 do adaptador do Line para iOS.
- Criado e testado com o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.5.1.