Metamoa
收藏 排行榜

Metamoa 3D 廣告 · 3D ads

概覽

Metamoa 3D 廣告將廣告主的 3D 模型、廣告建築、廣告角色放到網頁元宇宙空間內的廣告位上,只計算人們實際看到和做過的行為來收取廣告費,並把其中的份額分給空間經營者。作為廣告業與廣告代理業,我們接受從大企業到中小企業的投放。

實際畫面 · Moa 營地
實際畫面 · Moa 營地
實際畫面 · Moa 營地的小店(自有廣告)
實際畫面 · Moa 營地的小店(自有廣告)
實際畫面 · AI Butta 庭院
實際畫面 · AI Butta 庭院
實際畫面 · Walking Into Van Gogh
實際畫面 · Walking Into Van Gogh

4 種商品與計費

金額皆為供貨價,未稅。

商品billing計算內容單價
CPM(viewable 曝光)cpmviewable 曝光 1 次 = 模型在畫面內達一定比例以上,並連續顯示超過規定時間(分頁可見的狀態)每 1,000 次 viewable ₩8,000
CPA · 模型點擊cpa點按或點擊廣告模型。點擊後若繼續進入品牌空間,只按進入計費 1 次每 1 次點擊 ₩700
CPA · 品牌空間進入cpa點按廣告進入品牌空間(brand_url)。透過伺服器轉址(/ads/go)計算,同一人、同一活動每天一次每 1 次進入 ₩1,000
曝光時間timeviewable 曝光後廣告被看到的累計時間(僅在有輸入操作時,最多到每人每模型每日上限)每 1,000 秒 viewable ₩1,000
空間固定合約fixed按期(最長一個月)。在該期間獨占所簽約的廣告位(以廣告位為單位)。不保證曝光次數見下方等級表

空間固定合約等級

等級依該廣告位所在空間最近 14 天乾淨的每日空間點擊中位數決定(不計營運者本人、資料中心網路與自動化瀏覽器;metamoa 的「進入」只計通過真人驗證的)。未達最低等級的空間,其廣告位不以空間固定合約販售,只接受成效型投放。合約期間為每週 7 天或每月 30 天其中之一。

等級每日空間點擊每週(廣告位 1 個)每月(廣告位 1 個)
S1,000 以上₩50,000₩180,000
A300~999₩15,000₩50,000
B100~299₩5,000₩18,000

統計公式

日期以韓國時間按日計(ad_daily)。金額為捨去韓元以下的供貨價。觸發規則的事件不計入,並依原因另行統計(ad_excluded)。

空間經營者收益分潤等級

廣告收益(各空間的廣告媒體金額,扣除無效流量後的供貨價)由空間經營者與 Metamoa 依等級比例分配。2026年11月11日起施行。優先登記說明:https://metamoa.com/ads/partners

等級對象空間經營者 : Metamoa
白金先到先得第 1~10 位空間經營者9:1
黃金第 11~100 位空間經營者(90 名)8:2
白銀之後的空間經營者7:3
青銅自 2027年1月1日起新簽約的空間經營者6:4

今後可能依廣告成效調整比例。

廣告位(插槽)

空間經營者自行決定在自己的元宇宙中廣告擺在哪裡。廣告主以廣告位為單位選擇或接受推薦,空間固定合約也以廣告位為單位簽訂。廣告位清單可在空間管理畫面查看與開關。

欄位格式意義
name1~40 個字元空間內不重複的名稱
kindfloor · wall · air · character地面模型 · 牆面招牌 · 空中橫幅 · 站立或走動的廣告角色
position[x, y, z] 公尺廣告位方框底面中心的位置(空間座標)
rotation[x, y, z] 度(-360~360)廣告位的旋轉。預設 [0, 0, 0]
size[寬, 高, 深] 公尺(0.1~200)放廣告的方框。廣告會依此方框放大或縮小
scale[最小, 最大] 倍(0.05~20)各空間的尺寸倍率:配合方框時,只在廣告原始尺寸的此倍率範圍內放大縮小。預設 [0.25, 4]
roam0~50 公尺character 廣告位:角色走動的半徑(0 表示站立)
industries產業 id 清單此廣告位接受的產業。留空則接受所有產業
enabledtrue · false關閉後此廣告位不投放廣告

廣告模型的大小可能會依空間由空間經營者或 Metamoa 調整。

