LiaDéveloppeurs

Concepts

Des publicités en plein écran en trois formats, plus des bannières et des publicités natives qui Lia s'alignent à côté de votre page. Toutes jouées par Lia et rythmées de manière à ce que personne ne soit submergé. Votre serveur peut vérifier qu'une vidéo récompensée a vraiment été regardée avant de donner quoi que ce soit.

#Trois formats

FormatCe qu'il estQuand l'utiliser
rewardedUne vidéo que la personne choisit de regarder, en échange de quelque chose."Regardez une vidéo pour une seconde chance."
rewardedInterstitialLia le propose d'abord, avec Regarder et Passer, puis le joue pour une récompense.Une récompense à un point naturel, sans votre propre bouton.
interstitialUne publicité pleine page entre moments, sans rien en retour.Entre les tours, Lia les gère.

Votre page demande avec Lia.showAd({ format }), ou les raccourcis Lia.showRewardedAd(), Lia.showRewardedInterstitialAd() et Lia.showInterstitialAd(). Lia charge et joue la publicité au-dessus de votre application, avec son propre chargeur pendant qu'il charge, et met votre application en pause jusqu'à ce qu'elle'fermé.

#Ce que vous récupérez

Chaque appel publicitaire répond une fois que l'annonce est fermée :

{ "watched": true, "shown": true, "adId": "ad_8e1c4b0f2a9d47c6b3e15a07" }
ChampSignification
watchedUne vidéo récompensée a été regardée jusqu'à la fin. Donnez la récompense. Toujours false pour une bannière.
shownUne publicité s'affiche à l'écran.
adIdLa publicité'id, pour que votre serveur le vérifie. Présent lorsque watched est vrai, et lorsqu'une bannière a été affichée.
reasonPourquoi là'le non récompense, lorsque watched est faux.

Les raisons pour lesquelles'vous verrez :

RaisonSignification
cancelledIls ont fermé la vidéo avant la fin.
skippedIls ont choisi de passer quand Lia a proposé une bannière récompensée.
no_adAucune publicité n'était prête à s'afficher.
too_soonUne interstitielle, et elle n'est pas'ne pas être son tour encore.
failedLia ne pouvait pas'n'enregistre pas la vue.
Tout autre choseUn problème de connexion ou de serveur, comme network.

Si une vidéo récompensée s'arrête pendant qu'elle joue à cause d'un problème sur le téléphone, Lia la compte comme regardée afin que personne ne perde une récompense à cause d'une publicité cassée.

#Quel utiliser

  • Entre les tours et les jeux : des interstitiels. Ils'est court et closable, et personne n'a besoin de les choisir. Appelez Lia.showInterstitialAd() à chaque point naturel (une manche se termine, Jouer à nouveau) et laissez Lia décider s'il faut en afficher un.
  • Vidéos récompensées uniquement lorsqu'un joueur les demande pour quelque chose en échange : un indice, une seconde chance, une rotation supplémentaire, derrière un bouton qui le dit. Ne jouez jamais un seul entre les tours : une longue vidéo que quelqu'un ne'ne pas choisir est ce qui fait que les gens quittent un jeu.

#Rythme

Jeux' les interstitiels ont leur propre rythme, distinct de Lia'son ads : par défaut, au plus un toutes les 90 secondes, et uniquement toutes les 2nd fois que votre application demande (toutes les 2nd tours ou jeux). L'équipe Lia peut ajuster les deux. Lorsque ce n'est pas'leur tour, showInterstitialAd() réponds immédiatement avec reason: "too_soon" et rien n'est affiché. Continuez simplement.

Vidéos récompensées uniquement lorsqu'un joueur les demande'ne sont pas rythmés, car les gens les choisissent, et regarder l'un n'empêche jamais le suivant.

#Vos propres publicités Google, sur votre page

