Publicités 3D de Metamoa · 3D ads
Inscription prioritaire des opérateurs · voir les niveaux de partage des revenus
En bref
Les publicités 3D de Metamoa placent le modèle 3D, le bâtiment publicitaire ou le personnage publicitaire de l'annonceur dans des emplacements publicitaires au sein d'espaces de métavers web, ne comptent que ce que les gens ont réellement vu et fait, facturent sur cette base et en partagent une part avec les opérateurs d'espaces. En tant qu'entreprise de publicité et de régie publicitaire, nous accueillons aussi bien les grandes entreprises que les PME.
- Opérateurs d'espaces : dans Monétisation de la console de l'espace (/owner/revenue), utilisez 「S'inscrire aux publicités」 (vérification des conditions, informations de paiement, emplacements publicitaires) → ajoutez une ligne de script et les emplacements, et c'est terminé.
- Annonceurs : connectez-vous avec un compte Metamoa sur /ads/manage → importez un modèle 3D (glb), ou choisissez un bâtiment publicitaire et ajoutez une image ou une texture, ou choisissez un accessoire et une publicité pour un personnage publicitaire de base → choisissez vous-même les espaces ou utilisez 「Recommander」 → mode de facturation, budget et dates → diffusion après vérification.
- Pas de modèle ? Choisissez 「Demander un modèle」 et nous le réalisons pour vous. Nous acceptons aussi votre propre modèle. Les personnages publicitaires de base sont gratuits quel que soit le montant.
- Quatre modes de facturation : CPM (impressions visibles), CPA (clics sur le modèle, entrées dans l'espace de marque), durée d'affichage (temps total affiché) et contrats d'emplacement fixe (sur une période, l'emplacement en exclusivité). Tous les montants sont (prix hors taxes, TVA non comprise).
- La taille d'un modèle publicitaire peut être ajustée par l'opérateur de l'espace ou par Metamoa selon l'espace.




