Metamoa
Yêu thích Xếp hạng

Quảng cáo 3D của Metamoa · 3D ads

Tổng quan

Quảng cáo 3D của Metamoa đặt mô hình 3D, tòa nhà quảng cáo hoặc nhân vật quảng cáo của nhà quảng cáo vào các vị trí quảng cáo trong không gian metaverse trên web, chỉ đếm những gì người thật đã xem và đã làm, thu phí quảng cáo theo đó và chia phần cho các nhà vận hành không gian. Với tư cách doanh nghiệp quảng cáo và đại lý quảng cáo, chúng tôi nhận từ doanh nghiệp lớn đến doanh nghiệp vừa và nhỏ.

Màn hình thật · Moa Campsite
Màn hình thật · Moa Campsite
Màn hình thật · cửa hàng ở Moa Campsite (quảng cáo nội bộ)
Màn hình thật · cửa hàng ở Moa Campsite (quảng cáo nội bộ)
Màn hình thật · sân AI Butta
Màn hình thật · sân AI Butta
Màn hình thật · Walking Into Van Gogh
Màn hình thật · Walking Into Van Gogh

4 sản phẩm và cách tính phí

Mọi số tiền đều là giá chưa thuế, chưa gồm VAT.

Sản phẩmbillingThứ được đếmĐơn giá
CPM (lượt hiển thị viewable)cpm1 lượt hiển thị viewable = mô hình nằm trên màn hình ít nhất một tỷ lệ nhất định, liên tục lâu hơn một khoảng thời gian nhất định (khi tab đang hiển thị)₩8,000 mỗi 1,000 lượt viewable
CPA · nhấp vào mô hìnhcpaChạm hoặc nhấp vào mô hình quảng cáo. Nếu sau khi nhấp mà vào tiếp không gian thương hiệu thì chỉ tính 1 lượt vào₩700 mỗi 1 lượt nhấp
CPA · vào không gian thương hiệucpaChạm vào quảng cáo và vào không gian thương hiệu (brand_url). Đếm bằng chuyển hướng máy chủ (/ads/go); mỗi người, mỗi chiến dịch một lần mỗi ngày₩1,000 mỗi 1 lượt vào
Thời gian hiển thịtimeTổng thời gian quảng cáo được nhìn thấy sau lượt hiển thị viewable (chỉ khi có thao tác, tối đa đến mức trần mỗi ngày cho mỗi người và mô hình)₩1,000 mỗi 1,000 giây viewable
Hợp đồng vị trí cố địnhfixedTheo kỳ (tối đa một tháng). Bạn độc quyền dùng vị trí quảng cáo đã ký trong kỳ đó (theo từng vị trí). Không đảm bảo số lượt hiển thịXem bảng hạng bên dưới

Hạng của hợp đồng vị trí cố định

Hạng được xác định theo trung vị số lượt nhấp không gian sạch mỗi ngày trong 14 ngày gần nhất của không gian chứa vị trí đó (không tính lượt vào của chính nhà vận hành, mạng trung tâm dữ liệu và trình duyệt tự động; “Vào” của metamoa chỉ tính sau khi qua xác minh người thật). Vị trí ở không gian chưa đạt hạng thấp nhất không bán theo hợp đồng vị trí cố định, chỉ nhận theo hiệu quả. Thời hạn hợp đồng là theo tuần (7 ngày) hoặc theo tháng (30 ngày).

HạngLượt nhấp không gian mỗi ngàyTheo tuần (1 vị trí)Theo tháng (1 vị trí)
STừ 1,000 trở lên₩50,000₩180,000
A300~999₩15,000₩50,000
B100~299₩5,000₩18,000

Công thức tổng hợp

Ngày tính theo giờ Hàn Quốc, mỗi ngày một đơn vị (ad_daily). Số tiền là giá chưa thuế đã bỏ phần lẻ dưới một won. Sự kiện vi phạm quy tắc không được đếm và được đếm riêng theo lý do (ad_excluded).

Hạng chia doanh thu cho nhà vận hành không gian

Doanh thu quảng cáo (số tiền truyền thông quảng cáo theo không gian, giá chưa thuế sau khi trừ lưu lượng không hợp lệ) được chia giữa nhà vận hành không gian và Metamoa theo tỷ lệ của hạng. Áp dụng từ ngày 11/11/2026. Đăng ký ưu tiên: https://metamoa.com/ads/partners

HạngĐối tượngNhà vận hành không gian : Metamoa
Bạch kimTheo thứ tự đến trước: nhà vận hành không gian thứ 1~109:1
VàngNhà vận hành không gian thứ 11~100 (90 người)8:2
BạcCác nhà vận hành không gian sau đó7:3
ĐồngNhà vận hành không gian ký hợp đồng mới từ ngày 1/1/20276:4

Tỷ lệ có thể được điều chỉnh sau này tùy theo hiệu quả quảng cáo.

Vị trí quảng cáo (slot)

Nhà vận hành không gian tự quyết định chỗ đặt quảng cáo trong metaverse của mình. Nhà quảng cáo chọn theo vị trí hoặc nhận gợi ý, hợp đồng vị trí cố định cũng ký theo vị trí. Danh sách vị trí có thể xem và bật tắt trong trang quản lý không gian.

