Integrar a rede de anúncios da LINE à mediação

Este guia mostra como usar Google Mobile Ads Flutter Plugin para carregar e exibir anúncios da rede de publicidade LINE usando mediação, incluindo integrações em hierarquia. Ele explica como adicionar a rede de publicidade LINE à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da rede de publicidade LINE a um app Flutter.

Integrações e formatos de anúncio aceitos

O adaptador de mediação do Ad Manager para a rede de publicidade LINE tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Nativo

Requisitos

  • Mais recente Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 ou mais recente
  • Para implantação no Android
    • API Android nível da API 23 ou mais recente
  • Para implantação no iOS
    • Destino de implantação do iOS 13.0 ou mais recente
  • Um projeto do Flutter em funcionamento configurado com Google Mobile Ads Flutter Plugin. Consulte Configurar Google Mobile Ads Flutter Plugin para mais detalhes.
  • Configurar a mediação.

Etapa 1: definir as configurações na interface da rede de publicidade LINE

Inscreva-se e faça login na sua conta da rede de publicidade LINE.

Adicionar um novo aplicativo

Navegue até a guia アプリ (App) e clique no botão 新規登録 (New Registration).

Novo registro

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

Novo formulário de inscrição

Anote o アプリID (App ID).

Android

Detalhes do registro

iOS

Detalhes do registro

Criar um espaço do anúncio

Na guia アプリ (App), selecione seu app para conferir os detalhes dele. Na seção スロット (Slot), clique em 追加 (Add).

Adicionar espaço

Preencha o formulário com detalhes sobre o slot. Em Bidding Type, selecione Standard para configurar esse slot para mediação em hierarquia ou Google SDK Bidding para configurar esse slot para Lances do SDK. Clique em 作成 (Create) depois de preencher o formulário.

Adicionar formulário de espaço

Anote o スロットID (Slot ID).

Detalhes do espaço

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, é necessário implementar um arquivo app-ads.txt. Se ainda não fez isso, crie um arquivo app-ads.txt para o Ad Manager.

Para implementar app-ads.txt na rede de publicidade LINE, consulte Sobre o app-ads.txt.

Etapa 2: configurar a demanda da rede de publicidade LINE na interface do Ad Manager

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

Android

Para instruções, consulte a etapa 2 no guia para Android.

iOS

Para instruções, consulte a etapa 2 no guia para iOS.

Etapa 3: importar o SDK e o adaptador da rede de publicidade LINE

Integração pelo pub.dev

Adicione a seguinte dependência com as versões mais recentes do SDK e do adaptador da rede de publicidade LINE no arquivo pubspec.yaml do pacote:

dependencies:
  gma_mediation_line: ^2.0.0

Integração manual

Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para a rede de publicidade LINE, extraia o arquivo baixado e adicione a pasta do plug-in extraído (e o conteúdo dela) ao seu projeto do Flutter. Em seguida, faça referência ao plug-in no arquivo pubspec.yaml adicionando a seguinte dependência:

dependencies:
  gma_mediation_line:
    path: path/to/local/package

Etapa 4: adicionar o código necessário

Android

Nenhum código adicional é necessário para a integração da rede de publicidade LINE.

iOS

Integração da SKAdNetwork

Siga a documentação da rede de publicidade LINE para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto.

Etapa 5: testar a implementação

Ativar anúncios de teste

Certifique-se de registrar seu dispositivo de teste para Ad Manager.

Verificar anúncios de teste

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

Etapas opcionais

Parâmetros específicos da rede

O plug-in de mediação do Flutter da rede de publicidade LINE oferece suporte ao seguinte parâmetro de solicitação adicional, que pode ser transmitido ao adaptador pela classe LineMediationExtras:

  • enableAdSound : especifica o estado de início de som padrão de anúncios de banner, intersticiais e premiados.

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

LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [lineExtras],
);

Códigos de erro

Se o adaptador não receber um anúncio da rede de publicidade LINE, os editores poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo nas seguintes classes:

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

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

Android

Código do erro Domínio Motivo
1-10 com.five_corp.ad O SDK da rede de publicidade LINE retornou um erro específico do SDK. Consulte a documentação da rede de publicidade LINE para mais detalhes.
101 com.google.ads.mediation.line ID do aplicativo ausente ou inválido.
102 com.google.ads.mediation.line ID do slot ausente ou inválido.
103 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 a rede de publicidade LINE.
104 com.google.ads.mediation.line Não foi possível carregar um anúncio intersticial ou premiado devido à falta de contexto de atividade.
105 com.google.ads.mediation.line O SDK da rede de publicidade LINE não conseguiu mostrar um anúncio intersticial ou premiado.
106 com.google.ads.mediation.line Não foi possível carregar um anúncio nativo devido à falta de recursos.

iOS

Código do erro Domínio Motivo
1-10 Enviado pelo SDK da rede de publicidade LINE O SDK da rede de publicidade LINE retornou um erro específico do SDK. Consulte a documentação da rede de publicidade LINE para mais detalhes.
101 com.google.ads.mediation.line Parâmetros de servidor inválidos (por exemplo, ID do aplicativo ou ID 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 a rede de publicidade LINE.
103 com.google.ads.mediation.line Não foi possível carregar um recurso de imagem de ícone de informações no anúncio nativo.

Registro de alterações do adaptador de mediação do Flutter da LINE

Versão 2.0.2 (em andamento)

Versão 2.0.1 (em andamento)

Versão 2.0.0

Versão 1.0.6

Versão 1.0.5

Versão 1.0.4

Versão 1.0.3

Versão 1.0.2

Versão 1.0.1

Versão 1.0.0