Metamoa
Favoris Classement

Publicités 3D de Metamoa · 3D ads

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.

Écran réel · Moa Campsite
Écran réel · Moa Campsite
Écran réel · boutiques du Moa Campsite (annonces maison)
Écran réel · boutiques du Moa Campsite (annonces maison)
Écran réel · cour d'AI Butta
Écran réel · cour d'AI Butta
Écran réel · Walking Into Van Gogh
Écran réel · Walking Into Van Gogh

4 produits et facturation

Tous les montants sont des prix hors taxes, TVA non comprise.

ProduitbillingCe qui est comptéPrix unitaire
CPM (impressions visibles)cpm1 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èlecpaUn 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 marquecpaAppuyer 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'affichagetimeTemps 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 fixefixedPour 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 garantiesVoir 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).

NiveauClics quotidiens sur l'espaceHebdomadaire (1 emplacement)Mensuel (1 emplacement)
S1,000 ou plus₩50,000₩180,000
A300~999₩15,000₩50,000
B100~299₩5,000₩18,000

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).

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

NiveauQuiOpérateur de l'espace : Metamoa
PlatinePremiers arrivés : opérateurs d'espaces 1 à 109:1
OrOpérateurs d'espaces 11 à 100 (90 personnes)8:2
ArgentOpérateurs d'espaces suivants7:3
BronzeOpérateurs d'espaces signant un nouveau contrat à partir du 1/1/20276:4

Les ratios pourront être ajustés ultérieurement selon les performances publicitaires.

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.

ChampFormatSignification
name1 à 40 caractèresUn nom unique dans l'espace
kindfloor · wall · air · characterModèle au sol · enseigne murale · bannière aérienne · personnage publicitaire debout ou qui se promène
position[x, y, z] mètresPosition 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]
roam0 à 50 mètresemplacements character : le rayon dans lequel le personnage se promène (0 signifie debout)
industriesListe d'identifiants de secteursSecteurs acceptés par cet emplacement. Vide signifie tous les secteurs
enabledtrue · falseDé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

  1. 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.
  2. 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_).
  3. 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).
  4. 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.
  5. 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

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)

  1. 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.
  2. 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.
  3. 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).
  4. 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.
  5. 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.
  6. 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

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ègleCe qu'elle faitActuellement
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

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 }
typeChampSignification
imptoken, ms, area, inside, vis, focus, inputs, wdms : 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
timetoken, ms, vis, inputs, wdDurée affichée depuis le dernier time (jusqu'à 15,000 ms) et nombre d'entrées dans l'intervalle
clicktoken, trusted, wdLa 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).