TrườngĐịnh dạngÝ nghĩa
name1~40 ký tựTên không trùng trong không gian
kindfloor · wall · air · characterMô hình đặt sàn · biển hiệu tường · băng rôn trên không · nhân vật quảng cáo đứng hoặc đi lại
position[x, y, z] métVị trí tâm đáy của hộp vị trí (tọa độ không gian)
rotation[x, y, z] độ (-360~360)Góc xoay của vị trí. Mặc định [0, 0, 0]
size[rộng, cao, sâu] mét (0.1~200)Hộp chứa quảng cáo. Quảng cáo được phóng to hoặc thu nhỏ cho vừa hộp này
scale[tối thiểu, tối đa] lần (0.05~20)Hệ số kích thước theo không gian: khi khớp vào hộp, quảng cáo chỉ được phóng to thu nhỏ trong phạm vi hệ số này so với kích thước gốc. Mặc định [0.25, 4]
roam0~50 métVị trí character: bán kính nhân vật đi lại (0 là đứng yên)
industriesDanh sách id ngànhCác ngành vị trí này nhận. Để trống là mọi ngành
enabledtrue · falseKhi tắt, vị trí này không hiện quảng cáo

Kích thước mô hình quảng cáo có thể được nhà vận hành không gian hoặc Metamoa điều chỉnh tùy theo không gian.

Quảng cáo nhân vật chỉ chạy ở vị trí character, quảng cáo mô hình và tòa nhà chỉ chạy ở vị trí floor, wall, air.

SDK (khóa quảng cáo công khai) chỉ tạo được vị trí mới, và vị trí tạo như vậy ở trạng thái tắt; nhà vận hành phải kiểm tra và bật trong trang quản lý không gian thì quảng cáo mới chạy. Vị trí đã có (cùng tên) thì SDK không sửa được và trả về nguyên trạng. Vị trí SDK đang tắt tối đa 5 cái mỗi không gian, đếm riêng với 30 vị trí của nhà vận hành. Một nhóm IP mỗi ngày tạo được tối đa 20 cái, và vị trí SDK mà nhà vận hành không bật lần nào trong 7 ngày sẽ bị xóa (vị trí từng bật và vị trí chiến dịch đang dùng thì không xóa). Khi bật, chúng được tính trong 30 vị trí của nhà vận hành. Đổi hộp, loại, ngành của vị trí và bật tắt chỉ làm được bằng đăng nhập trang quản lý hoặc khóa không gian.

Id ngành: game (trò chơi) · fashion (thời trang, làm đẹp) · food (ăn uống) · tech (CNTT, điện tử) · finance (tài chính) · edu (giáo dục) · travel (du lịch, giải trí) · culture (văn hóa, giải trí) · auto (ô tô) · public (công, phi lợi nhuận) · etc (khác)

Mỗi không gian tối đa 30 vị trí. API vị trí dùng khóa không gian (mm_live_) hoặc đăng nhập trang quản lý không gian:

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}

Nhà vận hành không gian: các bước gắn

  1. Trong 「Đăng ký nhận quảng cáo」 ở mục Kiếm tiền của trang quản lý không gian (https://metamoa.com/owner/revenue?id=<id không gian>), đánh dấu xác nhận điều khoản và bắt đầu quảng cáo.
  2. Đặt dòng script ở ô 「API quảng cáo」 của cùng màn hình vào cuối <head> hoặc <body> của trang không gian. Khóa quảng cáo (mm_adpub_) có thể công khai (đừng đặt khóa không gian mm_live_ vào đó).
  3. Với không gian three.js, gọi attach và slot sau khi cảnh đã được dựng. Vị trí được đăng ký ở trạng thái tắt ở lần gọi đầu tiên. Bật trong 「Vị trí quảng cáo」 của trang quản lý thì quảng cáo sẽ chạy (cũng có thể tạo ở trạng thái bật ngay từ đầu bằng API vị trí).
  4. Quảng cáo hiện ra là xong. Lượt hiển thị viewable, lượt nhấp và thời gian hiển thị do SDK tự gửi, còn lượt vào không gian thương hiệu thì khi chạm quảng cáo SDK mở /ads/go và máy chủ đếm.
  5. Trong 「Vị trí quảng cáo」 của trang quản lý không gian, bật tắt vị trí và xem số liệu 30 ngày (trước và sau khi áp quy tắc) cùng phần được chia (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 });
});

Engine không phải three.js (Babylon.js, PlayCanvas, Unity WebGL…) nhận quảng cáo bằng serve, tự vẽ và gửi sự kiện: ads.serve(name) → { ad }, ads.report(name, event). Với lượt vào, chỉ cần mở ad.enter_url trong cửa sổ mới hoặc cùng cửa sổ. Quy cách xem ở 「Quy cách sự kiện」 bên dưới.

Cách SDK đếm

Đi vào qua cửa

Bạn có thể gắn cửa cho tòa nhà quảng cáo hoặc mô hình 3D của mình. Đây là cửa, không phải cổng dịch chuyển: khi người dùng đi bộ vào qua cửa, không gian hiện tại vẫn giữ nguyên và không gian thương hiệu mở trong cửa sổ mới (tab mới). Thêm "door": true vào creative của chiến dịch (chỉ khi kind là model hoặc building), và cần có brand_url (nếu không có là 400 invalid, fields brand_url). ad của serve sẽ có 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 } }

Quy tắc để cửa không mở lại liên tục (bắt buộc tuân thủ)

  1. Khi đi bộ vào trong vòng 1.2m trước cửa, không gian thương hiệu (enter_url có &via=door) mở một lần trong cửa sổ mới.
  2. Sau khi đóng cửa sổ mới mở và quay lại, dù di chuyển một chút trong hoặc gần cửa, cửa cũng không mở lại.
  3. Phải đi ra xa cửa hơn 3m rồi quay vào thì cửa mới mở lại (khoảng cách vào 1.2m < khoảng cách ra 3m).
  4. Trong lúc tab bị ẩn hoặc cửa sổ không có tiêu điểm thì không mở, và sau khi quay lại cũng phải ra khỏi khu vực cửa một lần. Nếu lúc mở trang đã đứng sẵn trong cửa thì cũng không mở.
  5. Chạm hoặc nhấp vào tòa nhà để mở vẫn như cũ (mỗi lần nhấp). Quy tắc cửa chỉ áp dụng cho việc đi bộ vào.
  6. Nếu trình duyệt chặn cửa sổ mới, nút 「Mở <thương hiệu>」 sẽ hiện ở cuối màn hình. Phải bấm nút đó mới mở (nếu rời cửa mà không bấm thì nút biến mất).

