Integrar a LY Ads Network com a mediação

Este guia mostra como usar o Google Mobile Ads 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 rede de publicidade LY Ads Network a um app iOS.

Integrações e formatos de anúncio aceitos

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

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Pré-requisitos

Antes de continuar, verifique o seguinte:

  • Destino de implantação do iOS 13.0 ou mais recente.

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

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.

Novo registro

Preencha o formulário e clique em registration.

Novo formulário de registro

Anote o ID do app.

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 espaço

Preencha o formulário para saber mais sobre o espaço. 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 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.

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 a chave secreta 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, 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

Usar o Gerenciador de Pacotes do Swift

Antes de continuar, você precisa ter a versão mínima do adaptador compatível, que é a 2.9.20251119.

Para adicionar uma dependência de pacote ao seu projeto, siga estas etapas:

  1. No Xcode, acesse File > Add Package Dependencies….

  2. No prompt que aparece, pesquise o seguinte URL do pacote:

    https://github.com/googleads/googleads-mobile-ios-mediation-line.git

  3. Em Regra de dependência, selecione Ramificação.

  4. No campo de texto, digite main.

Usar o CocoaPods

Adicione a seguinte linha ao Podfile do seu projeto:

pod 'GoogleMobileAdsMediationLine'

Na linha de comando, execute:

pod install --repo-update

Integração manual

  • Faça o download da versão mais recente do SDK da rede de publicidade LY e vincule FiveAd.framework ao seu projeto.
  • Baixe a versão mais recente do adaptador da rede de publicidade LY Ads no link de download no registro de alterações e vincule LineAdapter.framework ao seu projeto.

Etapa 4: adicionar o código necessário

Implementar a SKAdNetwork

Siga a documentação da rede de publicidade da 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 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 Google Mobile Ads SDK para garantir que ela seja encaminhada corretamente ao SDK da rede de publicidade LY.

Swift

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

Objective-C

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

Verificar anúncios de teste

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

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 GADMediationAdapterLineExtras. Essa classe inclui as seguintes propriedades:

adAudio
Especifica o estado inicial de som padrão dos anúncios de banner, intersticiais e premiados.

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

Swift

import LineAdapter
// ...

let request = GADRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

Objective-C

#import <LineAdapter/LineAdapter.h>
// ...

