Metamoa
Favorites Ranking

Metamoa 3D ads · 3D ads

At a glance

Metamoa 3D ads place an advertiser's 3D model, ad building or ad character in ad slots inside web metaverse spaces, count only what people actually saw and did, charge for that, and share it with the space operators. As an advertising and ad agency business, we take everyone from large enterprises to small businesses.

Real screen · Moa Campsite
Real screen · Moa Campsite
Real screen · shops at Moa Campsite (house ads)
Real screen · shops at Moa Campsite (house ads)
Real screen · the AI Butta courtyard
Real screen · the AI Butta courtyard
Real screen · Walking Into Van Gogh
Real screen · Walking Into Van Gogh

4 products and billing

All amounts are supply prices, VAT excluded.

ProductbillingWhat is countedUnit price
CPM (viewable impressions)cpm1 viewable impression = the model stays on screen at least a set share, for longer than a set time without a break (with the tab visible)₩8,000 per 1,000 viewable
CPA · model clickcpaA tap or click on the ad model. If the click goes on to a brand-space entry, only that 1 entry is charged₩700 per 1 click
CPA · brand-space entrycpaTapping the ad and going into the brand space (brand_url). Counted by a server redirect (/ads/go); once a day per person and campaign₩1,000 per 1 entry
View timetimeTotal time the ad was shown after a viewable impression (only while there is input, up to a daily cap per person and model)₩1,000 per 1,000 viewable seconds
Fixed space contractfixedFor a set period (up to one month). You have the contracted ad slot to yourself for that period (per slot). Impressions are not guaranteedSee the tier table below

Fixed space contract tiers

The tier is set by the median of the clean daily space clicks over the last 14 days of the space the slot is in (leaving out the operator's own visits, data-centre networks and automated browsers; metamoa's “Enter” counts only after the human check). Slots in spaces below the lowest tier are not sold as fixed contracts, only as performance ads. The contract period is either weekly (7 days) or monthly (30 days).

TierDaily space clicksWeekly (1 slot)Monthly (1 slot)
S1,000 or more₩50,000₩180,000
A300~999₩15,000₩50,000
B100~299₩5,000₩18,000

Counting formulas

Dates are Korea-time days (ad_daily). Amounts are supply prices with anything below one won dropped. Events caught by a rule are not counted and are tallied separately by reason (ad_excluded).

Space operator revenue share tiers

Ad revenue (the ad media amount per space, supply price after invalid traffic) is split between the space operator and Metamoa by the tier's ratio. In effect from 2026-11-11. Early sign-up: https://metamoa.com/ads/partners

TierWhoSpace operator : Metamoa
PlatinumFirst come: space operators 1 to 109:1
GoldSpace operators 11 to 100 (90 people)8:2
SilverSpace operators after that7:3
BronzeSpace operators signing a new contract from 2027-1-16:4

Ratios may be adjusted later based on ad performance.

Ad slots

The space operators decide where ads stand inside their own metaverse. Advertisers pick slots or get recommendations, and fixed contracts are made per slot too. The slot list can be viewed and turned on and off in the space console.

FieldFormatMeaning
name1 to 40 charactersA name not used twice in the space
kindfloor · wall · air · characterFloor model · wall sign · air banner · ad character standing or walking around
position[x, y, z] metersPosition of the middle of the slot box's floor (space coordinates)
rotation[x, y, z] degrees (-360 to 360)Rotation of the slot. Default [0, 0, 0]
size[width, height, depth] meters (0.1 to 200)The box the ad goes in. The ad is scaled up or down to fit this box
scale[min, max] times (0.05 to 20)Size scale per space: when fitting the box, the ad is scaled only within this range of its original size. Default [0.25, 4]
roam0 to 50 meterscharacter slots: the radius the character walks around in (0 means standing)
industriesList of industry idsIndustries this slot takes. Empty means all industries
enabledtrue · falseWhen off, no ads show in this slot

The size of an ad model may be adjusted by the space operator or Metamoa depending on the space.

Character ads go only to character slots; model and building ads only to floor, wall and air slots.

