Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e mostrar anúncios da 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 do Unity.
Integrações e formatos de anúncio compatíveis
O adaptador de mediação Ad Manager para 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 explicativo da 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 Ad Manager
Configurar as configurações de mediação para o 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 do Line
Faça o download da versão mais recente do plug-in de mediação do Google Mobile Ads para Line
no link de download no
Changelog e extraia
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 > Resolvedor do Play Services > Resolvedor do Android >
Force Resolve. A biblioteca Unity Play Services Resolver vai realizar
a resolução de dependências do zero e copiar as dependências declaradas para o
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 com o Line.
iOS
Integração da SKAdNetwork
Siga a documentação da linha
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.
Siga as instruções na documentação do Android e do iOS do Line para ativar os anúncios de teste.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste da Linha, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Linha (hierarquia).
Etapas opcionais
Parâmetros específicos da rede
O plug-in de mediação da Line Unity oferece suporte ao 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 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 de linha quando um anúncio não é carregado:
Android
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. |
iOS
Código do erro | Domínio | Motivo |
---|---|---|
1-10 | Enviado pelo SDK do Line | 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 | 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 a um tamanho de anúncio de banner compatível com o 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.3.1
- Suporte ao adaptador do Android para o Line versão 2.8.20240808.0.
- Suporte ao adaptador Line iOS 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 Line iOS 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 Line iOS 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 Line Android.
- 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 Line Android.
- 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.