LiaDesenvolvedores

Conceitos

Anúncios em tela cheia em três formatos, mais banners e anúncios nativos que Lia docks ao lado da sua página. Todos reproduzidos por Lia e com ritmo para que ninguém seja sobrecarregado. Seu servidor pode verificar que um vídeo recompensado foi realmente assistido antes de dar algo.

#Três formatos

FormatoO que ele éQuando usar
rewardedUm vídeo que a pessoa escolhe assistir, por algo em troca."Assista a um vídeo para uma segunda chance."
rewardedInterstitialLia oferece primeiro, com Watch e Skip, e depois joga para uma recompensa.Um prêmio em um momento natural, sem seu próprio botão.
interstitialUm anúncio de tela cheia entre momentos, sem nada em troca.Entre rodadas ou níveis. Lia define o ritmo.

Sua página pergunta com Lia.showAd({ format }), ou os atalhos Lia.showRewardedAd(), Lia.showRewardedInterstitialAd() e Lia.showInterstitialAd(). Lia carrega e reproduz o anúncio sobre seu app, com seu próprio carregador enquanto ele carrega, e pausa seu app até que ele'fechado.

#O que você recebe de volta

Cada chamada de anúncio responde depois que o anúncio é fechado:

{ "watched": true, "shown": true, "adId": "ad_8e1c4b0f2a9d47c6b3e15a07" }
CampoSignificado
watchedUma vídeo recompensado foi assistido até o final. Dê a recompensa. Sempre false para um interstício.
shownUm anúncio apareceu na tela.
adIdO anúncio'id, para que seu servidor o verifique. Apresentado quando watched é verdadeiro, e quando uma intersticial foi mostrada.
reasonPor que lá's não tem recompensa, quando watched é falso.

As razões pelas quais'verá:

MotivoSignificado
cancelledEles fecharam o vídeo antes do fim.
skippedEles escolheram Pular quando Lia ofereceu um intersticial recompensado.
no_adNenhuma propaganda estava pronta para ser exibida.
too_soonUma tela intersticial, e não'ainda é sua vez.
failedLia não pode'para registrar a visualização.
Qualquer outra coisaUm problema de conexão ou servidor, como network.

Se um vídeo recompensado parar de tocar parcialmente devido a um problema no telefone, Lia o conta como assistido para que ninguém perca uma recompensa por um anúncio quebrado.

#Qual usar

  • Entre rodadas e jogos: interstícios. Eles'é curto e fechável, e ninguém precisa escolhê-los. Chame Lia.showInterstitialAd() em cada ponto natural (um round termina, Jogar novamente) e deixe Lia decidir se um será exibido.
  • Vídeos recompensados apenas quando o jogador pede para algo em troca: uma dica, uma segunda chance, uma rodada extra, atrás de um botão que diz isso. Nunca jogue um sozinho entre rodadas: um vídeo longo alguém não'não escolher é o que faz as pessoas saírem de um jogo.

#Ritmo

Jogos' os intersticiais têm seu próprio ritmo, separado de Lia'seu próprio anúncios: por padrão, no máximo um a cada 90 segundos, e apenas a cada 2nd vez que seu app pedir (a cada 2nd rodada ou jogo). A equipe Lia pode ajustar ambos. Quando não'para a sua vez, showInterstitialAd() respostas imediatamente com reason: "too_soon" e nada é mostrado. Siga em frente.

Vídeos recompensados não'regulados, porque as pessoas os escolhem, e assistir a um nunca atrasa o próximo anúncio intersticial.

#Seus próprios anúncios do Google, na sua página

