Anuncios
Los anuncios son cómo ganás en Gamealia: te llevás una parte de lo que generan los anuncios alrededor de tu juego (mirá Ingresos y pagos). Gamealia usa los H5 Games Ads de Google en la página del portal, nunca dentro del frame de tu juego.
Los tipos de anuncio
| Anuncio | Quién lo pide | Reglas |
|---|---|---|
| Pre-roll | El portal, una vez, antes de que cargue tu juego | No tenés que hacer nada |
| Banner | El portal, al costado del juego en pantallas de escritorio de 1200 px o más | Nunca encima del juego |
| Midgame | Tu juego: Gamealia.ad.requestMidgame() | Con límite: al menos 120 s entre midgames |
| Con recompensa | Tu juego: Gamealia.ad.requestRewarded() | Solo cuando el jugador lo eligió; sin límite |
El pre-roll también inicia el intervalo de los midgames, así que el primer midgame puede salir 120 s después.
Midgame
Pedilo en un corte natural: game over, entre niveles, al volver al menú. Nunca en medio del juego.
async function onGameOver() {
Gamealia.game.gameplayStop();
await Gamealia.ad.requestMidgame(); // se resuelve cuando termina la pausa o si se saltea
showGameOverScreen();
}Dentro del límite el portal responde { shown: false } al instante, así que podés pedirlo en cada corte sin llevar la cuenta del tiempo.
Con recompensa
Ofrecelo con un botón ("Mirá un anuncio para una vida extra") y dá la recompensa solo cuando el resultado lo dice:
const { rewarded } = await Gamealia.ad.requestRewarded();
if (rewarded) giveExtraLife();
else showToast("No hay anuncios disponibles ahora");Pausar y silenciar
El portal envía adStart y adEnd alrededor de cada pausa. Pausá el bucle del juego y silenciá el audio entre los dos:
Gamealia.onAdStart(() => { pauseGame(); audio.mute(); });
Gamealia.onAdEnd(() => { audio.unmute(); resumeGame(); });El portal también manda mute y unmute (durante los anuncios, mientras la pestaña está oculta y desde el botón de silencio debajo del juego). Escuchalos también y mantené el audio apagado mientras cualquiera de los dos lo pida:
Gamealia.on("mute", () => audio.mute());
Gamealia.on("unmute", () => audio.unmute());En Unity Gamealia.AutoMuteAudio y en Godot auto_mute_audio (los dos activados por defecto) silencian el audio del motor por vos.
Cuando no se muestra un anuncio
shown: false es normal: el límite de frecuencia, no hay anuncio disponible, un bloqueador de anuncios, o los anuncios están desactivados para el juego. Tu juego tiene que seguir como si la pausa hubiera pasado.
Sin anuncios
Podés desactivar los anuncios de tu juego en la ficha (adsEnabled: false). Entonces cada pedido devuelve { shown: false }, no se muestran pre-roll ni banner, y el juego no genera ingresos. Igual tiene la misma visibilidad en el portal.
Qué no hacer
- Nada de otras redes o SDKs de anuncios (etiquetas de AdSense propias, AdinPlay, GameMonetize, ...): el autotest falla el build y el revisor lo rechaza.
- Nada de midgames en medio del juego, en el primer input, ni varios seguidos.
- Nada de recompensas por un anuncio que no se vio (
rewarded: false). - Nada de botones que simulen ser anuncios o que hagan tocar anuncios.
- Nada de ofertas para "quitar anuncios": no hay compras dentro del juego en v1.
En el mock
En tu máquina, los dos tipos muestran una capa "Mock ad" durante 2 segundos y disparan adStart y adEnd, así probás la pausa y el silencio sin el portal. En el mock no hay límite de frecuencia.