메타모아
즐겨찾기 랭킹

메타모아 3D 광고 · 3D ads

한눈에 보기

메타모아 3D 광고는 광고주의 3D 모델·광고용 건물·광고 캐릭터를 웹 메타버스 공간 안 광고 자리에 띄우고, 사람이 실제로 본 것과 한 일만 세어 광고비를 받고 그 몫을 공간운영자에게 나누는 광고예요. 광고업·광고대행업으로 대기업부터 중소기업까지 받아요.

실제 화면 · 모아 야영지
실제 화면 · 모아 야영지
실제 화면 · 모아 야영지 상점(하우스 광고)
실제 화면 · 모아 야영지 상점(하우스 광고)
실제 화면 · AI붓타 마당
실제 화면 · AI붓타 마당
실제 화면 · 반고흐 속으로
실제 화면 · 반고흐 속으로

상품 4종과 과금

금액은 모두 공급가, 부가세 별도예요.

상품billing세는 것단가
CPM (viewable 노출)cpmviewable 노출 1회 = 모델이 화면 안에 일정 몫 이상, 정해진 시간 넘게 이어서 보임(탭이 보이는 상태)viewable 1,000회당 8,000원
CPA · 모델 클릭cpa광고 모델을 탭·클릭. 클릭한 뒤 브랜드 공간 입장까지 가면 입장 1건만 청구클릭 1회당 700원
CPA · 브랜드 공간 입장cpa광고를 눌러 브랜드 공간(brand_url)으로 들어감. 서버 리다이렉트(/ads/go)로 세고, 같은 사람·캠페인은 하루 한 번입장 1회당 1,000원
노출 시간timeviewable 노출 뒤 광고가 보인 누적 시간(입력 활동이 있을 때만, 한 사람·모델 하루 상한까지)viewable 1,000초당 1,000원
공간 고정 계약fixed기간제(최대 한 달). 계약한 광고 자리를 그 기간 동안 혼자 씀(자리 단위). 노출 수는 보장하지 않음아래 등급표

공간 고정 계약 등급

등급은 그 자리가 있는 공간의 최근 14일 깨끗한 하루 공간 클릭의 중앙값으로 정해요(공간운영자 본인·데이터센터·자동화 브라우저를 빼고, 메타모아의 「들어가기」는 사람 확인을 통과한 것만 세요). 가장 낮은 등급에 못 미치는 공간의 자리는 공간 고정 계약으로 팔지 않고 성과형으로만 받아요. 계약 기간은 주간 7일 · 월간 30일 중 하나예요.

등급하루 공간 클릭주간(자리 1개)월간(자리 1개)
S1,000 이상50,000원180,000원
A300~99915,000원50,000원
B100~2995,000원18,000원

집계 공식

날짜는 한국 시간 하루 단위(ad_daily). 금액은 원 단위 아래를 버린 공급가예요. 규칙에 걸린 이벤트는 세지 않고 이유별로 따로 세요(ad_excluded).

공간운영자 수익 배분 등급

광고 수익(공간별 광고 매체 금액, 무효 트래픽을 뺀 공급가)을 공간운영자와 메타모아가 등급의 비율로 나눠요. 2026년 11월 11일 시행. 우선 등록 안내: https://metamoa.com/ads/partners

등급대상공간운영자 : 메타모아
플래티넘선착순 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끄면 이 자리에는 광고가 나가지 않아요

광고 모델의 크기는 공간에 따라 공간운영자·메타모아가 조절할 수 있어요.