The SDK (public ad key) can only create new slots, and slots made that way come in turned off; ads show only after the space operator checks and turns them on in the space console. The SDK cannot change an existing slot (same name) and returns it as it is. Up to 5 SDK slots that are off per space, counted apart from the 30 operator slots. One IP group can create up to 20 a day, and SDK slots the space operator never turned on within 7 days are deleted (slots turned on once, and slots used by a campaign, are not deleted). Once turned on, they count within the 30 operator slots. Changing a slot's box, kind or industries and turning it on or off works only with a space console sign-in or the space key.

Industry ids: game (games) · fashion (fashion, beauty) · food (food and drink) · tech (IT, electronics) · finance (finance) · edu (education) · travel (travel, leisure) · culture (culture, entertainment) · auto (cars) · public (public, non-profit) · etc (other)

Up to 30 slots per space. The slot API takes the space key (mm_live_) or a space console sign-in:

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}

Space operators: steps to set up

  1. In 「Register for ads」 of the space console's Monetization (https://metamoa.com/owner/revenue?id=<space id>), tick the terms check and start ads.
  2. Put the one line of script from the 「Ad API」 panel on the same screen at the end of your space page's <head> or <body>. The ad key (mm_adpub_) is safe to make public (never put the space key mm_live_ there).
  3. For a three.js space, call attach and slot after the scene is built. A slot is registered turned off the first time it is called. Ads show once you turn it on in 「Ad slots」 of the space console (you may also create it turned on from the start with the slot API).
  4. Once the ad shows, you're done. The SDK sends viewable impressions, clicks and view time by itself, and for brand-space entries the SDK opens /ads/go when the ad is tapped and the server counts it.
  5. In 「Ad slots」 of the space console, turn slots on and off and see the 30-day report (before and after the rules) and your share (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 });
});

Engines other than three.js (Babylon.js, PlayCanvas, Unity WebGL, etc.) get the ad with serve, draw it themselves and send the events: ads.serve(name) → { ad }, ads.report(name, event). For entries, open ad.enter_url in a new window or the same one. The spec is in 「Event spec」 below.

How the SDK counts

Enter through the door

You can put a door on an ad building or your own 3D model. It is a door, not a portal: when someone walks in through the door, the current space stays as it is and the brand space opens in a new window (new tab). Put "door": true in the campaign creative (only when kind is model or building), and brand_url is required (otherwise 400 invalid, fields brand_url). serve's ad then comes with 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 } }

Rules so the door does not keep reopening (must be followed)

  1. Walking within 1.2m of the door opens the brand space (enter_url with &via=door) once in a new window.
  2. After closing the new window and coming back, moving a little inside or near the door does not open it again.
  3. It opens again only after walking out farther than 3m from the door and coming back in (enter distance 1.2m < exit distance 3m).
  4. It does not open while the tab is hidden or the window has no focus, and after coming back you must leave the door area once. It does not open if you are already standing inside the door when the page opens.
  5. Tapping or clicking the building to open it works as before (every click). The door rules apply only to walking in.
  6. If the browser blocks the new window, an 「Open <brand>」 button appears at the bottom of the screen. It opens only when that button is tapped (it disappears if you leave the door without tapping).

Door position: a node named door in the glb if there is one; otherwise the SDK draws a default door at the bottom middle of the ad's front (+Z). The distance is the floor distance from the walking character to the front of the door. Give attach a walker (the walking character's Object3D or a function returning {x, y, z}). Without it, the camera position is used.

ads.attach({ THREE, GLTFLoader, scene, camera, renderer, walker: player });   // player: the walking character (Object3D)

Spaces that draw ad.door themselves with an engine other than three.js must follow the same rules: after opening once, do not open again until the walker goes outside exit_m, and after the tab was hidden and came back, until the walker leaves the door area once.

So walking in and out does not drain the budget

Bot and fraud rules

On the server, events go through the rules below in order. If any one catches it, it is left out of the report and tallied separately under that rule's name. Each rule is turned on and off in bot_rules of data/ads-config.json.