Quer um anúncio dentro do seu conteúdo, rolando com ele, como um slot entre as linhas de um feed? Use seus próprios tags de anúncio do Google (AdSense ou Google Ad Manager) na sua página'no HTML, como em qualquer site. Lia registra seu navegador web com o Google's anúncios SDK (o WebView API para Anúncios), então seus tags são servidos como anúncios no app, e:

  • Google's frames de anúncios carregam dentro da sua página. Frames de outros sites ainda são bloqueados, então outras redes de anúncios' tags não'para funcionar.
  • Toque em um anúncio abre-o no Safari, e seu app fica onde estava.
  • O dinheiro vai para sua própria conta do Google, sob suas próprias políticas do Google. Lia não'não conte ou compartilhe esses anúncios, e a regra de modo de teste abaixo não'não cobrir eles: use sua rede'anúncios de teste enquanto você constrói (no Ad Manager, Google'unidade de amostra /6355419/Travel/Europe/France/Paris; em AdSense, data-adtest="on").
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<div id="feed-ad"></div>
<script>
  window.googletag = window.googletag || { cmd: [] };
  googletag.cmd.push(function () {
    googletag.defineSlot("/6355419/Travel/Europe/France/Paris", [300, 250], "feed-ad").addService(googletag.pubads());
    googletag.enableServices();
    googletag.display("feed-ad");
  });
</script>

Precisa de Lia's app da próxima versão. O Demo SDK tem um "Carregue um anúncio de teste aqui" botão que faz exatamente isso.

#Chaves de teste sempre recebem anúncios de teste

Enquanto seu aplicativo estiver em modo de teste (seu desenvolvedor e testadores, com sua chave de teste), cada anúncio Lia que for exibido nele será um dos anúncios do Google'anúncios de teste: tela cheia, banner e nativo, qualquer Lia'seu próprio configuração é. Eles'é gravado (/ads/verify ainda responde por eles) mas nunca contado para o seu app's números ou ganhos. O modo ao vivo mostra anúncios reais.

#Verificação no seu servidor

Para qualquer prêmio que importa, não'para pegar a página's watched: true na sua palavra. Envie o adId para o seu servidor, e faça com que ele pergunte Lia com POST /ads/verify:

