Conceitos
Anúncios
Copiar página
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
| Formato | O que ele é | Quando usar |
|---|---|---|
rewarded | Um vídeo que a pessoa escolhe assistir, por algo em troca. | "Assista a um vídeo para uma segunda chance." |
rewardedInterstitial | Lia 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. |
interstitial | Um 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" }| Campo | Significado |
|---|---|
watched | Uma vídeo recompensado foi assistido até o final. Dê a recompensa. Sempre false para um interstício. |
shown | Um anúncio apareceu na tela. |
adId | O anúncio'id, para que seu servidor o verifique. Apresentado quando watched é verdadeiro, e quando uma intersticial foi mostrada. |
reason | Por que lá's não tem recompensa, quando watched é falso. |
As razões pelas quais'verá:
| Motivo | Significado |
|---|---|
cancelled | Eles fecharam o vídeo antes do fim. |
skipped | Eles escolheram Pular quando Lia ofereceu um intersticial recompensado. |
no_ad | Nenhuma propaganda estava pronta para ser exibida. |
too_soon | Uma tela intersticial, e não'ainda é sua vez. |
failed | Lia não pode'para registrar a visualização. |
| Qualquer outra coisa | Um 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:
- Um banner fixado para toda a visita. Chamada
Lia.showBanner({ position: "top" })uma vez, antesLia.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. - 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.
- 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-heighttodos 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.
| Chamada | O que Lia mostra | Bom 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:
| Resposta | Significado |
|---|---|
{ 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