RuleWhat it doesNow
Bot UA (ua_bot)Search robots, previewers, scripts (curl, python, headless, etc.) and requests with no User-Agent are left out.On
Automated browsers (headless)Browsers with navigator.webdriver on, HeadlessChrome, PhantomJS, Electron, jsdom, and requests without Accept-Language are left out. This is a measurement definition, not counted as a defence against scripts.On
Tab visibility and focus (visibility_focus)Impressions count only while the tab is visible (document.visibilityState = visible) and the window has focus; view time only while the tab is visible. This is a measurement definition.On
Viewable check (min_view)At least a set share of the model must stay on screen, at least a set area, for longer than a set time for 1 impression. This is a measurement definition.On
Repeat limits per person and internet address (repeat_limit)Impressions and clicks of the same person and model count once in a set time; entries (door included) once a day and up to a set number over set days. Anything over the hourly cap of one internet address group, the daily new viewers per space, or the daily impressions, clicks and entries per campaign and space is left out. Entry limits are checked again against the server's event records, so nothing is forgotten when the server restarts.On
Server-signed tokens (signed_token)Events must carry the signed token (HMAC) given by serve. The viewer and the internet address group at serve time are signed into the token; impressions from another address are left out, and so are impressions before a set time has passed since serve. A token counts at most one impression, click and entry each within its valid time. The campaign budget is checked again when counting, and events beyond it are not counted (budget).On
View-time measurement (view_time)View time counts only when there is camera or pointer input in between, and only up to the daily caps per token, per person and model, and per internet address and model.On
Space operator's own traffic (owner_traffic)Events from an internet address that opened that space's console are left out for a set number of days.On
Signs of human input (human_input)Only clicks the browser marks as human input (isTrusted) count. Impressions do not look at the number of inputs (people watching still, keyboard and screen-reader users).On
Anomaly watch and holds (anomaly)Impressions one person saw beyond a set number a day are left out. CPA clicks and entries count up to an automatic daily allowance per space, and the rest are held. If the click and entry rate (compared with the network minus that space), impressions per space click, new viewers per internet address, the data-center share, repeats from the same address, or entries per click cross their thresholds, that space's share for that month is held and an administrator decides.On
Data-center networks (asn)If x-mm-asn (AS number) added by Cloudflare is a cloud or hosting network, the event is left out, and if that share is large, the space is held. It is trusted only when the secret header (origin-auth) that a Cloudflare Transform Rule adds with it matches the server env value; otherwise the event's network is set to 「unknown」 and the data-center share is measured only from events whose network is known.On
Human check on entry (turnstile)A brand-space entry (/ads/go) counts only after passing Cloudflare Turnstile on the Metamoa domain. If it fails, the visitor is still sent to the brand space and only the entry is not counted. Entries that came in while there was no key are held.On
Impression human check (turnstile_imp)The SDK runs Cloudflare Turnstile in a hidden metamoa window and puts the pass it gets (bound to that network and space) on impressions. A pass counts; a failed check is left out. Without a pass only that impression is held; when the month ends it is released or voided by the space's unverifiable share (an admin may release it). The ad always shows as it is.On

Event spec

SDK requests are taken only from that space's own site. For the operator's own domain, the same registrable domain; for shared hosts such as github.io or vercel.app, exactly the same host name; and for spaces under a path (github.io/<repository>, claude.ai), the Referer path must be under it too (the SDK sends the full Referer). All with CORS open, JSON. sendBeacon (text/plain) is accepted too.

Getting an ad · 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"
      }
    ]
  }
}

If ad is null, there is no ad for that slot right now. If kind is model, place the glb at model_url; if building, place the building glb, then if mode is image, put the image at image_url on each mesh name in faces, and if texture, put image_url over all of texture.meshes, repeated by repeat. If character, stand the character glb, attach the prop at prop.attach, and put the image at image_url or the text letters on its board. Everything fits the slot.size box but is scaled only within slot.scale of its original size.

Registering a slot · 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 (같은 이름의 자리를 바꾸지 않고 그대로)

