Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google com o objetivo de carregar e exibir anúncios do Line usando a mediação, abrangendo integrações em hierarquia. 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 Ad Manager adaptador de mediação para linha tem os seguintes recursos:
Integração | |
---|---|
Lances | |
Cascata | 1 |
Formatos | |
Banner | |
Intersticial | |
Premiado |
1 A integração em hierarquia 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:
- 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 o artigo Começar para ver mais detalhes.
- Leia o Guia explicativo de mediação
Etapa 1: definir as configurações na interface do Line
Faça login na sua conta do Line.
Adicionar um novo aplicativo
Clique em 広告枠管理 (Gerenciamento de espaço de anúncio) > メディア (Mídia). Em seguida, clique em ski規作成 (Criar novo).
Preencha o formulário e clique em Related🇸 (Register).
Anote o ID do aplicativo.
Criar um posicionamento do anúncio
Clique no código do aplicativo ao qual você quer adicionar um canal do anúncio. Em seguida, selecione 詳細 (Detalhe).
Clique em IAPット 追加 (Adicionar slot).
Preencha o formulário e, quando terminar, clique em (Presentício).
Anote o ID do slot.
Etapa 2: configurar a demanda de linha na Ad Manager 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 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
Importar.
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 Unity.
Etapa 4: adicionar o código obrigatório
Android
Nenhum código adicional é necessário para a integração da linha.
iOS
Integração com a SKAdNetwork
Siga a documentação do Line (link em inglês)
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 em Ad Manager
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.
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 correspondentes gerados pelo adaptador de linha quando um anúncio falha no carregamento:
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 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 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 à ausência do contexto da 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 a documentação do 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 | 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 para o Line
Versão 1.1.1
- Oferece suporte ao adaptador do Android Line versão 2.7.20240214.1.
- 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.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.
- Oferece suporte ao adaptador do 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 o plug-in dos anúncios para dispositivos móveis do Google para Unity versão 8.5.1.