{ "adId": "ad_8e1c4b0f2a9d47c6b3e15a07", "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "watched": true, "watchedAt": 1761998400000 }

Verifique se watched é verdadeiro e o playerId é o jogador perguntando. Lia não'marcar um anúncio como usado, para pagar cada adId uma vez que você mesmo: usando ad:<adId> como seu chave de recompensa faz isso por você. Vídeos recompensados que pagam mostra todo o fluxo.

#Seguindo

Passar onState para ouvir cada etapa, ou ouvir cada anúncio com Lia.onAd(fn):

Lia.showRewardedAd({
  onState: function (state) { // "loading", "showing", "closed"
    if (state === "loading") pauseMusic();
    if (state === "closed") resumeMusic();
  },
});

#O que recomendamos para jogos

Anúncios que ficam ao lado do jogo, nunca por cima dele:

  1. Um banner fixado para toda a visita. Chamada Lia.showBanner({ position: "top" }) uma vez, antes Lia.ready(), e espere por ele (ou alguns segundos). Lia's carregador ainda cobre sua página enquanto o banner se fixa, então o jogador nunca vê o layout se mover, e ele permanece fixo enquanto joga. Lia'seu próprio jogos fixa-o no topo: a borda inferior é onde estão os polegares e os botões, e um jogo jogado inclinando ou arrastando precisa de sua área de jogo livre.
  2. Uma linha de anúncio dentro de uma tela calma, como sua casa ou sala de espera, com seu próprio tag de anúncio do Google (veja Seus próprios anúncios do Google). Coloque-o após a tela'seu próprio conteúdo, dê-lhe espaço acima dos seus botões, rotule-o "Anúncio", e mostre apenas uma vez após um anúncio ter preenchido. Nunca coloque-o abaixo de um tabuleiro, um relógio ou um botão que os jogadores pressionam com pressa.
  3. Uma tela intersticial entre rodadas (Lia.showInterstitialAd()) que Lia controla.

Mantenha o cartão nativo e a folha abaixo para apps onde uma pausa realmente é uma pausa. Em um jogo, elas aparecem sobre a ação.

Lia.init().then(function () {
  var banner = Lia.showBanner({ position: "top" }).catch(function () {});
  Promise.race([banner, new Promise(function (r) { setTimeout(r, 2500); })]).then(function () {
    Lia.ready(); // the page shows with the banner's room already taken
  });
});

#Banners e anúncios nativos

Desde SDK 1.7 seu app também pode mostrar um banner e um anúncio nativo em Lia'seu próprio aparência. AdMob pode'não desenhar um anúncio dentro de uma página da web, então Lia desenha esses nativamente, ao lado sua página em vez de dentro dela. Isso'o limite honesto, e ele molda como eles funcionam:

  • Eles nunca cobrem seu app. Um anúncio fixado toma seu espaço da sua página: o web view fica mais curto, então nada que você desenhou fica abaixo dele. Sua layout só precisa se ajustar à altura que ele'dado (100dvh, flexbox, ou --lia-viewport-height todos seguem o seu.
  • Eles podem'para rolar com seu conteúdo. Uma visualização nativa fixada em um ponto em uma página com rolagem ficaria lenta e deslocada, o que parece quebrado. Então lá's não "anúncio no meu feed" slot: anúncios ficam em uma borda, ou aparecem em uma pausa.
ChamadaO que Lia mostraBom para
Lia.showBanner({ position: "bottom" })Uma faixa adaptativa na parte inferior (ou "top") borda, atualizado por AdMob enquanto ele'está disponível.Menus, salas de espera, telas de leitura longa.
Lia.showNativeAd({ placement: "card" })Um cartão compacto (ícone, título, uma linha de texto, seu botão) fixado na borda inferior, com um botão de fechar.Uma tela de resultados, o fim de uma rodada.
Lia.showNativeAd({ placement: "sheet" })Um anúncio maior com sua imagem ou vídeo, em uma folha sobre seu app, que é pausado até que ele'fechado.Um ponto natural para um anúncio de tela cheia que seria muito.
// A results screen: a sponsored card under it while it's up.
showResults();
Lia.showNativeAd({ placement: "card" }); // { shown: true, placement: "card", height: 118 }, or { shown: false, reason }

// The next round: the card goes, and the page gets its room back.
Lia.hideNativeAd();

O que eles respondem:

RespostaSignificado
{ shown: true, position, height }O banner está ativo, height px de altura (cerca de 50 a 90).
{ shown: true, placement, height? }O anúncio nativo está ativo (um cartão, com sua altura), ou a folha foi exibida e agora está fechada.
{ shown: false, reason: "no_ad" }Nada carregado a tempo. Continue.
{ shown: false, reason: "too_soon" }Um anúncio nativo, e ele não'ainda é sua vez.
{ shown: false, reason: "off" }A equipe Lia desativou esse tipo de anúncio, para seu app ou para todos.

O banner e o cartão compartilham a borda inferior. Enquanto o cartão estiver visível, uma faixa inferior se afasta (você ouve "hidden") e volta quando o cartão é fechado. Um banner superior permanece.

Áreas seguras seguem. Na borda onde um anúncio está fixado, Lia adiciona espaço ao redor dele (a barra de casa, o notch), para que envie safeAreaChanged com esse lado em 0 e --lia-safe-area-inset-* atualização. Em tela cheia, um banner superior fica abaixo de Lia'flutuante Close e ⋯, e sua página começa abaixo dela (contentSafeArea.top torna-se 0).

Seguindo. Lia.banner e Lia.nativeAd diga o que'está disponível agora ({ visible, position | placement, height }), --lia-banner-height segura o banner'altura, e Lia.onBanner(fn) e Lia.onNativeAd(fn) ouça cada mudança ("loading", "shown" / "showing", "failed", "hidden" / "closed").

Ritmo. Anúncios nativos estão pelo menos um minuto de distância para cada pessoa (a equipe pode mudar isso), em todos os aplicativos. Banners não'regulados, mas não'faça-os piscar para cima e para baixo: mostre um onde eles podem ficar por um tempo. Nenhum deles conta para os anúncios de tela cheia' ritmo.

#O que você ganha

Você recebe 50% do que os anúncios em seu app ganham, incluindo banners e anúncios nativos. Lia conta cada anúncio que seu app exibe e o que ele ganha, e paga sua parte mensalmente em sua própria conta Lia, com sua parte das vendas. Veja Receber pagamento.

Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês

Digite para pesquisar todas as páginas, métodos e endpoints.