Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google a fim de carregar e exibir de linha que usam a mediação, incluindo integrações em hierarquia. Ele explica como adicionar linhas a um bloco de anúncios configuração de mediação e como integrar o SDK e o adaptador do Line em um app Unity.
Integrações e formatos de anúncio compatíveis
O AdMob adaptador de mediação para linha tem o seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | 1 |
Formatos | |
Banner | |
Intersticial | |
Premiado |
1 A integração em hierarquia 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
- Android API de nível 21 ou mais recente
- Para implantar no iOS
- Destino de implantação do iOS de 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 Acesse Primeiros passos para ver mais detalhes.
- Leia o Guia explicativo de mediação
Etapa 1: definir as configurações na interface do Line
Etapa 2: configurar a demanda de linha na AdMob interface
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 de projetos do Unity, selecione Assets > Importar pacote >
Pacote personalizado e encontre o GoogleMobileAdsLineMediation.unitypackage
que você transferiu por download. Verifique se todos os arquivos estão selecionados e clique em
Importação.
Em seguida, selecione Recursos > Resolvedor do Play Services > Resolvedor do Android >
Forçar resolução. A biblioteca Unity Play Services Resolver
a resolução das dependências do zero e copiar as dependências declaradas no
Assets/Plugins/Android
do seu app do Unity.
Etapa 4: adicionar o código obrigatório
Android
Nenhum código adicional é necessário para a integração com o Line.
iOS
Integração com a SKAdNetwork
Siga a documentação do Line (em inglês).
para adicionar os identificadores SKAdNetwork ao arquivo Info.plist
do projeto.
Etapa 5: testar a implementação
Ativar anúncios de teste
Registre seu dispositivo de teste em AdMob
Siga as instruções na Documentação do Android e iOS sobre como ativar anúncios de teste de linha.
Verificar anúncios de teste
Para verificar se você está recebendo anúncios de teste do Line, ative os testes de uma única origem no Ad Inspector usando as Line (Waterfall) origens de anúncios.
Etapas opcionais
Parâmetros específicos de rede
O plug-in de mediação do Line Unity é compatível com a solicitação adicional a seguir
que pode ser transmitido ao adaptador por meio do LineMediationExtras
classe:
SetEnableAdSound(boolean)
: especifica o estado inicial padrão do som. anúncios intersticiais, premiados e de banner.
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 podem verificar o erro subjacente a partir da resposta do anúncio usando
ResponseInfo
nas seguintes classes:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
Aqui estão os códigos e as mensagens de acompanhamento geradas pelo adaptador de linha quando um falha ao carregar:
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 Documentação da Line 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 linha. |
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 de linha não conseguiu mostrar um anúncio intersticial ou premiado. |
106 | com.google.ads.mediation.line | Falha ao 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 de linha retornou um erro específico do SDK. Consulte Documentação da 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 do anúncio solicitado não corresponde a um tamanho de anúncio de banner compatível com linha. |
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 para o Line
Versão 1.3.1
- Suporte ao adaptador do Android para o Line versão 2.8.20240808.0.
- Oferece suporte ao adaptador do Line iOS versão 2.8.20240612.0.
- 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
- 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
- Oferece suporte ao adaptador do Android Line versão 2.7.20240515.0.
- Oferece suporte ao adaptador do Line iOS versão 2.8.20240612.0.
- 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
- Oferece suporte ao adaptador do Android Line versão 2.7.20240515.0.
- Oferece suporte ao adaptador do 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
- Oferece suporte ao adaptador do Android Line versão 2.7.20240214.1.
- 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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 9.0.0.
Versão 1.0.0
- Versão inicial.
- Oferece suporte ao adaptador do Android Line versão 2.6.20230607.0.
- Oferece suporte ao adaptador do Line iOS 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.