Vị trí cửa: nếu trong glb có nút tên door thì dùng nút đó, không có thì SDK vẽ cửa mặc định ở giữa phía dưới mặt trước quảng cáo (+Z). Khoảng cách là khoảng cách trên sàn từ nhân vật đang đi đến trước cửa. Hãy truyền cho attach một walker (Object3D của nhân vật đang đi hoặc hàm trả về {x, y, z}). Nếu không có thì đo theo vị trí camera.

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

Không gian tự vẽ ad.door bằng engine không phải three.js cũng phải tuân thủ y hệt quy tắc trên: sau khi mở một lần, không mở lại cho đến khi ra ngoài exit_m; và sau khi tab bị ẩn rồi quay lại, không mở lại cho đến khi ra khỏi khu vực cửa một lần.

Để ra vào liên tục không làm hao ngân sách

Quy tắc kiểm tra bot và gian lận

Sự kiện lần lượt đi qua các quy tắc dưới đây trên máy chủ. Chỉ cần vướng một quy tắc là bị loại khỏi số liệu và đếm riêng theo tên quy tắc đó. Mỗi quy tắc được bật tắt riêng trong bot_rules của data/ads-config.json.

Quy tắcViệc làmHiện tại
UA bot (ua_bot)Loại robot tìm kiếm, trình xem trước, script (curl, python, headless…) và yêu cầu không có User-Agent.Bật
Trình duyệt tự động (headless)Loại trình duyệt bật navigator.webdriver, HeadlessChrome, PhantomJS, Electron, jsdom và yêu cầu không có Accept-Language. Đây là định nghĩa đo lường, không tính là biện pháp chống script.Bật
Trạng thái hiển thị và tiêu điểm của tab (visibility_focus)Lượt hiển thị chỉ đếm khi tab đang hiển thị (document.visibilityState = visible) và cửa sổ có tiêu điểm, thời gian hiển thị chỉ đếm khi tab đang hiển thị. Đây là định nghĩa đo lường.Bật
Xác định viewable (min_view)Phải có ít nhất một tỷ lệ nhất định của mô hình trên màn hình, với diện tích từ một mức nhất định trở lên, kéo dài quá một khoảng thời gian nhất định thì mới là 1 lượt hiển thị. Đây là định nghĩa đo lường.Bật
Giới hạn lặp lại theo người và địa chỉ internet (repeat_limit)Lượt hiển thị và lượt nhấp của cùng người, cùng mô hình chỉ tính một lần trong một khoảng thời gian nhất định; lượt vào (gồm cả đi vào qua cửa) mỗi ngày một lần và tối đa một số lần nhất định trong một số ngày nhất định. Loại phần vượt mức trần mỗi giờ của một nhóm địa chỉ internet, số người xem mới mỗi ngày theo không gian, số lượt hiển thị, nhấp, vào mỗi ngày theo chiến dịch và không gian. Giới hạn lượt vào được kiểm tra lại bằng nhật ký sự kiện của máy chủ nên máy chủ khởi động lại cũng không quên.Bật
Token do máy chủ ký (signed_token)Sự kiện phải mang token đã ký (HMAC) do serve cấp. Người xem và nhóm địa chỉ internet lúc serve được ký vào token; lượt hiển thị đến từ địa chỉ khác bị loại, lượt hiển thị trước khi qua một khoảng thời gian nhất định kể từ serve cũng bị loại. Trong thời hạn hiệu lực, token chỉ tính mỗi loại hiển thị, nhấp, vào một lần. Ngân sách chiến dịch được kiểm tra lại lúc đếm, sự kiện vượt ngân sách không được đếm (budget).Bật
Đo thời gian hiển thị (view_time)Thời gian hiển thị chỉ đếm khi trong khoảng đó có thao tác camera hoặc con trỏ, và chỉ đến mức trần mỗi token, mỗi ngày cho mỗi người và mô hình, mỗi ngày cho mỗi địa chỉ internet và mô hình.Bật
Lưu lượng của chính nhà vận hành (owner_traffic)Sự kiện đến từ địa chỉ internet đã mở trang quản lý của không gian đó bị loại trong một số ngày nhất định.Bật
Dấu vết thao tác của người (human_input)Lượt nhấp chỉ đếm những gì trình duyệt đánh dấu là thao tác của người (isTrusted). Lượt hiển thị không xét số lần thao tác (người xem yên lặng, người dùng bàn phím và trình đọc màn hình).Bật
Giám sát bất thường và tạm giữ (anomaly)Lượt hiển thị một người xem vượt một số nhất định mỗi ngày bị loại. Lượt nhấp và lượt vào CPA được đếm đến mức tự động công nhận mỗi ngày theo không gian, phần vượt bị tạm giữ. Nếu tỷ lệ nhấp và vào (so với mạng lưới không tính không gian đó), lượt hiển thị trên mỗi lượt nhấp không gian, người xem mới trên mỗi địa chỉ internet, tỷ trọng trung tâm dữ liệu, lặp lại từ cùng địa chỉ, lượt vào trên mỗi lượt nhấp vượt ngưỡng, phần của không gian đó trong tháng đó bị tạm giữ và quản trị viên quyết định.Bật
Mạng trung tâm dữ liệu (asn)Nếu x-mm-asn (số AS) do Cloudflare gắn là mạng đám mây hoặc lưu trữ thì sự kiện bị loại, tỷ trọng đó lớn thì không gian bị tạm giữ. Chỉ tin khi header bí mật (origin-auth) mà Cloudflare Transform Rule gắn kèm khớp với giá trị env của máy chủ; nếu không thì mạng của sự kiện đó ghi là 「không rõ」 và tỷ trọng trung tâm dữ liệu chỉ đo bằng các sự kiện biết mạng.Bật
Xác minh người thật khi vào (turnstile)Lượt vào không gian thương hiệu (/ads/go) phải qua Cloudflare Turnstile trên tên miền Metamoa mới được đếm. Dù thất bại, người dùng vẫn được chuyển sang không gian thương hiệu, chỉ là không đếm lượt vào. Lượt vào khi chưa có khóa bị tạm giữ.Bật
Xác minh người thật cho lượt hiển thị (turnstile_imp)SDK chạy Cloudflare Turnstile trong một cửa sổ metamoa ẩn và gắn thẻ thông hành nhận được (gắn với mạng và không gian đó) vào lượt hiển thị. Có thẻ thì được tính; xác minh thất bại thì bị loại. Không có thẻ thì chỉ lượt đó bị tạm giữ; hết tháng sẽ được giải phóng hoặc hủy theo tỷ lệ không xác minh được của không gian (quản trị viên có thể giải phóng). Quảng cáo luôn hiển thị như bình thường.Bật