ModèleTypeTaille par défaut (m)FacteurImage : faces publicitairesTexture : télécharger les gabarits
Bannière drapeau (banner-flag)Mâts de bannière3.7×3.5×0.40.5~2.52048:1072, au moins 1024×536 pxhttps://metamoa.com/ads/models/banner-flag/banner-flag.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/banner-flag/banner-flag.texture-template.png
Mât de bannière suspendue (banner-hanging)Mâts de bannière1.9×3×0.20.5~2.51088:2048, au moins 544×1024 pxhttps://metamoa.com/ads/models/banner-hanging/banner-hanging.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/banner-hanging/banner-hanging.texture-template.png
Tour de bannières (banner-tower)Mâts de bannière1.2×4×1.20.5~2.5656:1024, au moins 328×512 pxhttps://metamoa.com/ads/models/banner-tower/banner-tower.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/banner-tower/banner-tower.texture-template.png
Panneau publicitaire (billboard-board)Écrans · panneaux d'affichage1.9×2.4×1.50.5~31024:944, au moins 512×472 pxhttps://metamoa.com/ads/models/billboard-board/billboard-board.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/billboard-board/billboard-board.texture-template.png
Panneau d'affichage bas (billboard-low)Écrans · panneaux d'affichage4×2.2×0.60.5~32048:784, au moins 1024×392 pxhttps://metamoa.com/ads/models/billboard-low/billboard-low.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/billboard-low/billboard-low.texture-template.png
Panneau d'affichage sur pied (billboard-stand)Écrans · panneaux d'affichage8×4.8×2.50.5~22048:848, au moins 1024×424 pxhttps://metamoa.com/ads/models/billboard-stand/billboard-stand.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/billboard-stand/billboard-stand.texture-template.png
Grand panneau d'affichage (billboard-tall)Écrans · panneaux d'affichage6×6×2.90.5~32048:1136, au moins 1024×568 pxhttps://metamoa.com/ads/models/billboard-tall/billboard-tall.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/billboard-tall/billboard-tall.texture-template.png
Boutiques sur 3 étages (bld-3f-shop)Bâtiments9.4×11×9.40.5~22048:480, au moins 1024×240 pxhttps://metamoa.com/ads/models/bld-3f-shop/bld-3f-shop.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/bld-3f-shop/bld-3f-shop.texture-template.png
Immeuble classique (bld-classic)Bâtiments11.6×14×10.80.5~22048:608, au moins 1024×304 pxhttps://metamoa.com/ads/models/bld-classic/bld-classic.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/bld-classic/bld-classic.texture-template.png
Boutique d'angle (bld-corner-shop)Bâtiments6.6×10×6.60.5~22048:704, au moins 1024×352 pxhttps://metamoa.com/ads/models/bld-corner-shop/bld-corner-shop.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/bld-corner-shop/bld-corner-shop.texture-template.png
Immeuble de hauteur moyenne (bld-midrise)Bâtiments11.8×16×12.40.5~22048:1152, au moins 1024×576 pxhttps://metamoa.com/ads/models/bld-midrise/bld-midrise.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/bld-midrise/bld-midrise.texture-template.png
Boutique avec toit-terrasse (bld-shop-roof)Bâtiments9.9×10×12.20.5~22048:560, au moins 1024×280 pxhttps://metamoa.com/ads/models/bld-shop-roof/bld-shop-roof.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/bld-shop-roof/bld-shop-roof.texture-template.png
Tour (bld-tower)Bâtiments15.1×32×15.10.5~1.51632:2048, au moins 816×1024 pxhttps://metamoa.com/ads/models/bld-tower/bld-tower.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/bld-tower/bld-tower.texture-template.png
Boutiques à 2 unités (bld-twin-shop)Bâtiments16.5×9×10.20.5~22048:832, au moins 1024×416 pxhttps://metamoa.com/ads/models/bld-twin-shop/bld-twin-shop.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/bld-twin-shop/bld-twin-shop.texture-template.png
Stand éphémère (booth-carnival)Stands éphémères3.5×3.2×1.90.6~22048:336, au moins 1024×168 pxhttps://metamoa.com/ads/models/booth-carnival/booth-carnival.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/booth-carnival/booth-carnival.texture-template.png
Étal de marché (booth-market)Stands éphémères3.3×3×1.50.6~22048:400, au moins 1024×200 pxhttps://metamoa.com/ads/models/booth-market/booth-market.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/booth-market/booth-market.texture-template.png
Pavillon éphémère (booth-pavilion)Stands éphémères3.1×4×3.70.6~21024:352, au moins 512×176 pxhttps://metamoa.com/ads/models/booth-pavilion/booth-pavilion.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/booth-pavilion/booth-pavilion.texture-template.png
Tente d'événement (booth-tent)Stands éphémères3×2.1×30.6~2.52048:416, au moins 1024×208 pxhttps://metamoa.com/ads/models/booth-tent/booth-tent.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/booth-tent/booth-tent.texture-template.png
Panneau d'abribus (busstop-shelter)Écrans · panneaux d'affichage3.7×2.6×2.40.7~1.5512:1024, au moins 256×512 pxhttps://metamoa.com/ads/models/busstop-shelter/busstop-shelter.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/busstop-shelter/busstop-shelter.texture-template.png
Food cart (cart-food)Chariots · parasols1.5×2.6×30.7~1.81024:656, au moins 512×328 pxhttps://metamoa.com/ads/models/cart-food/cart-food.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/cart-food/cart-food.texture-template.png
Parasol (cart-parasol)Chariots · parasols2×2.6×2.30.6~2https://metamoa.com/ads/models/cart-parasol/cart-parasol.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/cart-parasol/cart-parasol.texture-template.png
Borne (kiosk-ticket)Bornes0.8×1.8×0.80.8~1.5880:1024, au moins 440×512 pxhttps://metamoa.com/ads/models/kiosk-ticket/kiosk-ticket.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/kiosk-ticket/kiosk-ticket.texture-template.png
Showroom conteneur (showroom-container)Showrooms6.1×3×2.90.5~22048:912, au moins 1024×456 pxhttps://metamoa.com/ads/models/showroom-container/showroom-container.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/showroom-container/showroom-container.texture-template.png
Chevalet en A (sign-aframe)Panneaux et enseignes de base0.5×1×0.40.6~2.5544:1024, au moins 272×512 pxhttps://metamoa.com/ads/models/sign-aframe/sign-aframe.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/sign-aframe/sign-aframe.texture-template.png
Panneau fléché (sign-arrow)Panneaux et enseignes de base1×2.2×0.20.5~2.51024:768, au moins 512×384 pxhttps://metamoa.com/ads/models/sign-arrow/sign-arrow.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/sign-arrow/sign-arrow.texture-template.png
Présentoir de menu (sign-menu)Panneaux et enseignes de base0.9×1.4×0.50.5~2.5640:1024, au moins 320×512 pxhttps://metamoa.com/ads/models/sign-menu/sign-menu.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/sign-menu/sign-menu.texture-template.png
Panneau sur poteau (sign-pole)Panneaux et enseignes de base0.6×2.6×0.30.5~2.5784:1024, au moins 392×512 pxhttps://metamoa.com/ads/models/sign-pole/sign-pole.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/sign-pole/sign-pole.texture-template.png
Panneau à planter (sign-stake)Panneaux et enseignes de base0.7×1.2×0.60.5~3800:1024, au moins 400×512 pxhttps://metamoa.com/ads/models/sign-stake/sign-stake.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/sign-stake/sign-stake.texture-template.png
Panneau mural (sign-wall)Panneaux et enseignes de base1.2×0.8×00.5~41024:672, au moins 512×336 pxhttps://metamoa.com/ads/models/sign-wall/sign-wall.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/sign-wall/sign-wall.texture-template.png
Bannière murale (sign-wall-banner)Panneaux et enseignes de base1×2×0.30.5~3528:1024, au moins 264×512 pxhttps://metamoa.com/ads/models/sign-wall-banner/sign-wall-banner.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/sign-wall-banner/sign-wall-banner.texture-template.png
Écran de scène (stage-screen)Écrans · panneaux d'affichage12×5.5×12.70.5~1.52048:352, au moins 1024×176 pxhttps://metamoa.com/ads/models/stage-screen/stage-screen.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/stage-screen/stage-screen.texture-template.png
Distributeur automatique (vending-drink)Distributeurs automatiques1.3×1.9×1.20.8~1.5848:1024, au moins 424×512 pxhttps://metamoa.com/ads/models/vending-drink/vending-drink.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/vending-drink/vending-drink.texture-template.png
Machine à capsules (vending-gacha)Distributeurs automatiques0.6×1.4×0.60.8~1.5912:1024, au moins 456×512 pxhttps://metamoa.com/ads/models/vending-gacha/vending-gacha.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/vending-gacha/vending-gacha.texture-template.png
Réfrigérateur vitrine (vending-showcase)Distributeurs automatiques0.9×2×0.80.8~1.5432:1024, au moins 216×512 pxhttps://metamoa.com/ads/models/vending-showcase/vending-showcase.texture-default.png · gabarit avec lignes https://metamoa.com/ads/models/vending-showcase/vending-showcase.texture-template.png
Boutique publicitaire (shop-ad)Bâtiments4.2×3.6×3.30.6~22048:1024, au moins 1024×512 px (une image affichée à l'avant, sur les côtés, à l'arrière et sur le dessus)

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.