Sending events · 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 }
typeFieldMeaning
imptoken, ms, area, inside, vis, focus, inputs, wdms: time shown without a break, area: model area over screen area (0 to 1), inside: share of the model inside the screen (0 to 1), vis·focus: tab visible and window focus, inputs: camera and pointer inputs in the meantime, wd: navigator.webdriver
timetoken, ms, vis, inputs, wdTime shown since the last time (up to 15,000ms) and the number of inputs in between
clicktoken, trusted, wdThe ad was tapped or clicked. trusted: human input (isTrusted)

Impressions count with the human-check pass the SDK gets from a hidden metamoa window (Cloudflare Turnstile). The ad shows at once without waiting for it. If your site sends a Content-Security-Policy, add https://metamoa.com to frame-src. When the window is blocked or there is no pass, that impression is held; after the month ends it is released if the space's unverifiable share is 20% or less, and voided above that.

Up to 20 at a time. Events do not carry vid; the viewer comes from the value inside the token. Wrong events and tokens of another space are counted only as excluded.

Entry · go

An entry counts only after /ads/go on the Metamoa domain checks with Cloudflare Turnstile that it is a person (when there is a key, a small check screen shows for 1 to 2 seconds). If the check fails, the person still goes to the brand space and only the entry is not counted.

GET https://metamoa.com/ads/go?t={serve 토큰}
→ 302 Location: {brand_url}   (노출이 센 토큰이면 입장을 센 뒤 브랜드 공간으로. 캠페인이 집행 중·기간 안이고 토큰이 유효 시간 안일 때만 검수에서 승인된 brand_url로 가고, 아니면 Location: /)

Ad buildings, characters and upload specs

Advertisers without a model pick one of our ad buildings or basic ad characters. For buildings, pick one of two ways: image (one image on each set board) · texture (one texture or pattern over the whole building surface).