角色廣告只投放到 character 廣告位,模型與建築廣告只投放到 floor、wall、air 廣告位。

用 SDK(公開廣告金鑰)只能建立新廣告位,這樣建立的廣告位為關閉狀態,需空間經營者在空間管理中確認並開啟後才會投放廣告。既有的廣告位(同名)SDK 無法修改,會原樣回傳。關閉狀態的 SDK 廣告位每個空間最多 5 個,與空間經營者廣告位 30 個分開計算。一個 IP 群組每天最多可建立 20 個,空間經營者在 7 天內從未開啟的 SDK 廣告位會被刪除(曾開啟過的、活動正在使用的不會刪除)。開啟後計入空間經營者廣告位 30 個之內。修改廣告位的方框、類型、產業以及開關,只能用空間管理登入或空間金鑰。

產業 id:game(遊戲)· fashion(時尚·美妝)· food(餐飲)· tech(IT·電子)· finance(金融)· edu(教育)· travel(旅遊·休閒)· culture(文化·娛樂)· auto(汽車)· public(公共·非營利)· etc(其他)

每個空間最多 30 個廣告位。廣告位 API 使用空間金鑰(mm_live_)或空間管理登入:

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}

空間經營者:串接步驟

  1. 在空間管理收益化(https://metamoa.com/owner/revenue?id=<空間 id>)的「登記廣告刊登」中勾選條款確認並開始廣告。
  2. 把同一畫面「廣告 API」欄的一行腳本放到空間頁面 <head> 或 <body> 結尾。廣告金鑰(mm_adpub_)可以公開(不要放入空間金鑰 mm_live_)。
  3. three.js 空間在場景建立後呼叫 attach 與 slot。廣告位第一次呼叫時以關閉狀態登記。在空間管理「廣告位」中開啟後即開始投放(也可以用廣告位 API 一開始就以開啟狀態建立)。
  4. 廣告顯示出來就完成了。viewable 曝光、點擊、顯示時間由 SDK 自動傳送,品牌空間進入則是點按廣告時 SDK 開啟 /ads/go 由伺服器計算。
  5. 在空間管理的「廣告位」中開關廣告位,查看 30 天統計(規則套用前後)與分潤(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 });
});

非 three.js 引擎(Babylon.js、PlayCanvas、Unity WebGL 等)以 serve 取得廣告後自行繪製並傳送事件:ads.serve(name) → { ad },ads.report(name, event)。進入時在新視窗或同一視窗開啟 ad.enter_url 即可。規格見下方「事件規格」。

SDK 的計算方式

從門進入

可以為廣告建築或自己的 3D 模型加一扇門。這是門,不是傳送門:人走進門時,目前的空間維持不變,在新視窗(新分頁)開啟品牌空間。在活動的 creative 中加入 "door": true(僅限 kind 為 model 或 building),且需要 brand_url(沒有則 400 invalid,fields brand_url)。serve 的 ad 中會帶有 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 } }

門不會反覆開啟的規則(務必遵守)

  1. 走到門前 1.2m 以內時,在新視窗開啟一次品牌空間(enter_url 加 &via=door)。
  2. 關閉新開的視窗回來後,即使在門內或門附近稍微移動,門也不會再次開啟。
  3. 只有走到離門超過 3m 的地方再回來,才會再次開啟(進入距離 1.2m < 離開距離 3m)。
  4. 分頁隱藏或視窗沒有焦點時不會開啟,回來後也必須先離開門的區域一次。開啟頁面時已站在門內也不會開啟。
  5. 點按或點擊建築開啟的方式與以往相同(每次點擊)。門的規則只適用於走進去的情況。
  6. 若瀏覽器封鎖新視窗,畫面下方會出現「開啟 <品牌>」按鈕。點按該按鈕才會開啟(不點按而離開門時按鈕消失)。

門的位置:glb 中有名為 door 的節點就用該節點,沒有則由 SDK 在廣告正面(+Z)中間的地面畫一扇預設門。距離是走動角色到門前的地面距離。請傳給 attach 一個 walker(走動角色的 Object3D 或回傳 {x, y, z} 的函式)。沒有時以攝影機位置測量。

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

用非 three.js 引擎自行繪製 ad.door 的空間也必須同樣遵守上述規則:開啟一次後,在走出 exit_m 之前;分頁隱藏後回來,在離開門的區域一次之前,都不再開啟。

避免進進出出耗盡預算

機器人與作弊檢測規則

