Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios da rede de anúncios da LINE usando a mediação, cobrindo integrações em cascata. Ele aborda como adicionar a rede de anúncios da 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 da LINE a um app Unity.
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 |
1 A integração em cascata está na versão Beta fechada. Entre em contato com seu gerente de contas para solicitar acesso.
Requisitos
- Unity 4 ou mais recente
- SDK dos anúncios para dispositivos móveis do Google mais recente
- Para implantar no Android
- API do Android de nível 21 ou mais recente
- Para implantar no iOS
- Destino de implantação do iOS 12.0 ou mais recente
- Um projeto do Unity configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Concluir o Guia para iniciantes da mediação.
Etapa 1: configurar as configurações na interface da linha
Faça login na sua conta da Rede de anúncios 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 da rede de anúncios do LINE na interface
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 ver as instruções, consulte a etapa 2 no guia para iOS.
Etapa 3: importar o SDK e o adaptador da rede de anúncios da LINE
OpenUPM-CLI
Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação da rede de anúncios do Google LINE Ads para Unity no seu projeto executando o comando abaixo no diretório raiz do projeto:
openupm add com.google.ads.mobile.mediation.line
OpenUPM
No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Unity Package Manager Settings.
Na guia Scoped Registries, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:
- Nome:
OpenUPM
- URL:
https://package.openupm.com
- Escopo(s):
com.google
Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecionar My Registries no menu suspenso.
Selecione o pacote Google Mobile Ads LINE Ads Network Mediation e clique em Install.
Pacote do Unity
Faça o download da versão mais recente do plug-in de mediação do Google Mobile Ads para a
rede de anúncios da LINE usando o link de download no
Changelog
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ê transferiu por download. Verifique se todos os arquivos estão selecionados e clique em
Import.
Em seguida, selecione Assets > External Dependency Manager >
Android Resolver > Force Resolve. A biblioteca do Gerenciador de dependências externas
vai realizar a resolução de dependências do zero e copiar as
dependências declaradas para o diretório Assets/Plugins/Android
do
app do 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 LINE
para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist
do projeto.
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 plug-in de mediação da rede de anúncios 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 de início de som padrão de anúncios em 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 publicidade do LINE,
os editores poderão verificar o erro subjacente da 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 exibidas pelo adaptador da rede de anúncios da 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 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. |
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 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 | Parâmetros do servidor inválidos (por exemplo, ID do aplicativo ou do slot ausente). |
102 | 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. |
103 | com.google.ads.mediation.line | Não foi possível carregar um recurso de imagem de ícone de informação no anúncio nativo. |
Registro de alterações do plug-in de mediação do Unity
Versão 1.4.0
- Suporte para a versão 2.8.20240827.0 do adaptador do Line para Android.
- Suporte à versão 2.9.20241106.1 do adaptador do iOS para a plataforma Line.
- 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
- Suporte ao adaptador do Android para o Line versão 2.8.20240808.0.
- Suporte ao adaptador do iOS da Line versão 2.8.20240612.0.
- Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.3.0
- Suporte à versão 2.8.20240722.0 do adaptador do Android para a plataforma Line.
- Suporte ao adaptador do iOS da Line versão 2.8.20240612.0.
- Criado e testado com a versão 9.2.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.2.0
- Suporte à versão 2.7.20240515.0 do adaptador do Android para a linha.
- Suporte ao adaptador do iOS da Line versão 2.8.20240612.0.
- Criado e testado com a versão 9.1.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.1.2
- Suporte à versão 2.7.20240515.0 do adaptador do Android para a linha.
- Suporte ao adaptador Line iOS versão 2.7.20240411.0.
- Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.1.1
- Suporte à versão 2.7.20240214.1 do adaptador do Android para a plataforma Line.
- Suporte ao adaptador Line iOS versão 2.7.20240411.0.
- Criado e testado com a versão 9.1.0 do plug-in dos anúncios para dispositivos móveis do Google para Unity.
Versão 1.1.0
- A classe
LineMediationExtras
foi adicionada com os seguintes métodos para oferecer suporte à transmissão de extras de mediação.SetEnabledAdSound(bool)
- Suporte à versão 2.7.20240214.1 do adaptador do Android para a plataforma Line.
- Suporte ao adaptador Line para iOS versão 2.7.20240318.0.
- 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.
- Suporte à versão 2.6.20230607.0 do adaptador do Line Android.
- Suporte ao adaptador para iOS da Line versão 2.6.20230609.0.
- Criado e testado com a versão 8.5.1 do plug-in dos anúncios para dispositivos móveis do Google para Unity.