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 a plataforma 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 autenticação (inscrição).
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
Definir as configurações de mediação para seu bloco de anúncios
Android
Para conferir 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 de anúncios para dispositivos móveis do Google para o Line no link de download no Changelog e extraia o GoogleMobileAdsLineMediation.unitypackage
do arquivo ZIP.
No editor de projetos 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
Import.
Em seguida, selecione Assets > Play Services Resolver > Android Resolver >
Force Resolve. A biblioteca do resolvedor do Unity Play Services vai executar
a resolução de dependências do zero e copiar as dependências declaradas no
diretório Assets/Plugins/Android
do seu app do 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 do Line 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 | Falha ao carregar um recurso de imagem de ícone de informações no anúncio nativo. |
Registro de alterações do plug-in de mediação do Unity
Versão 1.3.1
- Oferece suporte ao adaptador do Android Line versão 2.8.20240808.0.
- Suporte ao adaptador do Line para 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
- Oferece suporte ao adaptador do Android Line versão 2.8.20240722.0.
- Suporte ao adaptador do Line para 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 do Line para 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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.
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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.1.0.
Versão 1.1.0
- A classe
LineMediationExtras
foi adicionada com os métodos a seguir para oferecer suporte à transmissão de extras de mediação.SetEnabledAdSound(bool)
- Oferece suporte ao adaptador do Android Line versão 2.7.20240214.1.
- Suporte ao adaptador Line 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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.5.1.