4 produits et facturation
Tous les montants sont des prix hors taxes, TVA non comprise.
| Produit | billing | Ce qui est compté | Prix unitaire |
|---|---|---|---|
| CPM (impressions visibles) | cpm | 1 impression visible = le modèle reste à l'écran au moins dans une proportion définie, plus longtemps qu'une durée définie sans interruption (onglet visible) | ₩8,000 pour 1,000 visibles |
| CPA · clic sur le modèle | cpa | Un appui ou un clic sur le modèle publicitaire. Si le clic mène ensuite à une entrée dans l'espace de marque, seule cette 1 entrée est facturée | ₩700 pour 1 clic |
| CPA · entrée dans l'espace de marque | cpa | Appuyer sur la publicité et entrer dans l'espace de marque (brand_url). Compté via une redirection serveur (/ads/go) ; une fois par jour par personne et par campagne | ₩1,000 pour 1 entrée |
| Durée d'affichage | time | Temps total d'affichage de la publicité après une impression visible (uniquement pendant une interaction, jusqu'à un plafond quotidien par personne et par modèle) | ₩1,000 pour 1,000 secondes visibles |
| Contrat d'emplacement fixe | fixed | Pour une période définie (jusqu'à un mois). Vous disposez de l'emplacement publicitaire contracté en exclusivité pendant cette période (par emplacement). Les impressions ne sont pas garanties | Voir le tableau des niveaux ci-dessous |
Niveaux du contrat d'emplacement fixe
Le niveau est fixé par la médiane des clics quotidiens nets sur l'espace au cours des 14 derniers jours de l'espace où se trouve l'emplacement (hors visites de l'opérateur lui-même, réseaux de centres de données et navigateurs automatisés ; le « Entrer » de metamoa ne compte qu'après la vérification humaine). Les emplacements des espaces en dessous du niveau le plus bas ne sont pas vendus en contrat fixe, seulement en publicité à la performance. La durée du contrat est soit hebdomadaire (7 jours), soit mensuelle (30 jours).
| Niveau | Clics quotidiens sur l'espace | Hebdomadaire (1 emplacement) | Mensuel (1 emplacement) |
|---|---|---|---|
| S | 1,000 ou plus | ₩50,000 | ₩180,000 |
| A | 300~999 | ₩15,000 | ₩50,000 |
| B | 100~299 | ₩5,000 | ₩18,000 |
- Dépense minimale : dépense média de ₩10,000 (prix hors taxes, TVA non comprise), frais de création de modèle exclus. Pour la publicité à la performance, c'est le budget qui compte ; pour les contrats fixes, la somme des montants du contrat.
- La publicité à la performance (CPM, CPA, durée d'affichage) ne facture que ce qui a réellement été compté, et une campagne cesse d'être diffusée lorsque sa dépense atteint son budget (budget_won).
- Un contrat CPM n'est accepté que jusqu'à 70 % des impressions visibles prévues des emplacements choisis (clics quotidiens sur l'espace × 0.7 × jours) (409 over_inventory).
- Les publicités CPA et à la durée d'affichage ne sont pas bloquées, mais si le budget dépasse la dépense prévue, /ads/manage vous prévient avant la demande : sur les mêmes impressions visibles prévues, le CPA multiplie par le taux de clics de référence de 2 % × le plus élevé des prix au clic et à l'entrée, et la durée d'affichage par 60 secondes par personne et par jour (spend_estimate de GET /api/ads/options).
- Un emplacement sous contrat fixe ne diffuse que cette campagne pendant la période, et aucun autre contrat fixe n'est accepté pour le même emplacement sur des dates qui se chevauchent (409 slot_taken). L'emplacement est réservé lorsque la vérification l'approuve : les demandes en attente de vérification ne réservent pas d'emplacement, et le contrat approuvé en premier l'emporte. Si le modèle ne s'est pas affiché certains jours ou si le trafic baisse de plus de 30 %, nous compensons par un remboursement au prorata ou une prolongation.
- La facturation et les niveaux reposent sur les rapports mesurés par Metamoa (impressions visibles, clics, entrées, durée d'affichage, clics sur l'espace).
Formules de calcul
Les dates sont des jours à l'heure de Corée (ad_daily). Les montants sont des prix hors taxes, les fractions de won étant supprimées. Les événements interceptés par une règle ne sont pas comptés et sont comptabilisés à part par motif (ad_excluded).
- Impressions visibles imps = nombre d'événements
impayant passé toutes les règles - Clics clicks =
clickvalidés, entrées enters = entrées validées (/ads/go), converted = clics ayant mené à une entrée avec le même jeton - Durée d'affichage view_ms = somme des ms des événements
timevalidés (uniquement les jetons dont l'impression a été comptée, jusqu'à 15,000 ms par événement, jusqu'au plafond quotidien par personne et par modèle) - Montant CPM = floor(imps × cpm_won ÷ 1,000)
- Montant CPA = (clicks − converted) × click_won + enters × enter_won
- Montant durée d'affichage = floor(view_ms ÷ 1,000 × time_1000s_won ÷ 1,000)
- Montant du contrat fixe = somme des prix de niveau de chaque emplacement contracté. Lorsque seule une partie de la période est comptée, par emplacement floor(prix × jours de contrat dans cette période ÷ jours de contrat)
- Part de l'opérateur de l'espace = floor(montant par espace × taux du niveau de l'opérateur de cet espace (%) ÷ 100). Le montant est le prix média hors taxes après retrait du trafic invalide ; les frais de création de modèles et d'espaces ne sont pas partagés. Niveaux : 「Niveaux de partage des revenus des opérateurs d'espaces」 ci-dessous.
Niveaux de partage des revenus des opérateurs d'espaces
Les revenus publicitaires (le montant média publicitaire par espace, prix hors taxes après retrait du trafic invalide) sont partagés entre l'opérateur de l'espace et Metamoa selon le taux du niveau. En vigueur depuis le 11/11/2026. Inscription prioritaire : https://metamoa.com/ads/partners
| Niveau | Qui | Opérateur de l'espace : Metamoa |
|---|---|---|
| Platine | Premiers arrivés : opérateurs d'espaces 1 à 10 | 9:1 |
| Or | Opérateurs d'espaces 11 à 100 (90 personnes) | 8:2 |
| Argent | Opérateurs d'espaces suivants | 7:3 |
| Bronze | Opérateurs d'espaces signant un nouveau contrat à partir du 1/1/2027 | 6:4 |
Les ratios pourront être ajustés ultérieurement selon les performances publicitaires.
- Opérateur d'espace = un compte propriétaire qui a enregistré un espace sur Metamoa et se connecte à la console de l'espace. L'ordre correspond au moment où chacun a activé pour la première fois 「Consentement aux publicités」 dans la console, numéroté un par un par le serveur.
- Un niveau, une fois fixé, est conservé, et les autres espaces du même opérateur ont le même niveau.
- Les opérateurs d'espaces signant un nouveau contrat à partir du 1/1/2027 à 0 h (heure de Corée) sont Bronze, quel que soit leur ordre.
- Votre niveau et votre taux : le panneau 「Publicités 3D」 de la console de l'espace, partner de GET /api/space/{id}/ads. Places restantes : seats de GET /api/ads/partners.
- Places restantes : Platine 0/10 · Or 80/90
Vérification des conditions et consentement aux publicités
Les conditions d'utilisation comprennent désormais une clause de diffusion publicitaire (article 4-4). Pour recevoir des publicités, l'opérateur de l'espace fait deux choses à la fois dans 「S'inscrire aux publicités」 de Monétisation de la console.
- Vérification des conditions : cochez la vérification des conditions à l'étape 1 de 「S'inscrire aux publicités」 dans la console de l'espace (/owner/revenue?id=<id de l'espace>). Cela ne fonctionne que dans la console de l'espace (avec une clé d'espace, c'est 403 owner_page_only).
- Consentement aux publicités : activé en même temps que la vérification des conditions, puis activé et désactivé par espace sur le même écran. Pour l'activer, le type d'informations de paiement et un contact sont nécessaires (sinon 409 payout_info_required). C'est seulement lorsqu'il est activé que l'API publicitaire de l'espace (une ligne de script, clé publicitaire) apparaît ; le désactiver arrête immédiatement les publicités (serve 403 ads_off).
Registre de consentement : l'espace, qui (un hachage de l'e-mail de connexion de l'opérateur pour cette console), quand, quelle version des conditions (data-ads-version de terms.html) et activé/désactivé sont conservés sans suppression (ad_consents).
Les espaces qui n'ont pas vérifié les conditions, qui ont désactivé le consentement aux publicités ou qui ne sont pas listés ne reçoivent pas de publicités.
Emplacements publicitaires
Les opérateurs décident eux-mêmes où se placent les publicités dans leur propre métavers. Les annonceurs choisissent des emplacements ou reçoivent des recommandations, et les contrats fixes se font aussi par emplacement. La liste des emplacements peut être consultée, activée et désactivée dans la console de l'espace.
| Champ | Format | Signification |
|---|---|---|
| name | 1 à 40 caractères | Un nom unique dans l'espace |
| kind | floor · wall · air · character | Modèle au sol · enseigne murale · bannière aérienne · personnage publicitaire debout ou qui se promène |
| position | [x, y, z] mètres | Position du centre du sol de la boîte de l'emplacement (coordonnées de l'espace) |
| rotation | [x, y, z] degrés (-360 à 360) | Rotation de l'emplacement. Par défaut [0, 0, 0] |
| size | [largeur, hauteur, profondeur] mètres (0.1 à 200) | La boîte où va la publicité. La publicité est agrandie ou réduite pour tenir dans cette boîte |
| scale | [min, max] fois (0.05 à 20) | Facteur de taille par espace : pour tenir dans la boîte, la publicité n'est mise à l'échelle que dans cette plage de sa taille d'origine. Par défaut [0.25, 4] |
| roam | 0 à 50 mètres | emplacements character : le rayon dans lequel le personnage se promène (0 signifie debout) |
| industries | Liste d'identifiants de secteurs | Secteurs acceptés par cet emplacement. Vide signifie tous les secteurs |
| enabled | true · false | Désactivé, aucune publicité n'est diffusée sur cet emplacement |
La taille d'un modèle publicitaire peut être ajustée par l'opérateur de l'espace ou par Metamoa selon l'espace.
Les publicités de personnages vont uniquement sur les emplacements character ; celles de modèles et de bâtiments uniquement sur les emplacements floor, wall et air.
Le SDK (clé publicitaire publique) ne peut créer que de nouveaux emplacements, et ceux-ci arrivent désactivés ; les publicités ne s'affichent qu'après que l'opérateur les a vérifiés et activés dans la console. Le SDK ne peut pas modifier un emplacement existant (même nom) et le renvoie tel quel. Jusqu'à 5 emplacements SDK désactivés par espace, comptés à part des 30 emplacements de l'opérateur. Un groupe d'IP peut en créer jusqu'à 20 par jour, et les emplacements SDK que l'opérateur n'a jamais activés en 7 jours sont supprimés (ceux activés au moins une fois et ceux utilisés par une campagne ne le sont pas). Une fois activés, ils comptent dans les 30 emplacements de l'opérateur. Modifier la boîte, le type ou les secteurs d'un emplacement et l'activer ou le désactiver n'est possible qu'avec une connexion à la console ou la clé de l'espace.
Identifiants de secteurs : game (jeux) · fashion (mode, beauté) · food (alimentation et boissons) · tech (informatique, électronique) · finance (finance) · edu (éducation) · travel (voyages, loisirs) · culture (culture, divertissement) · auto (automobile) · public (public, non lucratif) · etc (autres)
Jusqu'à 30 emplacements par espace. L'API des emplacements utilise la clé de l'espace (mm_live_) ou une connexion à la console :
GET https://metamoa.com/api/space/{space_id}/ads/slots
POST https://metamoa.com/api/space/{space_id}/ads/slots {"name":"plaza-front","kind":"floor","position":[0,0,-8],"rotation":[0,90,0],"size":[4,4,4],"scale":[0.5,2],"industries":["game","food"]}
POST https://metamoa.com/api/space/{space_id}/ads/slots {"name":"gate-greeter","kind":"character","position":[3,0,-4],"size":[1.2,2.2,1.2],"roam":3}
PATCH https://metamoa.com/api/space/{space_id}/ads/slots/{slot_id} {"enabled": false, "scale": [0.5, 1.5]}
DELETE https://metamoa.com/api/space/{space_id}/ads/slots/{slot_id}Opérateurs d'espaces : étapes d'installation
- Dans 「S'inscrire aux publicités」 de Monétisation de la console (
https://metamoa.com/owner/revenue?id=<id de l'espace>), cochez la vérification des conditions et lancez les publicités. - Placez la ligne de script du panneau 「API publicitaire」 du même écran à la fin du <head> ou du <body> de la page de votre espace. La clé publicitaire (mm_adpub_) peut être rendue publique (n'y mettez jamais la clé d'espace mm_live_).
- Pour un espace three.js, appelez attach et slot une fois la scène construite. L'emplacement est enregistré désactivé au premier appel. Les publicités s'affichent dès que vous l'activez dans 「Emplacements publicitaires」 de la console (vous pouvez aussi le créer activé dès le départ avec l'API des emplacements).
- Dès que la publicité s'affiche, c'est terminé. Le SDK envoie lui-même les impressions visibles, les clics et la durée d'affichage, et pour les entrées dans l'espace de marque, le SDK ouvre /ads/go lorsqu'on appuie sur la publicité et le serveur la compte.
- Dans 「Emplacements publicitaires」 de la console, activez et désactivez les emplacements et consultez le rapport sur 30 jours (avant et après les règles) et votre part (GET /api/space/{space_id}/ads/stats).
<script src="https://metamoa.com/ads/sdk.js" data-space="{space_id}" data-key="{mm_adpub_…}" async></script>
import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
// after your scene, camera and renderer exist:
(window.metamoaAdsReady = window.metamoaAdsReady || []).push((ads) => {
ads.attach({ THREE, GLTFLoader, scene, camera, renderer });
ads.slot({ name: 'plaza-front', kind: 'floor', position: [0, 0, -8], rotation: [0, 0, 0], size: [4, 4, 4] });
ads.slot({ name: 'north-wall', kind: 'wall', position: [0, 3, -15], size: [6, 3.4, 0.4] });
ads.slot({ name: 'gate-greeter', kind: 'character', position: [3, 0, -4], size: [1.2, 2.2, 1.2], roam: 3 });
});
Les moteurs autres que three.js (Babylon.js, PlayCanvas, Unity WebGL, etc.) récupèrent la publicité avec serve, la dessinent eux-mêmes et envoient les événements : ads.serve(name) → { ad }, ads.report(name, event). Pour les entrées, ouvrez ad.enter_url dans une nouvelle fenêtre ou dans la même. La spécification se trouve dans 「Spécification des événements」 ci-dessous.
Comment le SDK compte
- Impression visible : lorsqu'au moins une proportion définie du modèle est dans le champ de la caméra, avec une taille à l'écran d'au moins une surface définie, plus longtemps qu'une durée définie pendant que l'onglet est visible, il envoie 1 impression (une fois par jeton serve).
- Durée d'affichage : après l'impression, tant que la publicité reste visible dans les conditions ci-dessus, il cumule et envoie toutes les 5 secondes, avec le nombre d'entrées caméra et pointeur dans l'intervalle (il s'arrête lorsque l'onglet est masqué).
- Si la réponse serve contient un vid, conservez-le dans ce navigateur et envoyez-le avec le serve suivant (GET /ads/v1/serve?…&vid=). Seul un vid signé par le serveur pour ce réseau est lu. Le serveur combine le vid et le groupe d'IP de connexion et signe cette personne dans le jeton. Une impression n'est comptée qu'environ 2 secondes après serve.
- Clic : un appui ou un clic sur la publicité envoie
click, et si la publicité a un espace de marque, ouvre enter_url (/ads/go) dans une nouvelle fenêtre. Le serveur compte l'entrée et envoie le visiteur vers l'espace de marque. - Porte : si ad.door est présent, entrer à pied par la porte ouvre enter_url une fois dans une nouvelle fenêtre. Quand elle se rouvre : voir 「Entrer par la porte」 ci-dessous.
- L'identifiant de navigateur (vid) est fourni par le serveur et conservé dans localStorage par le SDK. Il ne sert qu'aux limites de répétition. Aucune information personnelle comme un nom ou un contact n'est envoyée.
- Les publicités sont récupérées à nouveau toutes les 30 minutes (nouveau jeton). Les personnages des emplacements character marchent lentement dans le rayon roam.
Entrer par la porte
Vous pouvez ajouter une porte à un bâtiment publicitaire ou à votre propre modèle 3D. C'est une porte, pas un portail : quand quelqu'un entre à pied par la porte, l'espace actuel reste tel quel et l'espace de marque s'ouvre dans une nouvelle fenêtre (nouvel onglet). Mettez "door": true dans le creative de la campagne (uniquement si kind vaut model ou building), et brand_url est obligatoire (sinon 400 invalid, fields brand_url). Le ad de serve arrive alors avec door.
"creative": { "kind": "building", "building_id": "bld-corner-shop", "mode": "image", "images": { … }, "door": true }
serve → "ad": { …, "enter_url": "https://metamoa.com/ads/go?t=<serve 토큰>", "door": { "node": "door", "enter_m": 1.2, "exit_m": 3 } }
Règles pour que la porte ne se rouvre pas sans cesse (à respecter impérativement)
- S'approcher à pied à moins de 1.2 m de la porte ouvre l'espace de marque (enter_url avec &via=door) une fois dans une nouvelle fenêtre.
- Après avoir fermé la nouvelle fenêtre et être revenu, bouger un peu dans la porte ou près d'elle ne la rouvre pas.
- Elle ne se rouvre qu'après s'être éloigné à plus de 3 m de la porte et être revenu (distance d'entrée 1.2 m < distance de sortie 3 m).
- Elle ne s'ouvre pas tant que l'onglet est masqué ou que la fenêtre n'a pas le focus, et au retour il faut quitter une fois la zone de la porte. Elle ne s'ouvre pas si vous êtes déjà dans la porte à l'ouverture de la page.
- Appuyer ou cliquer sur le bâtiment pour l'ouvrir fonctionne comme avant (à chaque clic). Les règles de la porte ne s'appliquent qu'à l'entrée à pied.
- Si le navigateur bloque la nouvelle fenêtre, un bouton 「Ouvrir <marque>」 apparaît en bas de l'écran. Elle ne s'ouvre qu'en appuyant sur ce bouton (il disparaît si vous quittez la porte sans appuyer).
Position de la porte : un nœud nommé door dans le glb s'il existe ; sinon le SDK dessine une porte par défaut en bas au centre de la face avant de la publicité (+Z). La distance est la distance au sol entre le personnage qui marche et l'avant de la porte. Donnez à attach un walker (l'Object3D du personnage qui marche ou une fonction renvoyant {x, y, z}). Sans lui, la position de la caméra est utilisée.
ads.attach({ THREE, GLTFLoader, scene, camera, renderer, walker: player }); // player: the walking character (Object3D)
Les espaces qui dessinent eux-mêmes ad.door avec un moteur autre que three.js doivent suivre les mêmes règles : après une ouverture, ne pas rouvrir avant que le marcheur soit sorti de exit_m, et après que l'onglet a été masqué puis réaffiché, avant qu'il ait quitté une fois la zone de la porte.
Pour que les allées et venues n'épuisent pas le budget
- Une entrée par la porte est comptée au même prix que 1 entrée CPA (prix et dépense minimale inchangés).
- Les entrées par personne (l'identifiant de navigateur du serveur + groupe d'adresses internet) et par campagne sont comptées une fois toutes les 24 heures, jusqu'à 3 fois en 30 jours. Un même groupe d'adresses internet est limité à 3 fois par jour par campagne et par espace.
- Au-delà, les entrées envoient toujours le visiteur vers l'espace de marque mais ne sont pas facturées, seulement enregistrées (motif d'exclusion repeat_limit). Elles sont revérifiées avec les journaux d'événements du serveur (hachages uniquement), donc rien n'est oublié au redémarrage du serveur.
- Une entrée avec le même jeton serve n'est comptée qu'une fois, et seulement pour les jetons dont l'impression a été comptée d'abord (règles anti-bots et anti-fraude inchangées).
Règles anti-bots et anti-fraude
Sur le serveur, les événements passent par les règles ci-dessous dans l'ordre. Si l'une d'elles les intercepte, ils sont exclus du rapport et comptabilisés à part sous le nom de cette règle. Chaque règle s'active et se désactive dans bot_rules de data/ads-config.json.
| Règle | Ce qu'elle fait | Actuellement |
|---|---|---|
UA de bot (ua_bot) | Les robots de recherche, aperçus, scripts (curl, python, headless, etc.) et requêtes sans User-Agent sont exclus. | Activée |
Navigateurs automatisés (headless) | Les navigateurs avec navigator.webdriver activé, HeadlessChrome, PhantomJS, Electron, jsdom, et les requêtes sans Accept-Language sont exclus. C'est une définition de mesure, pas comptée comme une défense contre les scripts. | Activée |
Visibilité et focus de l'onglet (visibility_focus) | Les impressions ne comptent que lorsque l'onglet est visible (document.visibilityState = visible) et que la fenêtre a le focus ; la durée d'affichage, seulement lorsque l'onglet est visible. C'est une définition de mesure. | Activée |
Contrôle de visibilité (min_view) | Au moins une proportion définie du modèle doit rester à l'écran, sur au moins une surface définie, plus longtemps qu'une durée définie pour 1 impression. C'est une définition de mesure. | Activée |
Limites de répétition par personne et adresse internet (repeat_limit) | Les impressions et clics d'une même personne et d'un même modèle comptent une fois sur une durée définie ; les entrées (porte comprise), une fois par jour et jusqu'à un nombre défini sur des jours définis. Ce qui dépasse le plafond horaire d'un groupe d'adresses internet, les nouveaux spectateurs quotidiens par espace ou les impressions, clics et entrées quotidiens par campagne et par espace est exclu. Les limites d'entrée sont revérifiées avec les journaux d'événements du serveur, donc rien n'est oublié au redémarrage du serveur. | Activée |
Jetons signés par le serveur (signed_token) | Les événements doivent porter le jeton signé (HMAC) fourni par serve. Le spectateur et le groupe d'adresses internet au moment de serve sont signés dans le jeton ; les impressions venant d'une autre adresse sont exclues, de même que celles survenant avant qu'une durée définie se soit écoulée depuis serve. Un jeton compte au plus une impression, un clic et une entrée chacun pendant sa durée de validité. Le budget de la campagne est revérifié au comptage, et les événements qui le dépassent ne sont pas comptés (budget). | Activée |
Mesure de la durée d'affichage (view_time) | La durée d'affichage ne compte que s'il y a des entrées caméra ou pointeur dans l'intervalle, et seulement jusqu'aux plafonds quotidiens par jeton, par personne et modèle, et par adresse internet et modèle. | Activée |
Trafic de l'opérateur lui-même (owner_traffic) | Les événements venant d'une adresse internet ayant ouvert la console de cet espace sont exclus pendant un nombre de jours défini. | Activée |
Traces d'interaction humaine (human_input) | Seuls les clics que le navigateur marque comme interaction humaine (isTrusted) comptent. Les impressions ne tiennent pas compte du nombre d'interactions (personnes qui regardent sans bouger, utilisateurs de clavier et de lecteurs d'écran). | Activée |
Surveillance des anomalies et mises en attente (anomaly) | Les impressions vues par une personne au-delà d'un nombre défini par jour sont exclues. Les clics et entrées CPA comptent jusqu'à un quota quotidien automatique par espace, et le reste est mis en attente. Si le taux de clics et d'entrées (comparé au réseau hors cet espace), les impressions par clic sur l'espace, les nouveaux spectateurs par adresse internet, la part des centres de données, les répétitions depuis une même adresse ou les entrées par clic dépassent leurs seuils, la part de cet espace pour ce mois est mise en attente et un administrateur tranche. | Activée |
Réseaux de centres de données (asn) | Si le x-mm-asn (numéro AS) ajouté par Cloudflare correspond à un réseau cloud ou d'hébergement, l'événement est exclu, et si cette part est importante, l'espace est mis en attente. Il n'est fiable que lorsque l'en-tête secret (origin-auth) qu'une Cloudflare Transform Rule ajoute avec lui correspond à la valeur env du serveur ; sinon, le réseau de l'événement est noté 「inconnu」 et la part des centres de données n'est mesurée qu'avec les événements dont le réseau est connu. | Activée |
Vérification humaine à l'entrée (turnstile) | Une entrée dans l'espace de marque (/ads/go) ne compte qu'après avoir passé Cloudflare Turnstile sur le domaine de Metamoa. En cas d'échec, le visiteur est quand même envoyé vers l'espace de marque, seule l'entrée n'est pas comptée. Les entrées arrivées sans clé sont mises en attente. | Activée |
Vérification humaine des impressions (turnstile_imp) | Le SDK exécute Cloudflare Turnstile dans une fenêtre metamoa cachée et joint aux impressions le pass obtenu (lié à ce réseau et à cet espace). Un pass compte ; une vérification échouée est exclue. Sans pass, seule cette impression est retenue ; à la fin du mois elle est libérée ou annulée selon la part non vérifiable de l'espace (un administrateur peut la libérer). La publicité s'affiche toujours telle quelle. | Activée |
- Les clics et les entrées ne comptent que si l'impression de ce jeton a été comptée d'abord (sinon no_impression).
- Lorsque les tables conservées par le serveur sont pleines, il ne supprime pas les enregistrements dont le délai n'est pas écoulé ; il cesse de compter les nouveaux événements (capacity). Il échoue en mode fermé.
Spécification des événements
Les requêtes SDK ne sont acceptées que depuis le site propre de cet espace. Pour le domaine de l'opérateur, le même domaine enregistrable ; pour les hôtes partagés comme github.io ou vercel.app, exactement le même nom d'hôte ; et pour les espaces sous un chemin (github.io/<dépôt>, claude.ai), le chemin du Referer doit aussi se trouver en dessous (le SDK envoie le Referer complet). Le tout avec CORS ouvert, en JSON. sendBeacon (text/plain) est également accepté.
Obtenir une publicité · serve
GET https://metamoa.com/ads/v1/serve?space={space_id}&key={mm_adpub_…}&slot={자리 이름 또는 id}&vid={vid}
→ 200 {
"space_id": "onsen-village",
"vid": "<새 브라우저 id: 이 브라우저에 id가 없을 때만 와요>",
"slot": {
"id": "sl_k2m9x0a1b2c3d4e5",
"name": "plaza-front",
"kind": "floor",
"position": [
0,
0,
-8
],
"rotation": [
0,
0,
0
],
"size": [
4,
4,
4
],
"scale": [
0.25,
4
],
"roam": 0
},
"ad": {
"campaign_id": "cp_q8w7e6r5t4y3u2i1",
"brand": "반짝 우유",
"token": "<serve 토큰>",
"enter_url": "https://metamoa.com/ads/go?t=<serve 토큰>",
"kind": "building",
"building_id": "billboard-low",
"model_url": "https://metamoa.com/ads/models/billboard-low/billboard-low.image.glb?v=1",
"size_m": [
4,
2.24,
0.575
],
"mode": "image",
"faces": [
{
"id": "main",
"mesh": "ad_image",
"image_url": "https://metamoa.com/ads/a/as_a1b2c3d4e5f6g7h8.webp"
}
]
}
}
Si ad vaut null, il n'y a pas de publicité pour cet emplacement pour le moment. Si kind vaut model, placez le glb de model_url ; si building, placez le glb du bâtiment puis, si mode vaut image, mettez l'image de image_url sur chaque nom de mesh de faces, et si texture, appliquez image_url sur tous les texture.meshes, répétée selon repeat. Si character, placez debout le glb du personnage, fixez l'accessoire à prop.attach et mettez sur son panneau l'image de image_url ou les lettres de text. Tout s'adapte à la boîte slot.size, mais n'est mis à l'échelle que dans les limites de slot.scale par rapport à sa taille d'origine.
Enregistrer un emplacement · slots
POST https://metamoa.com/ads/v1/slots
{
"space": "{space_id}",
"key": "{mm_adpub_…}",
"name": "plaza-front",
"kind": "floor",
"position": [
0,
0,
-8
],
"rotation": [
0,
90,
0
],
"size": [
4,
4,
4
],
"scale": [
0.5,
2
],
"industries": [
"game",
"food"
]
}
→ 201 { "slot": {…, "enabled": false} } (새 자리, 공간운영자가 켤 때까지 꺼짐) · 200 (같은 이름의 자리를 바꾸지 않고 그대로)
Envoyer des événements · events
POST https://metamoa.com/ads/v1/events
{
"space": "onsen-village",
"key": "mm_adpub_XXXXXXXXXXXXXXXXXXXXXX",
"events": [
{
"type": "imp",
"token": "<serve 토큰>",
"ms": 2100,
"area": 0.04,
"inside": 1,
"vis": true,
"focus": true,
"inputs": 3,
"wd": false
},
{
"type": "time",
"token": "<serve 토큰>",
"ms": 5000,
"vis": true,
"inputs": 2,
"wd": false
},
{
"type": "click",
"token": "<serve 토큰>",
"trusted": true,
"wd": false
}
]
}
→ 200 { "accepted": 3, "excluded": 0 }
| type | Champ | Signification |
|---|---|---|
| imp | token, ms, area, inside, vis, focus, inputs, wd | ms : durée d'affichage sans interruption, area : surface du modèle rapportée à celle de l'écran (0 à 1), inside : part du modèle à l'intérieur de l'écran (0 à 1), vis·focus : onglet visible et focus de la fenêtre, inputs : entrées caméra et pointeur dans l'intervalle, wd : navigator.webdriver |
| time | token, ms, vis, inputs, wd | Durée affichée depuis le dernier time (jusqu'à 15,000 ms) et nombre d'entrées dans l'intervalle |
| click | token, trusted, wd | La publicité a été touchée ou cliquée. trusted : interaction humaine (isTrusted) |
Les impressions comptent avec le pass de vérification humaine que le SDK obtient d'une fenêtre metamoa cachée (Cloudflare Turnstile). La publicité s'affiche aussitôt sans l'attendre. Si votre site envoie une Content-Security-Policy, ajoutez https://metamoa.com à frame-src. Si la fenêtre est bloquée ou s'il n'y a pas de pass, l'impression est retenue ; à la fin du mois elle est libérée si la part non vérifiable de l'espace est de 20 % ou moins, et annulée au-delà.
Jusqu'à 20 à la fois. Les événements ne transmettent pas de vid ; le spectateur provient de la valeur contenue dans le jeton. Les événements erronés et les jetons d'un autre espace ne sont comptés qu'en excluded.
Entrée · go
Une entrée ne compte qu'après que /ads/go, sur le domaine de Metamoa, a vérifié avec Cloudflare Turnstile qu'il s'agit d'une personne (s'il y a une clé, un petit écran de vérification s'affiche pendant 1 à 2 secondes). En cas d'échec, la personne va quand même dans l'espace de marque, seule l'entrée n'est pas comptée.
GET https://metamoa.com/ads/go?t={serve 토큰}
→ 302 Location: {brand_url} (노출이 센 토큰이면 입장을 센 뒤 브랜드 공간으로. 캠페인이 집행 중·기간 안이고 토큰이 유효 시간 안일 때만 검수에서 승인된 brand_url로 가고, 아니면 Location: /)Bâtiments publicitaires, personnages et spécifications d'import
Les annonceurs sans modèle choisissent l'un de nos bâtiments publicitaires ou personnages publicitaires de base. Pour les bâtiments, choisissez l'un des deux modes : image (une image sur chaque panneau défini) · texture (une texture ou un motif sur toute la surface du bâtiment).
Pour les textures, téléchargez le gabarit par défaut (PNG carré), modifiez-le et importez-le à la même taille (1024 à 2048 px). Les lignes roses du gabarit avec lignes sont les limites des pièces de surface : peignez à l'intérieur d'une pièce et cela apparaît sur cette surface.
Pour la boutique publicitaire (shop-ad), l'unique image importée s'affiche à l'avant, sur les côtés, à l'arrière et sur le dessus : l'enseigne avant, les deux côtés, l'arrière et le panneau du toit ont tous le même ratio, elle se lit donc de tous les côtés, même vue d'en haut. Elle a une porte, on peut donc utiliser 「Entrer par la porte」 ("door": true).
Les personnages publicitaires de base sont gratuits quel que soit le montant. Ils se tiennent debout ou se promènent sur les emplacements character, portent des accessoires fixés à leur squelette comme une pancarte au cou, un badge, une pancarte à la main, un ballon, un drapeau ou un sac de courses, et le panneau de l'accessoire porte une image publicitaire ou des lettres d'enseigne (jusqu'à 12 caractères). Les chats, le chien et Vincent ne peuvent porter que des accessoires autour du cou.
| Personnage | id | Accessoires possibles | Licence |
|---|---|---|---|
| Changmoa | changmoa | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Metappyeoseu | metabbyeos | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Bulk Uploader | bulkuploader | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Hotspot Wizard | hotspot | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Bangjang Knight | bangjang | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Teolgalide | teolgal | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Nailbus | neilbus | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Linkblin | linkblin | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Diablong | diablong | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Vincent | vincent | prop-neck-sign prop-badge | Interne (FLOAT Co., Ltd.) |
| Chat à poil court Nyangjupgo | cat_short | prop-neck-sign prop-badge | CC BY 4.0 |
| Chat à poil long Nyangjupgo | cat_long | prop-neck-sign prop-badge | CC BY 4.0 |
| Munchkin Nyangjupgo | cat_munchkin | prop-neck-sign prop-badge | CC BY 4.0 |
| Corgi Nyangjupgo | dog_corgi | prop-neck-sign prop-badge | CC BY 4.0 |
| Accessoire | id | Ratio d'image · taille minimale |
|---|---|---|
| Pancarte au cou (type badge) | prop-badge | 720:1024, au moins 360×512 px |
| Ballon | prop-balloon | 1024:1024, au moins 512×512 px |
| Drapeau à main | prop-flag | 1024:688, au moins 512×344 px |
| Pancarte portée au cou | prop-neck-sign | 1024:720, au moins 512×360 px |
| Pancarte à la main | prop-picket | 1024:720, au moins 512×360 px |
| Sac de courses | prop-shopping-bag | 1024:1024, au moins 512×512 px |
- Formats d'image : PNG · JPEG · WEBP, jusqu'à 2 Mo, jusqu'à 4096 px de large et de haut, tolérance de ratio jusqu'à 2 %. Les images importées sont réenregistrées en WebP (les métadonnées photo sont supprimées).
- Modèle 3D : un fichier binaire glTF 2.0 (.glb), jusqu'à 6 Mo, textures dans le fichier, sans adresse externe (uri).
- Les fichiers importés sont vérifiés par leur contenu (octets magiques) : les images ne sont acceptées qu'en PNG, JPEG ou WebP (pas de SVG, HTML, etc.) et refaites en WebP, et les modèles uniquement en binaire glTF 2.0. Les fichiers publicitaires ne sont servis qu'avec un type fixe (image/webp, model/gltf-binary), nosniff et une politique sandbox, ils ne s'exécutent donc jamais comme scripts.
- La taille d'un modèle publicitaire peut être ajustée par l'opérateur de l'espace ou par Metamoa selon l'espace.
- Les fichiers de modèles et de personnages se trouvent sous /ads/models/ et ne sont servis qu'avec des réponses n'autorisant aucun script (type fixe, nosniff, sandbox). La liste et les sources sont dans docs/ads/MODELS.md ; pour les modifier, régénérez data/ads-buildings.json et les fichiers ensemble avec scripts/ads-import-models.mjs.
Crédits des modèles
La plupart des modèles de base sont en CC0 (domaine public) ou réalisés en interne ; ceux ci-dessous sont en CC BY, leurs sources sont donc citées. FLOAT Co., Ltd. les a tous modifiés (taille, faces publicitaires, etc.).
- Panneau d'affichage sur pied : "Blank Billboard" by Jarlan Perez (https://poly.pizza/m/1E0d2B7bC8e), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), modifié par FLOAT Co., Ltd.
- Stand éphémère : "Carnival Booth" by sirkitree (https://poly.pizza/m/4NizXJZsuO2), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), modifié par FLOAT Co., Ltd.
- Panneau d'abribus : "Bus Stop" by Zsky (https://poly.pizza/m/OWczicNWhO), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), modifié par FLOAT Co., Ltd.
- Chevalet en A : "Sandwich Board" by Anonymous (https://poly.pizza/m/ejy0W_7cHWT), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), modifié par FLOAT Co., Ltd.
- Chat à poil court Nyangjupgo : "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, converti en voxels par FLOAT Co., Ltd.
- Chat à poil long Nyangjupgo : "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, converti en voxels par FLOAT Co., Ltd.
- Munchkin Nyangjupgo : "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, converti en voxels par FLOAT Co., Ltd.
- Corgi Nyangjupgo : "Dog" by Polyfork (https://polyfork.dev/asset/dog-base), CC BY 4.0, converti en voxels par FLOAT Co., Ltd.
Demander un modèle
Lorsqu'un annonceur choisit 「Demander un modèle」, nous réalisons le modèle 3D, l'ajoutons à la campagne puis le vérifions. Envoyez les éléments (photos du produit, logo, plans) à [email protected] avec le numéro de campagne.
| Niveau | grade | Frais de création | Gratuit à partir de cette dépense média |
|---|---|---|---|
| Produit simple · enseigne | simple | ₩50,000 (prix hors taxes, TVA non comprise) | ₩500,000 |
| Produit détaillé | precise | ₩100,000 (prix hors taxes, TVA non comprise) | ₩1,000,000 |
| Nouveau personnage | character | ₩100,000 (prix hors taxes, TVA non comprise) | ₩1,000,000 |
- Le seuil de gratuité est la dépense média réelle (la somme sur toute la durée du contrat, jusqu'à 3 mois, hors modélisation, TVA et trafic invalide).
- Un modèle réalisé gratuitement est fourni avec une licence de diffusion sur Metamoa uniquement (les droits d'auteur restent à Metamoa ; une cession se fait contre les frais de création), avec 1 révisions. Si l'annonceur résilie ou réduit sa dépense, les frais de création sont facturés au prorata : frais de création × (1 − dépense média réelle ÷ seuil de gratuité). Les modèles payants ont droit à 2 révisions.
- Les personnages publicitaires de base (ceux du Camp Moa et de Nyangjupgo) sont gratuits quel que soit le montant, sans demande de création.
Annonceurs : étapes d'inscription autonome
- Connectez-vous avec un compte Metamoa sur https://metamoa.com/ads/manage (inscription dans la même fenêtre).
- Créer une campagne : nom, marque, secteur et adresse de l'espace de marque (si vous utilisez le CPA à l'entrée).
- Création : ① importer votre propre modèle 3D (glb) ② choisir un bâtiment publicitaire → une image par panneau en mode image, une texture en mode texture ③ choisir un personnage publicitaire de base + un accessoire → une image ou des lettres d'enseigne sur le panneau de l'accessoire ④ demander un modèle (choisir un niveau). Les spécifications et un aperçu s'affichent.
- Espaces : dans la liste des espaces ayant consenti aux publicités, choisissez vous-même les emplacements selon la catégorie, le nombre de personnes connectées et les clics quotidiens sur l'espace, ou appuyez sur 「Recommander」 pour un ensemble d'espaces adapté au secteur, à la catégorie et au trafic.
- Définissez le mode de facturation (CPM, CPA, durée d'affichage, contrat d'emplacement fixe), le budget et les dates, puis envoyez la demande → en attente de vérification.
- Une fois la vérification passée (obscénité, violence, soupçon d'atteinte au droit d'auteur, etc.), la campagne est diffusée. Une campagne en cours peut être mise en pause et réactivée, et vous voyez chaque jour les impressions visibles, les clics, les entrées et la durée d'affichage.
PUT https://metamoa.com/api/ads/assets?kind=image&building=billboard-low&face=main (본문: 이미지 파일)
PUT https://metamoa.com/api/ads/assets?kind=image&prop=prop-neck-sign (본문: 이미지 파일)
POST https://metamoa.com/api/ads/recommend {"industry": "food", "count": 5}
POST https://metamoa.com/api/ads/campaigns
{
"name": "겨울 우유 3D",
"brand": "반짝 우유",
"industry": "food",
"billing": "cpm",
"budget_won": 500000,
"start_day": "2026-12-01",
"end_day": "2026-12-31",
"targeting": "recommend",
"slot_ids": [
"sl_k2m9x0a1b2c3d4e5"
],
"brand_url": "https://milk.example/space",
"creative": {
"kind": "building",
"building_id": "billboard-low",
"mode": "image",
"images": {
"main": "as_a1b2c3d4e5f6g7h8"
}
}
}
(헤더: X-Account-Token: mm1.… · X-Device-Id: <기기 id>)
Création avec personnage : {"kind": "character", "character_id": "bangjang", "prop": "prop-picket", "image": "as_…"} ou "text": "Lait Brillant" à la place de "image". Contrat d'emplacement fixe : "billing": "fixed", "fixed_period": "week" | "month", end_day = start_day + période − 1. Demande de modèle : {"kind": "request", "grade": "simple", "note": "…"}.
Les créations de bâtiment et de modèle propre acceptent deux éléments de plus (facultatif) : "tagline": "description d'une ligne" (jusqu'à 30 caractères, lettres uniquement — pas de balises, chevrons ni accolades (400 invalid, fields creative), vérifiée avec la création) est dessinée sur la bande sous l'enseigne de la boutique publicitaire ou du bâtiment (mesh ad_tagline) et arrive dans ad.tagline { text, mesh, aspect } de serve. "door": true correspond à 「Entrer par la porte」 (brand_url requis). Ce sont les mêmes champs 「Description d'une ligne」 et 「Entrer par la porte」 qu'à l'étape 2 de /ads/manage.
Vérification
- Les modèles, images et campagnes importés sont en attente de vérification (review) avant diffusion. Quand un administrateur approuve, la campagne est diffusée (active) ; en cas de refus, rejected et le motif sont conservés.
- Les images sont d'abord contrôlées à l'import par une analyse d'image par IA (obscénité, violence, logos ou personnages d'autrui) et bloquées immédiatement si elles sont détectées (rejected). Si l'analyse ne peut pas être effectuée, un administrateur les examine.
- Les modèles sont ouverts et examinés par un administrateur. Obscénité, violence ou soupçon d'atteinte au droit d'auteur entraînent un refus.
Codes d'erreur
Le corps de l'erreur est { "error": "<code>", "message": "<une ligne sur la suite à donner>" } ; les erreurs de champ arrivent avec fields, les limites avec retry_after.
| HTTP | error | Signification |
|---|---|---|
| 400 | invalid | Un champ a un format incorrect. fields indique les champs erronés. |
| 400 | bad_model | Pas un glb, pas du glTF 2.0, ou contient une adresse externe (uri). Le motif est dans reason. |
| 400 | bad_image | Le format, la taille ou le ratio de l'image ne correspond pas à la spécification. reason (format · bytes · too_large · too_small · aspect) et spec sont fournis. |
| 400 | bad_building | Le default_building de l'emplacement n'est pas un identifiant de bâtiment ou de panneau de GET /ads/v1/buildings (vide est accepté). |
| 400 | slot_unavailable | L'emplacement choisi n'accepte pas de publicité, n'accepte pas ce secteur ou ne correspond pas au type de création (personnages uniquement sur les emplacements de personnage). slot_ids indique ces emplacements. |
| 401 | unauthorized | Pas de clé d'espace ni de connexion à la console, ou valeur incorrecte. |
| 401 | sign_in | Annonceur : pas de connexion à un compte Metamoa, ou elle a expiré. |
| 403 | owner_required | Une clé d'espace existe, mais l'opérateur de l'espace n'est pas encore vérifié. |
| 403 | owner_page_only | Tentative de vérification des conditions ou de consentement aux publicités avec une clé d'espace (ne fonctionne que dans la console de l'espace). |
| 403 | bad_ad_key | SDK : space et key (mm_adpub_) ne correspondent pas. |
| 403 | terms_required | Cet espace n'a pas vérifié les conditions de diffusion publicitaire. |
| 403 | ads_off | Cet espace a désactivé le consentement aux publicités. |
| 403 | origin_mismatch | La requête SDK ne provient pas du site de cet espace (même domaine). |
| 404 | not_house | Nos propres publicités (GET /ads/v1/house) ont été appelées depuis un espace que Metamoa n'exploite pas lui-même. |
| 403 | not_yours | Annonceur : a utilisé l'identifiant de fichier de quelqu'un d'autre. |
| 404 | no_slot | Aucun emplacement publicitaire avec ce nom ou cet identifiant. |
| 404 | not_found | Cette campagne ou ce fichier n'existe pas. |
| 409 | not_listed | Un espace non listé (avant approbation ou masqué). |
| 409 | payout_info_required | Tentative d'activer le consentement aux publicités sans type d'informations de paiement (particulier ou entreprise) ni contact (téléphone mobile ou e-mail). Ajoutez-les dans Monétisation de la console (/owner/revenue?id=<id de l'espace>). |
| 409 | advertiser_required | Annonceur : tentative de demander ou de payer une campagne avant d'avoir ajouté les informations d'annonceur (PUT /api/ads/advertiser). |
| 409 | biz_doc_required | Annonceur : un annonceur entreprise a tenté de payer ou de demander un contrat d'emplacement fixe avant d'importer une copie de son certificat d'immatriculation (PUT /api/ads/advertiser/doc). |
| 409 | business_only | Annonceur : un annonceur particulier a tenté d'importer une copie de certificat d'immatriculation d'entreprise. |
| 400 | bad_doc | Annonceur : la copie du certificat d'immatriculation n'est pas au format PDF, JPG ou PNG. |
| 413 | doc_too_big | Annonceur : la copie du certificat d'immatriculation dépasse 5 Mo. |
| 503 | advertiser_unavailable | Annonceur : le serveur n'a pas de clé de chiffrement pour les informations d'annonceur et ne peut donc pas les accepter. |
| 409 | email_not_linked | Annonceur : l'e-mail d'un annonceur particulier n'est pas celui utilisé pour se connecter à ce compte Metamoa. |
| 409 | name_taken | Un emplacement du même nom existe déjà. |
| 409 | slot_limit | Jusqu'à 30 emplacements de l'opérateur par espace, et jusqu'à 5 emplacements SDK non confirmés. |
| 409 | slot_taken | Un emplacement déjà sous un autre contrat d'emplacement fixe pour cette période. |
| 409 | tier_too_low | Choix, en contrat d'emplacement fixe, d'un emplacement d'un espace dont les clics quotidiens sont inférieurs au niveau le plus bas. slot_ids indique ces emplacements. |
| 409 | not_for_sale | Aucun prix de contrat d'emplacement fixe. |
| 409 | under_minimum | En dessous de la dépense média minimale. min_spend_won et spend_won sont fournis. |
| 409 | no_click_history | Choix du CPM ou d'un contrat d'emplacement fixe pour des emplacements d'espaces sans historique de clics (impossible de mesurer les impressions et le niveau). Seuls le CPA et la durée d'affichage sont possibles. slot_ids et billings sont fournis. |
| 409 | over_inventory | Le budget CPM dépasse le plafond d'impressions visibles prévues des emplacements choisis. max_budget_won est fourni. |
| 409 | rejected_file | Utilisation dans une campagne d'un fichier bloqué lors de la vérification. |
| 409 | wrong_state | Action impossible dans cet état (mettre en pause une campagne en cours de vérification, etc.). |
| 409 | stale | Administrateur : la campagne a changé après l'ouverture de l'écran de vérification (la version de decide diffère de l'actuelle). Regardez à nouveau et décidez de nouveau. |
| 409 | already_paid | Tentative de rouvrir le paiement d'une campagne déjà payée. |
| 409 | not_paid | Administrateur : tentative d'approuver le règlement d'une campagne dont le paiement n'est pas terminé. |
| 409 | held | Administrateur : tentative d'approuver le règlement d'une campagne ayant une part en attente (statuer d'abord sur la mise en attente). |
| 424 | hrum_failed | Impossible de se connecter au paiement (Hrum). Réessayez dans un instant. |
| 503 | pay_not_ready | Le paiement ne peut pas encore être ouvert (serveur pas encore configuré). |
| 409 | model_missing | Administrateur : campagne de demande de modèle approuvée avant que le modèle soit joint. |
| 413 | model_too_big | Le fichier du modèle dépasse 6 Mo. |
| 429 | too_many | Trop de requêtes. Attendez le nombre de secondes indiqué par Retry-After. |
Toutes les routes
SDK (CORS *, 그 공간 사이트에서)
GET /ads/sdk.js · GET /ads/v1/serve · POST /ads/v1/slots · POST /ads/v1/events · GET /ads/go (Turnstile 화면, 문이면 &via=door) · POST /ads/go · GET /ads/v1/buildings · GET /ads/a/{asset}.glb|webp
공간운영자 (공간 관리 로그인 mm_own_ 또는 공간 키 mm_live_)
GET /api/space/{id}/ads · POST /api/space/{id}/ads/terms · POST /api/space/{id}/ads/consent {"on": true} (이 둘은 공간 관리 로그인만)
GET|POST /api/space/{id}/ads/slots · PATCH|DELETE /api/space/{id}/ads/slots/{slot_id} · GET /api/space/{id}/ads/stats?from=&to=
공간운영자 등급 (공개)
GET /api/ads/partners → 등급표, 남은 자리(플래티넘·골드) · 안내 페이지 /ads/partners
광고 고르기 (공개)
GET /api/ads/options → 업종·과금 방식·건물·업로드 규격·정해진 단가 (로그인 없이 조회 가능)
광고주 (메타모아 계정: X-Account-Token + X-Device-Id)
GET|PUT /api/ads/advertiser (광고주 정보: 사업자 또는 개인, 캠페인 신청·결제 전에 한 번) · PUT /api/ads/advertiser/doc (사업자등록증 사본, 첫 결제·공간 고정 계약 전) · POST /api/ads/production (제작 의뢰: 이름·회사, 연락처, 원하는 것, 예산 범위(선택), 일정 · 로그인 없이) · GET /api/ads/spaces · POST /api/ads/recommend · PUT /api/ads/assets · GET /api/ads/assets · GET /api/ads/assets/{id}/raw
GET|POST /api/ads/campaigns · GET /api/ads/campaigns/{id} · PATCH /api/ads/campaigns/{id} {brand_url} (바꾸면 다시 검수 대기, 승인 전까지 입장은 전에 승인된 주소로) · POST /api/ads/campaigns/{id}/pause|resume · POST /api/ads/campaigns/{id}/pay (흐름 결제 열기)
문서: /ads/docs (사람) · /ads/llms.txt (AI) · /api#ads · /api/openapi.json