LiaDesarrolladores

Conceptos

Anuncios en pantalla completa en tres formatos, más banners y anuncios nativos que Lia se acoplan junto a tu página. Todos reproducidos por Lia y programados para que nadie se sature. Su servidor puede verificar que un video recompensado fue realmente visto antes de otorgar algo.

#Tres formatos

Formato¿Qué esCuándo usarlo
rewardedUn video que la persona elige ver, por algo a cambio."Mira un video para una segunda oportunidad."
rewardedInterstitialLia lo ofrece primero, con Ver y Saltar, y luego lo juega por una recompensa.Un premio en un momento natural, sin su propio botón.
interstitialUn anuncio de pantalla completa entre momentos, sin nada a cambio.Entre rondas, Lia las regula.

Tu página pregunta con Lia.showAd({ format }), o las atajos Lia.showRewardedAd(), Lia.showRewardedInterstitialAd() y Lia.showInterstitialAd(). Lia carga y reproduce el anuncio sobre tu aplicación, con su propio cargador mientras carga, y pausa tu aplicación hasta que's cerrado.

#Lo que recibe de vuelta

Cada llamada a anuncio responde una vez que el anuncio está cerrado:

{ "watched": true, "shown": true, "adId": "ad_8e1c4b0f2a9d47c6b3e15a07" }
CampoSignificado
watchedUn video recompensado fue visto hasta el final. Entregue la recompensa. Siempre false para una intersticial.
shownUn anuncio apareció en la pantalla.
adIdEl anuncio's id, para que su servidor lo verifique. Presente cuando watched es verdadero, y cuando se mostró un intersticial.
reason¿Por qué allí'no hay recompensa, cuando watched es falso.

Las razones por las que'verá:

RazónSignificado
cancelledEllos cerraron el video antes de terminar.
skippedEllos eligieron Saltear cuando Lia ofreció un intersticial recompensado.
no_adNo había anuncio listo para mostrar.
too_soonUna pantalla intersticial, y no'aún es su turno.
failedLia no puede'no grabar la vista.
Cualquier otra cosaUn problema de conexión o servidor, como network.

Si un video recompensado se detiene a mitad por un problema en el teléfono, Lia lo cuenta como visto para que nadie pierda una recompensa por un anuncio roto.

#¿Cuál usar

  • Entre rondas y juegos: intersticios. Ellos'son cortos y cerrables, y nadie tiene que elegirlos. Llame Lia.showInterstitialAd() en cada punto natural (un round termina, Jugar de nuevo) y deje que Lia decida si uno se muestra.
  • Vídeos recompensados solo cuando el jugador lo pide para algo a cambio: una pista, una segunda oportunidad, un giro adicional, detrás de un botón que dice eso. Nunca reproduzcas uno solo entre rondas: un video largo que alguien no't elegir es lo que hace que la gente deje un juego.

#Ritmo

Juegos' los intersticiales tienen su propio ritmo, separado de Lia'propios anuncios: por defecto, como máximo uno cada 90 segundos, y solo cada 2nd vez que tu aplicación lo pida (cada 2nd ronda o juego). El equipo Lia puede ajustar ambos. Cuando no'no su turno, showInterstitialAd() responde de inmediato con reason: "too_soon" y nada se muestra. Sigue adelante.

Vídeos recompensados no'no están acelerados, porque la gente los elige, y ver uno nunca retrasa al siguiente intersticial.

#Tus propias publicidades de Google, en tu página

¿Quieres un anuncio dentro de tu contenido, desplazándose con él, como un slot entre filas de un feed? Usa tus propios tags de anuncios de Google (AdSense o Google Ad Manager) en tu página's HTML, como en cualquier sitio web. Lia registra su vista de web con Google's anuncios SDK (el WebView API para Anuncios), así que tus etiquetas se sirven como anuncios dentro de la aplicación, y:

  • Google's marcos de anuncios se cargan dentro de tu página. Los marcos de otros sitios siguen bloqueados, por lo que otras redes publicitarias' no se pueden etiquetar'no funciona.
  • Tocar un anuncio lo abre en Safari, y tu aplicación permanece donde estaba.
  • El dinero va a tu propia cuenta de Google, bajo sus propias políticas de Google. Lia no'contar o compartir estos anuncios, y la regla de modo de prueba a continuación no'cubrirlos: use su red'sus anuncios de prueba mientras construyes (en Ad Manager, Google'la unidad de muestra /6355419/Travel/Europe/France/Paris; en 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>

Necesita Lia'app de la próxima versión. La SDK demo tiene un "Carga un anuncio de prueba aquí" el botón que hace exactamente esto.

#Las claves de prueba siempre reciben anuncios de prueba

Mientras tu app esté abierta en modo de prueba (sus desarrolladores y probadores, con tu clave de prueba), cada anuncio Lia que se muestra en ella es uno de Google'sus anuncios de prueba: de pantalla completa, banner y nativo, cualquiera que Lia'su propio ajuste es. Ellos'se ha grabado (/ads/verify todavía responde por ellos) pero nunca se contará hacia su aplicación'números o ganancias. El modo en vivo muestra anuncios reales.

#Verificación en tu servidor

Para cualquier recompensa que importe, no'no tomar la página's watched: true en su palabra. Envía el adId a tu servidor, y que le pregunte Lia con POST /ads/verify:

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

Verifica que watched es verdadero y el playerId es el jugador que pregunta. Lia no'no marcar un anuncio como usado, por lo que paga cada adId una vez que te autentiques: usando ad:<adId> como su clave de recompensa lo hace por ti. Anuncios recompensados que pagan muestra todo el flujo.

