Metamoa
お気に入り ランキング

メタモア3D広告 · 3D ads

概要

メタモア3D広告は、広告主の3Dモデル・広告用建物・広告キャラクターをWebメタバース空間内の広告枠に表示し、人が実際に見たこと・したことだけを数えて広告費を受け取り、その分を空間運営者に分配する広告です。広告業・広告代理業として、大企業から中小企業まで受け付けます。

実際の画面 · モア野営地
実際の画面 · モア野営地
実際の画面 · モア野営地のお店(ハウス広告)
実際の画面 · モア野営地のお店(ハウス広告)
実際の画面 · AI Butta の境内
実際の画面 · AI Butta の境内
実際の画面 · Walking Into Van Gogh
実際の画面 · Walking Into Van Gogh

商品4種と課金

金額はすべて供給価格、付加価値税別です。

商品billing数えるもの単価
CPM(viewableインプレッション)cpmviewableインプレッション1回 = モデルが画面内に一定割合以上、決められた時間を超えて続けて表示(タブが表示されている状態)viewable 1,000回あたり₩8,000
CPA · モデルクリックcpa広告モデルをタップ・クリック。クリック後にブランド空間入場まで進んだ場合は入場1件のみ請求クリック1回あたり₩700
CPA · ブランド空間入場cpa広告を押してブランド空間(brand_url)に入る。サーバーのリダイレクト(/ads/go)で数え、同じ人・キャンペーンは1日1回入場1回あたり₩1,000
表示時間timeviewableインプレッション後に広告が表示された累積時間(入力操作があるときのみ、1人・1モデルの1日上限まで)viewable 1,000秒あたり₩1,000
空間固定契約fixed期間制(最長1か月)。契約した広告枠をその期間中ひとりで使用(枠単位)。インプレッション数は保証しません下の等級表

空間固定契約の等級

等級は、その枠がある空間の直近14日間のクリーンな1日空間クリックの中央値で決まります(運営者本人・データセンター網・自動化ブラウザを除き、メタモアの「入る」は人間確認を通ったものだけを数えます)。最も低い等級に届かない空間の枠は空間固定契約では販売せず、成果型のみ受け付けます。契約期間は週間7日・月間30日のいずれかです。

等級1日の空間クリック週間(枠1個)月間(枠1個)
S1,000以上₩50,000₩180,000
A300~999₩15,000₩50,000
B100~299₩5,000₩18,000

集計式

日付は韓国時間の1日単位(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個とは別に数えます。1つのIPグループは1日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」欄のスクリプト1行を、空間ページの<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を新しいウィンドウか同じウィンドウで開けばOKです。仕様は下の「イベント仕様」。

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)を新しいウィンドウで1回開きます。
  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の外に出るまで、またタブが隠れて戻った後はドアの区域を一度出るまで、再び開きません。

出入りの繰り返しで予算が減らないように

ボット・不正検証ルール

イベントはサーバーで下のルールを順に通ります。1つでも引っかかれば集計から外し、そのルール名で別途数えます。ルールはdata/ads-config.jsonのbot_rulesで1つずつオン・オフします。

