Integrar a LY Ads Network com a mediação

Selecione a plataforma: Android Android iOS Unity Flutter

Este guia mostra como usar Google Mobile Ads SDK para carregar e exibir anúncios da LY Ads Network usando a mediação, incluindo integrações em hierarquia. Ele explica como adicionar a 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 Android.

Integrações e formatos de anúncio aceitos

O adaptador de mediação da LY Ads Network tem os seguintes recursos:

Requisitos

• API Android nível da API 23 ou mais recente

• Mais recentes de Google Mobile Ads SDK

• Leia todo o guia para iniciantes da mediação.

Etapa 1: definir as configurações na interface da rede de anúncios da LY

Inscreva-se e faça login na sua conta da LY Ads Network.

Adicionar um novo aplicativo

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

Preencha o formulário e clique em registro.

Anote o ID do app.

Criar um espaço do anúncio

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

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

Anote o ID 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 anúncios da LY. Isso pode levar algum tempo. Entre em contato com seu representante da rede de anúncios da LY se tiver alguma dúvida.

Criar uma chave da API Reporting

Navegue até a guia Gerenciar chaves da API Reporting e clique no botão Criar chave de API.

Preencha o formulário e clique em Salvar.

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

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 anúncios da LY na interface do Ad Manager

Faça login na sua conta do Ad Manager.

Adicionar a LY Ads Network em "Empresas"

Ativar o compartilhamento de indicador seguro

Compartilhar indicadores seguros em solicitações de lance

Permitir o compartilhamento de indicadores seguros para Lances do SDK

Configurar os lances da LY Ads Network

Configurar o mapeamento de blocos de anúncios

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

Integração com o Android Studio (recomendada)

No arquivo gradle do app, adicione as seguintes dependências de implementação:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("com.google.ads.mediation:line:3.1.0.0")
}

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    implementation 'com.google.ads.mediation:line:3.1.0.0'
}

Integração manual

1. Faça o download da versão mais recente do arquivo .aar do SDK da rede de anúncios da LY e adicione-o ao projeto.

2. Navegue até os artefatos do adaptador da LY Ads Network no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador da rede de publicidade LY e adicione-o ao projeto.

Etapa 4: adicionar o código necessário

Nenhum código adicional é necessário para a integração da rede de anúncios da LY.

Etapa 5: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste no Ad Manager.

O adaptador da LY Ads Network contém um método auxiliar para ativar o modo de teste da LY Ads Network. É preciso definir essa opção antes de inicializar Google Mobile Ads SDK para garantir que ela seja encaminhada corretamente ao SDK da rede de anúncios da LY.

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

Verificar anúncios de teste

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

Etapas opcionais

Parâmetros específicos da rede

O adaptador da rede de anúncios da LY oferece suporte a um parâmetro de solicitação adicional que pode ser transmitido ao adaptador usando a classe LineExtras. Esse construtor de classe inclui os seguintes parâmetros:

enableAdSound

Um boolean para especificar o estado de início do som padrão de anúncios de banner, intersticiais e premiados.

Confira um exemplo de código para criar uma solicitação de anúncio que define esses parâmetros:

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

Como usar anúncios nativos

Renderização do anúncio

O adaptador da LY Ads Network preenche os seguintes campos de um NativeAd.

¹ Para anúncios nativos, o SDK da rede de anúncios da LY não fornece um recurso de ícone do app. Em vez disso, o adaptador da rede de anúncios LY preenche o ícone do app com uma imagem transparente.

Códigos de erro

Se o adaptador não receber um anúncio da LY Ads Network, verifique o erro subjacente na resposta do anúncio usando ResponseInfo.getAdapterResponses() nas seguintes classes:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

Confira os códigos e as mensagens geradas pelo adaptador da LY Ads Network quando um anúncio não é carregado:

Registro de alterações do adaptador de mediação do LINE para Android

Próxima versão

• Mapeia AgeRestrictedTreatment para a API ChildDirectedTreatment da Line.

Versão 3.1.1.0 (em andamento)

Versão 3.1.0.0