#Siguiendo el ritmo

Pasar onState para escuchar cada etapa, o escuchar cada anuncio con Lia.onAd(fn):

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

#Lo que recomendamos para juegos

Anuncios que están al lado del juego, nunca encima:

  1. Un banner fijado para toda la visita. Llamar Lia.showBanner({ position: "top" }) una vez, antes Lia.ready(), y espera por él (o unos segundos). Lia'tu cargador sigue cubriendo tu página mientras el banner se acopla, así el jugador nunca ve moverse el diseño, y se mantiene fijo mientras juega. Lia'propios juegos lo fija en la parte superior: el borde inferior es donde están los dedos y los botones, y un juego jugado inclinando o arrastrando necesita su área de juego libre.
  2. Una fila de anuncio dentro de una pantalla tranquila, como su hogar o lobby, con su propio tag de anuncio de Google (ver Tus propias publicidades de Google. Colócalo después de la pantalla'propio contenido, déjale espacio encima de tus botones, etiquétalo "Anuncio", y muéstralo solo una vez que un anuncio lo haya llenado. Nunca lo coloques debajo de un tablero, un reloj o un botón que los jugadores presionen con prisa.
  3. Una pantalla intersticial entre rondas (Lia.showInterstitialAd()), que Lia regula.

Mantenga la tarjeta nativa y la hoja inferior para aplicaciones donde una pausa realmente sea una pausa. En un juego, aparecen sobre la acción.

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 y anuncios nativos

Desde SDK 1.7 su aplicación también puede mostrar un banner y un anuncio nativo en Lia'su propia apariencia. AdMob puede'dibujar un anuncio dentro de una página web, así que Lia los dibuja nativamente, al lado tu página en lugar de dentro de ella. Eso'su límite honesto, y define cómo funcionan:

  • Ellos nunca cubren tu aplicación. Un anuncio fijado toma su espacio de tu página: la vista web se acorta, por lo tanto nada de lo que dibujaste se sitúa debajo de él. Tu diseño solo necesita ajustarse a la altura que tiene'dado (100dvh, flexbox, o --lia-viewport-height todos lo siguen).
  • Ellos pueden'no desplazarse con su contenido. Una vista nativa fijada en un punto en una página con desplazamiento se retrasará y se desplazará, lo que parece roto. Por eso'tu no "anuncio en mi feed" slot: los anuncios se sitúan en un borde, o aparecen en un momento de pausa.
Llamar¿Qué muestra LiaÚtil para
Lia.showBanner({ position: "bottom" })Un banner adaptativo en la parte inferior (o "top") borde, refrescado por AdMob mientras que está'se levanta.Menús, salas de espera, pantallas de lectura larga.
Lia.showNativeAd({ placement: "card" })Una tarjeta compacta (icono, título, una línea de texto, su botón) fijada en el borde inferior, con un botón de cierre.Una pantalla de resultados, el final de un round.
Lia.showNativeAd({ placement: "sheet" })Un anuncio más grande con su imagen o video, en una hoja sobre tu aplicación, que se pausa hasta que se's cerrado.Un punto natural de pausa donde un anuncio de pantalla completa sería demasiado.
// 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();

¿Qué responden?

RespuestaSignificado
{ shown: true, position, height }El banner está activo, height de altura (aproximadamente 50 a 90).
{ shown: true, placement, height? }El anuncio nativo está activo (una tarjeta, con su altura), o la hoja se mostró y ahora está cerrada.
{ shown: false, reason: "no_ad" }Nada cargado a tiempo. Sigue adelante.
{ shown: false, reason: "too_soon" }Un anuncio nativo, y no es'aún es su turno.
{ shown: false, reason: "off" }El equipo Lia apagó este tipo de anuncio, para tu aplicación o para todos.

El banner y la tarjeta comparten el borde inferior. Mientras que la tarjeta está visible, una banda inferior se aparta (escuchas "hidden") y vuelve cuando se cierra la tarjeta. Una banda superior permanece.

Áreas seguras siguen. En el borde donde un anuncio está anclado, Lia agrega un espacio alrededor (la barra de inicio, la notch), para que envíe safeAreaChanged con ese lado en 0 y --lia-safe-area-inset-* actualización. En pantalla completa, una banda superior se sitúa debajo de Lia'los botones Cerrar flotantes y ⋯, y tu página comienza debajo de ellos (contentSafeArea.top se convierte en 0).

Siguiendo el ritmo. Lia.banner y Lia.nativeAd dice qué'se levanta ahora ({ visible, position | placement, height }), --lia-banner-height mantiene el banner's altura, y Lia.onBanner(fn) y Lia.onNativeAd(fn) escuchar cada cambio ("loading", "shown" / "showing", "failed", "hidden" / "closed").

Ritmo. Los anuncios nativos están al menos un minuto de distancia para cada persona (el equipo puede cambiarlo), en todas las aplicaciones. Las banderas no'no están acelerados, pero no'parpadearlos encendidos y apagados: mostrar uno donde pueda permanecer un rato. Ninguno cuenta hacia los anuncios de pantalla completa' ritmo.

#Lo que gana

Recibes 50% de lo que ganan los anuncios en tu app, incluidos los anuncios de banners y nativos. Lia cuenta cada anuncio que muestra tu app y lo que gana, y paga tu parte mensualmente en tu propio Lia balance, con tu parte de ventas. Ver Recibir pago.

Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés

Escribe para buscar en cada página, método y punto final.