Integrar a rede de anúncios do LINE à 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 do Line usando mediação, 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 da Rede de anúncios LINE usa texto em japonês para 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 rede de anúncios do LINE tem os seguintes recursos:

² 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

• Conclua o Guia para iniciantes da mediação.

Etapa 1: configurar a interface da rede de anúncios LINE

Faça login na sua conta da Rede de anúncios LINE.

Adicionar um novo aplicativo

Clique em 広告枠管理 (Gerenciamento de espaços publicitários) > メディア (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 da rede de anúncios do LINE na interface do Ad Manager

Faça login na sua conta do Ad Manager.

Adicionar a rede de anúncios do LINE em empresas

Ativar o compartilhamento de indicador seguro

Compartilhar indicador seguro em solicitações de lance

Permitir o compartilhamento de indicadores seguros para lances do SDK

Configurar lances da LINE Ads Network

Configurar o mapeamento de blocos de anúncios

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

Como usar 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 da rede de anúncios LINE e vincule FiveAd.framework ao seu projeto.
• Faça o download da versão mais recente do adaptador da rede de anúncios do LINE no link de download no Changelog e conecte LineAdapter.framework no seu projeto.

Etapa 4: adicionar o código necessário

Integração da SKAdNetwork

Siga a documentação da LINE Ads Network 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.

Verificar anúncios de teste

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

Etapas opcionais

Parâmetros específicos da rede

O adaptador de rede da rede de anúncios do LINE 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:

import LineAdapter
// ...

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

#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 da rede de anúncios do LINE preenche os seguintes campos para um GADNativeAd.

¹ Para anúncios nativos, o SDK da rede de anúncios LINE não fornece um recurso de ícone de app. Em vez disso, o adaptador da rede de anúncios LINE 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 do LINE, verifique o erro subjacente da resposta do anúncio usando GADResponseInfo.adNetworkInfoArray nas seguintes classes:

GADMediationAdapterLine

Confira os códigos e as mensagens exibidas pelo adaptador da rede de anúncios da LINE quando um anúncio não é carregado:

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

Próxima versão

• A lógica que verifica se o SDK do FAD foi registrado na configuração do adaptador foi removida.
• Atualizamos a API "show" dos anúncios intersticiais e premiados com a nova API "showWithViewController:".
• A verificação do estado do anúncio nativo foi removida antes do download dos recursos de anúncios nativos porque ela foi descontinuada e não há substituição.

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.
• Foi adicionado suporte a lances para formatos de anúncios de 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

• Adicionamos o 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 premiado 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.
• Adicionamos suporte à hierarquia para formatos de anúncios 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.