• Adicionada propriedade para criar o adaptador com a dependência do SDK do GMA Next-Gen.
• Compatibilidade verificada com a versão 3.1.0.0 do SDK da FiveAd.

Criado e testado com:

• Versão 25.1.0 do SDK do Google Mobile Ads.
• Versão 0.25.0-beta01 do SDK do Google Mobile Ads Next-Gen.
• Versão 3.1.0.0 do SDK da FiveAd.

Versão 3.0.1.2

Criado e testado com:

• Versão 25.1.0 do SDK do Google Mobile Ads.
• Versão 3.0.1.2 do SDK FiveAd.

Versão 3.0.1.1

• As impressões de anúncios nativos agora são substituídas pelo SDK da FiveAd ao usar o SDK dos anúncios para dispositivos móveis do Google v24.4.0 ou mais recente.

Criado e testado com:

• Versão 24.9.0 do SDK do Google Mobile Ads.
• Versão 3.0.1.1 do SDK da FiveAd.

Versão 3.0.1.0

• Adicionamos suporte para encaminhar o parâmetro tagForUnderAgeOfConsent do SDK do Google Mobile Ads ao SDK da FiveAd.
• Compatibilidade verificada com a versão 3.0.1.0 do SDK da FiveAd.

Criado e testado com:

• Versão 24.9.0 do SDK do Google Mobile Ads.
• Versão 3.0.1.0 do SDK da FiveAd.

Versão 3.0.0.0

• Compatibilidade verificada com a versão 3.0.0.0 do SDK da FiveAd.

Criado e testado com:

• Versão 24.9.0 do SDK do Google Mobile Ads.
• Versão 3.0.0.0 do SDK da FiveAd.

Versão 2.9.20251028.0

• Compatibilidade verificada com a versão 2.9.20251028 do SDK da FiveAd.

Criado e testado com:

• Versão 24.7.0 do SDK do Google Mobile Ads.
• Versão 2.9.20251028.0 do SDK da FiveAd

Versão 2.9.20250924.1

• Referências no nível da classe ao contexto removidas. Pode ajudar a reduzir problemas de vazamento de memória.

Criado e testado com:

• Versão 24.7.0 do SDK do Google Mobile Ads.
• Versão 2.9.20250924.1 do SDK da FiveAd.

Versão 2.9.20250924.0

• Compatibilidade verificada com a versão 2.9.20250924 do SDK da FiveAd.

Criado e testado com:

• Versão 24.6.0 do SDK do Google Mobile Ads.
• Versão 2.9.20250924.0 do SDK da FiveAd.

Versão 2.9.20250718.0

• Compatibilidade verificada com a versão 2.9.20250718 do SDK da FiveAd.

Criado e testado com:

• Versão 24.3.0 do SDK do Google Mobile Ads.
• Versão 2.9.20250718.0 do SDK da FiveAd.

Versão 2.9.20250519.0

• Compatibilidade verificada com a versão 2.9.20250519 do SDK da FiveAd.

Criado e testado com:

• Versão 24.3.0 do SDK do Google Mobile Ads.
• Versão 2.9.20250519.0 do SDK da FiveAd.

Versão 2.9.20250317.1

• Corrige as dimensões de carregamento de banner para anúncios de lances com a nova API FiveAd.

Criado e testado com:

• Versão 24.1.0 do SDK do Google Mobile Ads.
• Versão 2.9.20250317.0 do SDK da FiveAd

Versão 2.9.20250317.0

• Compatibilidade verificada com a versão 2.9.20250317 do SDK da FiveAd.

Criado e testado com:

• Versão 24.1.0 do SDK do Google Mobile Ads.
• Versão 2.9.20250317.0 do SDK da FiveAd

Versão 2.9.20250110.1

• Atualizamos o nível mínimo necessário da API Android para 23.
• Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 24.0.0.

Criado e testado com:

• Versão 24.0.0 do SDK do Google Mobile Ads.
• Versão 2.9.20250110.0 do SDK da FiveAd

Versão 2.9.20250110.0