GADRequest *request = [GADRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

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 GADNativeAd.

Campo Recursos sempre incluídos pelo adaptador da rede de publicidade LY
Título
Imagem
Corpo
Ícone do app 1
Call-to-action
Classificação por estrela
Loja
Preço

1 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 na resposta do anúncio usando GADResponseInfo.adNetworkInfoArray nas seguintes classes:

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:

Código do erro Domínio Motivo
1-10 Enviado pelo SDK da rede de publicidade LY. 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 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 LY Ads Network.
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 adaptador de mediação do LINE para iOS

Versão 3.1.1.0

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

Criado e testado com:

  • Versão 13.9.0 do SDK do Google Mobile Ads.
  • Versão 3.1.1 do SDK da FiveAd.

Versão 3.1.0.0

  • Agora, a versão mínima do iOS é a 15.0.
  • Compatibilidade verificada com a versão 3.1.0 do SDK da FiveAd.

Criado e testado com:

  • Versão 13.8.0 do SDK do Google Mobile Ads.
  • Versão 3.1.0 do SDK da FiveAd.

Versão 3.0.1.2

  • Atualizamos a versão mínima do iOS para flexibilizar a dependência do SDK do Google Mobile Ads e permitir versões secundárias.
  • Correção de um problema em que o ícone Opções de Anúncios para anúncios nativos era muito grande.

Criado e testado com:

  • Versão 13.4.0 do SDK do Google Mobile Ads.
  • Versão 3.0.1 do SDK da FiveAd.

Versão 3.0.1.1

  • Agora o adaptador encaminha a flag ageRestrictedTreatment do SDK do Google Mobile Ads à API da COPPA do SDK da FiveAd.

Criado e testado com:

  • Versão 13.3.0 do SDK do Google Mobile Ads.
  • Versão 3.0.1 do SDK da FiveAd.

Versão 3.0.1.0

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

Criado e testado com:

  • Versão 13.1.0 do SDK do Google Mobile Ads.
  • Versão 3.0.1 do SDK da FiveAd.

Versão 3.0.0.1

  • Atualizamos a dependência do SDK do Google Mobile Ads para a versão 13.0.0.

Criado e testado com:

  • Versão 13.0.0 do SDK do Google Mobile Ads.
  • Versão 3.0.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 12.14.0 do SDK do Google Mobile Ads.
  • Versão 3.0.0 do SDK da FiveAd.

Versão 2.9.20251119.1

  • Adicionamos suporte para encaminhar os parâmetros tagForUnderAgeOfConsent do SDK dos anúncios para dispositivos móveis do Google ao SDK da FiveAd.

Criado e testado com:

  • Versão 12.14.0 do SDK do Google Mobile Ads.
  • Versão 2.9.20251119 do SDK da FiveAd.

Versão 2.9.20251119.0

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

Criado e testado com:

  • Versão 12.14.0 do SDK do Google Mobile Ads.
  • Versão 2.9.20251119 do SDK da FiveAd.

Versão 2.9.20250930.0

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

Criado e testado com:

  • Versão 12.12.0 do SDK do Google Mobile Ads.
  • Versão 2.9.20250930 do SDK da FiveAd.

Versão 2.9.20250912.0

  • Agora o adaptador inicializa o SDK da FiveAd antes de cada solicitação de anúncio.
  • Compatibilidade verificada com a versão 2.9.20250912 do SDK da FiveAd.

Criado e testado com:

  • Versão 12.11.0 do SDK do Google Mobile Ads.
  • Versão 2.9.20250912 do SDK da FiveAd.

Versão 2.9.20250512.0

  • Agora requer a versão mínima 13.0 do iOS.
  • Compatibilidade verificada com a versão 2.9.20250512 do SDK da FiveAd.

Criado e testado com:

  • Versão 12.4.0 do SDK do Google Mobile Ads.
  • Versão 2.9.20250512 do SDK da FiveAd.

Versão 2.9.20241106.3

  • Correção de um problema em que GADMediationAdapterLine.h não era um cabeçalho público.
  • Ativação das flags -fobjc-arc e -fstack-protector-all.
  • A verificação do tamanho do anúncio de banner para lances foi removida após o carregamento.
    • Os anúncios de banner em hierarquia vão continuar verificando os tamanhos dos anúncios de banner após o carregamento.

Criado e testado com:

  • Versão 12.2.0 do SDK do Google Mobile Ads.
  • Versão 2.9.20241106 do SDK da FiveAd.

Versão 2.9.20241106.2

  • Adicionamos a propriedade GADMediationAdapterLine.testMode para indicar se o SDK da FiveAd precisa ser inicializado no modo de teste. Essa flag precisa ser definida antes de inicializar o SDK do Google Mobile Ads.
  • Removemos a verificação do estado de inicialização do SDK da FiveAd antes de inicializar o SDK.
  • Removemos a verificação de estado do anúncio nativo descontinuada antes de fazer o download dos recursos de anúncios nativos.
  • Agora requer a versão 12.0.0 ou mais recente do SDK do Google Mobile Ads.

Criado e testado com:

  • Versão 12.0.0 do SDK do Google Mobile Ads.
  • Versão 2.9.20241106 do SDK da FiveAd.

Versão 2.9.20241106.1

  • Atualizamos o adaptador para usar a API de carregamento de anúncios mais recente para anúncios de banner de lances.
  • Corrigimos um problema que impedia o encaminhamento correto de eventos de anúncios intersticiais de lances.

Criado e testado com:

  • Versão 11.12.0 do SDK do Google Mobile Ads.
  • Versão 2.9.20241106 do SDK da FiveAd.

Versão 2.9.20241106.0

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

Criado e testado com:

  • Versão 11.12.0 do SDK do Google Mobile Ads.
  • Versão 2.9.20241106 do SDK da FiveAd.

Versão 2.8.20240827.1

  • Atualizamos CFBundleShortVersionString para ter três componentes em vez de quatro.

Criado e testado com:

  • Versão 11.10.0 do SDK do Google Mobile Ads.
  • Versão 2.8.20240827 do SDK da FiveAd.

Versão 2.8.20240827.0

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

Criado e testado com:

  • Versão 11.8.0 do SDK do Google Mobile Ads.
  • Versão 2.8.20240827 do SDK da FiveAd.

Versão 2.8.20240612.0

  • Adicionamos o controle de áudio para anúncios nativos usando GADVideoOptions.
  • Compatibilidade verificada com a versão 2.8.20240612 do SDK da FiveAd.

Criado e testado com:

  • Versão 11.5.0 do SDK do Google Mobile Ads.
  • Versão 2.8.20240612 do SDK da FiveAd.

Versão 2.7.20240411.0

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

Criado e testado com:

  • Versão 11.3.0 do SDK do Google Mobile Ads.
  • Versão 2.7.20240411 do SDK da FiveAd.

Versão 2.7.20240318.0

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

Criado e testado com:

  • Versão 11.2.0 do SDK do Google Mobile Ads.
  • Versão 2.7.20240318 do SDK da FiveAd.

Versão 2.7.20240214.1

  • Agora requer a versão mínima 12.0 do iOS.
  • Agora requer a versão 11.0 ou mais recente do SDK do Google Mobile Ads.
  • Incluímos Info.plist nos frameworks em LineAdapter.xcframework.

Criado e testado com:

  • Versão 11.0.1 do SDK do Google Mobile Ads.
  • Versão 2.7.20240214 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 11.0.1 do SDK do Google Mobile Ads.
  • Versão 2.7.20240214 do SDK da FiveAd.

Versão 2.7.20240126.0

  • Compatibilidade verificada com a versão 2.7.20240126 do SDK da FiveAd.
  • Atualizamos a implementação do adaptador com os novos protocolos de delegação do SDK da FiveAd.

Criado e testado com:

  • Versão 10.14.0 do SDK do Google Mobile Ads.
  • Versão 2.7.20240126 do SDK da FiveAd.

Versão 2.7.20231115.0

  • Compatibilidade verificada com a versão 2.7.20231115 do SDK da FiveAd.
  • Incluímos o cabeçalho GADMediationAdapterLineExtras no modulemap.

Criado e testado com:

  • Versão 10.14.0 do SDK do Google Mobile Ads.
  • Versão 2.7.20231115 do SDK da FiveAd.

Versão 2.6.20230609.1

  • Adicionamos GADMediationAdapterLineAudioState para gerenciar o estado de áudio inicial do anúncio de banner, intersticial e premiado quando ele é mostrado pela primeira vez.

Criado e testado com:

  • Versão 10.14.0 do SDK do Google Mobile Ads.
  • Versão 2.6.20230609 do SDK da FiveAd.

Versão 2.6.20230609.0

  • Versão inicial.
  • Adicionamos suporte à hierarquia para formatos de anúncio de banner, intersticial, premiado e nativo.
  • Compatibilidade verificada com a versão 2.6.20230609 do SDK da FiveAd.

Criado e testado com:

  • Versão 10.9.0 do SDK do Google Mobile Ads.
  • Versão 2.6.20230609 do SDK da FiveAd.