Anuncios 3D de Metamoa · 3D ads
Registro anticipado de operadores · ver los niveles de reparto de ingresos
De un vistazo
Los anuncios 3D de Metamoa colocan el modelo 3D, el edificio publicitario o el personaje publicitario del anunciante en espacios publicitarios dentro de espacios de metaverso web, cuentan solo lo que las personas realmente vieron e hicieron, cobran por ello y reparten esa parte con los operadores de espacios. Como empresa de publicidad y agencia publicitaria, aceptamos desde grandes empresas hasta pymes.
- Operadores de espacios: en Monetización de la consola del espacio (/owner/revenue), usa 「Registrarse para anuncios」 (revisión de términos, datos de pago, espacios publicitarios) → añade una línea de script y los espacios publicitarios, y listo.
- Anunciantes: inicia sesión con una cuenta de Metamoa en /ads/manage → sube un modelo 3D (glb), o elige un edificio publicitario y añade una imagen o textura, o elige un accesorio y un anuncio para un personaje publicitario básico → elige tú los espacios o usa 「Recomendar」 → tipo de cobro, presupuesto y fechas → se publica tras la revisión.
- ¿Sin modelo? Elige 「Solicitar un modelo」 y lo hacemos por ti. También aceptamos tu propio modelo. Los personajes publicitarios básicos son gratis con cualquier importe.
- Cuatro formas de cobro: CPM (impresiones visibles), CPA (clics en el modelo, entradas al espacio de marca), tiempo de visualización (tiempo total mostrado) y contratos de espacio fijo (por un periodo, el espacio en exclusiva). Todos los importes son (precio de suministro, IVA no incluido).
- El tamaño de un modelo publicitario puede ser ajustado por el operador del espacio o por Metamoa según el espacio.