ModelKindDefault size (m)ScaleImage: ad facesTexture: download templates
Flag banner (banner-flag)Banner poles3.7×3.5×0.40.5~2.52048:1072, at least 1024×536pxhttps://metamoa.com/ads/models/banner-flag/banner-flag.texture-default.png · template with lines https://metamoa.com/ads/models/banner-flag/banner-flag.texture-template.png
Hanging banner pole (banner-hanging)Banner poles1.9×3×0.20.5~2.51088:2048, at least 544×1024pxhttps://metamoa.com/ads/models/banner-hanging/banner-hanging.texture-default.png · template with lines https://metamoa.com/ads/models/banner-hanging/banner-hanging.texture-template.png
Banner tower (banner-tower)Banner poles1.2×4×1.20.5~2.5656:1024, at least 328×512pxhttps://metamoa.com/ads/models/banner-tower/banner-tower.texture-default.png · template with lines https://metamoa.com/ads/models/banner-tower/banner-tower.texture-template.png
Ad board (billboard-board)Screens · billboards1.9×2.4×1.50.5~31024:944, at least 512×472pxhttps://metamoa.com/ads/models/billboard-board/billboard-board.texture-default.png · template with lines https://metamoa.com/ads/models/billboard-board/billboard-board.texture-template.png
Low billboard (billboard-low)Screens · billboards4×2.2×0.60.5~32048:784, at least 1024×392pxhttps://metamoa.com/ads/models/billboard-low/billboard-low.texture-default.png · template with lines https://metamoa.com/ads/models/billboard-low/billboard-low.texture-template.png
Standing billboard (billboard-stand)Screens · billboards8×4.8×2.50.5~22048:848, at least 1024×424pxhttps://metamoa.com/ads/models/billboard-stand/billboard-stand.texture-default.png · template with lines https://metamoa.com/ads/models/billboard-stand/billboard-stand.texture-template.png
Large billboard (billboard-tall)Screens · billboards6×6×2.90.5~32048:1136, at least 1024×568pxhttps://metamoa.com/ads/models/billboard-tall/billboard-tall.texture-default.png · template with lines https://metamoa.com/ads/models/billboard-tall/billboard-tall.texture-template.png
3-floor shops (bld-3f-shop)Buildings9.4×11×9.40.5~22048:480, at least 1024×240pxhttps://metamoa.com/ads/models/bld-3f-shop/bld-3f-shop.texture-default.png · template with lines https://metamoa.com/ads/models/bld-3f-shop/bld-3f-shop.texture-template.png
Classic building (bld-classic)Buildings11.6×14×10.80.5~22048:608, at least 1024×304pxhttps://metamoa.com/ads/models/bld-classic/bld-classic.texture-default.png · template with lines https://metamoa.com/ads/models/bld-classic/bld-classic.texture-template.png
Corner shop (bld-corner-shop)Buildings6.6×10×6.60.5~22048:704, at least 1024×352pxhttps://metamoa.com/ads/models/bld-corner-shop/bld-corner-shop.texture-default.png · template with lines https://metamoa.com/ads/models/bld-corner-shop/bld-corner-shop.texture-template.png
Mid-rise building (bld-midrise)Buildings11.8×16×12.40.5~22048:1152, at least 1024×576pxhttps://metamoa.com/ads/models/bld-midrise/bld-midrise.texture-default.png · template with lines https://metamoa.com/ads/models/bld-midrise/bld-midrise.texture-template.png
Rooftop shop (bld-shop-roof)Buildings9.9×10×12.20.5~22048:560, at least 1024×280pxhttps://metamoa.com/ads/models/bld-shop-roof/bld-shop-roof.texture-default.png · template with lines https://metamoa.com/ads/models/bld-shop-roof/bld-shop-roof.texture-template.png
High-rise building (bld-tower)Buildings15.1×32×15.10.5~1.51632:2048, at least 816×1024pxhttps://metamoa.com/ads/models/bld-tower/bld-tower.texture-default.png · template with lines https://metamoa.com/ads/models/bld-tower/bld-tower.texture-template.png
2-unit shops (bld-twin-shop)Buildings16.5×9×10.20.5~22048:832, at least 1024×416pxhttps://metamoa.com/ads/models/bld-twin-shop/bld-twin-shop.texture-default.png · template with lines https://metamoa.com/ads/models/bld-twin-shop/bld-twin-shop.texture-template.png
Pop-up booth (booth-carnival)Pop-up booths3.5×3.2×1.90.6~22048:336, at least 1024×168pxhttps://metamoa.com/ads/models/booth-carnival/booth-carnival.texture-default.png · template with lines https://metamoa.com/ads/models/booth-carnival/booth-carnival.texture-template.png
Market stall (booth-market)Pop-up booths3.3×3×1.50.6~22048:400, at least 1024×200pxhttps://metamoa.com/ads/models/booth-market/booth-market.texture-default.png · template with lines https://metamoa.com/ads/models/booth-market/booth-market.texture-template.png
Pop-up pavilion (booth-pavilion)Pop-up booths3.1×4×3.70.6~21024:352, at least 512×176pxhttps://metamoa.com/ads/models/booth-pavilion/booth-pavilion.texture-default.png · template with lines https://metamoa.com/ads/models/booth-pavilion/booth-pavilion.texture-template.png
Event tent (booth-tent)Pop-up booths3×2.1×30.6~2.52048:416, at least 1024×208pxhttps://metamoa.com/ads/models/booth-tent/booth-tent.texture-default.png · template with lines https://metamoa.com/ads/models/booth-tent/booth-tent.texture-template.png
Bus stop ad board (busstop-shelter)Screens · billboards3.7×2.6×2.40.7~1.5512:1024, at least 256×512pxhttps://metamoa.com/ads/models/busstop-shelter/busstop-shelter.texture-default.png · template with lines https://metamoa.com/ads/models/busstop-shelter/busstop-shelter.texture-template.png
Food cart (cart-food)Carts · parasols1.5×2.6×30.7~1.81024:656, at least 512×328pxhttps://metamoa.com/ads/models/cart-food/cart-food.texture-default.png · template with lines https://metamoa.com/ads/models/cart-food/cart-food.texture-template.png
Parasol (cart-parasol)Carts · parasols2×2.6×2.30.6~2https://metamoa.com/ads/models/cart-parasol/cart-parasol.texture-default.png · template with lines https://metamoa.com/ads/models/cart-parasol/cart-parasol.texture-template.png
Kiosk (kiosk-ticket)Kiosks0.8×1.8×0.80.8~1.5880:1024, at least 440×512pxhttps://metamoa.com/ads/models/kiosk-ticket/kiosk-ticket.texture-default.png · template with lines https://metamoa.com/ads/models/kiosk-ticket/kiosk-ticket.texture-template.png
Container showroom (showroom-container)Showrooms6.1×3×2.90.5~22048:912, at least 1024×456pxhttps://metamoa.com/ads/models/showroom-container/showroom-container.texture-default.png · template with lines https://metamoa.com/ads/models/showroom-container/showroom-container.texture-template.png
A-frame board (sign-aframe)Basic signs and boards0.5×1×0.40.6~2.5544:1024, at least 272×512pxhttps://metamoa.com/ads/models/sign-aframe/sign-aframe.texture-default.png · template with lines https://metamoa.com/ads/models/sign-aframe/sign-aframe.texture-template.png
Arrow signpost (sign-arrow)Basic signs and boards1×2.2×0.20.5~2.51024:768, at least 512×384pxhttps://metamoa.com/ads/models/sign-arrow/sign-arrow.texture-default.png · template with lines https://metamoa.com/ads/models/sign-arrow/sign-arrow.texture-template.png
Menu stand (sign-menu)Basic signs and boards0.9×1.4×0.50.5~2.5640:1024, at least 320×512pxhttps://metamoa.com/ads/models/sign-menu/sign-menu.texture-default.png · template with lines https://metamoa.com/ads/models/sign-menu/sign-menu.texture-template.png
Pole sign (sign-pole)Basic signs and boards0.6×2.6×0.30.5~2.5784:1024, at least 392×512pxhttps://metamoa.com/ads/models/sign-pole/sign-pole.texture-default.png · template with lines https://metamoa.com/ads/models/sign-pole/sign-pole.texture-template.png
Stake sign (sign-stake)Basic signs and boards0.7×1.2×0.60.5~3800:1024, at least 400×512pxhttps://metamoa.com/ads/models/sign-stake/sign-stake.texture-default.png · template with lines https://metamoa.com/ads/models/sign-stake/sign-stake.texture-template.png
Wall sign (sign-wall)Basic signs and boards1.2×0.8×00.5~41024:672, at least 512×336pxhttps://metamoa.com/ads/models/sign-wall/sign-wall.texture-default.png · template with lines https://metamoa.com/ads/models/sign-wall/sign-wall.texture-template.png
Wall banner (sign-wall-banner)Basic signs and boards1×2×0.30.5~3528:1024, at least 264×512pxhttps://metamoa.com/ads/models/sign-wall-banner/sign-wall-banner.texture-default.png · template with lines https://metamoa.com/ads/models/sign-wall-banner/sign-wall-banner.texture-template.png
Stage screen (stage-screen)Screens · billboards12×5.5×12.70.5~1.52048:352, at least 1024×176pxhttps://metamoa.com/ads/models/stage-screen/stage-screen.texture-default.png · template with lines https://metamoa.com/ads/models/stage-screen/stage-screen.texture-template.png
Vending machine (vending-drink)Vending machines1.3×1.9×1.20.8~1.5848:1024, at least 424×512pxhttps://metamoa.com/ads/models/vending-drink/vending-drink.texture-default.png · template with lines https://metamoa.com/ads/models/vending-drink/vending-drink.texture-template.png
Capsule toy machine (vending-gacha)Vending machines0.6×1.4×0.60.8~1.5912:1024, at least 456×512pxhttps://metamoa.com/ads/models/vending-gacha/vending-gacha.texture-default.png · template with lines https://metamoa.com/ads/models/vending-gacha/vending-gacha.texture-template.png
Showcase fridge (vending-showcase)Vending machines0.9×2×0.80.8~1.5432:1024, at least 216×512pxhttps://metamoa.com/ads/models/vending-showcase/vending-showcase.texture-default.png · template with lines https://metamoa.com/ads/models/vending-showcase/vending-showcase.texture-template.png
Ad shop (shop-ad)Buildings4.2×3.6×3.30.6~22048:1024, at least 1024×512px (one image shown on the front, sides, back and top)

