Integrar o Line com a mediação

Selecione a plataforma: Android (Beta) Android iOS Unity Flutter

Este guia mostra como usar GMA Next-Gen SDK para carregar e exibir anúncios da rede de publicidade LINE usando Mediação da AdMob, 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 Android.

A interface do painel da rede de publicidade LINE usa texto em japonês para identificadores, 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 identificadores e botões são traduzidos com os equivalentes em inglês entre parênteses.

Integrações e formatos de anúncio aceitos

O adaptador de mediação da rede de publicidade LINE tem os seguintes recursos:

Requisitos

• API Android nível 24 ou mais recente

• [Para lances]: para integrar todos os formatos de anúncio aceitos em lances, use o adaptador da rede de publicidade LINE 2.9.20241129.0 ou uma versão mais recente (recomendamos usar a última versão)

• Mais recente GMA Next-Gen SDK

• Leia todo o guia para iniciantes da 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).

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

Anote o アプリID (App ID).

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).

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

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

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, implemente um arquivo app-ads.txt. Se ainda não fez isso, configure um arquivo app-ads.txt para seu app.

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

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

Adicione a rede de publicidade LINE à configuração de mediação do seu bloco de anúncios.

Faça login na sua conta do AdMob. Em seguida, navegue até a guia Mediação. Caso queira modificar um grupo de mediação, clique no nome dele para editar e pule para Adicionar a rede de publicidade LINE como uma origem de anúncios.

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

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

Dê um nome ao grupo de mediação e selecione os locais de segmentação. 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úncios da AdMob. Em seguida, clique em Concluído.

O card "Blocos de anúncios" vai aparecer com os blocos selecionados:

Adicionar a rede de publicidade LINE como uma origem de anúncios

Lances

No card Lances da seção Origens de anúncios, selecione Adicionar origem de anúncios. Em seguida, selecione Rede de publicidade LINE.

Clique em Como assinar um contrato de parceria e estabeleça uma parceria de lances com a rede de publicidade LINE.



Clique em Confirmar e concordar e em Continuar.



Se você já tiver um mapeamento para a rede de publicidade LINE, selecione-o. Caso contrário, clique em Adicionar mapeamento.



Em seguida, insira o ID do aplicativo e ID do bloco de anúncios vistos na seção anterior. Em seguida, clique em Concluído.

Cascata

No card Hierarquia da seção Origens de anúncios, selecione Adicionar origem do anúncio.

Selecione Rede de publicidade LINE e ative a chave Otimizar. Insira o Nome de login e a Senha obtidos na seção anterior para configurar a otimização da origem de anúncios para a rede de publicidade LINE. Em seguida, insira um valor de eCPM para a rede de publicidade LINE e clique em Continuar.



Se você já tiver um mapeamento para a rede de publicidade LINE, selecione-o. Caso contrário, clique em Adicionar mapeamento.

Em seguida, insira o ID do aplicativo e o ID do bloco de anúncios vistos na seção anterior. Em seguida, clique em Concluído.

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

Integração com o Android Studio (recomendada)

No arquivo gradle do app, adicione as seguintes dependências e configurações de implementação:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:line:3.0.1.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:line:3.0.1.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Integração manual

1. Faça o download da versão mais recente do SDK da rede de publicidade LINE do arquivo .aar e adicione ao seu projeto.

2. Navegue até os artefatos do adaptador da rede de publicidade LINE no repositório Maven do Google. Selecione a versão mais recente, faça o download do arquivo .aar do adaptador da rede de publicidade LINE e adicione-o ao projeto.

Etapa 4: adicionar o código necessário

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

Etapa 5: testar a implementação

Ativar anúncios de teste

Certifique-se de registrar seu dispositivo de teste na AdMob.

O adaptador da rede de publicidade LINE contém um método auxiliar para ativar o modo de teste da rede de publicidade LINE. Defina essa opção antes de inicializar GMA Next-Gen SDK para garantir que ela seja encaminhada corretamente ao SDK da rede de publicidade LINE.

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

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 Rede de publicidade LINE (hierarquia) origens de anúncios.

Etapas opcionais

Parâmetros específicos da rede

O adaptador da rede de publicidade LINE oferece suporte a um parâmetro de solicitação adicional que pode ser transmitido ao adaptador usando a classe LineExtras. O construtor dessa classe inclui os seguintes parâmetros:

enableAdSound

Um boolean para especificar 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:

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

Como usar anúncios nativos

Renderização do anúncio

O adaptador da rede de publicidade LINE preenche as seguintes descrições de campo avançadas de anúncios nativos para um NativeAd.

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

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

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