Integrar o Line com a mediação (Beta)

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 para iniciantes 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 do bloco de anúncios

Android

Para instruções, consulte a etapa 2 no guia para Android.

iOS

Para ver as instruções, consulte a etapa 2 no guia para iOS.

Etapa 3: importar o SDK e o adaptador do Line

OpenUPM-CLI

Se você tiver o OpenUPM-CLI instalado, poderá instalar o plug-in de mediação de linha do Google Mobile Ads para Unity no seu projeto executando o comando abaixo no diretório raiz do projeto:

openupm add com.google.ads.mobile.mediation.line

OpenUPM

No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Unity Package Manager Settings.

Na guia Scoped Registries, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopo(s): com.google

Detalhes do OpenUPM

Em seguida, navegue até Window > Package Manager para abrir o Unity Package Manager e selecionar My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Google Mobile Ads Line Mediation e clique em Install.

Instalar pelo OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plug-in de mediação do Google Mobile Ads para a plataforma Line no link de download no Changelog e extraia o 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.

Importar do Unity

Em seguida, selecione Assets > External Dependency Manager > Android Resolver > Force Resolve. A biblioteca do Gerenciador de dependências externas vai realizar a resolução de dependências do zero e copiar as dependências declaradas para o diretório Assets/Plugins/Android do app do Unity.

Forçar resolução

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 Google, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Line (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 que acompanham o 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.4.0

Versão 1.3.1

Versão 1.3.0

Versão 1.2.0

Versão 1.1.2

Versão 1.1.1

Versão 1.1.0

Versão 1.0.0