事件在伺服器上依序經過下列規則。只要觸發其中一條,就從統計中排除,並以該規則名稱另行統計。規則在 data/ads-config.json 的 bot_rules 中逐條開關。

規則作用目前
機器人 UA(ua_bot)排除搜尋機器人、預覽、腳本(curl、python、headless 等)以及沒有 User-Agent 的請求。開
自動化瀏覽器(headless)排除開啟 navigator.webdriver 的瀏覽器、HeadlessChrome、PhantomJS、Electron、jsdom,以及沒有 Accept-Language 的請求。這是測量定義,不算作對腳本的防禦。開
分頁可見性與焦點(visibility_focus)曝光只在分頁可見(document.visibilityState = visible)且視窗有焦點時計入,顯示時間只在分頁可見時計入。這是測量定義。開
viewable 判定(min_view)模型的規定比例以上在畫面內、達規定面積以上、持續超過規定時間,才算曝光 1 次。這是測量定義。開
同一人·同一網路位址重複限制(repeat_limit)同一人、同一模型的曝光與點擊在規定時間內計一次,進入(含從門進入)每天一次,並在規定天數內最多規定次數。超過單一網路位址群組每小時上限、每個空間每日新觀眾數、每個活動與空間每日曝光·點擊·進入數的部分予以排除。進入限制會以伺服器的事件紀錄再次核對,伺服器重新啟動也不會遺忘。開
伺服器簽署權杖(signed_token)事件必須攜帶 serve 提供的簽署權杖(HMAC)。觀看者與 serve 時的網路位址群組會簽署寫入權杖,來自其他位址的曝光予以排除,serve 後未過規定時間的曝光也予以排除。權杖在有效期間內曝光、點擊、進入各只計一次。活動預算在計算時再次核對,超出的事件不計入(budget)。開
曝光時間測量(view_time)顯示時間只在期間有攝影機或指標輸入時計入,並且只計到每個權杖、每人每模型每日、每個網路位址每模型每日的上限。開
空間經營者本人流量(owner_traffic)來自開啟過該空間管理畫面的網路位址的事件,在規定天數內予以排除。開
人工輸入痕跡(human_input)點擊只計算瀏覽器標記為人工輸入(isTrusted)的。曝光不看輸入次數(靜靜觀看的人、使用鍵盤或螢幕閱讀器的使用者)。開
異常值監控與保留(anomaly)一人一天看到超過規定次數的曝光予以排除。CPA 點擊與進入按每個空間每日自動認列數計入,超出部分保留。若點擊·進入率(與排除該空間後的網路比較)、每次空間點擊的曝光、每個網路位址的新觀眾、資料中心占比、同一位址重複、點擊後的進入率超過標準,則保留該空間當月的分潤,由管理員判定。開
資料中心網路(asn)Cloudflare 附加的 x-mm-asn(AS 號碼)屬於雲端或主機代管網路時,排除該事件,占比大時保留該空間。只有當 Cloudflare Transform Rule 一併附加的祕密標頭(origin-auth)與伺服器 env 值一致時才採信,否則該事件的網路記為「未知」,資料中心占比只以已知網路的事件計算。開
進入時的真人驗證(turnstile)品牌空間進入(/ads/go)必須在 Metamoa 網域上通過 Cloudflare Turnstile 才計入。即使失敗,使用者仍會被送往品牌空間,只是不計入進入。沒有金鑰時的進入予以保留。開
曝光真人驗證 (turnstile_imp)SDK 在隱藏的 metamoa 視窗中執行 Cloudflare Turnstile,把取得的通行憑證(綁定該網路與空間)附在曝光上。通過的計入,驗證失敗的剔除。沒有憑證時只暫扣該次曝光,月底依該空間無法驗證的比例放行或作廢(管理員可以放行)。廣告始終照常顯示。開

事件規格

SDK 請求只接受來自該空間網站的請求。空間經營者自己的網域須為同一註冊網域,github.io、vercel.app 等共用主機須主機名稱完全相同,位於路徑下的空間(github.io/<儲存庫>、claude.ai)則 Referer 路徑也須在其下(SDK 會傳送完整的 Referer)。全部開放 CORS,JSON。也接受 sendBeacon(text/plain)。

取得廣告 · 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"
      }
    ]
  }
}