Souhaitez-vous une publicité à l'intérieur de votre contenu, qui défilerait avec, comme une case entre les lignes d'un fil ? Utilisez vos propres balises Google (AdSense ou Google Ad Manager) sur votre page's HTML, comme sur n'importe quel site web. Lia enregistre sa vue web avec Google'les publicités s'affichent SDK (le WebView API pour les publicités), donc vos balises sont diffusées comme des publicités intégrées à l'application, et :

  • Google'les cadres publicitaires s'affichent à l'intérieur de votre page. Les cadres provenant d'autres sites sont toujours bloqués, donc d'autres réseaux publicitaires' n'a pas été enregistré'fonctionne.
  • Appuyer sur une publicité l'ouvre dans Safari, et votre application reste là où elle était.
  • L'argent va à votre propre compte Google, sous vos propres politiques Google. Lia ne'ne pas compter ou partager ces publicités, et la règle de mode test ci-dessous ne'ne pas les couvrir : utilisez votre réseau'côté, les bannières de test pendant que vous construisez (dans le gestionnaire d'annonces, Google'unité d'exemple /6355419/Travel/Europe/France/Paris; dans 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>

A besoin de Lia'votre application de la prochaine version. Le SDK démo a un "Chargez une publicité de test ici" bouton qui fait exactement cela.

#Les clés de test reçoivent toujours des publicités de test

Tant que votre application est ouverte en mode test (ses développeurs et testeurs, avec votre clé de test), chaque publicité Lia qui s'affiche est l'une de Google'côté, les bannières de test : pleine page, bannière et native, quel que soit Lia'son propre paramètre est. Ils'êtes enregistrés (/ads/verify répond encore pour eux) mais jamais compté vers votre application'nombres ou gains. Le mode en direct affiche des publicités réelles.

#Vérification sur votre serveur

Pour toute récompense qui compte, ne'prendre la page's watched: true sur ses mots. Envoyez le adId à votre serveur, et faites-la demander à Lia avec POST /ads/verify:

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

Vérifiez que watched est vrai et le playerId est le joueur qui demande. Lia ne'ne pas marquer une publicité comme utilisée, donc payez chaque adId une fois vous-même : en utilisant ad:<adId> en tant que votre clé de récompense le fait pour vous. Publicités récompensées qui paient montre l'ensemble du flux.

#En suivant

Passer onState pour entendre chaque étape, ou écouter chaque publicité avec Lia.onAd(fn):

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

#Ce que nous recommandons pour les jeux

Les publicités qui s'affichent à côté du jeu, jamais au-dessus :

  1. Une bannière fixée pour toute la visite. Appel Lia.showBanner({ position: "top" }) une fois, avant Lia.ready(), et attendez-le (ou quelques secondes). Lia'le chargeur continue à couvrir votre page pendant que le bandeau s'ancrage, de sorte que le joueur ne voit jamais le déplacement du layout, et il reste en place pendant qu'il joue. Lia'ses propres jeux le fixent en haut : le bord inférieur est là où se trouvent les pouces et les boutons, et un jeu joué en inclinant ou en glissant a besoin de son aire de jeu libre.
  2. Une rangée de publicité à l'intérieur d'un écran calme, tels que votre maison ou votre lobby, avec votre propre balise Google (voir Vos propres publicités Google). Placez-le après l'écran'son propre contenu, laissez-lui de la place au-dessus de vos boutons, étiquetez-le "Annonce", et affichez-le uniquement une fois qu'une publicité l'a rempli. Ne le placez jamais sous un tableau, une horloge ou un bouton que les joueurs pressentent rapidement.
  3. Une interstitielle entre les tours (Lia.showInterstitialAd()) que Lia gère.

Gardez la carte native et la feuille ci-dessous pour les applications où une pause est vraiment une pause. Dans un jeu, elles apparaissent au-dessus de l'action.

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
  });
});

#Bannières et publicités natives