ルールすること現在
ボット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)同じ人・同じモデルのインプレッションとクリックは決められた時間に1回、入場(ドアから入るを含む)は1日1回で、決められた日数の間に決められた回数まで。1つのインターネットアドレスグループの時間あたり上限、空間ごとの1日の新規視聴者数、キャンペーン・空間ごとの1日のインプレッション・クリック・入場数を超えるものは除外する。入場制限はサーバーのイベント記録で再確認し、サーバーが再起動しても忘れない。オン
サーバー署名トークン(signed_token)イベントはserveが渡した署名トークン(HMAC)を持ってくる必要がある。見る人とserve時のインターネットアドレスグループがトークン内に署名され、別のアドレスから来たインプレッションは除外し、serve後に決められた時間が経つ前のインプレッションも除外する。トークンは有効時間内にインプレッション・クリック・入場をそれぞれ1回だけ数える。キャンペーン予算は数えるときに再確認し、超えるイベントは数えない(budget)。オン
表示時間の測定(view_time)表示時間は、その間にカメラ・ポインター入力があるときのみ、トークンごと・1人と1モデルごとの1日・1インターネットアドレスと1モデルごとの1日の上限までのみ数える。オン
空間運営者本人のトラフィック(owner_traffic)その空間の空間管理画面を開いたインターネットアドレスから来たイベントは、決められた日数の間除外する。オン
人の入力の痕跡(human_input)クリックはブラウザが人の入力と表示した(isTrusted)ものだけを数える。インプレッションは入力数を見ない(じっと見ている人、キーボード・スクリーンリーダー利用者)。オン
異常値の監視と保留(anomaly)1人が1日に決められた数を超えて見たインプレッションは除外する。CPAのクリック・入場は空間ごとの1日の自動承認数まで数え、超えた分は保留する。クリック・入場率(その空間を除いたネットワークと比較)、空間クリックに対するインプレッション、インターネットアドレスあたりの新規視聴者、データセンターの割合、同じアドレスの繰り返し、クリックに対する入場が基準を超えると、その空間のその月の取り分を保留し、管理者が判定する。オン
データセンター網(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: /)

広告用建物・キャラクターとアップロード仕様

モデルのない広告主は、私たちが提供する広告用建物か基本広告キャラクターを選びます。建物は2つの方式から1つを選びます:画像型(決められた板に画像を1枚ずつ)· テクスチャ型(建物の表面全体にテクスチャ・パターンを1枚)。

モデル種類基本サイズ(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以上(1枚が前・横・後ろ・上の面に表示)

テクスチャ型は、基本テンプレート(正方形PNG)をダウンロードして編集した後、同じサイズ(1024〜2048px)でアップロードします。線入りテンプレートのピンクの線は表面パーツの境界で、パーツの内側だけを塗るとその表面に表示されます。

広告ショップ(shop-ad)は、アップロードした画像1枚が前・横・後ろ・上の面に表示されます:前の看板、両側、後ろ、屋根の上の板がすべて同じ比率なので、どちらから見ても、上から見下ろしても読めます。ドアがあるので「ドアから入る」("door": true)を使えます。

基本広告キャラクターは金額にかかわらず無料です。character枠に立つか歩き回り、首かけ看板・社員証・手持ちプラカード・風船・旗・ショッピングバッグなどの小物を骨に付けて持ち、小物の板に広告画像か看板の文字(12文字まで)が入ります。ネコ・イヌ・ヴィンセントは首にかける小物のみ使えます。

キャラクター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でメタモアアカウントにログイン(登録も同じウィンドウで)。
  2. キャンペーン作成:名前・ブランド・業種、ブランド空間のアドレス(入場CPAを使うとき)。
  3. 広告物:① 自分の3Dモデル(glb)をアップロード ② 広告用建物を選ぶ → 画像型なら板ごとに画像、テクスチャ型ならテクスチャ1枚 ③ 基本広告キャラクター + 小物を選ぶ → 小物の板に画像か看板の文字 ④ モデル制作依頼(等級を選択)。仕様とプレビューが表示されます。
  4. 表示空間:広告掲載に同意した空間の一覧から、カテゴリ・現在の接続者数・1日の空間クリックを見て枠を自分で選ぶか、「おすすめで」を押すと業種・カテゴリ・トラフィックに合わせた空間のセットをおすすめします。
  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": "…"}。

建物・自分のモデルの広告物には、さらに2つを入れられます(任意):"tagline": "一行説明"(30文字まで、文字のみ — タグ・山括弧・波括弧は不可(400 invalid、fields creative)、広告物と一緒に審査)は広告ショップ・建物看板の下の帯(メッシュad_tagline)に描かれ、serveのad.tagline { text, mesh, aspect }で届きます。"door": trueは「ドアから入る」です(brand_urlが必要)。/ads/manageステップ2の「一行説明」・「ドアから入る」欄と同じです。

審査

エラーコード

エラー本文は { "error": "<コード>", "message": "<次にすることを1行で>" } で、項目エラーは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_low1日の空間クリックが最も低い等級に届かない空間の枠を、空間固定契約で選んだ。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