Quy cách sự kiện

Yêu cầu SDK chỉ được nhận từ trang của chính không gian đó. Nếu là tên miền riêng của nhà vận hành thì phải cùng tên miền đăng ký, nếu là máy chủ dùng chung như github.io, vercel.app thì tên máy chủ phải giống hệt, còn không gian nằm dưới một đường dẫn (github.io/<kho>, claude.ai) thì đường dẫn Referer cũng phải nằm dưới đó (SDK gửi Referer đầy đủ). Tất cả mở CORS, JSON. Cũng nhận sendBeacon (text/plain).

Nhận quảng cáo · 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"
      }
    ]
  }
}

Nếu ad là null thì hiện chưa có quảng cáo để chạy ở vị trí đó. Nếu kind là model thì đặt glb của model_url; nếu là building thì đặt glb tòa nhà, sau đó nếu mode là image thì dán ảnh image_url lên tên mesh trong faces, nếu là texture thì dán image_url lên toàn bộ texture.meshes, lặp theo repeat. Nếu là character thì dựng glb nhân vật, gắn đạo cụ vào vị trí prop.attach rồi đặt ảnh image_url hoặc chữ của text lên tấm bảng đó. Tất cả đều khớp với hộp slot.size nhưng chỉ phóng to thu nhỏ trong hệ số slot.scale so với kích thước gốc.

Đăng ký vị trí · 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 (같은 이름의 자리를 바꾸지 않고 그대로)

Gửi sự kiện · 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 }
typeTrườngÝ nghĩa
imptoken, ms, area, inside, vis, focus, inputs, wdms: thời gian hiển thị liên tục, area: diện tích mô hình so với diện tích màn hình (0~1), inside: phần mô hình nằm trong màn hình (0~1), vis·focus: tab hiển thị và cửa sổ có tiêu điểm, inputs: số lần thao tác camera và con trỏ trong thời gian đó, wd: navigator.webdriver
timetoken, ms, vis, inputs, wdThời gian hiển thị kể từ lần time trước (tối đa 15,000ms) và số lần thao tác trong khoảng đó
clicktoken, trusted, wdĐã chạm hoặc nhấp vào quảng cáo. trusted: thao tác của người (isTrusted)

Lượt hiển thị được tính cùng thẻ xác minh người thật mà SDK nhận từ một cửa sổ metamoa ẩn (Cloudflare Turnstile). Quảng cáo hiện ngay, không chờ thẻ. Nếu trang của bạn gửi Content-Security-Policy, hãy thêm https://metamoa.com vào frame-src. Khi cửa sổ bị chặn hoặc không có thẻ, lượt hiển thị đó bị tạm giữ; sau khi hết tháng sẽ được giải phóng nếu tỷ lệ không xác minh được của không gian từ 20% trở xuống, và bị hủy nếu vượt quá.

Mỗi lần tối đa 20 cái. Sự kiện không gửi vid. Người xem lấy theo giá trị trong token. Sự kiện sai và token của không gian khác chỉ được đếm là excluded.

Lượt vào · go

Lượt vào chỉ được đếm sau khi /ads/go trên tên miền Metamoa xác minh bằng Cloudflare Turnstile rằng đó là người thật (khi có khóa, một màn hình xác minh nhỏ hiện trong 1~2 giây). Dù xác minh thất bại, người đó vẫn đi tới không gian thương hiệu, chỉ là không đếm lượt vào.

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

Tòa nhà quảng cáo, nhân vật và quy cách tải lên

Nhà quảng cáo chưa có mô hình chọn tòa nhà quảng cáo hoặc nhân vật quảng cáo cơ bản do chúng tôi cung cấp. Với tòa nhà, chọn một trong hai cách: dạng ảnh (mỗi tấm bảng định sẵn một ảnh) · dạng texture (một texture hoặc họa tiết phủ toàn bộ bề mặt tòa nhà).