Depuis SDK 1.7, votre application peut également afficher une bannière, et une publicité native dans Lia'son propre look. AdMob peut'ne pas afficher une publicité à l'intérieur d'une page web, donc Lia affiche ces publicités nativement, à côté de votre page au lieu de l'intérieur. Cela'la limite honnête, et cela façonne la manière dont ils fonctionnent :

  • Ils ne couvrent jamais votre application. Une publicité ancrée prend sa place de votre page : le web view devient plus court, donc rien de ce que vous avez dessiné ne se trouve dessous. Votre mise en page n'a qu'à s'adapter à la hauteur qu'elle'donné (100dvh, flexbox, ou --lia-viewport-height tous la suivent).
  • Ils peuvent'ne fait pas défiler avec votre contenu. Une vue native ancrée à un endroit dans une page défilante ferait des saccades et déraperait, ce qui a l'air cassé. Donc là'le non "une publicité dans mon fil d'actualité" emplacement : les publicités se situent sur le bord, ou apparaissent lors d'une pause.
AppelCe que Lia montreBon pour
Lia.showBanner({ position: "bottom" })Un bannière adaptative en bas (ou "top") bord, rafraîchi par AdMob pendant qu'elle'est en ligne.Menus, salons d'attente, écrans de lecture longue.
Lia.showNativeAd({ placement: "card" })Une carte compacte (icône, titre, une ligne de texte, son bouton) ancrée au bord inférieur, avec un bouton de fermeture.Un écran de résultats, la fin d'un tour.
Lia.showNativeAd({ placement: "sheet" })Une publicité plus grande avec sa photo ou sa vidéo, dans une feuille au-dessus de votre application, qui est mise en pause jusqu'à ce qu'elle'fermé.Une pause naturelle où une publicité pleine écran serait trop forte.
// 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();

Ce qu'ils répondent :

RéponseSignification
{ shown: true, position, height }La bannière est active, height haute de px (environ 50 à 90).
{ shown: true, placement, height? }La publicité native est affichée (une carte, avec sa hauteur), ou la feuille a été affichée et est maintenant fermée.
{ shown: false, reason: "no_ad" }Rien chargé à temps. Continuez.
{ shown: false, reason: "too_soon" }Une publicité native, et elle n''ne pas être son tour encore.
{ shown: false, reason: "off" }L'équipe Lia a désactivé ce type de publicité, pour votre application ou pour tout le monde.

Une bannière et la carte partagent le bord inférieur. Tant que la carte est affichée, une bannière en bas se déplace (vous entendez "hidden") et revient quand la carte se ferme. Une bannière en haut reste.

Zones sécurisées suivantes. À l'extrémité où une publicité est ancrée, Lia ajoute un espace autour (la barre d'accueil, le trou), donc il envoie safeAreaChanged avec ce côté à 0 et --lia-safe-area-inset-* mise à jour. En plein écran, une bannière supérieure est située sous Lia'flottant Fermer et ⋯, et votre page commence en dessous (contentSafeArea.top devient 0).

En suivant. Lia.banner et Lia.nativeAd dire ce'est en ligne maintenant ({ visible, position | placement, height }), --lia-banner-height garde la bannière'hauteur, et Lia.onBanner(fn) et Lia.onNativeAd(fn) entendez chaque changement ("loading", "shown" / "showing", "failed", "hidden" / "closed").

Rythme. Les publicités natives sont au moins une minute d'écart pour chaque personne (l'équipe peut le changer), dans toutes les applications. Les bannières ne sont pas'ne sont pas rythmés, mais ne'ne les fait pas clignoter allumés et éteints : montrez-en un qui peut rester un moment. Aucun de ces deux ne compte pour les publicités en plein écran' rythme.

#Ce que vous gagnez

Vous obtenez 50% de ce que génèrent les publicités dans votre application, y compris les bannières et les publicités natives. Lia compte chaque publicité affichée par votre application et ce qu'elle génère, et verse votre part mensuellement sur votre propre solde Lia, avec votre part des ventes. Voir Être payé.

Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais

Tapez pour rechercher sur toutes les pages, méthodes et points de terminaison.