Integrar a LY com a mediação

Este guia mostra como usar o GMA Next-Gen SDK para carregar e exibir anúncios da rede de publicidade LY usando a Mediação da AdMob, 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 Android.

Integrações e formatos de anúncio aceitos

O adaptador de mediação da Rede de publicidade LY tem os seguintes recursos:

Pré-requisitos

Antes de continuar, verifique o seguinte:

• API Android nível 24 ou mais recente.

• [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o adaptador da rede de publicidade LY 2.9.20241129.0 ou uma versão mais recente (recomendamos usar a última versão).

• Versão mais recente do GMA Next-Gen SDK.

• Configure a Mediação da AdMob.

Etapa 1: definir as configurações na interface da rede de publicidade LY Ads

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.

Preencha o formulário e clique em registration.

Anote o ID do app.

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.

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.

Anote o ID do slot.

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

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.

Preencha o formulário e clique em Salvar.

Anote o ID da chave de API e a chave secreta da 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, configure um arquivo app-ads.txt para seu app.

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 LY na interface da AdMob

Definir as configurações de mediação do bloco de anúncios

Adicione a LY Ads Network à configuração de mediação do seu bloco de anúncios.

Faça login na sua conta da AdMob. Navegue até a guia Mediação. Se você tiver um grupo de mediação que quer modificar, clique no nome dele para editar e pule para Adicionar a LY Ads Network como uma rede de publicidade.

Para criar um novo grupo de mediação, selecione Criar grupo de mediação.

Insira o formato e a plataforma do anúncio, depois clique em Continuar.

Dê um nome ao grupo de mediação e selecione os locais de segmentação. Em seguida, defina o status do grupo de mediação como Ativado e clique em Adicionar blocos de anúncios.

Associe esse grupo de mediação a um ou mais dos seus blocos de anúncios da AdMob. Em seguida, clique em Concluído.

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar a LY Ads Network como uma origem de anúncios

Lances

Na seção Origens de anúncios, encontre o card Lances e selecione Adicionar origem de anúncios. Em seguida, selecione LY Ads Network.

Clique em Como assinar um contrato de parceria e configure uma parceria de lances com a Rede de publicidade LY Ads Network.



Clique em Confirmar e concordar e em Continuar.



Se você já tiver um mapeamento para a rede de publicidade LY Ads, selecione-o. Caso contrário, clique em Adicionar mapeamento.



Em seguida, insira o ID do aplicativo e o ID do espaço vistos na seção anterior. Em seguida, clique em Concluído.

Cascata

No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.

Selecione LY Ads Network e ative a chave Otimizar. Insira o ID da chave de API e o segredo da chave de API obtidos na seção anterior para configurar a otimização da origem de anúncios para a rede de publicidade LY Ads. Em seguida, insira um valor de eCPM para a LY Ads Network e clique em Continuar.




Se você já tiver um mapeamento para a rede de publicidade LY, selecione-o. Caso contrário, clique em Adicionar mapeamento.



Em seguida, insira o ID do aplicativo e o ID do espaço obtidos na seção anterior. Em seguida, clique em Concluído.

Etapa 3: importar o SDK e o adaptador da rede de publicidade LY Ads

Integração com o Android Studio (recomendada)

No arquivo do Gradle no nível do app, adicione as seguintes dependências e configurações de implementação:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integração manual

1. Faça o download da versão mais recente do arquivo .aar do SDK da rede de publicidade LY e adicione ao seu projeto.

2. Acesse os artefatos do adaptador da rede de publicidade LY 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

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

Etapa 5: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob.

O adaptador da rede de publicidade LY Ads contém um método auxiliar para ativar o modo de teste da rede de publicidade LY Ads. Defina essa opção antes de inicializar o GMA Next-Gen SDK para garantir que ela seja encaminhada corretamente ao SDK da rede de publicidade 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 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 adaptador da rede de publicidade LY aceita 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 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:

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 as seguintes descrições de campos de anúncios nativos avançados para um NativeAd.

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

Códigos de erro

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

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

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

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

Versão 3.1.1.2

• Fixe a dependência do Kotlin do adaptador em 1.9.0 (a versão mínima do Kotlin compatível com o SDK do GMA NextGen).

Criado e testado com:

• Versão 25.4.0 do SDK do Google Mobile Ads.
• Versão 1.4.0 do SDK Next-Gen do Google Mobile Ads.
• Versão 3.1.1.1 do SDK da FiveAd.

Versão 3.1.1.1

• Mapeia AgeRestrictedTreatment para a API ChildDirectedTreatment do Line.

Criado e testado com:

• Versão 25.4.0 do SDK do Google Mobile Ads.
• Versão 1.2.1 do SDK Next-Gen do Google Mobile Ads.
• Versão 3.1.1.1 do SDK da FiveAd.

Versão 3.1.1.0

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

Criado e testado com:

• Versão 25.2.0 do SDK do Google Mobile Ads.
• Versão 1.2.1 do SDK Next-Gen do Google Mobile Ads.
• Versão 3.1.1.0 do SDK da FiveAd.

Versão 3.1.0.0

• Adicionamos uma 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 Next-Gen do Google Mobile Ads.
• 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 da 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 dos anúncios para dispositivos móveis do Google 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

• As referências de nível de classe ao Context foram 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

• Correção das dimensões de carregamento de banners 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 descontinuada foi removida em favor de NativeAdMapper.
• Correção do processo de coleta de indicadores.
• 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 uso de FiveAdViewEventListener foi descontinuado 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 publishers 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.
• Adição de 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.