캐릭터 광고는 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인 노드가 있으면 그 노드, 없으면 광고 앞면(+Z) 가운데 바닥에 SDK가 기본 문을 그려요. 거리는 걷는 캐릭터에서 문 앞까지 바닥 거리예요. 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)은 메타모아 도메인에서 Cloudflare Turnstile을 통과해야 센다. 실패해도 사용자는 브랜드 공간으로 보내고 입장만 세지 않는다. 키가 없을 때 들어온 입장은 보류한다.켬
노출 사람 확인 (turnstile_imp)SDK가 숨은 메타모아 창에서 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 전체에 image_url을 repeat만큼 반복해 입혀요. 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가 숨은 메타모아 창(Cloudflare Turnstile)에서 받은 사람 확인 패스와 함께 세요. 광고는 확인을 기다리지 않고 바로 보여요. 사이트에 Content-Security-Policy가 있으면 frame-src에 https://metamoa.com을 넣어 주세요. 확인 창이 막히거나 패스가 없으면 그 노출은 보류되고, 그 달이 끝난 뒤 그 공간의 확인 불가 비율이 20% 이하면 풀리고 넘으면 무효예요.

한 번에 20개까지. 이벤트에는 vid를 보내지 않아요. 보는 사람은 토큰 안의 값을 써요. 틀린 이벤트·남의 공간 토큰은 excluded로만 세요.

입장 · go

입장은 메타모아 도메인의 /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자까지)가 들어가요. 고양이·강아지·빈센트는 목에 거는 소품만 돼요.

캐릭터id들 수 있는 소품라이선스
창모아changmoaprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
메타뼈스metabbyeosprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
벌크업로더bulkuploaderprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
핫스팟 법사hotspotprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
방장기사bangjangprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
털갈이드teolgalprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
네일버스neilbusprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
링크블린linkblinprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
디아블롱diablongprop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bagCC0 1.0
빈센트vincentprop-neck-sign prop-badge자사 (플로트 주식회사)
냥줍고 단모 고양이cat_shortprop-neck-sign prop-badgeCC BY 4.0
냥줍고 장모 고양이cat_longprop-neck-sign prop-badgeCC BY 4.0
냥줍고 먼치킨cat_munchkinprop-neck-sign prop-badgeCC BY 4.0
냥줍고 코기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라 출처를 밝혀요. 모두 플로트 주식회사가 크기·광고 면 등을 고쳤어요.

모델 제작 요청

광고주가 「모델 제작 요청」을 고르면 우리가 3D 모델을 만들어 캠페인에 붙인 뒤 검수해요. 만들 자료(제품 사진·로고·도면)는 [email protected]로 캠페인 번호와 함께 보내 주세요.

등급grade제작비이 매체비 이상 집행하면 무료
단순 제품·간판simple50,000원 (공급가, 부가세 별도)500,000원
정밀 제품precise100,000원 (공급가, 부가세 별도)1,000,000원
새 캐릭터character100,000원 (공급가, 부가세 별도)1,000,000원

광고주: 셀프 등록 순서

  1. https://metamoa.com/ads/manage에서 메타모아 계정으로 로그인(가입도 같은 창).
  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_…"} 또는 "image" 대신 "text": "반짝 우유". 공간 고정 계약: "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_modelglb가 아님, 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광고주: 메타모아 계정 로그인이 없거나 끝남.
403owner_required공간 키는 있지만 공간운영자 확인 전.
403owner_page_only약관 확인·광고 게재 동의를 공간 키로 시도함(공간 관리 화면에서만 된다).
403bad_ad_keySDK: space와 key(mm_adpub_)가 맞지 않음.
403terms_required그 공간이 광고 게재 약관 확인을 하지 않음.
403ads_off그 공간이 광고 게재 동의를 끔.
403origin_mismatchSDK 요청이 그 공간 사이트(같은 도메인)에서 오지 않음.
404not_house우리 광고(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광고주: 개인 광고주의 이메일이 이 메타모아 계정에 로그인한 메일이 아님.
409name_taken같은 이름의 자리가 이미 있음.
409slot_limit공간마다 공간운영자 자리 30개까지, 확인 안 된 SDK 자리 5개까지.
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결제(흐름)에 연결하지 못함. 잠시 뒤 다시.
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