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 exibir anúncios do 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 iOS.

A interface do painel da Linha usa texto em japonês nos rótulos, botões e descrições. As capturas de tela neste guia não foram traduzidas. No entanto, nas descrições e instruções deste guia, os rótulos e botões são traduzidos com os equivalentes em inglês entre parênteses.

Integrações e formatos de anúncio compatíveis

O adaptador de mediação para a plataforma Line tem os seguintes recursos:

Integração
Lances
Cascata  1
Formatos
Banner
Intersticial
Premiado
Nativo

1 A integração em cascata está em Beta fechado. Entre em contato com seu gerente de contas para solicitar acesso.

Requisitos

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

  • SDK dos anúncios para dispositivos móveis do Google mais recente

  • Concluir o Guia para iniciantes de 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 do Ad Manager

Faça login na sua conta do Ad Manager.

Adicionar linha em empresas

Lances

Esta etapa não é necessária para integrações de lances.

Cascata

Acesse Administrador > Empresas e clique no botão Nova empresa na guia Todas as empresas. Selecione Rede de publicidade.

Selecione Linha como a Rede de publicidade, insira um Nome exclusivo e ative a Mediação.

Não é necessário inserir um Nome de usuário ou uma Senha. Clique em Salvar quando terminar.

Ativar o compartilhamento de indicador seguro

Lances

Acesse Administrador > Configurações globais. Acesse a guia Configurações da conta do Ad Exchange e ative o Compartilhamento de indicadores seguros. Clique em Salvar.

Cascata

Esta etapa não é necessária para integrações em hierarquia.

Configurar os lances de linha

Lances

Navegue até Exibição > Bidders e clique em Novo bidder na guia Lances do SDK.

Selecione Linha como o bidder.

Ative Adicionar a biblioteca de indicadores deste bidder à lista de indicadores permitidos e Permitir que os indicadores sejam compartilhados com este bidder. Em seguida, clique em Continuar.

Clique em Continuar.

Clique em Concluído.

Cascata

Esta etapa não é necessária para integrações em hierarquia.

Configurar o mapeamento de blocos de anúncios

Lances

Navegue até Envio > Bidders e selecione a empresa para a linha na guia Lances do SDK.

Acesse a guia Mapeamento de bloco de anúncios e clique em Novo mapeamento de bloco de anúncios.

Escolha Bloco de anúncios específico. Selecione um bloco de anúncios e formato, App para dispositivos móveis como o Tipo de inventário e seu Aplicativo para dispositivos móveis. Em seguida, insira o ID do aplicativo e o ID do slot recebidos na seção anterior. Por fim, clique em Salvar.

Cascata

Acesse Exibição > Grupos de rendimento e clique no botão Novo grupo de rendimento. Selecione o aplicativo para dispositivos móveis.

Role a tela para baixo e clique em Adicionar parceiro de rendimento.

Selecione a empresa que você criou para a linha na seção anterior. Escolha Mediação do SDK para dispositivos móveis como o Tipo de integração, iOS como a Plataforma e Ativo como o Status.

Insira o ID do aplicativo e o ID do slot recebidos na seção anterior e o valor do CPM padrão. Clique em Salvar.

Etapa 3: importar o SDK e o adaptador da linha

Adicione a seguinte linha ao Podfile do 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 do Line e vincule FiveAd.framework ao seu projeto.
  • Faça o download da versão mais recente do adaptador de linha no link de download no Changelog e vincule LineAdapter.framework no seu projeto.

Etapa 4: adicionar o código necessário

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 no Ad Manager.

Siga as instruções na documentação do Line para ativar os anúncios de teste do Line.

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 adaptador de linha oferece suporte a 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 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:

Swift

import LineAdapter
// ...

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

Objective-C

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

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

Como usar anúncios nativos

Renderização do anúncio

O adaptador de linha preenche os seguintes campos para um GADNativeAd.

Campo Recursos sempre incluídos pelo adaptador de linha
Título
Imagem
Corpo
Ícone do app 1
Call-to-action
Star rating
Loja
Preço

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

Códigos de erro

Se o adaptador não receber um anúncio do Line, você poderá verificar o erro subjacente da resposta do anúncio usando GADResponseInfo.adNetworkInfoArray nas seguintes classes:

GADMediationAdapterLine

Confira os códigos e as mensagens enviadas pelo adaptador de linha quando um anúncio não é carregado:

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 adaptador de mediação do LINE para iOS

Versão 2.9.20241106.1

  • O adaptador foi atualizado para usar a API de carregamento de anúncios mais recente para lances de anúncios de banner.
  • Correção de um problema que impedia que os eventos de anúncios fossem encaminhados corretamente para lances de anúncios intersticiais.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.12.0.
  • SDK do FiveAd versão 2.9.20241106.

Versão 2.9.20241106.0

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

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.12.0.
  • SDK do FiveAd versão 2.9.20241106.

Versão 2.8.20240827.1

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

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.10.0.
  • SDK do FiveAd versão 2.8.20240827.

Versão 2.8.20240827.0

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

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.8.0.
  • SDK do FiveAd versão 2.8.20240827.

Versão 2.8.20240612.0

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

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.5.0.
  • SDK do FiveAd versão 2.8.20240612.

Versão 2.7.20240411.0

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

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.3.0.
  • SDK do FiveAd versão 2.7.20240411.

Versão 2.7.20240318.0

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

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.2.0.
  • SDK do FiveAd versão 2.7.20240318.

Versão 2.7.20240214.1

  • Agora requer a versão mínima do iOS 12.0.
  • Agora é necessário usar o SDK dos anúncios para dispositivos móveis do Google versão 11.0 ou mais recente.
  • Incluiu Info.plist nos frameworks em LineAdapter.xcframework.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.0.1.
  • SDK do FiveAd versão 2.7.20240214.

Versão 2.7.20240214.0

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

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 11.0.1.
  • SDK do FiveAd versão 2.7.20240214.

Versão 2.7.20240126.0

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

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.14.0.
  • SDK do FiveAd versão 2.7.20240126.

Versão 2.7.20231115.0

  • Compatibilidade verificada com o SDK do FiveAd versão 2.7.20231115.
  • Incluiu o cabeçalho GADMediationAdapterLineExtras no modulemap.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.14.0.
  • SDK do FiveAd versão 2.7.20231115.

Versão 2.6.20230609.1

  • Adição de GADMediationAdapterLineAudioState para gerenciar o estado de áudio inicial do anúncio de banner, intersticial e recompensado quando ele é exibido pela primeira vez.

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.14.0.
  • SDK do FiveAd versão 2.6.20230609.

Versão 2.6.20230609.0

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

Criado e testado com:

  • SDK dos anúncios para dispositivos móveis do Google versão 10.9.0.
  • SDK do FiveAd versão 2.6.20230609.