ad 為 null 表示該廣告位目前沒有可投放的廣告。kind 為 model 時放置 model_url 的 glb,為 building 時放置建築 glb 後,mode 為 image 則在 faces 的 mesh 名稱上貼 image_url 的圖片,為 texture 則在全部 texture.meshes 上依 repeat 次數重複貼上 image_url。為 character 時立起角色 glb,在 prop.attach 位置掛上道具,並在其牌面放入 image_url 的圖片或 text 文字。全部配合 slot.size 方框,但只在原始尺寸的 slot.scale 倍率範圍內放大縮小。

登記廣告位 · 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 (같은 이름의 자리를 바꾸지 않고 그대로)

傳送事件 · 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欄位意義
imptoken, ms, area, inside, vis, focus, inputs, wdms:連續顯示時間,area:模型面積占畫面面積的比例(0~1),inside:模型在畫面內的比例(0~1),vis·focus:分頁可見·視窗焦點,inputs:期間攝影機與指標輸入次數,wd:navigator.webdriver
timetoken, ms, vis, inputs, wd上次 time 之後的顯示時間(最多 15,000ms)及期間的輸入次數
clicktoken, trusted, wd點按或點擊了廣告。trusted:人工輸入(isTrusted)

曝光與 SDK 從隱藏的 metamoa 視窗(Cloudflare Turnstile)取得的真人驗證憑證一起計數。廣告不等待驗證,立即顯示。如果你的網站送出 Content-Security-Policy,請在 frame-src 加入 https://metamoa.com。視窗被封鎖或沒有憑證時,該次曝光會被暫扣;月底後,若該空間無法驗證的比例在 20% 以下則放行,超過則作廢。

每次最多 20 個。事件中不傳送 vid,觀看者使用權杖內的值。錯誤的事件與其他空間的權杖只計為 excluded。

進入 · go

進入只在 Metamoa 網域的 /ads/go 透過 Cloudflare Turnstile 確認是真人之後才計入(有金鑰時會顯示 1~2 秒的小確認畫面)。確認失敗時人仍會前往品牌空間,只是不計入進入。

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

廣告建築、角色與上傳規格

沒有模型的廣告主可以選擇我們提供的廣告建築或基本廣告角色。建築二選一:圖片型(在規定的牌面上各放一張圖片)· 材質型(在整個建築表面貼一張材質或圖樣)。