For textures, download the default template (square PNG), edit it and upload it at the same size (1024 to 2048px). The pink lines of the template with lines are the borders of the surface pieces: paint inside a piece and it shows on that surface.

For the ad shop (shop-ad), the one uploaded image is shown on the front, sides, back and top: the front sign, both sides, the back and the roof board all have the same ratio, so it reads from any side, even looking down from above. It has a door, so 「Enter through the door」 ("door": true) can be used.

Basic ad characters are free at any amount. They stand or walk around in character slots, hold props such as a neck sign, ID badge, hand picket, balloon, flag or shopping bag attached to their bones, and the prop board carries an ad image or sign letters (up to 12 characters). The cats, the dog and Vincent can take only props worn around the neck.

CharacteridProps it can holdLicense
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-badgeOur own (FLOAT Co., Ltd.)
Nyangjupgo shorthair catcat_shortprop-neck-sign prop-badgeCC BY 4.0
Nyangjupgo longhair catcat_longprop-neck-sign prop-badgeCC BY 4.0
Nyangjupgo munchkincat_munchkinprop-neck-sign prop-badgeCC BY 4.0
Nyangjupgo corgidog_corgiprop-neck-sign prop-badgeCC BY 4.0
PropidImage ratio · minimum size
Neck sign (ID badge type)prop-badge720:1024, at least 360×512px
Balloonprop-balloon1024:1024, at least 512×512px
Hand flagprop-flag1024:688, at least 512×344px
Neck signprop-neck-sign1024:720, at least 512×360px
Hand picketprop-picket1024:720, at least 512×360px
Shopping bagprop-shopping-bag1024:1024, at least 512×512px