Mô hìnhLoạiKích thước mặc định (m)Hệ sốDạng ảnh: mặt quảng cáoDạng texture: tải mẫu gốc
Băng rôn cờ (banner-flag)Cột băng rôn3.7×3.5×0.40.5~2.52048:1072, từ 1024×536px trở lênhttps://metamoa.com/ads/models/banner-flag/banner-flag.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/banner-flag/banner-flag.texture-template.png
Cột băng rôn dọc (banner-hanging)Cột băng rôn1.9×3×0.20.5~2.51088:2048, từ 544×1024px trở lênhttps://metamoa.com/ads/models/banner-hanging/banner-hanging.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/banner-hanging/banner-hanging.texture-template.png
Tháp băng rôn (banner-tower)Cột băng rôn1.2×4×1.20.5~2.5656:1024, từ 328×512px trở lênhttps://metamoa.com/ads/models/banner-tower/banner-tower.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/banner-tower/banner-tower.texture-template.png
Bảng quảng cáo (billboard-board)Bảng điện tử · biển quảng cáo1.9×2.4×1.50.5~31024:944, từ 512×472px trở lênhttps://metamoa.com/ads/models/billboard-board/billboard-board.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/billboard-board/billboard-board.texture-template.png
Biển quảng cáo thấp (billboard-low)Bảng điện tử · biển quảng cáo4×2.2×0.60.5~32048:784, từ 1024×392px trở lênhttps://metamoa.com/ads/models/billboard-low/billboard-low.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/billboard-low/billboard-low.texture-template.png
Biển quảng cáo đứng (billboard-stand)Bảng điện tử · biển quảng cáo8×4.8×2.50.5~22048:848, từ 1024×424px trở lênhttps://metamoa.com/ads/models/billboard-stand/billboard-stand.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/billboard-stand/billboard-stand.texture-template.png
Biển quảng cáo lớn (billboard-tall)Bảng điện tử · biển quảng cáo6×6×2.90.5~32048:1136, từ 1024×568px trở lênhttps://metamoa.com/ads/models/billboard-tall/billboard-tall.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/billboard-tall/billboard-tall.texture-template.png
Cửa hàng 3 tầng (bld-3f-shop)Tòa nhà9.4×11×9.40.5~22048:480, từ 1024×240px trở lênhttps://metamoa.com/ads/models/bld-3f-shop/bld-3f-shop.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/bld-3f-shop/bld-3f-shop.texture-template.png
Tòa nhà cổ điển (bld-classic)Tòa nhà11.6×14×10.80.5~22048:608, từ 1024×304px trở lênhttps://metamoa.com/ads/models/bld-classic/bld-classic.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/bld-classic/bld-classic.texture-template.png
Cửa hàng góc phố (bld-corner-shop)Tòa nhà6.6×10×6.60.5~22048:704, từ 1024×352px trở lênhttps://metamoa.com/ads/models/bld-corner-shop/bld-corner-shop.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/bld-corner-shop/bld-corner-shop.texture-template.png
Tòa nhà tầm trung (bld-midrise)Tòa nhà11.8×16×12.40.5~22048:1152, từ 1024×576px trở lênhttps://metamoa.com/ads/models/bld-midrise/bld-midrise.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/bld-midrise/bld-midrise.texture-template.png
Cửa hàng có sân thượng (bld-shop-roof)Tòa nhà9.9×10×12.20.5~22048:560, từ 1024×280px trở lênhttps://metamoa.com/ads/models/bld-shop-roof/bld-shop-roof.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/bld-shop-roof/bld-shop-roof.texture-template.png
Tòa nhà cao tầng (bld-tower)Tòa nhà15.1×32×15.10.5~1.51632:2048, từ 816×1024px trở lênhttps://metamoa.com/ads/models/bld-tower/bld-tower.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/bld-tower/bld-tower.texture-template.png
Cửa hàng 2 dãy (bld-twin-shop)Tòa nhà16.5×9×10.20.5~22048:832, từ 1024×416px trở lênhttps://metamoa.com/ads/models/bld-twin-shop/bld-twin-shop.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/bld-twin-shop/bld-twin-shop.texture-template.png
Gian hàng pop-up (booth-carnival)Gian hàng pop-up3.5×3.2×1.90.6~22048:336, từ 1024×168px trở lênhttps://metamoa.com/ads/models/booth-carnival/booth-carnival.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/booth-carnival/booth-carnival.texture-template.png
Sạp hàng (booth-market)Gian hàng pop-up3.3×3×1.50.6~22048:400, từ 1024×200px trở lênhttps://metamoa.com/ads/models/booth-market/booth-market.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/booth-market/booth-market.texture-template.png
Nhà trưng bày pop-up (booth-pavilion)Gian hàng pop-up3.1×4×3.70.6~21024:352, từ 512×176px trở lênhttps://metamoa.com/ads/models/booth-pavilion/booth-pavilion.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/booth-pavilion/booth-pavilion.texture-template.png
Lều sự kiện (booth-tent)Gian hàng pop-up3×2.1×30.6~2.52048:416, từ 1024×208px trở lênhttps://metamoa.com/ads/models/booth-tent/booth-tent.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/booth-tent/booth-tent.texture-template.png
Biển quảng cáo trạm xe buýt (busstop-shelter)Bảng điện tử · biển quảng cáo3.7×2.6×2.40.7~1.5512:1024, từ 256×512px trở lênhttps://metamoa.com/ads/models/busstop-shelter/busstop-shelter.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/busstop-shelter/busstop-shelter.texture-template.png
Xe đẩy đồ ăn (cart-food)Xe đẩy · dù che1.5×2.6×30.7~1.81024:656, từ 512×328px trở lênhttps://metamoa.com/ads/models/cart-food/cart-food.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/cart-food/cart-food.texture-template.png
Dù che (cart-parasol)Xe đẩy · dù che2×2.6×2.30.6~2https://metamoa.com/ads/models/cart-parasol/cart-parasol.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/cart-parasol/cart-parasol.texture-template.png
Ki-ốt (kiosk-ticket)Ki-ốt0.8×1.8×0.80.8~1.5880:1024, từ 440×512px trở lênhttps://metamoa.com/ads/models/kiosk-ticket/kiosk-ticket.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/kiosk-ticket/kiosk-ticket.texture-template.png
Phòng trưng bày container (showroom-container)Phòng trưng bày6.1×3×2.90.5~22048:912, từ 1024×456px trở lênhttps://metamoa.com/ads/models/showroom-container/showroom-container.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/showroom-container/showroom-container.texture-template.png
Biển chữ A (sign-aframe)Biển và bảng chỉ dẫn cơ bản0.5×1×0.40.6~2.5544:1024, từ 272×512px trở lênhttps://metamoa.com/ads/models/sign-aframe/sign-aframe.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/sign-aframe/sign-aframe.texture-template.png
Biển chỉ đường mũi tên (sign-arrow)Biển và bảng chỉ dẫn cơ bản1×2.2×0.20.5~2.51024:768, từ 512×384px trở lênhttps://metamoa.com/ads/models/sign-arrow/sign-arrow.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/sign-arrow/sign-arrow.texture-template.png
Kệ thực đơn (sign-menu)Biển và bảng chỉ dẫn cơ bản0.9×1.4×0.50.5~2.5640:1024, từ 320×512px trở lênhttps://metamoa.com/ads/models/sign-menu/sign-menu.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/sign-menu/sign-menu.texture-template.png
Biển trên cột (sign-pole)Biển và bảng chỉ dẫn cơ bản0.6×2.6×0.30.5~2.5784:1024, từ 392×512px trở lênhttps://metamoa.com/ads/models/sign-pole/sign-pole.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/sign-pole/sign-pole.texture-template.png
Biển cắm đất (sign-stake)Biển và bảng chỉ dẫn cơ bản0.7×1.2×0.60.5~3800:1024, từ 400×512px trở lênhttps://metamoa.com/ads/models/sign-stake/sign-stake.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/sign-stake/sign-stake.texture-template.png
Biển gắn tường (sign-wall)Biển và bảng chỉ dẫn cơ bản1.2×0.8×00.5~41024:672, từ 512×336px trở lênhttps://metamoa.com/ads/models/sign-wall/sign-wall.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/sign-wall/sign-wall.texture-template.png
Băng rôn treo tường (sign-wall-banner)Biển và bảng chỉ dẫn cơ bản1×2×0.30.5~3528:1024, từ 264×512px trở lênhttps://metamoa.com/ads/models/sign-wall-banner/sign-wall-banner.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/sign-wall-banner/sign-wall-banner.texture-template.png
Màn hình sân khấu (stage-screen)Bảng điện tử · biển quảng cáo12×5.5×12.70.5~1.52048:352, từ 1024×176px trở lênhttps://metamoa.com/ads/models/stage-screen/stage-screen.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/stage-screen/stage-screen.texture-template.png
Máy bán hàng tự động (vending-drink)Máy bán hàng tự động1.3×1.9×1.20.8~1.5848:1024, từ 424×512px trở lênhttps://metamoa.com/ads/models/vending-drink/vending-drink.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/vending-drink/vending-drink.texture-template.png
Máy gắp viên nang (vending-gacha)Máy bán hàng tự động0.6×1.4×0.60.8~1.5912:1024, từ 456×512px trở lênhttps://metamoa.com/ads/models/vending-gacha/vending-gacha.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/vending-gacha/vending-gacha.texture-template.png
Tủ lạnh trưng bày (vending-showcase)Máy bán hàng tự động0.9×2×0.80.8~1.5432:1024, từ 216×512px trở lênhttps://metamoa.com/ads/models/vending-showcase/vending-showcase.texture-default.png · mẫu gốc có đường kẻ https://metamoa.com/ads/models/vending-showcase/vending-showcase.texture-template.png
Cửa hàng quảng cáo (shop-ad)Tòa nhà4.2×3.6×3.30.6~22048:1024, từ 1024×512px trở lên (một ảnh hiện ở mặt trước, hai bên, mặt sau và mặt trên)