模型類型預設尺寸(m)倍率圖片型:廣告面材質型:下載底圖
旗幟橫幅(banner-flag)橫幅桿3.7×3.5×0.40.5~2.52048:1072,1024×536px 以上https://metamoa.com/ads/models/banner-flag/banner-flag.texture-default.png · 有線底圖 https://metamoa.com/ads/models/banner-flag/banner-flag.texture-template.png
直式橫幅桿(banner-hanging)橫幅桿1.9×3×0.20.5~2.51088:2048,544×1024px 以上https://metamoa.com/ads/models/banner-hanging/banner-hanging.texture-default.png · 有線底圖 https://metamoa.com/ads/models/banner-hanging/banner-hanging.texture-template.png
橫幅塔(banner-tower)橫幅桿1.2×4×1.20.5~2.5656:1024,328×512px 以上https://metamoa.com/ads/models/banner-tower/banner-tower.texture-default.png · 有線底圖 https://metamoa.com/ads/models/banner-tower/banner-tower.texture-template.png
廣告板(billboard-board)電子看板·廣告看板1.9×2.4×1.50.5~31024:944,512×472px 以上https://metamoa.com/ads/models/billboard-board/billboard-board.texture-default.png · 有線底圖 https://metamoa.com/ads/models/billboard-board/billboard-board.texture-template.png
矮廣告看板(billboard-low)電子看板·廣告看板4×2.2×0.60.5~32048:784,1024×392px 以上https://metamoa.com/ads/models/billboard-low/billboard-low.texture-default.png · 有線底圖 https://metamoa.com/ads/models/billboard-low/billboard-low.texture-template.png
立式廣告看板(billboard-stand)電子看板·廣告看板8×4.8×2.50.5~22048:848,1024×424px 以上https://metamoa.com/ads/models/billboard-stand/billboard-stand.texture-default.png · 有線底圖 https://metamoa.com/ads/models/billboard-stand/billboard-stand.texture-template.png
大型廣告看板(billboard-tall)電子看板·廣告看板6×6×2.90.5~32048:1136,1024×568px 以上https://metamoa.com/ads/models/billboard-tall/billboard-tall.texture-default.png · 有線底圖 https://metamoa.com/ads/models/billboard-tall/billboard-tall.texture-template.png
3 層商店(bld-3f-shop)建築9.4×11×9.40.5~22048:480,1024×240px 以上https://metamoa.com/ads/models/bld-3f-shop/bld-3f-shop.texture-default.png · 有線底圖 https://metamoa.com/ads/models/bld-3f-shop/bld-3f-shop.texture-template.png
古典大樓(bld-classic)建築11.6×14×10.80.5~22048:608,1024×304px 以上https://metamoa.com/ads/models/bld-classic/bld-classic.texture-default.png · 有線底圖 https://metamoa.com/ads/models/bld-classic/bld-classic.texture-template.png
轉角商店(bld-corner-shop)建築6.6×10×6.60.5~22048:704,1024×352px 以上https://metamoa.com/ads/models/bld-corner-shop/bld-corner-shop.texture-default.png · 有線底圖 https://metamoa.com/ads/models/bld-corner-shop/bld-corner-shop.texture-template.png
中層大樓(bld-midrise)建築11.8×16×12.40.5~22048:1152,1024×576px 以上https://metamoa.com/ads/models/bld-midrise/bld-midrise.texture-default.png · 有線底圖 https://metamoa.com/ads/models/bld-midrise/bld-midrise.texture-template.png
屋頂商店(bld-shop-roof)建築9.9×10×12.20.5~22048:560,1024×280px 以上https://metamoa.com/ads/models/bld-shop-roof/bld-shop-roof.texture-default.png · 有線底圖 https://metamoa.com/ads/models/bld-shop-roof/bld-shop-roof.texture-template.png
高層大樓(bld-tower)建築15.1×32×15.10.5~1.51632:2048,816×1024px 以上https://metamoa.com/ads/models/bld-tower/bld-tower.texture-default.png · 有線底圖 https://metamoa.com/ads/models/bld-tower/bld-tower.texture-template.png
2 棟商店(bld-twin-shop)建築16.5×9×10.20.5~22048:832,1024×416px 以上https://metamoa.com/ads/models/bld-twin-shop/bld-twin-shop.texture-default.png · 有線底圖 https://metamoa.com/ads/models/bld-twin-shop/bld-twin-shop.texture-template.png
快閃攤位(booth-carnival)快閃攤位3.5×3.2×1.90.6~22048:336,1024×168px 以上https://metamoa.com/ads/models/booth-carnival/booth-carnival.texture-default.png · 有線底圖 https://metamoa.com/ads/models/booth-carnival/booth-carnival.texture-template.png
市集攤位(booth-market)快閃攤位3.3×3×1.50.6~22048:400,1024×200px 以上https://metamoa.com/ads/models/booth-market/booth-market.texture-default.png · 有線底圖 https://metamoa.com/ads/models/booth-market/booth-market.texture-template.png
快閃展亭(booth-pavilion)快閃攤位3.1×4×3.70.6~21024:352,512×176px 以上https://metamoa.com/ads/models/booth-pavilion/booth-pavilion.texture-default.png · 有線底圖 https://metamoa.com/ads/models/booth-pavilion/booth-pavilion.texture-template.png
活動帳篷(booth-tent)快閃攤位3×2.1×30.6~2.52048:416,1024×208px 以上https://metamoa.com/ads/models/booth-tent/booth-tent.texture-default.png · 有線底圖 https://metamoa.com/ads/models/booth-tent/booth-tent.texture-template.png
公車站廣告看板(busstop-shelter)電子看板·廣告看板3.7×2.6×2.40.7~1.5512:1024,256×512px 以上https://metamoa.com/ads/models/busstop-shelter/busstop-shelter.texture-default.png · 有線底圖 https://metamoa.com/ads/models/busstop-shelter/busstop-shelter.texture-template.png
餐車(cart-food)推車·陽傘1.5×2.6×30.7~1.81024:656,512×328px 以上https://metamoa.com/ads/models/cart-food/cart-food.texture-default.png · 有線底圖 https://metamoa.com/ads/models/cart-food/cart-food.texture-template.png
陽傘(cart-parasol)推車·陽傘2×2.6×2.30.6~2https://metamoa.com/ads/models/cart-parasol/cart-parasol.texture-default.png · 有線底圖 https://metamoa.com/ads/models/cart-parasol/cart-parasol.texture-template.png
服務機(kiosk-ticket)服務機0.8×1.8×0.80.8~1.5880:1024,440×512px 以上https://metamoa.com/ads/models/kiosk-ticket/kiosk-ticket.texture-default.png · 有線底圖 https://metamoa.com/ads/models/kiosk-ticket/kiosk-ticket.texture-template.png
貨櫃展示間(showroom-container)展示間6.1×3×2.90.5~22048:912,1024×456px 以上https://metamoa.com/ads/models/showroom-container/showroom-container.texture-default.png · 有線底圖 https://metamoa.com/ads/models/showroom-container/showroom-container.texture-template.png
A 字立牌(sign-aframe)基本立牌·指示牌0.5×1×0.40.6~2.5544:1024,272×512px 以上https://metamoa.com/ads/models/sign-aframe/sign-aframe.texture-default.png · 有線底圖 https://metamoa.com/ads/models/sign-aframe/sign-aframe.texture-template.png
箭頭路標(sign-arrow)基本立牌·指示牌1×2.2×0.20.5~2.51024:768,512×384px 以上https://metamoa.com/ads/models/sign-arrow/sign-arrow.texture-default.png · 有線底圖 https://metamoa.com/ads/models/sign-arrow/sign-arrow.texture-template.png
菜單立牌(sign-menu)基本立牌·指示牌0.9×1.4×0.50.5~2.5640:1024,320×512px 以上https://metamoa.com/ads/models/sign-menu/sign-menu.texture-default.png · 有線底圖 https://metamoa.com/ads/models/sign-menu/sign-menu.texture-template.png
柱式指示牌(sign-pole)基本立牌·指示牌0.6×2.6×0.30.5~2.5784:1024,392×512px 以上https://metamoa.com/ads/models/sign-pole/sign-pole.texture-default.png · 有線底圖 https://metamoa.com/ads/models/sign-pole/sign-pole.texture-template.png
插地立牌(sign-stake)基本立牌·指示牌0.7×1.2×0.60.5~3800:1024,400×512px 以上https://metamoa.com/ads/models/sign-stake/sign-stake.texture-default.png · 有線底圖 https://metamoa.com/ads/models/sign-stake/sign-stake.texture-template.png
牆面指示牌(sign-wall)基本立牌·指示牌1.2×0.8×00.5~41024:672,512×336px 以上https://metamoa.com/ads/models/sign-wall/sign-wall.texture-default.png · 有線底圖 https://metamoa.com/ads/models/sign-wall/sign-wall.texture-template.png
壁掛橫幅(sign-wall-banner)基本立牌·指示牌1×2×0.30.5~3528:1024,264×512px 以上https://metamoa.com/ads/models/sign-wall-banner/sign-wall-banner.texture-default.png · 有線底圖 https://metamoa.com/ads/models/sign-wall-banner/sign-wall-banner.texture-template.png
舞台大螢幕(stage-screen)電子看板·廣告看板12×5.5×12.70.5~1.52048:352,1024×176px 以上https://metamoa.com/ads/models/stage-screen/stage-screen.texture-default.png · 有線底圖 https://metamoa.com/ads/models/stage-screen/stage-screen.texture-template.png
自動販賣機(vending-drink)自動販賣機1.3×1.9×1.20.8~1.5848:1024,424×512px 以上https://metamoa.com/ads/models/vending-drink/vending-drink.texture-default.png · 有線底圖 https://metamoa.com/ads/models/vending-drink/vending-drink.texture-template.png
扭蛋機(vending-gacha)自動販賣機0.6×1.4×0.60.8~1.5912:1024,456×512px 以上https://metamoa.com/ads/models/vending-gacha/vending-gacha.texture-default.png · 有線底圖 https://metamoa.com/ads/models/vending-gacha/vending-gacha.texture-template.png
展示冰箱(vending-showcase)自動販賣機0.9×2×0.80.8~1.5432:1024,216×512px 以上https://metamoa.com/ads/models/vending-showcase/vending-showcase.texture-default.png · 有線底圖 https://metamoa.com/ads/models/vending-showcase/vending-showcase.texture-template.png
廣告商店(shop-ad)建築4.2×3.6×3.30.6~22048:1024,1024×512px 以上(一張圖顯示在正面、側面、背面與頂面)