• A classe UnifiedNativeAdMapper obsoleta foi removida em favor de NativeAdMapper.
• Processo de coleta de indicadores corrigido.
• Corrigimos o processo de inicialização para formatos de anúncio intersticial e premiado em hierarquia.
• Compatibilidade verificada com a versão 2.9.20250110 do SDK da FiveAd.

Criado e testado com:

• Versão 23.6.0 do SDK do Google Mobile Ads.
• Versão 2.9.20250110.0 do SDK da FiveAd

Versão 2.9.20241129.0

• Adicionamos suporte a lances para formatos de anúncio de banner, intersticial, premiado e nativo.
• Compatibilidade verificada com a versão 2.9.20241129 do SDK da FiveAd.

Criado e testado com:

• Versão 23.5.0 do SDK do Google Mobile Ads.
• Versão 2.9.20241129.0 do SDK da FiveAd

Versão 2.8.20240827.0

• Compatibilidade verificada com a versão 2.8.20240827 do SDK da FiveAd.

Criado e testado com:

• Versão 23.3.0 do SDK do Google Mobile Ads.
• Versão 2.8.20240827.0 do SDK da FiveAd.

Versão 2.8.20240808.0

• Compatibilidade verificada com a versão 2.8.20240808 do SDK da FiveAd.

Criado e testado com:

• Versão 23.2.0 do SDK do Google Mobile Ads.
• Versão 2.8.20240808.0 do SDK da FiveAd

Versão 2.8.20240722.0

• Compatibilidade verificada com a versão 2.8.20240722 do SDK da FiveAd.

Criado e testado com:

• Versão 23.2.0 do SDK do Google Mobile Ads.
• Versão 2.8.20240722.0 do SDK da FiveAd

Versão 2.7.20240515.0

• Compatibilidade verificada com a versão 2.7.20240515 do SDK da FiveAd.

Criado e testado com:

• Versão 23.1.0 do SDK do Google Mobile Ads.
• Versão 2.7.20240515.0 do SDK da FiveAd

Versão 2.7.20240214.1

• Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 23.0.0.
• Compatibilidade verificada com a versão 2.7.20240214 do SDK da FiveAd.

Criado e testado com:

• Versão 23.0.0 do SDK do Google Mobile Ads.
• Versão 2.7.20240214.0 do SDK da FiveAd.

Versão 2.7.20240214.0

• Compatibilidade verificada com a versão 2.7.20240214 do SDK da FiveAd.

Criado e testado com:

• Versão 22.6.0 do SDK do Google Mobile Ads.
• Versão 2.7.20240214.0 do SDK da FiveAd.

Versão 2.7.20240126.0

• Compatibilidade verificada com a versão 2.7.20240126 do SDK da FiveAd.

Criado e testado com:

• Versão 22.6.0 do SDK do Google Mobile Ads.
• Versão 2.7.20240126.0 do SDK da FiveAd.

Versão 2.7.20240112.0

• O FiveAdViewEventListener descontinuado foi removido em favor de FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener e FiveAdNativeEventListener.
• Compatibilidade verificada com a versão 2.7.20240112 do SDK da FiveAd.
• Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 22.6.0.

Criado e testado com:

• Versão 22.6.0 do SDK do Google Mobile Ads.
• Versão 2.7.20240112 do SDK da FiveAd.

Versão 2.6.20230607.1

• Adicionamos a classe LineExtras para que os editores definam as configurações de som padrão para formatos de anúncio de banner, intersticial e premiado.
• Atualizamos a versão mínima necessária do SDK do Google Mobile Ads para 22.4.0.

Criado e testado com:

• Versão 22.4.0 do SDK do Google Mobile Ads.
• Versão 2.6.20230607 do SDK da FiveAd.

Versão 2.6.20230607.0

• Versão inicial.
• Adiciona suporte aos formatos de anúncio de banner, intersticial, premiado e nativo.
• Compatibilidade verificada com a versão 2.6.20230607 do SDK da FiveAd.

Criado e testado com:

• Versão 22.1.0 do SDK do Google Mobile Ads.
• Versão 2.6.20230607 do SDK da FiveAd.