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 da Linha usa texto em japonês nos rótulos, botões e descrições. As capturas de tela deste 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 |
2 A integração em cascata está na versão Beta aberta.
3 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 um posicionamento do anúncio
Siga as mesmas etapas para criar posições de anúncio para integrações de lances e hierarquia. Cada posição de anúncio pode ser usada para ambos.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 AdMob interface
Etapa 3: importar o SDK e o adaptador da linha
Usando o CocoaPods (recomendado)
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 do
Line e vincule
FiveAd.framework
ao 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 com a 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 na AdMob.
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 Linha, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios Linha (hierarquia).
Etapas opcionais
Parâmetros específicos da 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 inicial padrão de som de anúncios intersticiais, premiados e de banner.
Confira um exemplo de código para 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 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 |
1 Para anúncios nativos, o SDK da linha 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 da 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 exibidas 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 do Line 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 linha. |
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
Próxima versão
- Atualizamos a API de carregamento de anúncios de banner de lances com a versão mais recente do Five ad.
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 é 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 emLineAdapter.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
- Verificamos a compatibilidade com a versão 2.7.20240214 do SDK do FiveAd.
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.