Với dạng texture, tải mẫu gốc mặc định (PNG vuông) về, sửa rồi tải lên đúng kích thước đó (1024~2048px). Đường kẻ hồng trên mẫu gốc có đường kẻ là ranh giới các mảnh bề mặt, chỉ tô bên trong mảnh là sẽ hiện trên bề mặt đó.

Cửa hàng quảng cáo (shop-ad) hiển thị một ảnh đã tải lên ở mặt trước, hai bên, mặt sau và mặt trên: biển phía trước, hai bên, phía sau và tấm bảng trên mái đều cùng tỷ lệ, nên nhìn từ phía nào, kể cả nhìn từ trên xuống, cũng đọc được. Có cửa nên dùng được 「Đi vào qua cửa」 ("door": true).

Nhân vật quảng cáo cơ bản miễn phí với mọi mức chi. Chúng đứng hoặc đi lại ở vị trí character, cầm các đạo cụ gắn vào xương như biển đeo cổ, thẻ nhân viên, bảng cầm tay, bóng bay, cờ, túi mua sắm, và tấm bảng đạo cụ chứa ảnh quảng cáo hoặc chữ biển hiệu (tối đa 12 ký tự). Mèo, chó và Vincent chỉ dùng được đạo cụ đeo ở cổ.

Nhân vậtidĐạo cụ có thể cầmGiấy phép
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-badgeTự làm (FLOAT Co., Ltd.)
Mèo lông ngắn Nyangjupgocat_shortprop-neck-sign prop-badgeCC BY 4.0
Mèo lông dài Nyangjupgocat_longprop-neck-sign prop-badgeCC BY 4.0
Mèo Munchkin Nyangjupgocat_munchkinprop-neck-sign prop-badgeCC BY 4.0
Chó Corgi Nyangjupgodog_corgiprop-neck-sign prop-badgeCC BY 4.0
Đạo cụidTỷ lệ ảnh · kích thước tối thiểu
Biển đeo cổ (kiểu thẻ nhân viên)prop-badge720:1024, từ 360×512px trở lên
Bóng bayprop-balloon1024:1024, từ 512×512px trở lên
Cờ cầm tayprop-flag1024:688, từ 512×344px trở lên
Biển đeo ở cổprop-neck-sign1024:720, từ 512×360px trở lên
Bảng cầm tayprop-picket1024:720, từ 512×360px trở lên
Túi mua sắmprop-shopping-bag1024:1024, từ 512×512px trở lên