材質型請下載預設底圖(正方形 PNG),修改後以相同尺寸(1024~2048px)上傳。有線底圖的粉紅色線是表面區塊的邊界,只在區塊內部上色就會顯示在該表面上。

廣告商店(shop-ad)上傳的一張圖片會顯示在正面、側面、背面與頂面:正面招牌、兩側、背面、屋頂上的牌面比例相同,從任何方向看、從上往下看都看得到。附有門,可以使用「從門進入」("door": true)。

基本廣告角色不論金額多少都免費。它們站在或走動於 character 廣告位,把頸掛牌、識別證、手舉牌、氣球、旗子、購物袋等道具綁在骨架上拿著,道具牌面上可放廣告圖片或招牌文字(最多 12 個字)。貓、狗與 Vincent 只能使用掛在脖子上的道具。

角色id可持道具授權
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-badge自有(FLOAT Co., Ltd.)
Nyangjupgo 短毛貓cat_shortprop-neck-sign prop-badgeCC BY 4.0
Nyangjupgo 長毛貓cat_longprop-neck-sign prop-badgeCC BY 4.0
Nyangjupgo 曼赤肯貓cat_munchkinprop-neck-sign prop-badgeCC BY 4.0
Nyangjupgo 柯基dog_corgiprop-neck-sign prop-badgeCC BY 4.0
道具id圖片比例·最小尺寸
頸掛牌(識別證款)prop-badge720:1024,360×512px 以上
氣球prop-balloon1024:1024,512×512px 以上
手旗prop-flag1024:688,512×344px 以上
掛在脖子上的牌子prop-neck-sign1024:720,512×360px 以上
手舉牌prop-picket1024:720,512×360px 以上
購物袋prop-shopping-bag1024:1024,512×512px 以上