PersonnageidAccessoires possiblesLicence
Changmoachangmoaprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
Metappyeoseumetabbyeosprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
Bulk Uploaderbulkuploaderprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
Hotspot Wizardhotspotprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
Bangjang Knightbangjangprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
Teolgalideteolgalprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
Nailbusneilbusprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
Linkblinlinkblinprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
Diablongdiablongprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
Vincentvincentprop-neck-sign prop-badgeInterne (FLOAT Co., Ltd.)
Chat à poil court Nyangjupgocat_shortprop-neck-sign prop-badgeCC BY 4.0
Chat à poil long Nyangjupgocat_longprop-neck-sign prop-badgeCC BY 4.0
Munchkin Nyangjupgocat_munchkinprop-neck-sign prop-badgeCC BY 4.0
Corgi Nyangjupgodog_corgiprop-neck-sign prop-badgeCC BY 4.0
AccessoireidRatio d'image · taille minimale
Pancarte au cou (type badge)prop-badge720:1024, au moins 360×512 px
Ballonprop-balloon1024:1024, au moins 512×512 px
Drapeau à mainprop-flag1024:688, au moins 512×344 px
Pancarte portée au couprop-neck-sign1024:720, au moins 512×360 px
Pancarte à la mainprop-picket1024:720, au moins 512×360 px
Sac de coursesprop-shopping-bag1024:1024, au moins 512×512 px

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.).

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.

NiveaugradeFrais de créationGratuit à partir de cette dépense média
Produit simple · enseignesimple₩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 personnagecharacter₩100,000 (prix hors taxes, TVA non comprise)₩1,000,000