Model credits

Most basic models are CC0 (public domain) or made in-house; the ones below are CC BY, so their sources are credited. FLOAT Co., Ltd. modified all of them (size, ad faces, etc.).

Request a model

When an advertiser chooses 「Request a model」, we make the 3D model, attach it to the campaign and then review it. Send the materials (product photos, logo, drawings) to [email protected] with the campaign number.

TiergradeMaking feeFree from this media spend
Simple product · signsimple₩50,000 (supply price, VAT excluded)₩500,000
Detailed productprecise₩100,000 (supply price, VAT excluded)₩1,000,000
New charactercharacter₩100,000 (supply price, VAT excluded)₩1,000,000

Advertisers: self sign-up steps

  1. Sign in with a Metamoa account at https://metamoa.com/ads/manage (sign-up in the same window).
  2. Create a campaign: name, brand, industry and brand-space address (when using entry CPA).
  3. Creative: ① upload your own 3D model (glb) ② pick an ad building → an image for each board for image, one texture for texture ③ pick a basic ad character + prop → an image or sign letters on the prop board ④ request a model (choose a grade). The specs and a preview are shown.
  4. Spaces: from the list of spaces that consented to ads, pick slots yourself by category, people online now and daily space clicks, or tap 「Recommend」 for a bundle of spaces matched to industry, category and traffic.
  5. Set the billing type (CPM, CPA, view time, fixed space contract), budget and dates and apply → waiting for review.
  6. Once it passes review (obscenity, violence, suspected copyright, etc.), it runs. A running campaign can be paused and turned back on, and you see viewable impressions, clicks, entries and view time every day.
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>)

Character creative: {"kind": "character", "character_id": "bangjang", "prop": "prop-picket", "image": "as_…"} or "text": "Sparkle Milk" instead of "image". Fixed space contract: "billing": "fixed", "fixed_period": "week" | "month", end_day = start_day + period − 1. Model request: {"kind": "request", "grade": "simple", "note": "…"}.

Building and own-model creatives can take two more things (optional): "tagline": "one-line description" (up to 30 characters, letters only — no tags, angle brackets or curly braces (400 invalid, fields creative), reviewed with the creative) is drawn on the strip under the ad shop's or building's sign (mesh ad_tagline) and comes as serve's ad.tagline { text, mesh, aspect }. "door": true is 「Enter through the door」 (brand_url required). These are the same as the 「One-line description」 and 「Enter through the door」 fields in step 2 of /ads/manage.

Review

Error codes