模型出處標示

基本模型大多為 CC0(公眾領域)或自製,以下為 CC BY,因此標明出處。全部由 FLOAT Co., Ltd. 修改了尺寸、廣告面等。

模型製作請求

廣告主選擇「模型製作請求」後,我們會製作 3D 模型並附加到活動中,然後進行審核。製作資料(產品照片、標誌、圖面)請連同活動編號寄至 [email protected]。

等級grade製作費投放媒體費達此金額以上即免費
簡單產品·招牌simple₩50,000(供貨價,未稅)₩500,000
精細產品precise₩100,000(供貨價,未稅)₩1,000,000
新角色character₩100,000(供貨價,未稅)₩1,000,000

廣告主:自助登記步驟

  1. 在 https://metamoa.com/ads/manage 用 Metamoa 帳號登入(註冊也在同一視窗)。
  2. 建立活動:名稱、品牌、產業,品牌空間網址(使用進入 CPA 時)。
  3. 廣告物:① 上傳自己的 3D 模型(glb)② 選擇廣告建築 → 圖片型為每個牌面放圖片,材質型放一張材質 ③ 選擇基本廣告角色 + 道具 → 在道具牌面放圖片或招牌文字 ④ 模型製作請求(選擇等級)。會顯示規格與預覽。
  4. 曝光空間:從同意刊登廣告的空間清單中,查看分類、目前線上人數、每日空間點擊後自行選擇廣告位,或點按「推薦」,依產業、分類、流量推薦一組空間。
  5. 決定計費方式(CPM、CPA、曝光時間、空間固定合約)、預算與期間後申請 → 等待審核。
  6. 通過審核(猥褻、暴力、涉嫌侵權等)後即開始投放。進行中的活動可以暫停與重新開啟,每天可查看 viewable 曝光、點擊、進入與顯示時間。
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>)

角色廣告物:{"kind": "character", "character_id": "bangjang", "prop": "prop-picket", "image": "as_…"} 或以 "text": "閃亮牛奶" 取代 "image"。空間固定合約:"billing": "fixed", "fixed_period": "week" | "month", end_day = start_day + 期間 − 1。模型製作請求:{"kind": "request", "grade": "simple", "note": "…"}。

建築與自有模型廣告物還可以再加兩項(選填):"tagline": "一句話介紹"(最多 30 個字,僅限文字 — 不可使用標籤、角括號、大括號(400 invalid,fields creative),與廣告物一起審核)會畫在廣告商店或建築招牌下方的條帶(網格 ad_tagline)上,並以 serve 的 ad.tagline { text, mesh, aspect } 回傳。"door": true 即「從門進入」(需要 brand_url)。與 /ads/manage 第 2 步的「一句話介紹」「從門進入」欄相同。

審核

錯誤代碼

