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 AdMob adaptador de mediação para linha tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | 1 |
Formatos | |
Banner | |
Intersticial | |
Premiado |
1 A integração em cascata está na versão Beta aberta.
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 em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
- Leia o Guia explicativo 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 autenticação (inscrição).
Anote o ID do aplicativo.
Criar um posicionamento 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 de linha na interface AdMob
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 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
Importar.
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 do Line, ative o teste de uma única origem no Ad Inspector usando as origens de anúncios Line (Cascata).
Etapas opcionais
Parâmetros específicos de rede
O plug-in de mediação do Line Unity é compatível com o seguinte parâmetro de solicitação
extra, 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.
Veja um exemplo de código que explica como 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 de linha 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 de espaço 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 do 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.
- Oferece suporte ao adaptador do 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.
- Oferece suporte ao adaptador do 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
- Oferece suporte ao adaptador do Android Line versão 2.7.20240515.0.
- 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 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.