The error body is { "error": "<code>", "message": "<one line on what to do next>" }; field errors come with fields, limits with retry_after.

HTTPerrorMeaning
400invalidA field has the wrong format. fields lists the wrong fields.
400bad_modelNot a glb, not glTF 2.0, or contains an outside address (uri). The reason is in reason.
400bad_imageThe image format, size or ratio does not match the spec. reason (format · bytes · too_large · too_small · aspect) and spec come with it.
400bad_buildingThe slot's default_building is not a building or sign id of GET /ads/v1/buildings (empty is fine).
400slot_unavailableThe chosen slot does not take ads, does not take that industry, or does not match the kind of creative (characters only in character slots). slot_ids lists those slots.
401unauthorizedNo space key or space console sign-in, or a wrong one.
401sign_inAdvertiser: no Metamoa account sign-in, or it expired.
403owner_requiredThere is a space key, but the space operator is not verified yet.
403owner_page_onlyTried the terms check or consent to ads with a space key (works only in the space console).
403bad_ad_keySDK: space and key (mm_adpub_) do not match.
403terms_requiredThat space has not checked the ad placement terms.
403ads_offThat space has turned consent to ads off.
403origin_mismatchThe SDK request did not come from that space's site (same domain).
404not_houseOur own ads (GET /ads/v1/house) were called from a space Metamoa does not run itself.
403not_yoursAdvertiser: used someone else's file id.
404no_slotThere is no ad slot with that name or id.
404not_foundThat campaign or file does not exist.
409not_listedA space that is not listed (before approval or hidden).
409payout_info_requiredTried to turn on consent to ads without the payout info type (individual or business) and a contact (mobile phone or email). Add them in the space console's Monetization (/owner/revenue?id=<space id>).
409advertiser_requiredAdvertiser: tried to apply for or pay for a campaign before adding the advertiser info (PUT /api/ads/advertiser).
409biz_doc_requiredAdvertiser: a business advertiser tried to pay or apply for a fixed space contract before uploading a copy of the business registration certificate (PUT /api/ads/advertiser/doc).
409business_onlyAdvertiser: an individual advertiser tried to upload a copy of a business registration certificate.
400bad_docAdvertiser: the copy of the business registration certificate is not a PDF, JPG or PNG.
413doc_too_bigAdvertiser: the copy of the business registration certificate is over 5MB.
503advertiser_unavailableAdvertiser: the server has no encryption key for advertiser info, so it cannot take it.
409email_not_linkedAdvertiser: an individual advertiser's email is not the mail signed in to this Metamoa account.
409name_takenA slot with the same name already exists.
409slot_limitUp to 30 operator slots per space, and up to 5 unconfirmed SDK slots.
409slot_takenA slot already under another fixed space contract for that period.
409tier_too_lowChose, as a fixed space contract, a slot in a space whose daily space clicks are below the lowest tier. slot_ids lists those slots.
409not_for_saleThere is no fixed space contract price.
409under_minimumBelow the minimum media spend. min_spend_won and spend_won come with it.
409no_click_historyChose CPM or a fixed space contract for slots in spaces with no space-click history yet (impressions and tier cannot be measured). Only CPA and view time work. slot_ids and billings come with it.
409over_inventoryThe CPM budget is over the expected viewable impressions cap of the chosen slots. max_budget_won comes with it.
409rejected_fileUsed a file blocked in review for a campaign.
409wrong_stateSomething that cannot be done in that state (pausing a campaign under review, etc.).
409staleAdministrator: the campaign changed after the review screen was opened (decide's version differs from the current one). Look again and decide again.
409already_paidTried to open payment again for a campaign already paid.
409not_paidAdministrator: tried to approve settlement for a campaign whose payment is not complete.
409heldAdministrator: tried to approve settlement for a campaign with a held share (decide the hold first).
424hrum_failedCould not connect to payment (Hrum). Try again in a moment.
503pay_not_readyPayment cannot be opened yet (before the server is set up).
409model_missingAdministrator: approved a model request campaign before attaching the model.
413model_too_bigThe model file is over 6MB.
429too_manyToo many requests. Wait the Retry-After seconds.

All paths

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