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 mostrar anúncios da Line usando Mediação da AdMob, cobrindo integrações em hierarquia. 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 para linhas usa texto em japonês para os 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 Line tem os seguintes recursos:

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

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

² A integração em cascata está na versão Beta aberta.

³ Esse formato só é aceito na integração em cascata.

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 explicativo 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

Siga as mesmas etapas para criar posições de anúncio para integrações de lances e hierarquia. Cada posicionamento do anúncio pode ser usado para ambos.

Clique no ID do aplicativo em que você quer adicionar uma veiculação de anúncios. Em seguida, selecione 詳細 (Detalhe).

Clique em ▾Resizeット 追加 (Adicionar slot).

Preencha o formulário e, quando terminar, clique em (登録) Register.

Observação :entre em contato com seu gerente de contas da rede de anúncios de linha para criar canais de anúncios nativos na interface do Line.

Anote o ID do slot.

Etapa 2: configurar a demanda de linha na AdMob interface

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

Você precisa adicionar Line à configuração de mediação do seu bloco de anúncios.

Primeiro, faça login na sua conta da AdMob. Em seguida, acesse a guia Mediação. Se você quiser modificar um grupo de mediação, clique no nome dele para editá-lo e prossiga para Adicionar Line como uma origem de anúncios.

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

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

Atribua um nome ao seu grupo de mediação e selecione locais para segmentar. 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únciosAdMob existentes. Em seguida, clique em Concluído.

Agora você verá o card de blocos de anúncios preenchido com os blocos selecionados:

Adicionar Line como uma origem de anúncios

Lances

No card Lances na seção Origens de anúncios, selecione Adicionar Origem do anúncio. Em seguida, selecione Line.

Clique em Como assinar um contrato de parceria e configure um lance parceria com Line.

Clique em Reconhecer e concordar e clique em Continuar.

Se você já tem um mapeamento para Line, poderá selecioná-lo. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o Application ID and Slot ID recebido na seção anterior. Em seguida, clique em Concluído.

Importante: o Application ID precisa associadas ao aplicativo segmentado, conforme Line interface.

Cascata

No card Cascata, na seção Origens de anúncios, selecione Adicionar origem do anúncio. Em seguida, selecione Line.

Selecione Line. Em seguida, insira um valor de eCPM para Line e clique em Continuar.

Observação :só é necessário configurar a otimização da origem de anúncios uma vez por rede.

Se você já tem um mapeamento para Line, pode selecioná-lo. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o Application ID and Slot ID recebido na seção anterior. Em seguida, clique em Concluído.

Importante: o Application ID precisa estar associado ao app de destino, como na Line interface.

Etapa 3: importar o SDK e o adaptador da linha

Observação :a não integração das versões compatíveis do SDK dos anúncios para dispositivos móveis do Google e de linha pode levar a problemas de build.

Usando o CocoaPods (recomendado)

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 em AdMob

Siga as instruções na Documentação do Line sobre como ativar anúncios de teste de linha.

Importante: desative o modo de teste para AdMob e Line antes de lançar o app.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do Line, ative os testes de uma única origem no Ad Inspector usando as Line (Waterfall) origens de anúncios.

Etapas opcionais

Parâmetros específicos de rede

O adaptador de linha oferece suporte a um parâmetro de solicitação extra 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.

Veja um exemplo de código que explica 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];

Usar anúncios nativos

Renderização de anúncios

O adaptador de linha preenche os seguintes descrições dos campos de anúncios nativos avançados 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

¹ Para anúncios nativos, o SDK do Line não fornece um recurso de ícone do 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ê pode verificar o erro subjacente da resposta do anúncio usando GADResponseInfo.adNetworkInfoArray nas seguintes classes:

GADMediationAdapterLine

Veja a seguir os códigos e as mensagens correspondentes gerados 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.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

• Verificamos a compatibilidade com a versão 2.7.20240411 do SDK do FiveAd.

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 requer a versão 11.0 ou mais recente do SDK dos anúncios para dispositivos móveis do Google.
• 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

• Verificamos a compatibilidade com a versão 2.7.20240126 do SDK do FiveAd.
• Atualizamos a implementação do adaptador com os novos protocolos de delegação do SDK 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

• Verificamos a compatibilidade com a versão 2.7.20231115 do SDK do FiveAd.
• Inclusão do 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

• GADMediationAdapterLineAudioState foi adicionado para gerenciar o estado inicial de áudio do banner, intersticial e anúncio premiado quando é 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.
• Foi adicionada a hierarquia para os formatos de banner, intersticial, premiado e nativo.
• Verificamos a compatibilidade com a versão 2.6.20230609 do SDK do FiveAd.

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.