Integrar a LY Ads Network com a mediação

Selecione a plataforma: Android iOS Unity Flutter Android (legada)

Este guia mostra como usar Google Mobile Ads Unity Plugin para carregar e exibir anúncios da LY Ads Network usando a mediação, incluindo integrações em hierarquia. Ele explica como adicionar a rede de publicidade LY Ads Network à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da LY Ads Network a um app Unity.

Integrações e formatos de anúncio aceitos

O adaptador de mediação do Ad Manager para a LY Ads Network tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Versão mais recente do Google Mobile Ads Unity Plugin.
  • Unity Editor versão 4 ou mais recente.
  • [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o plug-in de mediação de anúncios para dispositivos móveis do Google para a rede de anúncios da LY 1.5.0 ou mais recente (recomendamos usar a última versão).
  • Para implantar no Android
    • API Android nível 24 ou mais recente.
  • Para implantar no iOS
    • Destino de implantação do iOS 13.0 ou mais recente.
  • Um projeto do Unity em funcionamento configurado com Google Mobile Ads Unity Plugin. Consulte Configurar Google Mobile Ads Unity Plugin para mais detalhes.
  • Configure a mediação.

    • Etapa 1: definir as configurações na interface da LY Ads Network

    Crie uma conta e faça login na LY Ads Network.

    Adicionar um novo aplicativo

    Navegue até a guia App e clique no botão Novo registro.

    Novo registro

    Preencha o formulário e clique em registration.

    Novo formulário de inscrição

    Anote o ID do app.

    Android

    Detalhes do registro

    iOS

    Detalhes do registro

    Criar um espaço do anúncio

    Na guia App, selecione seu app para ver os detalhes dele. Na seção Slot, clique em Adicionar.

    Adicionar slot

    Preencha o formulário para saber mais sobre o horário. Em Tipo de lance, selecione Padrão para configurar esse espaço para mediação em hierarquia ou Lances do SDK do Google para configurar esse espaço para lances. Clique em Criar depois de preencher o formulário.

    Adicionar formulário de slot

    Anote o ID do slot.

    Detalhes do slot

    Depois de criar o primeiro slot, clique em Analisar na página de detalhes do app para receber a aprovação da rede de publicidade da LY. Isso pode levar algum tempo. Entre em contato com seu representante da rede de publicidade da LY se tiver alguma dúvida.

    Pedir análise

    Criar uma chave de API Reporting

    Acesse a guia Gerenciar chaves de API de relatórios e clique no botão Criar chave de API.

    Guia "Chave da API Reporting"

    Preencha o formulário e clique em Salvar.

    Formulário de chave de API Reporting

    Anote o ID da chave de API e o segredo da chave de API.

    Formulário de chave de API Reporting

    Atualizar o app-ads.txt

    Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, crie um arquivo app-ads.txt para o Ad Manager.

    Para implementar o app-ads.txt na LY Ads Network, consulte Sobre o app-ads.txt.

    Etapa 2: configurar a demanda da rede de publicidade da LY na interface do Ad Manager

    Definir 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 instruções, consulte a etapa 2 no guia para iOS.

    Etapa 3: importar o SDK e o adaptador da rede de anúncios da LY

    OpenUPM-CLI

    Se a CLI do OpenUPM estiver instalada, você poderá instalar o plug-in de mediação da rede de anúncios LY dos anúncios para dispositivos móveis do Google para Unity no seu projeto executando o seguinte comando no diretório raiz do projeto:

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

    OpenUPM

    No editor do projeto do Unity, selecione Edit > Configurações do Projeto > Package Manager para abrir as configurações do gerenciador de pacotes do Unity.

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

    • Nome: OpenUPM
    • URL: https://package.openupm.com
    • Escopos: com.google

    Detalhes do OpenUPM

    Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

    Registros do Unity

    Selecione o pacote Mediação de linha do Google Mobile Ads e clique em Instalar.

    Instalar pelo OpenUPM

    Pacote do Unity

    Baixe a versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para a rede de publicidade LY no link de download do registro de alterações 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ê salvou. Verifique se todos os arquivos estão selecionados e clique em Importar.

    Importar do Unity

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

    Forçar resolução

    Etapa 4: adicionar o código necessário

    Android

    Não é necessário nenhum código adicional para a integração com a rede de publicidade LY.

    iOS

    Integração da SKAdNetwork

    Siga a documentação da rede de publicidade LY para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto.

    Etapa 5: testar a implementação

    Ativar anúncios de teste

    Registre seu dispositivo de teste no Ad Manager.

    Verificar anúncios de teste

    Para verificar se você está recebendo anúncios de teste da rede de publicidade LY, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios da rede de publicidade LY.

    Etapas opcionais

    Parâmetros específicos da rede

    O plug-in de mediação da LY Ads Network Unity é compatível com o seguinte parâmetro de solicitação adicional, que pode ser transmitido ao adaptador pela classe LineMediationExtras:

    • SetEnableAdSound(boolean) : especifica o estado inicial de som padrão dos anúncios de banner, intersticiais e premiados.

    Confira um exemplo de código de 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 da LY Ads Network, os editores poderão verificar o erro subjacente na 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 geradas pelo adaptador da rede de publicidade LY Ads Network quando um anúncio não é carregado:

    Android

    Código do erro Domínio Motivo
    1-10 com.five_corp.ad O SDK da rede de publicidade LY Ads retornou um erro específico do SDK. Consulte a documentação da LY Ads Network para mais detalhes.
    101 com.google.ads.mediation.line O ID do aplicativo está ausente ou é inválido.
    102 com.google.ads.mediation.line O ID do espaço está ausente ou é inválido.
    103 com.google.ads.mediation.line O tamanho de anúncio solicitado não corresponde a um tamanho de anúncio de banner aceito pela rede de publicidade LY.
    104 com.google.ads.mediation.line Falha ao carregar um anúncio intersticial ou premiado devido à falta de contexto da atividade.
    105 com.google.ads.mediation.line O SDK da rede de publicidade LY 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 à falta de recursos.
    107 com.google.ads.mediation.line O SDK da FiveAd retornou um carregador de anúncios nulo.

    iOS

    Código do erro Domínio Motivo
    1-10 Enviado pelo SDK da rede de publicidade LY. O SDK da rede de publicidade da LY retornou um erro específico do SDK. Consulte a documentação da LY Ads Network para mais detalhes.
    101 com.google.ads.mediation.line Parâmetros de servidor inválidos (por exemplo, ID do aplicativo ou ID do espaço ausente).
    102 com.google.ads.mediation.line O tamanho de anúncio solicitado não corresponde a um tamanho de anúncio de banner aceito pela rede de publicidade LY.
    103 com.google.ads.mediation.line Falha ao carregar um recurso de imagem do ícone de informações no anúncio nativo.
    104 com.google.ads.mediation.line Falha ao coletar indicadores para lances.
    105 com.google.ads.mediation.line Falha ao inicializar o carregador de anúncios do SDK de anúncio da LINE Ads.

    Registro de alterações do plug-in de mediação do Line Unity

    Versão 2.2.1

    Versão 2.2.0

    Versão 2.1.1

    Versão 2.1.0

    Versão 2.0.2

    Versão 2.0.1

    Versão 2.0.0

    Versão 1.5.10

    Versão 1.5.9

    Versão 1.5.8

    Versão 1.5.7

    Versão 1.5.6

    Versão 1.5.5

    • Foi corrigido um problema em que a instalação pelo OpenUPM fazia com que o plug-in não importasse os pacotes corretamente.

    Versão 1.5.4

    Versão 1.5.3

    Versão 1.5.2

    Versão 1.5.1

    Versão 1.5.0

    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