Ghi nguồn mô hình

Phần lớn mô hình cơ bản là CC0 (phạm vi công cộng) hoặc tự làm; các mô hình dưới đây là CC BY nên ghi rõ nguồn. Tất cả đều được FLOAT Co., Ltd. chỉnh sửa kích thước, mặt quảng cáo…

Yêu cầu làm mô hình

Khi nhà quảng cáo chọn 「Yêu cầu làm mô hình」, chúng tôi làm mô hình 3D, gắn vào chiến dịch rồi duyệt. Hãy gửi tư liệu (ảnh sản phẩm, logo, bản vẽ) đến [email protected] kèm mã chiến dịch.

HạnggradePhí làmMiễn phí nếu chi từ mức phí truyền thông này trở lên
Sản phẩm đơn giản · biển hiệusimple₩50,000 (giá chưa thuế, chưa gồm VAT)₩500,000
Sản phẩm chi tiếtprecise₩100,000 (giá chưa thuế, chưa gồm VAT)₩1,000,000
Nhân vật mớicharacter₩100,000 (giá chưa thuế, chưa gồm VAT)₩1,000,000

Nhà quảng cáo: các bước tự đăng ký

  1. Đăng nhập bằng tài khoản Metamoa tại https://metamoa.com/ads/manage (đăng ký cũng trong cùng cửa sổ).
  2. Tạo chiến dịch: tên, thương hiệu, ngành, địa chỉ không gian thương hiệu (khi dùng CPA lượt vào).
  3. Tư liệu quảng cáo: ① tải lên mô hình 3D của mình (glb) ② chọn tòa nhà quảng cáo → dạng ảnh thì mỗi tấm bảng một ảnh, dạng texture thì một texture ③ chọn nhân vật quảng cáo cơ bản + đạo cụ → ảnh hoặc chữ biển hiệu trên tấm bảng đạo cụ ④ yêu cầu làm mô hình (chọn hạng). Quy cách và bản xem trước sẽ hiện ra.
  4. Không gian hiển thị: từ danh sách không gian đã đồng ý hiển thị quảng cáo, xem danh mục, số người đang truy cập và lượt nhấp không gian mỗi ngày rồi tự chọn vị trí, hoặc bấm 「Gợi ý」 để nhận một nhóm không gian phù hợp ngành, danh mục và lưu lượng.
  5. Chọn cách tính phí (CPM, CPA, thời gian hiển thị, hợp đồng vị trí cố định), ngân sách và thời gian rồi đăng ký → chờ duyệt.
  6. Qua được kiểm duyệt (khiêu dâm, bạo lực, nghi vi phạm bản quyền…) thì sẽ chạy. Chiến dịch đang chạy có thể tạm dừng và bật lại, và bạn xem lượt hiển thị viewable, lượt nhấp, lượt vào, thời gian hiển thị theo từng ngày.
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>)

Tư liệu nhân vật: {"kind": "character", "character_id": "bangjang", "prop": "prop-picket", "image": "as_…"} hoặc "text": "Sữa Lấp Lánh" thay cho "image". Hợp đồng vị trí cố định: "billing": "fixed", "fixed_period": "week" | "month", end_day = start_day + thời hạn − 1. Yêu cầu làm mô hình: {"kind": "request", "grade": "simple", "note": "…"}.

Tư liệu tòa nhà và mô hình riêng có thể thêm hai thứ (tùy chọn): "tagline": "mô tả một dòng" (tối đa 30 ký tự, chỉ chữ — không dùng thẻ, dấu ngoặc nhọn hay ngoặc móc (400 invalid, fields creative), được duyệt cùng tư liệu) được vẽ trên dải dưới biển hiệu của cửa hàng quảng cáo hoặc tòa nhà (mesh ad_tagline), và trả về qua ad.tagline { text, mesh, aspect } của serve. "door": true là 「Đi vào qua cửa」 (cần brand_url). Giống ô 「Mô tả một dòng」 và 「Đi vào qua cửa」 ở bước 2 của /ads/manage.

Kiểm duyệt

Mã lỗi

Nội dung lỗi là { "error": "<mã>", "message": "<một dòng về việc cần làm tiếp>" }, lỗi trường đi kèm fields, giới hạn đi kèm retry_after.