Annonceurs : étapes d'inscription autonome

  1. Connectez-vous avec un compte Metamoa sur https://metamoa.com/ads/manage (inscription dans la même fenêtre).
  2. Créer une campagne : nom, marque, secteur et adresse de l'espace de marque (si vous utilisez le CPA à l'entrée).
  3. 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.
  4. 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.
  5. 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.
  6. 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

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.

HTTPerrorSignification
400invalidUn champ a un format incorrect. fields indique les champs erronés.
400bad_modelPas un glb, pas du glTF 2.0, ou contient une adresse externe (uri). Le motif est dans reason.
400bad_imageLe 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.
400bad_buildingLe default_building de l'emplacement n'est pas un identifiant de bâtiment ou de panneau de GET /ads/v1/buildings (vide est accepté).
400slot_unavailableL'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.
401unauthorizedPas de clé d'espace ni de connexion à la console, ou valeur incorrecte.
401sign_inAnnonceur : pas de connexion à un compte Metamoa, ou elle a expiré.
403owner_requiredUne clé d'espace existe, mais l'opérateur de l'espace n'est pas encore vérifié.
403owner_page_onlyTentative 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).
403bad_ad_keySDK : space et key (mm_adpub_) ne correspondent pas.
403terms_requiredCet espace n'a pas vérifié les conditions de diffusion publicitaire.
403ads_offCet espace a désactivé le consentement aux publicités.
403origin_mismatchLa requête SDK ne provient pas du site de cet espace (même domaine).
404not_houseNos propres publicités (GET /ads/v1/house) ont été appelées depuis un espace que Metamoa n'exploite pas lui-même.
403not_yoursAnnonceur : a utilisé l'identifiant de fichier de quelqu'un d'autre.
404no_slotAucun emplacement publicitaire avec ce nom ou cet identifiant.
404not_foundCette campagne ou ce fichier n'existe pas.
409not_listedUn espace non listé (avant approbation ou masqué).
409payout_info_requiredTentative 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>).
409advertiser_requiredAnnonceur : tentative de demander ou de payer une campagne avant d'avoir ajouté les informations d'annonceur (PUT /api/ads/advertiser).
409biz_doc_requiredAnnonceur : 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).
409business_onlyAnnonceur : un annonceur particulier a tenté d'importer une copie de certificat d'immatriculation d'entreprise.
400bad_docAnnonceur : la copie du certificat d'immatriculation n'est pas au format PDF, JPG ou PNG.
413doc_too_bigAnnonceur : la copie du certificat d'immatriculation dépasse 5 Mo.
503advertiser_unavailableAnnonceur : le serveur n'a pas de clé de chiffrement pour les informations d'annonceur et ne peut donc pas les accepter.
409email_not_linkedAnnonceur : l'e-mail d'un annonceur particulier n'est pas celui utilisé pour se connecter à ce compte Metamoa.
409name_takenUn emplacement du même nom existe déjà.
409slot_limitJusqu'à 30 emplacements de l'opérateur par espace, et jusqu'à 5 emplacements SDK non confirmés.
409slot_takenUn emplacement déjà sous un autre contrat d'emplacement fixe pour cette période.
409tier_too_lowChoix, 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.
409not_for_saleAucun prix de contrat d'emplacement fixe.
409under_minimumEn dessous de la dépense média minimale. min_spend_won et spend_won sont fournis.
409no_click_historyChoix 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.
409over_inventoryLe budget CPM dépasse le plafond d'impressions visibles prévues des emplacements choisis. max_budget_won est fourni.
409rejected_fileUtilisation dans une campagne d'un fichier bloqué lors de la vérification.
409wrong_stateAction impossible dans cet état (mettre en pause une campagne en cours de vérification, etc.).
409staleAdministrateur : 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.
409already_paidTentative de rouvrir le paiement d'une campagne déjà payée.
409not_paidAdministrateur : tentative d'approuver le règlement d'une campagne dont le paiement n'est pas terminé.
409heldAdministrateur : tentative d'approuver le règlement d'une campagne ayant une part en attente (statuer d'abord sur la mise en attente).
424hrum_failedImpossible de se connecter au paiement (Hrum). Réessayez dans un instant.
503pay_not_readyLe paiement ne peut pas encore être ouvert (serveur pas encore configuré).
409model_missingAdministrateur : campagne de demande de modèle approuvée avant que le modèle soit joint.
413model_too_bigLe fichier du modèle dépasse 6 Mo.
429too_manyTrop 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