4 productos y cobro
Todos los importes son precios de suministro, IVA no incluido.
| Producto | billing | Qué se cuenta | Precio unitario |
|---|---|---|---|
| CPM (impresiones visibles) | cpm | 1 impresión visible = el modelo permanece en pantalla al menos en una proporción fijada, durante más de un tiempo fijado sin interrupción (con la pestaña visible) | ₩8,000 por 1,000 visibles |
| CPA · clic en el modelo | cpa | Un toque o clic en el modelo publicitario. Si tras el clic se llega a entrar al espacio de marca, solo se cobra esa 1 entrada | ₩700 por 1 clic |
| CPA · entrada al espacio de marca | cpa | Tocar el anuncio y entrar al espacio de marca (brand_url). Se cuenta mediante una redirección del servidor (/ads/go); una vez al día por persona y campaña | ₩1,000 por 1 entrada |
| Tiempo de visualización | time | Tiempo total que el anuncio se mostró tras una impresión visible (solo mientras hay interacción, hasta un tope diario por persona y modelo) | ₩1,000 por 1,000 segundos visibles |
| Contrato de espacio fijo | fixed | Por un periodo fijo (hasta un mes). Usas en exclusiva el espacio publicitario contratado durante ese periodo (por espacio). No se garantizan impresiones | Ver la tabla de niveles abajo |
Niveles del contrato de espacio fijo
El nivel se fija según la mediana de los clics diarios limpios en el espacio durante los últimos 14 días del espacio donde está la ubicación (sin las visitas del propio operador, redes de centros de datos ni navegadores automatizados; el «Entrar» de metamoa solo cuenta tras la verificación humana). Las ubicaciones en espacios por debajo del nivel más bajo no se venden como contrato fijo, solo como anuncios por rendimiento. El periodo del contrato es semanal (7 días) o mensual (30 días).
| Nivel | Clics diarios en el espacio | Semanal (1 espacio) | Mensual (1 espacio) |
|---|---|---|---|
| S | 1,000 o más | ₩50,000 | ₩180,000 |
| A | 300~999 | ₩15,000 | ₩50,000 |
| B | 100~299 | ₩5,000 | ₩18,000 |
- Inversión mínima: inversión en medios de ₩10,000 (precio de suministro, IVA no incluido), sin incluir la tarifa de creación del modelo. En los anuncios por rendimiento cuenta el presupuesto; en los contratos fijos, la suma de los importes del contrato.
- Los anuncios por rendimiento (CPM, CPA, tiempo de visualización) cobran solo lo que realmente se contó, y una campaña deja de publicarse cuando su gasto alcanza su presupuesto (budget_won).
- Un contrato CPM solo se acepta hasta el 70% de las impresiones visibles previstas de los espacios elegidos (clics diarios en el espacio × 0.7 × días) (409 over_inventory).
- Los anuncios CPA y de tiempo de visualización no se bloquean, pero si el presupuesto supera el gasto previsto, /ads/manage te avisa antes de solicitar: sobre las mismas impresiones visibles previstas, el CPA multiplica por la tasa de clics de referencia del 2% × el mayor de los precios de clic y entrada, y el tiempo de visualización por 60 segundos por persona y día (spend_estimate de GET /api/ads/options).
- Un espacio con contrato fijo muestra solo esa campaña durante el periodo, y no se acepta otro contrato fijo para el mismo espacio en fechas que se solapen (409 slot_taken). El espacio se reserva cuando la revisión lo aprueba: las solicitudes pendientes de revisión no reservan espacios, y gana el contrato aprobado primero. Si el modelo no se mostró algunos días o el tráfico cae más del 30%, lo compensamos con un reembolso proporcional o una prórroga.
- El cobro y los niveles se basan en los informes medidos por Metamoa (impresiones visibles, clics, entradas, tiempo de visualización, clics en el espacio).
Fórmulas de recuento
Las fechas son días en hora de Corea (ad_daily). Los importes son precios de suministro sin fracciones de won. Los eventos detectados por una regla no se cuentan y se registran aparte por motivo (ad_excluded).
- Impresiones visibles imps = número de eventos
impque pasaron todas las reglas - Clics clicks =
clickaprobados, entradas enters = entradas aprobadas (/ads/go), converted = clics que llegaron a una entrada con el mismo token - Tiempo de visualización view_ms = suma de ms de los eventos
timeaprobados (solo tokens cuya impresión se contó, hasta 15,000ms por evento, hasta el tope diario por persona y modelo) - Importe CPM = floor(imps × cpm_won ÷ 1,000)
- Importe CPA = (clicks − converted) × click_won + enters × enter_won
- Importe por tiempo de visualización = floor(view_ms ÷ 1,000 × time_1000s_won ÷ 1,000)
- Importe del contrato fijo = suma de los precios de nivel de cada espacio contratado. Si solo se cuenta parte del periodo, por espacio floor(precio × días de contrato dentro de ese periodo ÷ días de contrato)
- Parte del operador del espacio = floor(importe por espacio × porcentaje del nivel del operador de ese espacio (%) ÷ 100). El importe es el precio de suministro de medios tras quitar el tráfico no válido; las tarifas de creación de modelos y espacios no se reparten. Niveles: 「Niveles de reparto de ingresos para operadores de espacios」 abajo.
Niveles de reparto de ingresos para operadores de espacios
Los ingresos publicitarios (el importe de medios publicitarios por espacio, precio de suministro tras quitar el tráfico no válido) se reparten entre el operador del espacio y Metamoa según el porcentaje del nivel. En vigor desde el 11/11/2026. Registro anticipado: https://metamoa.com/ads/partners
| Nivel | Quién | Operador del espacio : Metamoa |
|---|---|---|
| Platino | Por orden de llegada: operadores de espacios 1 a 10 | 9:1 |
| Oro | Operadores de espacios 11 a 100 (90 personas) | 8:2 |
| Plata | Operadores de espacios posteriores | 7:3 |
| Bronce | Operadores de espacios que firmen un nuevo contrato desde el 1/1/2027 | 6:4 |
Los porcentajes podrán ajustarse más adelante según el rendimiento de los anuncios.
- Operador del espacio = una cuenta propietaria que registró un espacio en Metamoa e inicia sesión en la consola del espacio. El orden es el momento en que cada uno activó por primera vez 「Consentimiento para anuncios」 en la consola del espacio, numerado de uno en uno por el servidor.
- Un nivel, una vez fijado, se mantiene, y los demás espacios del mismo operador tienen el mismo nivel.
- Los operadores de espacios que firmen un nuevo contrato desde el 1/1/2027 a las 0:00 (hora de Corea) son Bronce sin importar su orden.
- Tu nivel y porcentaje: el panel 「Anuncios 3D」 de la consola del espacio, partner de GET /api/space/{id}/ads. Plazas restantes: seats de GET /api/ads/partners.
- Plazas restantes ahora: Platino 0/10 · Oro 80/90
Revisión de términos y consentimiento para anuncios
Los términos de servicio ahora incluyen una cláusula de colocación de anuncios (artículo 4-4). Para recibir anuncios, el operador del espacio hace dos cosas a la vez en 「Registrarse para anuncios」 de Monetización en la consola del espacio.
- Revisión de términos: marca la revisión de términos en el paso 1 de 「Registrarse para anuncios」 en la consola del espacio (/owner/revenue?id=<id del espacio>). Solo funciona en la consola del espacio (con una clave del espacio da 403 owner_page_only).
- Consentimiento para anuncios: se activa junto con la revisión de términos y luego se activa y desactiva por espacio en la misma pantalla. Para activarlo se necesitan el tipo de datos de pago y un contacto (si no, 409 payout_info_required). Solo cuando está activado aparece la API de anuncios del espacio (una línea de script, clave de anuncios); al desactivarlo los anuncios se detienen de inmediato (serve 403 ads_off).
Registro de consentimiento: el espacio, quién (un hash del correo de inicio de sesión del operador en esa consola), cuándo, qué versión de los términos (data-ads-version de terms.html) y activado/desactivado se guardan sin borrarse (ad_consents).
Los espacios que no han revisado los términos, tienen desactivado el consentimiento para anuncios o no están listados no reciben anuncios.
Espacios publicitarios
Los operadores deciden dónde se colocan los anuncios dentro de su propio metaverso. Los anunciantes eligen espacios o reciben recomendaciones, y los contratos fijos también se hacen por espacio. La lista de espacios se puede ver, activar y desactivar en la consola del espacio.
| Campo | Formato | Significado |
|---|---|---|
| name | 1 a 40 caracteres | Un nombre que no se repite en el espacio |
| kind | floor · wall · air · character | Modelo en el suelo · letrero de pared · banner aéreo · personaje publicitario de pie o caminando |
| position | [x, y, z] metros | Posición del centro del suelo de la caja del espacio (coordenadas del espacio) |
| rotation | [x, y, z] grados (-360 a 360) | Rotación del espacio. Por defecto [0, 0, 0] |
| size | [ancho, alto, fondo] metros (0.1 a 200) | La caja donde va el anuncio. El anuncio se amplía o reduce para encajar en esta caja |
| scale | [mín, máx] veces (0.05 a 20) | Escala de tamaño por espacio: al encajar en la caja, el anuncio solo se escala dentro de este rango de su tamaño original. Por defecto [0.25, 4] |
| roam | 0 a 50 metros | espacios character: el radio por el que camina el personaje (0 significa de pie) |
| industries | Lista de ids de sector | Sectores que acepta este espacio. Vacío significa todos los sectores |
| enabled | true · false | Desactivado, no se muestran anuncios en este espacio |
El tamaño de un modelo publicitario puede ser ajustado por el operador del espacio o por Metamoa según el espacio.
Los anuncios de personajes van solo a espacios character; los de modelos y edificios solo a espacios floor, wall y air.
El SDK (clave pública de anuncios) solo puede crear espacios nuevos, y los espacios creados así entran desactivados; los anuncios se muestran solo después de que el operador los revise y active en la consola del espacio. El SDK no puede cambiar un espacio existente (mismo nombre) y lo devuelve tal cual. Hasta 5 espacios SDK desactivados por espacio, contados aparte de los 30 espacios del operador. Un grupo de IP puede crear hasta 20 al día, y los espacios SDK que el operador nunca activó en 7 días se eliminan (no se eliminan los activados alguna vez ni los usados por una campaña). Al activarse, cuentan dentro de los 30 espacios del operador. Cambiar la caja, el tipo o los sectores de un espacio y activarlo o desactivarlo solo funciona con el inicio de sesión de la consola o la clave del espacio.
Ids de sector: game (juegos) · fashion (moda, belleza) · food (comida y bebida) · tech (TI, electrónica) · finance (finanzas) · edu (educación) · travel (viajes, ocio) · culture (cultura, entretenimiento) · auto (automóviles) · public (público, sin ánimo de lucro) · etc (otros)
Hasta 30 espacios por espacio. La API de espacios usa la clave del espacio (mm_live_) o el inicio de sesión de la consola:
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}Operadores de espacios: pasos de instalación
- En 「Registrarse para anuncios」 de Monetización en la consola del espacio (
https://metamoa.com/owner/revenue?id=<id del espacio>), marca la revisión de términos y empieza los anuncios. - Pon la línea de script del panel 「API de anuncios」 de la misma pantalla al final del <head> o <body> de la página de tu espacio. La clave de anuncios (mm_adpub_) se puede hacer pública (nunca pongas ahí la clave del espacio mm_live_).
- En un espacio three.js, llama a attach y slot después de crear la escena. El espacio se registra desactivado la primera vez que se llama. Los anuncios se muestran cuando lo activas en 「Espacios publicitarios」 de la consola (también puedes crearlo activado desde el principio con la API de espacios).
- Cuando se ve el anuncio, has terminado. El SDK envía por sí solo las impresiones visibles, los clics y el tiempo de visualización, y para las entradas al espacio de marca el SDK abre /ads/go al tocar el anuncio y el servidor lo cuenta.
- En 「Espacios publicitarios」 de la consola del espacio, activa y desactiva espacios y consulta el informe de 30 días (antes y después de las reglas) y tu parte (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 });
});
Los motores que no son three.js (Babylon.js, PlayCanvas, Unity WebGL, etc.) obtienen el anuncio con serve, lo dibujan ellos mismos y envían los eventos: ads.serve(name) → { ad }, ads.report(name, event). Para las entradas, abre ad.enter_url en una ventana nueva o en la misma. La especificación está en 「Especificación de eventos」 abajo.
Cómo cuenta el SDK
- Impresión visible: cuando al menos una proporción fijada del modelo está dentro de la vista de la cámara, con un tamaño en pantalla de al menos un área fijada, durante más de un tiempo fijado con la pestaña visible, envía 1 impresión (una vez por token de serve).
- Tiempo de visualización: tras la impresión, mientras el anuncio sigue visible en las condiciones anteriores, acumula y envía cada 5 segundos, junto con el número de entradas de cámara y puntero en ese intervalo (se detiene cuando la pestaña se oculta).
- Si la respuesta de serve trae un vid, guárdalo en ese navegador y envíalo con el siguiente serve (GET /ads/v1/serve?…&vid=). Solo se lee un vid que el servidor firmó para esa red. El servidor combina el vid y el grupo de IP de conexión y firma a esa persona dentro del token. Una impresión solo se cuenta unos 2 segundos después de serve.
- Clic: un toque o clic en el anuncio envía
clicky, si el anuncio tiene un espacio de marca, abre enter_url (/ads/go) en una ventana nueva. El servidor cuenta la entrada y envía al visitante al espacio de marca. - Puerta: si existe ad.door, entrar caminando por la puerta abre enter_url una vez en una ventana nueva. Cuándo vuelve a abrirse: ver 「Entrar por la puerta」 abajo.
- El id del navegador (vid) lo da el servidor y el SDK lo guarda en localStorage. Solo se usa para los límites de repetición. No se envía información personal como nombres o contactos.
- Los anuncios se vuelven a obtener cada 30 minutos (un token nuevo). Los personajes de los espacios character caminan despacio dentro del radio roam.
Entrar por la puerta
Puedes poner una puerta en un edificio publicitario o en tu propio modelo 3D. Es una puerta, no un portal: cuando alguien entra caminando por la puerta, el espacio actual se queda como está y el espacio de marca se abre en una ventana nueva (pestaña nueva). Pon "door": true en el creative de la campaña (solo cuando kind es model o building), y brand_url es obligatorio (si no, 400 invalid, fields brand_url). El ad de serve vendrá con 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 } }
Reglas para que la puerta no se reabra sin parar (de obligado cumplimiento)
- Al acercarse caminando a menos de 1.2m de la puerta, se abre el espacio de marca (enter_url con &via=door) una vez en una ventana nueva.
- Tras cerrar la ventana nueva y volver, moverse un poco dentro o cerca de la puerta no la vuelve a abrir.
- Solo se vuelve a abrir tras alejarse más de 3m de la puerta y volver a entrar (distancia de entrada 1.2m < distancia de salida 3m).
- No se abre mientras la pestaña está oculta o la ventana no tiene el foco, y al volver hay que salir de la zona de la puerta una vez. No se abre si ya estás dentro de la puerta al abrir la página.
- Tocar o hacer clic en el edificio para abrirlo funciona como antes (en cada clic). Las reglas de la puerta solo se aplican al entrar caminando.
- Si el navegador bloquea la ventana nueva, aparece un botón 「Abrir <marca>」 en la parte inferior de la pantalla. Solo se abre al tocar ese botón (desaparece si te alejas de la puerta sin tocarlo).
Posición de la puerta: un nodo llamado door en el glb si lo hay; si no, el SDK dibuja una puerta por defecto en el centro inferior del frente del anuncio (+Z). La distancia es la distancia en el suelo desde el personaje que camina hasta el frente de la puerta. Pasa a attach un walker (el Object3D del personaje que camina o una función que devuelva {x, y, z}). Sin él, se usa la posición de la cámara.
ads.attach({ THREE, GLTFLoader, scene, camera, renderer, walker: player }); // player: the walking character (Object3D)
Los espacios que dibujan ad.door ellos mismos con un motor que no es three.js deben seguir las mismas reglas: tras abrirla una vez, no volver a abrirla hasta salir de exit_m, y tras ocultarse la pestaña y volver, hasta salir una vez de la zona de la puerta.
Para que entrar y salir no agote el presupuesto
- Una entrada por la puerta se cuenta al mismo precio que 1 entrada CPA (precio e inversión mínima sin cambios).
- Las entradas por persona (el id de navegador del servidor + grupo de direcciones de internet) y campaña se cuentan una vez cada 24 horas, hasta 3 veces en 30 días. El mismo grupo de direcciones de internet llega hasta 3 veces al día por campaña y espacio.
- Las entradas por encima de eso siguen enviando al visitante al espacio de marca, pero no se cobran, solo se registran (motivo de exclusión repeat_limit). Se comprueban de nuevo con los registros de eventos del servidor (solo hashes), así que no se olvidan aunque el servidor se reinicie.
- Una entrada con el mismo token de serve se cuenta una vez, y solo para tokens cuya impresión se contó primero (las reglas antibots y antifraude tal cual).
Reglas antibots y antifraude
En el servidor, los eventos pasan por las reglas siguientes en orden. Si alguna lo detecta, queda fuera del informe y se registra aparte con el nombre de esa regla. Cada regla se activa y desactiva en bot_rules de data/ads-config.json.
| Regla | Qué hace | Ahora |
|---|---|---|
UA de bot (ua_bot) | Se excluyen robots de búsqueda, previsualizadores, scripts (curl, python, headless, etc.) y solicitudes sin User-Agent. | Activada |
Navegadores automatizados (headless) | Se excluyen navegadores con navigator.webdriver activado, HeadlessChrome, PhantomJS, Electron, jsdom y solicitudes sin Accept-Language. Es una definición de medición, no cuenta como defensa contra scripts. | Activada |
Visibilidad y foco de la pestaña (visibility_focus) | Las impresiones solo cuentan mientras la pestaña está visible (document.visibilityState = visible) y la ventana tiene el foco; el tiempo de visualización, solo mientras la pestaña está visible. Es una definición de medición. | Activada |
Comprobación de visibilidad (min_view) | Al menos una proporción fijada del modelo debe seguir en pantalla, con al menos un área fijada, durante más de un tiempo fijado para 1 impresión. Es una definición de medición. | Activada |
Límites de repetición por persona y dirección de internet (repeat_limit) | Las impresiones y los clics de la misma persona y modelo cuentan una vez en un tiempo fijado; las entradas (puerta incluida), una vez al día y hasta un número fijado durante días fijados. Se excluye lo que supere el tope por hora de un grupo de direcciones de internet, los nuevos espectadores diarios por espacio o las impresiones, clics y entradas diarios por campaña y espacio. Los límites de entrada se comprueban de nuevo con los registros de eventos del servidor, así que no se olvidan aunque el servidor se reinicie. | Activada |
Tokens firmados por el servidor (signed_token) | Los eventos deben llevar el token firmado (HMAC) que da serve. El espectador y el grupo de direcciones de internet en el momento de serve se firman dentro del token; se excluyen las impresiones desde otra dirección y también las que llegan antes de que pase un tiempo fijado desde serve. Un token cuenta como máximo una impresión, un clic y una entrada dentro de su tiempo de validez. El presupuesto de la campaña se vuelve a comprobar al contar, y los eventos que lo superan no se cuentan (budget). | Activada |
Medición del tiempo de visualización (view_time) | El tiempo de visualización solo cuenta cuando hay entradas de cámara o puntero en ese intervalo, y solo hasta los topes diarios por token, por persona y modelo, y por dirección de internet y modelo. | Activada |
Tráfico del propio operador (owner_traffic) | Los eventos desde una dirección de internet que abrió la consola de ese espacio se excluyen durante un número fijado de días. | Activada |
Rastros de interacción humana (human_input) | Solo cuentan los clics que el navegador marca como interacción humana (isTrusted). Las impresiones no miran el número de interacciones (personas que miran quietas, usuarios de teclado y lectores de pantalla). | Activada |
Vigilancia de anomalías y retenciones (anomaly) | Se excluyen las impresiones que una persona vio por encima de un número fijado al día. Los clics y entradas CPA cuentan hasta una asignación diaria automática por espacio, y el resto se retiene. Si la tasa de clics y entradas (comparada con la red sin ese espacio), las impresiones por clic en el espacio, los nuevos espectadores por dirección de internet, la proporción de centros de datos, las repeticiones desde la misma dirección o las entradas por clic superan sus umbrales, se retiene la parte de ese espacio de ese mes y un administrador decide. | Activada |
Redes de centros de datos (asn) | Si el x-mm-asn (número AS) que añade Cloudflare es una red de nube o hosting, el evento se excluye, y si esa proporción es grande, el espacio se retiene. Solo se confía en él cuando la cabecera secreta (origin-auth) que una Cloudflare Transform Rule añade junto a él coincide con el valor env del servidor; si no, la red del evento queda como 「desconocida」 y la proporción de centros de datos se mide solo con eventos de red conocida. | Activada |
Verificación humana en la entrada (turnstile) | Una entrada al espacio de marca (/ads/go) solo cuenta tras superar Cloudflare Turnstile en el dominio de Metamoa. Si falla, el visitante igualmente va al espacio de marca y solo no se cuenta la entrada. Las entradas que llegaron sin clave se retienen. | Activada |
Verificación humana de impresiones (turnstile_imp) | El SDK ejecuta Cloudflare Turnstile en una ventana oculta de metamoa y añade a las impresiones el pase que obtiene (vinculado a esa red y espacio). Un pase cuenta; una verificación fallida se excluye. Sin pase solo se retiene esa impresión; al terminar el mes se libera o anula según la proporción no verificable del espacio (un administrador puede liberarla). El anuncio siempre se muestra tal cual. | Activada |
- Los clics y las entradas solo cuentan cuando la impresión de ese token se contó primero (si no, no_impression).
- Cuando las tablas que guarda el servidor se llenan, no borra registros cuyo plazo aún no ha vencido; deja de contar eventos nuevos (capacity). Falla de forma cerrada.
Especificación de eventos
Las solicitudes del SDK solo se aceptan desde el propio sitio de ese espacio. Para el dominio propio del operador, el mismo dominio registrable; para hosts compartidos como github.io o vercel.app, exactamente el mismo nombre de host; y para espacios bajo una ruta (github.io/<repositorio>, claude.ai), la ruta del Referer también debe estar debajo (el SDK envía el Referer completo). Todo con CORS abierto, JSON. También se acepta sendBeacon (text/plain).
Obtener un anuncio · 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 es null, ahora no hay anuncio para ese espacio. Si kind es model, coloca el glb de model_url; si es building, coloca el glb del edificio y, si mode es image, pon la imagen de image_url en cada nombre de mesh de faces, y si es texture, pon image_url sobre todos los texture.meshes, repetida según repeat. Si es character, coloca de pie el glb del personaje, sujeta el accesorio en prop.attach y pon en su tablero la imagen de image_url o las letras de text. Todo se ajusta a la caja slot.size, pero solo se escala dentro de slot.scale de su tamaño original.
Registrar un espacio · 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 (같은 이름의 자리를 바꾸지 않고 그대로)
Enviar eventos · 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 | Campo | Significado |
|---|---|---|
| imp | token, ms, area, inside, vis, focus, inputs, wd | ms: tiempo mostrado sin interrupción, area: área del modelo sobre el área de pantalla (0 a 1), inside: proporción del modelo dentro de la pantalla (0 a 1), vis·focus: pestaña visible y foco de la ventana, inputs: entradas de cámara y puntero en ese intervalo, wd: navigator.webdriver |
| time | token, ms, vis, inputs, wd | Tiempo mostrado desde el último time (hasta 15,000ms) y el número de entradas en ese intervalo |
| click | token, trusted, wd | Se tocó o hizo clic en el anuncio. trusted: interacción humana (isTrusted) |
Las impresiones cuentan con el pase de verificación humana que el SDK obtiene de una ventana oculta de metamoa (Cloudflare Turnstile). El anuncio se muestra al instante sin esperarlo. Si tu sitio envía una Content-Security-Policy, añade https://metamoa.com a frame-src. Si la ventana está bloqueada o no hay pase, esa impresión queda retenida; al terminar el mes se libera si la proporción no verificable del espacio es del 20% o menos, y se anula si la supera.
Hasta 20 a la vez. Los eventos no llevan vid; el espectador sale del valor dentro del token. Los eventos erróneos y los tokens de otro espacio solo se cuentan como excluded.
Entrada · go
Una entrada solo cuenta después de que /ads/go, en el dominio de Metamoa, compruebe con Cloudflare Turnstile que es una persona (cuando hay clave, aparece una pequeña pantalla de verificación durante 1 a 2 segundos). Si la verificación falla, la persona igualmente va al espacio de marca y solo no se cuenta la entrada.
GET https://metamoa.com/ads/go?t={serve 토큰}
→ 302 Location: {brand_url} (노출이 센 토큰이면 입장을 센 뒤 브랜드 공간으로. 캠페인이 집행 중·기간 안이고 토큰이 유효 시간 안일 때만 검수에서 승인된 brand_url로 가고, 아니면 Location: /)Edificios publicitarios, personajes y especificaciones de subida
Los anunciantes sin modelo eligen uno de nuestros edificios publicitarios o personajes publicitarios básicos. Para los edificios, elige una de dos formas: imagen (una imagen en cada tablero fijado) · textura (una textura o patrón sobre toda la superficie del edificio).
Para las texturas, descarga la plantilla por defecto (PNG cuadrado), edítala y súbela al mismo tamaño (1024 a 2048px). Las líneas rosas de la plantilla con líneas son los bordes de las piezas de la superficie: pinta dentro de una pieza y se verá en esa superficie.
En la tienda publicitaria (shop-ad), la única imagen subida se muestra en el frente, los lados, la parte trasera y la superior: el letrero frontal, ambos lados, la parte trasera y el tablero del techo tienen la misma proporción, así que se lee desde cualquier lado, incluso mirando desde arriba. Tiene puerta, así que se puede usar 「Entrar por la puerta」 ("door": true).
Los personajes publicitarios básicos son gratis con cualquier importe. Se colocan de pie o caminan en espacios character, llevan accesorios como un cartel al cuello, una tarjeta identificativa, una pancarta de mano, un globo, una bandera o una bolsa de compras sujetos a sus huesos, y el tablero del accesorio lleva una imagen publicitaria o letras de letrero (hasta 12 caracteres). Los gatos, el perro y Vincent solo pueden llevar accesorios al cuello.
| Personaje | id | Accesorios que puede llevar | Licencia |
|---|---|---|---|
| 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 | Propio (FLOAT Co., Ltd.) |
| Gato de pelo corto Nyangjupgo | cat_short | prop-neck-sign prop-badge | CC BY 4.0 |
| Gato de pelo largo 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 |
| Accesorio | id | Proporción de imagen · tamaño mínimo |
|---|---|---|
| Cartel al cuello (tipo tarjeta identificativa) | prop-badge | 720:1024, al menos 360×512px |
| Globo | prop-balloon | 1024:1024, al menos 512×512px |
| Bandera de mano | prop-flag | 1024:688, al menos 512×344px |
| Cartel colgado al cuello | prop-neck-sign | 1024:720, al menos 512×360px |
| Pancarta de mano | prop-picket | 1024:720, al menos 512×360px |
| Bolsa de compras | prop-shopping-bag | 1024:1024, al menos 512×512px |
- Formatos de imagen: PNG · JPEG · WEBP, hasta 2MB, hasta 4096px de ancho y alto, tolerancia de proporción hasta 2%. Las imágenes subidas se vuelven a guardar como WebP (se eliminan los metadatos de la foto).
- Modelo 3D: un archivo binario glTF 2.0 (.glb), hasta 6MB, texturas dentro del archivo, sin direcciones externas (uri).
- Los archivos subidos se comprueban por contenido (bytes mágicos): las imágenes solo se aceptan como PNG, JPEG o WebP (nada de SVG, HTML, etc.) y se rehacen como WebP, y los modelos solo como binario glTF 2.0. Los archivos publicitarios se sirven solo con un tipo fijo (image/webp, model/gltf-binary), nosniff y una política sandbox, así que nunca se ejecutan como scripts.
- El tamaño de un modelo publicitario puede ser ajustado por el operador del espacio o por Metamoa según el espacio.
- Los archivos de modelos y personajes están en /ads/models/ y solo se sirven como respuestas que no permiten scripts (tipo fijo, nosniff, sandbox). La lista y las fuentes están en docs/ads/MODELS.md; para cambiarlos, regenera data/ads-buildings.json y los archivos juntos con scripts/ads-import-models.mjs.
Créditos de los modelos
La mayoría de los modelos básicos son CC0 (dominio público) o de creación propia; los siguientes son CC BY, por lo que se citan sus fuentes. FLOAT Co., Ltd. los modificó todos (tamaño, caras publicitarias, etc.).
- Valla de pie: "Blank Billboard" by Jarlan Perez (https://poly.pizza/m/1E0d2B7bC8e), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), modificado por FLOAT Co., Ltd.
- Puesto pop-up: "Carnival Booth" by sirkitree (https://poly.pizza/m/4NizXJZsuO2), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), modificado por FLOAT Co., Ltd.
- Panel de parada de autobús: "Bus Stop" by Zsky (https://poly.pizza/m/OWczicNWhO), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), modificado por FLOAT Co., Ltd.
- Caballete tipo A: "Sandwich Board" by Anonymous (https://poly.pizza/m/ejy0W_7cHWT), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), modificado por FLOAT Co., Ltd.
- Gato de pelo corto Nyangjupgo: "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, convertido en vóxeles por FLOAT Co., Ltd.
- Gato de pelo largo Nyangjupgo: "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, convertido en vóxeles por FLOAT Co., Ltd.
- Munchkin Nyangjupgo: "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, convertido en vóxeles por FLOAT Co., Ltd.
- Corgi Nyangjupgo: "Dog" by Polyfork (https://polyfork.dev/asset/dog-base), CC BY 4.0, convertido en vóxeles por FLOAT Co., Ltd.
Solicitar un modelo
Cuando un anunciante elige 「Solicitar un modelo」, creamos el modelo 3D, lo añadimos a la campaña y luego lo revisamos. Envía los materiales (fotos del producto, logotipo, planos) a [email protected] con el número de campaña.
| Nivel | grade | Tarifa de creación | Gratis a partir de esta inversión en medios |
|---|---|---|---|
| Producto simple · letrero | simple | ₩50,000 (precio de suministro, IVA no incluido) | ₩500,000 |
| Producto detallado | precise | ₩100,000 (precio de suministro, IVA no incluido) | ₩1,000,000 |
| Personaje nuevo | character | ₩100,000 (precio de suministro, IVA no incluido) | ₩1,000,000 |
- El umbral de gratuidad es la inversión real en medios (la suma de todo el periodo del contrato, hasta 3 meses, sin modelado, IVA ni tráfico no válido).
- Un modelo hecho gratis incluye una licencia para mostrarlo solo en Metamoa (los derechos de autor son de Metamoa; la cesión, a cambio de la tarifa de creación), con 1 revisiones. Si el anunciante cancela o reduce la inversión, la tarifa de creación se cobra de forma proporcional: tarifa de creación × (1 − inversión real en medios ÷ umbral de gratuidad). Los modelos de pago tienen 2 revisiones.
- Los personajes publicitarios básicos (los personajes del Campamento Moa y de Nyangjupgo) son gratis con cualquier importe, sin solicitud de creación.
Anunciantes: pasos de registro autónomo
- Inicia sesión con una cuenta de Metamoa en https://metamoa.com/ads/manage (el registro, en la misma ventana).
- Crear una campaña: nombre, marca, sector y dirección del espacio de marca (al usar CPA de entrada).
- Creatividad: ① sube tu propio modelo 3D (glb) ② elige un edificio publicitario → una imagen por tablero en imagen, una textura en textura ③ elige un personaje publicitario básico + accesorio → una imagen o letras de letrero en el tablero del accesorio ④ solicita un modelo (elige un grado). Se muestran las especificaciones y una vista previa.
- Espacios: de la lista de espacios que aceptaron anuncios, elige tú los espacios por categoría, personas conectadas ahora y clics diarios en el espacio, o toca 「Recomendar」 para un conjunto de espacios ajustado al sector, la categoría y el tráfico.
- Define el tipo de cobro (CPM, CPA, tiempo de visualización, contrato de espacio fijo), el presupuesto y las fechas y solicita → pendiente de revisión.
- Cuando supera la revisión (obscenidad, violencia, sospecha de infracción de derechos de autor, etc.), se publica. Una campaña en curso se puede pausar y reactivar, y cada día ves las impresiones visibles, los clics, las entradas y el tiempo de visualización.
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>)
Creatividad de personaje: {"kind": "character", "character_id": "bangjang", "prop": "prop-picket", "image": "as_…"} o "text": "Leche Brillante" en lugar de "image". Contrato de espacio fijo: "billing": "fixed", "fixed_period": "week" | "month", end_day = start_day + periodo − 1. Solicitud de modelo: {"kind": "request", "grade": "simple", "note": "…"}.
Las creatividades de edificio y de modelo propio admiten dos cosas más (opcional): "tagline": "descripción de una línea" (hasta 30 caracteres, solo letras — sin etiquetas, corchetes angulares ni llaves (400 invalid, fields creative), revisada junto con la creatividad) se dibuja en la franja bajo el letrero de la tienda publicitaria o del edificio (mesh ad_tagline) y llega como ad.tagline { text, mesh, aspect } de serve. "door": true es 「Entrar por la puerta」 (requiere brand_url). Son los mismos campos 「Descripción de una línea」 y 「Entrar por la puerta」 del paso 2 de /ads/manage.
Revisión
- Los modelos e imágenes subidos y las campañas quedan pendientes de revisión (review) antes de publicarse. Cuando un administrador aprueba, se publica (active); si se rechaza, quedan rejected y el motivo.
- Las imágenes se revisan primero al subirlas mediante un análisis de imagen con IA en busca de obscenidad, violencia y logotipos o personajes ajenos, y se bloquean de inmediato si se detectan (rejected). Si el análisis no puede hacerse, un administrador las revisa.
- Los modelos los abre y revisa un administrador. Obscenidad, violencia o sospecha de infracción de derechos de autor implican rechazo.
Códigos de error
El cuerpo del error es { "error": "<código>", "message": "<una línea sobre qué hacer después>" }; los errores de campo vienen con fields y los límites con retry_after.
| HTTP | error | Significado |
|---|---|---|
| 400 | invalid | Un campo tiene un formato incorrecto. fields indica los campos erróneos. |
| 400 | bad_model | No es un glb, no es glTF 2.0 o contiene una dirección externa (uri). El motivo va en reason. |
| 400 | bad_image | El formato, el tamaño o la proporción de la imagen no coinciden con la especificación. Vienen reason (format · bytes · too_large · too_small · aspect) y spec. |
| 400 | bad_building | El default_building del espacio no es un id de edificio o cartel de GET /ads/v1/buildings (vacío está bien). |
| 400 | slot_unavailable | El espacio elegido no acepta anuncios, no acepta ese sector o no coincide con el tipo de creatividad (personajes solo en espacios de personaje). slot_ids indica esos espacios. |
| 401 | unauthorized | No hay clave del espacio ni inicio de sesión de la consola, o es incorrecto. |
| 401 | sign_in | Anunciante: no hay inicio de sesión con una cuenta de Metamoa o ha caducado. |
| 403 | owner_required | Hay una clave del espacio, pero el operador del espacio aún no está verificado. |
| 403 | owner_page_only | Se intentó la revisión de términos o el consentimiento para anuncios con una clave del espacio (solo funciona en la consola del espacio). |
| 403 | bad_ad_key | SDK: space y key (mm_adpub_) no coinciden. |
| 403 | terms_required | Ese espacio no ha revisado los términos de colocación de anuncios. |
| 403 | ads_off | Ese espacio desactivó el consentimiento para anuncios. |
| 403 | origin_mismatch | La solicitud del SDK no vino del sitio de ese espacio (mismo dominio). |
| 404 | not_house | Se llamó a nuestros propios anuncios (GET /ads/v1/house) desde un espacio que Metamoa no gestiona directamente. |
| 403 | not_yours | Anunciante: usó el id de archivo de otra persona. |
| 404 | no_slot | No hay ningún espacio publicitario con ese nombre o id. |
| 404 | not_found | Esa campaña o archivo no existe. |
| 409 | not_listed | Un espacio que no está listado (antes de la aprobación u oculto). |
| 409 | payout_info_required | Se intentó activar el consentimiento para anuncios sin el tipo de datos de pago (particular o empresa) ni un contacto (móvil o correo electrónico). Añádelos en Monetización de la consola del espacio (/owner/revenue?id=<id del espacio>). |
| 409 | advertiser_required | Anunciante: se intentó solicitar o pagar una campaña antes de añadir los datos del anunciante (PUT /api/ads/advertiser). |
| 409 | biz_doc_required | Anunciante: un anunciante empresa intentó pagar o solicitar un contrato de espacio fijo antes de subir una copia del certificado de registro empresarial (PUT /api/ads/advertiser/doc). |
| 409 | business_only | Anunciante: un anunciante particular intentó subir una copia de un certificado de registro empresarial. |
| 400 | bad_doc | Anunciante: la copia del certificado de registro empresarial no es PDF, JPG ni PNG. |
| 413 | doc_too_big | Anunciante: la copia del certificado de registro empresarial supera 5MB. |
| 503 | advertiser_unavailable | Anunciante: el servidor no tiene la clave de cifrado para los datos del anunciante, así que no puede aceptarlos. |
| 409 | email_not_linked | Anunciante: el correo de un anunciante particular no es el correo con el que se inició sesión en esta cuenta de Metamoa. |
| 409 | name_taken | Ya existe un espacio con el mismo nombre. |
| 409 | slot_limit | Hasta 30 espacios del operador por espacio, y hasta 5 espacios SDK sin confirmar. |
| 409 | slot_taken | Un espacio que ya tiene otro contrato de espacio fijo en ese periodo. |
| 409 | tier_too_low | Se eligió como contrato de espacio fijo un espacio de un lugar cuyos clics diarios están por debajo del nivel más bajo. slot_ids indica esos espacios. |
| 409 | not_for_sale | No hay precio de contrato de espacio fijo. |
| 409 | under_minimum | Por debajo de la inversión mínima en medios. Vienen min_spend_won y spend_won. |
| 409 | no_click_history | Se eligió CPM o contrato de espacio fijo para espacios sin historial de clics todavía (no se pueden medir impresiones ni nivel). Solo funcionan CPA y tiempo de visualización. Vienen slot_ids y billings. |
| 409 | over_inventory | El presupuesto CPM supera el tope de impresiones visibles previstas de los espacios elegidos. Viene max_budget_won. |
| 409 | rejected_file | Se usó en una campaña un archivo bloqueado en la revisión. |
| 409 | wrong_state | Algo que no se puede hacer en ese estado (pausar una campaña en revisión, etc.). |
| 409 | stale | Administrador: la campaña cambió después de abrir la pantalla de revisión (la version de decide difiere de la actual). Vuelve a mirar y decide de nuevo. |
| 409 | already_paid | Se intentó abrir de nuevo el pago de una campaña ya pagada. |
| 409 | not_paid | Administrador: se intentó aprobar la liquidación de una campaña cuyo pago no está completo. |
| 409 | held | Administrador: se intentó aprobar la liquidación de una campaña con una parte retenida (decide primero la retención). |
| 424 | hrum_failed | No se pudo conectar con el pago (Hrum). Inténtalo de nuevo en un momento. |
| 503 | pay_not_ready | Aún no se puede abrir el pago (antes de configurar el servidor). |
| 409 | model_missing | Administrador: se aprobó una campaña de solicitud de modelo antes de adjuntar el modelo. |
| 413 | model_too_big | El archivo del modelo supera 6MB. |
| 429 | too_many | Demasiadas solicitudes. Espera los segundos de Retry-After. |
Todas las rutas
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