HTTPerrorÝ nghĩa
400invalidĐịnh dạng trường sai. fields chứa các trường sai.
400bad_modelKhông phải glb, không phải glTF 2.0, hoặc có địa chỉ bên ngoài (uri). Lý do ở reason.
400bad_imageĐịnh dạng, kích thước hoặc tỷ lệ ảnh khác quy cách. Trả về reason (format · bytes · too_large · too_small · aspect) và spec.
400bad_buildingdefault_building của vị trí không phải id tòa nhà hoặc biển của GET /ads/v1/buildings (để trống thì được).
400slot_unavailableVị trí đã chọn không nhận quảng cáo, không nhận ngành đó, hoặc không hợp với loại tư liệu (nhân vật chỉ ở vị trí nhân vật). slot_ids chứa các vị trí đó.
401unauthorizedKhông có hoặc sai khóa không gian, đăng nhập trang quản lý không gian.
401sign_inNhà quảng cáo: chưa đăng nhập tài khoản Metamoa hoặc đã hết hạn.
403owner_requiredCó khóa không gian nhưng chưa xác nhận nhà vận hành không gian.
403owner_page_onlyThử xác nhận điều khoản hoặc đồng ý hiển thị quảng cáo bằng khóa không gian (chỉ làm được trong trang quản lý không gian).
403bad_ad_keySDK: space và key (mm_adpub_) không khớp.
403terms_requiredKhông gian đó chưa xác nhận điều khoản hiển thị quảng cáo.
403ads_offKhông gian đó đã tắt đồng ý hiển thị quảng cáo.
403origin_mismatchYêu cầu SDK không đến từ trang của không gian đó (cùng tên miền).
404not_houseGọi quảng cáo của chúng tôi (GET /ads/v1/house) từ nơi không phải không gian do Metamoa trực tiếp vận hành.
403not_yoursNhà quảng cáo: dùng id tệp của người khác.
404no_slotKhông có vị trí quảng cáo với tên hoặc id đó.
404not_foundKhông có chiến dịch hoặc tệp đó.
409not_listedKhông gian chưa được đưa vào danh sách (trước khi duyệt hoặc đã ẩn).
409payout_info_requiredMuốn bật đồng ý hiển thị quảng cáo nhưng chưa có loại thông tin thanh toán (cá nhân, doanh nghiệp) và liên hệ (điện thoại di động hoặc email). Nhập trong mục Kiếm tiền của trang quản lý không gian (/owner/revenue?id=<id không gian>).
409advertiser_requiredNhà quảng cáo: định đăng ký hoặc thanh toán chiến dịch trước khi nhập thông tin nhà quảng cáo (PUT /api/ads/advertiser).
409biz_doc_requiredNhà quảng cáo: nhà quảng cáo doanh nghiệp thanh toán hoặc đăng ký hợp đồng vị trí cố định trước khi tải lên bản sao giấy đăng ký kinh doanh (PUT /api/ads/advertiser/doc).
409business_onlyNhà quảng cáo: nhà quảng cáo cá nhân định tải lên bản sao giấy đăng ký kinh doanh.
400bad_docNhà quảng cáo: bản sao giấy đăng ký kinh doanh không phải PDF, JPG, PNG.
413doc_too_bigNhà quảng cáo: bản sao giấy đăng ký kinh doanh vượt quá 5MB.
503advertiser_unavailableNhà quảng cáo: máy chủ không có khóa mã hóa thông tin nhà quảng cáo nên không nhận được.
409email_not_linkedNhà quảng cáo: email của nhà quảng cáo cá nhân không phải email đã đăng nhập tài khoản Metamoa này.
409name_takenĐã có vị trí cùng tên.
409slot_limitMỗi không gian tối đa 30 vị trí của nhà vận hành, tối đa 5 vị trí SDK chưa xác nhận.
409slot_takenVị trí đã có hợp đồng vị trí cố định khác trong thời gian đó.
409tier_too_lowChọn theo hợp đồng vị trí cố định một vị trí ở không gian có lượt nhấp không gian mỗi ngày chưa đạt hạng thấp nhất. slot_ids chứa các vị trí đó.
409not_for_saleKhông có đơn giá hợp đồng vị trí cố định.
409under_minimumThấp hơn mức phí truyền thông tối thiểu. Trả về min_spend_won, spend_won.
409no_click_historyChọn CPM hoặc hợp đồng vị trí cố định cho vị trí ở không gian chưa có lịch sử lượt nhấp không gian (không đo được lượng hiển thị và hạng). Chỉ được chọn CPA và thời gian hiển thị. Trả về slot_ids, billings.
409over_inventoryNgân sách CPM vượt mức trần lượt hiển thị viewable dự kiến của các vị trí đã chọn. Trả về max_budget_won.
409rejected_fileDùng trong chiến dịch tệp đã bị chặn khi kiểm duyệt.
409wrong_stateViệc không làm được ở trạng thái đó (tạm dừng chiến dịch đang duyệt…).
409staleQuản trị viên: chiến dịch đã thay đổi sau khi mở màn hình duyệt (version của decide khác hiện tại). Xem lại rồi quyết định lại.
409already_paidĐịnh mở lại thanh toán cho chiến dịch đã thanh toán.
409not_paidQuản trị viên: định duyệt quyết toán cho chiến dịch chưa thanh toán xong.
409heldQuản trị viên: định duyệt quyết toán cho chiến dịch còn phần đang tạm giữ (hãy quyết định phần tạm giữ trước).
424hrum_failedKhông kết nối được thanh toán (Hrum). Vui lòng thử lại sau ít phút.
503pay_not_readyChưa mở được thanh toán (máy chủ chưa thiết lập).
409model_missingQuản trị viên: duyệt chiến dịch yêu cầu làm mô hình trước khi gắn mô hình.
413model_too_bigTệp mô hình vượt quá 6MB.
429too_manyQuá nhiều yêu cầu. Hãy chờ số giây ở Retry-After.

Toàn bộ đường dẫn

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