錯誤內文為 { "error": "<代碼>", "message": "<下一步該做什麼的一句話>" },欄位錯誤會附帶 fields,限額會附帶 retry_after。

HTTPerror意義
400invalid欄位格式錯誤。fields 中回傳錯誤的欄位。
400bad_model不是 glb、不是 glTF 2.0,或包含外部位址(uri)。原因見 reason。
400bad_image圖片格式、大小或比例與規格不符。會回傳 reason(format · bytes · too_large · too_small · aspect)與 spec。
400bad_building廣告位的 default_building 不是 GET /ads/v1/buildings 中的建築或立牌 id(空值可以)。
400slot_unavailable所選廣告位不接收廣告、不接收該產業,或與廣告物類型不符(角色只能用於角色廣告位)。slot_ids 中回傳這些廣告位。
401unauthorized沒有空間金鑰或空間管理登入,或不正確。
401sign_in廣告主:沒有 Metamoa 帳號登入,或已過期。
403owner_required有空間金鑰,但尚未確認空間經營者身分。
403owner_page_only用空間金鑰嘗試條款確認或同意刊登廣告(只能在空間管理畫面操作)。
403bad_ad_keySDK:space 與 key(mm_adpub_)不符。
403terms_required該空間尚未確認廣告刊登條款。
403ads_off該空間關閉了同意刊登廣告。
403origin_mismatchSDK 請求不是來自該空間網站(同一網域)。
404not_house在非 Metamoa 直接經營的空間呼叫了我們的廣告(GET /ads/v1/house)。
403not_yours廣告主:使用了他人的檔案 id。
404no_slot沒有該名稱或 id 的廣告位。
404not_found該活動或檔案不存在。
409not_listed未列入目錄的空間(核准前或已隱藏)。
409payout_info_required想開啟同意刊登廣告,但沒有結算資訊的類型(個人·企業)與聯絡方式(手機或電子郵件)。請在空間管理收益化(/owner/revenue?id=<空間 id>)中填寫。
409advertiser_required廣告主:在填寫廣告主資訊(PUT /api/ads/advertiser)之前就想申請或付款活動。
409biz_doc_required廣告主:企業廣告主在上傳營業登記證影本(PUT /api/ads/advertiser/doc)之前就付款或申請空間固定合約。
409business_only廣告主:個人廣告主想上傳營業登記證影本。
400bad_doc廣告主:營業登記證影本不是 PDF、JPG、PNG。
413doc_too_big廣告主:營業登記證影本超過 5MB。
503advertiser_unavailable廣告主:伺服器沒有廣告主資訊加密金鑰,無法接收。
409email_not_linked廣告主:個人廣告主的電子郵件不是登入此 Metamoa 帳號的電子郵件。
409name_taken已存在同名的廣告位。
409slot_limit每個空間最多 30 個空間經營者廣告位,最多 5 個未確認的 SDK 廣告位。
409slot_taken該期間已簽有其他空間固定合約的廣告位。
409tier_too_low以空間固定合約選擇了每日空間點擊未達最低等級的空間的廣告位。slot_ids 中回傳這些廣告位。
409not_for_sale沒有空間固定合約單價。
409under_minimum低於最低投放媒體費。會回傳 min_spend_won、spend_won。
409no_click_history為尚無空間點擊紀錄的空間的廣告位選擇了 CPM 或空間固定合約(無法測量曝光量與等級)。只能選 CPA 與曝光時間型。會回傳 slot_ids、billings。
409over_inventoryCPM 預算超過所選廣告位預估 viewable 曝光上限。會回傳 max_budget_won。
409rejected_file在活動中使用了審核中被封鎖的檔案。
409wrong_state該狀態下無法進行的操作(暫停審核中的活動等)。
409stale管理員:開啟審核畫面後活動有了變更(decide 的 version 與目前不同)。請重新查看後再決定。
409already_paid想對已付款的活動再次開啟付款。
409not_paid管理員:想核准尚未完成付款的活動的結算。
409held管理員:想核准有保留分潤的活動的結算(請先判定保留)。
424hrum_failed無法連線到付款(Hrum)。請稍後再試。
503pay_not_ready暫時無法開啟付款(伺服器設定前)。
409model_missing管理員:在為模型製作請求活動附加模型之前就核准了。
413model_too_big模型檔案超過 6MB。
429too_many請求過多。請等待 Retry-After 指定的秒數。

全部路徑

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