メタモア3D広告 · 3D ads
概要
メタモア3D広告は、広告主の3Dモデル・広告用建物・広告キャラクターをWebメタバース空間内の広告枠に表示し、人が実際に見たこと・したことだけを数えて広告費を受け取り、その分を空間運営者に分配する広告です。広告業・広告代理業として、大企業から中小企業まで受け付けます。
- 空間運営者:空間管理の収益化(/owner/revenue)の「広告掲載を登録する」(規約確認・精算情報・広告枠)→ スクリプト1行と広告枠を入れれば完了。
- 広告主:/ads/manageでメタモアアカウントにログイン → 3Dモデル(glb)をアップロード、または広告用建物を選んで画像・テクスチャを入れる、または基本広告キャラクターに小物と広告を選ぶ → 表示空間を自分で選ぶか「おすすめで」→ 課金方式・予算・期間 → 審査後に配信。
- モデルがなければ「モデル制作依頼」を選ぶと私たちが作ります。モデルを直接いただいても受け付けます。基本広告キャラクターは金額にかかわらず無料です。
- 課金は4種類:CPM(viewableインプレッション)、CPA(モデルクリック・ブランド空間入場)、表示時間(表示された累積時間)、空間固定契約(期間制、枠の独占)。金額はすべて(供給価格、付加価値税別)。
- 広告モデルの大きさは、空間に応じて空間運営者・メタモアが調整することがあります。




商品4種と課金
金額はすべて供給価格、付加価値税別です。
| 商品 | billing | 数えるもの | 単価 |
|---|---|---|---|
| CPM(viewableインプレッション) | cpm | viewableインプレッション1回 = モデルが画面内に一定割合以上、決められた時間を超えて続けて表示(タブが表示されている状態) | viewable 1,000回あたり₩8,000 |
| CPA · モデルクリック | cpa | 広告モデルをタップ・クリック。クリック後にブランド空間入場まで進んだ場合は入場1件のみ請求 | クリック1回あたり₩700 |
| CPA · ブランド空間入場 | cpa | 広告を押してブランド空間(brand_url)に入る。サーバーのリダイレクト(/ads/go)で数え、同じ人・キャンペーンは1日1回 | 入場1回あたり₩1,000 |
| 表示時間 | time | viewableインプレッション後に広告が表示された累積時間(入力操作があるときのみ、1人・1モデルの1日上限まで) | viewable 1,000秒あたり₩1,000 |
| 空間固定契約 | fixed | 期間制(最長1か月)。契約した広告枠をその期間中ひとりで使用(枠単位)。インプレッション数は保証しません | 下の等級表 |
空間固定契約の等級
等級は、その枠がある空間の直近14日間のクリーンな1日空間クリックの中央値で決まります(運営者本人・データセンター網・自動化ブラウザを除き、メタモアの「入る」は人間確認を通ったものだけを数えます)。最も低い等級に届かない空間の枠は空間固定契約では販売せず、成果型のみ受け付けます。契約期間は週間7日・月間30日のいずれかです。
| 等級 | 1日の空間クリック | 週間(枠1個) | 月間(枠1個) |
|---|---|---|---|
| S | 1,000以上 | ₩50,000 | ₩180,000 |
| A | 300~999 | ₩15,000 | ₩50,000 |
| B | 100~299 | ₩5,000 | ₩18,000 |
- 最低出稿:媒体費₩10,000(供給価格、付加価値税別)、モデル制作費を除く。成果型は予算、空間固定契約は契約金額の合計で判断します。
- 成果型(CPM・CPA・表示時間)は実際に数えた分だけ請求し、使った金額が予算(budget_won)に達するとそのキャンペーンは配信されなくなります。
- CPM契約は、選んだ枠の予想viewableインプレッション(1日の空間クリック × 0.7 × 日数)の70%までのみ受け付けます(409 over_inventory)。
- CPA・表示時間型は止めませんが、予算が予想出稿額より大きいと/ads/manageが申込前にお知らせします:同じ予想viewableインプレッションに、CPAはクリック率基準線2% × クリック・入場単価の大きい方、表示時間は1人1日60秒を掛けます(GET /api/ads/optionsのspend_estimate)。
- 空間固定契約が入った枠には、その期間中そのキャンペーンだけが配信され、同じ枠・重なる期間の固定契約は受け付けません(409 slot_taken)。枠は審査承認時に確保されます:審査待ちの申込は枠を押さえず、先に承認された契約が優先されます。モデルが表示されない日があったり、トラフィックが30%を超えて落ちた場合は、日割り返金または延長で調整します。
- 請求と等級は、メタモアの実測レポート(viewableインプレッション・クリック・入場・表示時間、空間クリック)に基づきます。
集計式
日付は韓国時間の1日単位(ad_daily)。金額はウォン未満を切り捨てた供給価格です。ルールに引っかかったイベントは数えず、理由別に別途数えます(ad_excluded)。
- viewableインプレッション imps = すべてのルールを通過した
impイベント数 - クリック clicks = 通過した
click数、入場 enters = 通過した入場(/ads/go)数、converted = クリック後に同じトークンで入場まで進んだ数 - 表示時間 view_ms = 通過した
timeイベントのms合計(インプレッションが数えられたトークンのみ、イベントごとに15,000msまで、1人・1モデルの1日上限まで) - CPM金額 = floor(imps × cpm_won ÷ 1,000)
- CPA金額 = (clicks − converted) × click_won + enters × enter_won
- 表示時間金額 = floor(view_ms ÷ 1,000 × time_1000s_won ÷ 1,000)
- 空間固定契約金額 = 契約した枠ごとの等級単価の合計。期間の一部だけを集計する場合は枠ごとに floor(単価 × その期間内の契約日数 ÷ 契約日数)
- 空間運営者の取り分 = floor(空間別金額 × その空間の空間運営者等級の比率(%) ÷ 100)。金額は無効トラフィックを除いた媒体供給価格で、モデル・空間制作費は分配しません。等級は下の「空間運営者の収益分配等級」。
空間運営者の収益分配等級
広告収益(空間別の広告媒体金額、無効トラフィックを除いた供給価格)を、空間運営者とメタモアが等級の比率で分けます。2026年11月11日施行。優先登録のご案内:https://metamoa.com/ads/partners
| 等級 | 対象 | 空間運営者 : メタモア |
|---|---|---|
| プラチナ | 先着1〜10番目の空間運営者 | 9:1 |
| ゴールド | 11〜100番目の空間運営者(90名) | 8:2 |
| シルバー | それ以降の空間運営者 | 7:3 |
| ブロンズ | 2027年1月1日から新たに契約する空間運営者 | 6:4 |
今後、広告成果に応じて比率は調整されることがあります。
- 空間運営者 = メタモアに空間を登録し、空間管理にログインした所有アカウント単位です。順番は、空間管理で初めて「広告掲載同意」をオンにした時刻順で、サーバーが1件ずつ付けます。
- 一度決まった等級はそのまま維持され、同じ空間運営者の他の空間も同じ等級です。
- 2027年1月1日0時(韓国時間)から新たに契約する空間運営者は、順番にかかわらずブロンズです。
- 自分の等級と比率:空間管理の「3D広告」欄、GET /api/space/{id}/adsのpartner。残り枠:GET /api/ads/partnersのseats。
- 現在の残り枠:プラチナ 0/10 · ゴールド 80/90
規約確認と広告掲載同意
利用規約に広告掲載条項(第4条の4)が入りました。広告を受けるには、空間運営者が空間管理の収益化の「広告掲載を登録する」で2つを一度に行います。
- 規約確認:空間管理(/owner/revenue?id=<空間 id>)「広告掲載を登録する」ステップ1の規約確認チェック。空間管理画面でのみ可能です(空間キーでは403 owner_page_only)。
- 広告掲載同意:規約確認と一緒にオンになり、その後は同じ画面で空間ごとにオン・オフします。オンにするには精算情報の種別と連絡先が必要です(なければ409 payout_info_required)。オンにするとその空間の広告API(スクリプト1行・広告キー)が表示され、オフにするとすぐに広告が配信されなくなります(serve 403 ads_off)。
同意記録:空間、誰が(その空間管理にログインした空間運営者メールのハッシュ)、いつ、どの規約版(terms.htmlのdata-ads-version)、オン・オフを削除せずに蓄積します(ad_consents)。
規約確認をしていない、または広告掲載同意をオフにした空間、一覧に載っていない空間には広告は配信されません。
広告枠(スロット)
空間運営者が自分のメタバース内で広告が立つ場所を直接決めます。広告主は枠単位で選ぶかおすすめを受け、空間固定契約も枠単位でまとめます。枠の一覧は空間管理画面で確認し、オン・オフできます。
| 項目 | 形式 | 意味 |
|---|---|---|
| name | 1〜40文字 | 空間内で重複しない名前 |
| kind | floor · 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] |
| roam | 0〜50 メートル | character枠:キャラクターが歩き回る半径(0なら立っている) |
| industries | 業種idの一覧 | この枠が受ける業種。空ならすべての業種 |
| enabled | true · 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}空間運営者:導入の手順
- 空間管理の収益化(
https://metamoa.com/owner/revenue?id=<空間 id>)の「広告掲載を登録する」で規約確認にチェックし、広告を始めます。 - 同じ画面の「広告API」欄のスクリプト1行を、空間ページの<head>か<body>の最後に入れます。広告キー(mm_adpub_)は公開してもよいキーです(空間キーmm_live_は入れないでください)。
- three.jsの空間なら、シーンが作られた後にattachとslotを呼びます。枠は初めて呼んだときにオフの状態で登録されます。空間管理の「広告枠」でオンにすると広告が配信されます(枠APIで最初からオンの状態で作っても構いません)。
- 広告が表示されれば完了です。viewableインプレッション・クリック・表示時間はSDKが自動で送り、ブランド空間入場は広告を押すとSDKが/ads/goを開いてサーバーが数えます。
- 空間管理の「広告枠」で枠をオン・オフし、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の数え方
- viewableインプレッション:モデルの決められた割合以上がカメラ画面内にあり、画面に映る大きさが決められた面積以上のまま、タブが表示されている間に決められた時間を超えて続くと、インプレッション1回を送ります(serveトークン1つにつき1回)。
- 表示時間:インプレッション後、広告が上の条件で表示されている間5秒ごとに積算して送り、その間のカメラ・ポインター入力数も一緒に送ります(タブが隠れると停止)。
- serve応答にvidが来たらそのブラウザに保存し、次のserveから一緒に送ります(GET /ads/v1/serve?…&vid=)。vidはサーバーがそのネットワークに署名した値だけが読まれます。サーバーがvidと接続IPグループを合わせて、その人をトークン内に署名して入れます。インプレッションはserveから2秒ほど経ってから数えます。
- クリック:広告をタップ・クリックすると
clickを送り、広告にブランド空間があればenter_url(/ads/go)を新しいウィンドウで開きます。サーバーが入場を数えてブランド空間へ送ります。 - ドア:ad.doorがあれば、歩いてドアから入るときにenter_urlを新しいウィンドウで1回開きます。再び開く条件は下の「ドアから入る」。
- ブラウザid(vid)はサーバーが渡し、SDKがlocalStorageに保存します。繰り返し制限にのみ使います。名前・連絡先などの個人情報は送りません。
- 広告は30分ごとに新しく受け取ります(新しいトークン)。キャラクター枠はroam半径内をゆっくり歩きます。
ドアから入る
広告用建物や自分の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.2m以内に入ると、ブランド空間(enter_urlに&via=door)を新しいウィンドウで1回開きます。
- 新しく開いたウィンドウを閉じて戻り、ドアの中やドアの近くで少し動いても、ドアは再び開きません。
- ドアから3mより遠くへ歩いて出てから、再び入ってはじめて再度開きます(入る距離1.2m < 出る距離3m)。
- タブが隠れているかウィンドウにフォーカスがない間は開かず、戻った後もドアの区域を一度出る必要があります。ページを開いたときにすでにドアの中に立っていても開きません。
- 建物をタップ・クリックして開くのはこれまでどおりです(クリックのたびに)。ドアのルールは歩いて入る場合にのみ適用されます。
- ブラウザが新しいウィンドウをブロックすると、画面下に「<ブランド>を開く」ボタンが表示されます。そのボタンを押すと開きます(押さずにドアから離れると消えます)。
ドアの位置: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の外に出るまで、またタブが隠れて戻った後はドアの区域を一度出るまで、再び開きません。
出入りの繰り返しで予算が減らないように
- ドアからの入場は、CPA入場1件と同じ単価で数えます(単価・最低出稿はそのまま)。
- 1人(サーバーが渡したブラウザid + インターネットアドレスグループ)・1キャンペーンの入場は24時間に1回、30日に3回までのみ数えます。同じインターネットアドレスグループはキャンペーン・空間ごとに1日3回までです。
- それ以上出入りした入場は、ブランド空間へは送りますが請求せず、記録だけします(除外理由 repeat_limit)。サーバーのイベント記録(ハッシュのみ)で再確認するので、サーバーが再起動しても忘れません。
- 同じserveトークンの入場は1回だけ数え、インプレッションが先に数えられたトークンだけを数えます(ボット・不正検証ルールのまま)。
ボット・不正検証ルール
イベントはサーバーで下のルールを順に通ります。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を動かし、得たパス(そのネットワークと空間に結び付く)を表示に付けます。通過は数え、確認失敗は除きます。パスがなければその表示だけ保留し、月が終わると空間の確認不可の割合で解除か無効にします(管理者が解除できます)。広告は常にそのまま表示されます。 | オン |
- クリックと入場は、そのトークンのインプレッションが先に数えられた場合にのみ数えます(そうでなければno_impression)。
- サーバーが記憶する表がいっぱいになると、まだ期間が残っている記録は消さず、新しいイベントを数えません(capacity)。止める側に閉じます。
イベント仕様
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 | 項目 | 意味 |
|---|---|---|
| imp | token, ms, area, inside, vis, focus, inputs, wd | ms:続けて表示された時間、area:画面面積に対するモデル面積(0〜1)、inside:モデルのうち画面内の割合(0〜1)、vis·focus:タブ表示・ウィンドウフォーカス、inputs:その間のカメラ・ポインター入力数、wd:navigator.webdriver |
| time | token, ms, vis, inputs, wd | 前回のtime以降に表示された時間(15,000msまで)とその間の入力数 |
| click | token, 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枚)。
テクスチャ型は、基本テンプレート(正方形PNG)をダウンロードして編集した後、同じサイズ(1024〜2048px)でアップロードします。線入りテンプレートのピンクの線は表面パーツの境界で、パーツの内側だけを塗るとその表面に表示されます。
広告ショップ(shop-ad)は、アップロードした画像1枚が前・横・後ろ・上の面に表示されます:前の看板、両側、後ろ、屋根の上の板がすべて同じ比率なので、どちらから見ても、上から見下ろしても読めます。ドアがあるので「ドアから入る」("door": true)を使えます。
基本広告キャラクターは金額にかかわらず無料です。character枠に立つか歩き回り、首かけ看板・社員証・手持ちプラカード・風船・旗・ショッピングバッグなどの小物を骨に付けて持ち、小物の板に広告画像か看板の文字(12文字まで)が入ります。ネコ・イヌ・ヴィンセントは首にかける小物のみ使えます。
| キャラクター | id | 持てる小物 | ライセンス |
|---|---|---|---|
| Changmoa | changmoa | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Metappyeoseu | metabbyeos | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Bulk Uploader | bulkuploader | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Hotspot Wizard | hotspot | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Bangjang Knight | bangjang | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Teolgalide | teolgal | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Nailbus | neilbus | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Linkblin | linkblin | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Diablong | diablong | prop-neck-sign prop-badge prop-picket prop-balloon prop-flag prop-shopping-bag | CC0 1.0 |
| Vincent | vincent | prop-neck-sign prop-badge | 自社(FLOAT Co., Ltd.) |
| Nyangjupgo 短毛のネコ | cat_short | prop-neck-sign prop-badge | CC BY 4.0 |
| Nyangjupgo 長毛のネコ | cat_long | prop-neck-sign prop-badge | CC BY 4.0 |
| Nyangjupgo マンチカン | cat_munchkin | prop-neck-sign prop-badge | CC BY 4.0 |
| Nyangjupgo コーギー | dog_corgi | prop-neck-sign prop-badge | CC BY 4.0 |
| 小物 | id | 画像の比率・最小サイズ |
|---|---|---|
| 首かけ看板(社員証タイプ) | prop-badge | 720:1024、360×512px以上 |
| 風船 | prop-balloon | 1024:1024、512×512px以上 |
| 手旗 | prop-flag | 1024:688、512×344px以上 |
| 首にかける立て札 | prop-neck-sign | 1024:720、512×360px以上 |
| 手持ちプラカード | prop-picket | 1024:720、512×360px以上 |
| ショッピングバッグ | prop-shopping-bag | 1024:1024、512×512px以上 |
- 画像形式:PNG · JPEG · WEBP、2MBまで、縦横4096pxまで、比率の誤差2%まで。アップロードした画像はWebPで保存し直します(写真情報は消去されます)。
- 3Dモデル:glTF 2.0バイナリ(.glb)1ファイル、6MBまで、テクスチャはファイル内、外部アドレス(uri)なし。
- アップロードしたファイルは内容(マジックバイト)で形式を確認します:画像はPNG・JPEG・WebPのみ(SVG・HTMLなどは受け付けない)受け付けてWebPに作り直し、モデルはglTF 2.0バイナリのみ受け付けます。広告ファイルは固定形式(image/webp、model/gltf-binary)・nosniff・sandboxポリシーでのみ配信し、スクリプトとして実行されません。
- 広告モデルの大きさは、空間に応じて空間運営者・メタモアが調整することがあります。
- モデル・キャラクターのファイルは/ads/models/の下にあり、スクリプトが許可されない応答(固定形式・nosniff・sandbox)でのみ配信されます。一覧と出典はdocs/ads/MODELS.md、変更するときはscripts/ads-import-models.mjsでdata/ads-buildings.jsonとファイルを一緒に作り直します。
モデルの出典表記
基本モデルはCC0(パブリックドメイン)・自社制作がほとんどで、以下はCC BYのため出典を明記します。すべてFLOAT Co., Ltd.がサイズ・広告面などを修正しました。
- スタンドビルボード:"Blank Billboard" by Jarlan Perez(https://poly.pizza/m/1E0d2B7bC8e)、CC BY 3.0(https://creativecommons.org/licenses/by/3.0/)、FLOAT Co., Ltd.が修正
- ポップアップブース:"Carnival Booth" by sirkitree(https://poly.pizza/m/4NizXJZsuO2)、CC BY 3.0(https://creativecommons.org/licenses/by/3.0/)、FLOAT Co., Ltd.が修正
- バス停の広告板:"Bus Stop" by Zsky(https://poly.pizza/m/OWczicNWhO)、CC BY 3.0(https://creativecommons.org/licenses/by/3.0/)、FLOAT Co., Ltd.が修正
- A型看板:"Sandwich Board" by Anonymous(https://poly.pizza/m/ejy0W_7cHWT)、CC BY 3.0(https://creativecommons.org/licenses/by/3.0/)、FLOAT Co., Ltd.が修正
- Nyangjupgo 短毛のネコ:"Cat" by Polyfork(https://polyfork.dev/asset/cat-base)、CC BY 4.0、FLOAT Co., Ltd.がボクセルに修正
- Nyangjupgo 長毛のネコ:"Cat" by Polyfork(https://polyfork.dev/asset/cat-base)、CC BY 4.0、FLOAT Co., Ltd.がボクセルに修正
- Nyangjupgo マンチカン:"Cat" by Polyfork(https://polyfork.dev/asset/cat-base)、CC BY 4.0、FLOAT Co., Ltd.がボクセルに修正
- Nyangjupgo コーギー:"Dog" by Polyfork(https://polyfork.dev/asset/dog-base)、CC BY 4.0、FLOAT Co., Ltd.がボクセルに修正
モデル制作依頼
広告主が「モデル制作依頼」を選ぶと、私たちが3Dモデルを作ってキャンペーンに付けた後、審査します。制作用の資料(製品写真・ロゴ・図面)は[email protected]へキャンペーン番号と一緒にお送りください。
| 等級 | grade | 制作費 | この媒体費以上の出稿で無料 |
|---|---|---|---|
| シンプルな製品・看板 | simple | ₩50,000(供給価格、付加価値税別) | ₩500,000 |
| 精密な製品 | precise | ₩100,000(供給価格、付加価値税別) | ₩1,000,000 |
| 新しいキャラクター | character | ₩100,000(供給価格、付加価値税別) | ₩1,000,000 |
- 無料の基準は実際の出稿媒体費(契約全期間の合計、最大3か月、モデリング・付加価値税・無効トラフィックを除く)で判断します。
- 無料で作ったモデルはメタモアでの配信用の使用権のみをお渡しし(著作権はメタモア、譲渡は制作費を受けて)、修正は1回です。広告主の都合で解約・減額する場合は制作費を比例で請求します:制作費 × (1 − 実際の出稿媒体費 ÷ 無料の基準)。有料モデルは修正2回です。
- 基本広告キャラクター(モア野営地・Nyangjupgoのキャラクター)は、制作依頼なしで金額にかかわらず無料で使えます。
広告主:セルフ登録の手順
- https://metamoa.com/ads/manageでメタモアアカウントにログイン(登録も同じウィンドウで)。
- キャンペーン作成:名前・ブランド・業種、ブランド空間のアドレス(入場CPAを使うとき)。
- 広告物:① 自分の3Dモデル(glb)をアップロード ② 広告用建物を選ぶ → 画像型なら板ごとに画像、テクスチャ型ならテクスチャ1枚 ③ 基本広告キャラクター + 小物を選ぶ → 小物の板に画像か看板の文字 ④ モデル制作依頼(等級を選択)。仕様とプレビューが表示されます。
- 表示空間:広告掲載に同意した空間の一覧から、カテゴリ・現在の接続者数・1日の空間クリックを見て枠を自分で選ぶか、「おすすめで」を押すと業種・カテゴリ・トラフィックに合わせた空間のセットをおすすめします。
- 課金方式(CPM・CPA・表示時間・空間固定契約)・予算・期間を決めて申込 → 審査待ち。
- 審査(わいせつ・暴力・著作権の疑いなど)を通過すると配信されます。配信中のキャンペーンは停止・再開でき、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の「一行説明」・「ドアから入る」欄と同じです。
審査
- アップロードされたモデル・画像とキャンペーンは、掲載前に審査待ち(review)です。管理者が承認すると配信(active)、却下するとrejectedと理由が残ります。
- 画像はアップロード時にAI画像検査でわいせつ・暴力・他人のロゴ・キャラクターを先に確認し、引っかかればすぐにブロックします(rejected)。検査ができない場合は管理者が直接確認します。
- モデルは管理者が直接開いて確認します。わいせつ・暴力・著作権の疑いがあれば却下します。
エラーコード
エラー本文は { "error": "<コード>", "message": "<次にすることを1行で>" } で、項目エラーはfields、上限はretry_afterが一緒に届きます。
| HTTP | error | 意味 |
|---|---|---|
| 400 | invalid | 項目の形式が誤っている。fieldsに誤った項目が入る。 |
| 400 | bad_model | glbではない、glTF 2.0ではない、外部アドレス(uri)が含まれている。reasonに理由。 |
| 400 | bad_image | 画像の形式・サイズ・比率が仕様と異なる。reason(format・bytes・too_large・too_small・aspect)とspecが届く。 |
| 400 | bad_building | 枠のdefault_buildingがGET /ads/v1/buildingsの建物・立て札のidではない(空の値は可)。 |
| 400 | slot_unavailable | 選んだ枠が広告を受けない、その業種を受けない、または広告物の種類と合わない(キャラクターはキャラクター枠のみ)。slot_idsにその枠。 |
| 401 | unauthorized | 空間キー・空間管理ログインがない、または誤っている。 |
| 401 | sign_in | 広告主:メタモアアカウントのログインがない、または期限切れ。 |
| 403 | owner_required | 空間キーはあるが、空間運営者の確認前。 |
| 403 | owner_page_only | 規約確認・広告掲載同意を空間キーで試みた(空間管理画面でのみ可能)。 |
| 403 | bad_ad_key | SDK:spaceとkey(mm_adpub_)が一致しない。 |
| 403 | terms_required | その空間が広告掲載規約の確認をしていない。 |
| 403 | ads_off | その空間が広告掲載同意をオフにした。 |
| 403 | origin_mismatch | SDKリクエストがその空間のサイト(同じドメイン)から来ていない。 |
| 404 | not_house | 私たちの広告(GET /ads/v1/house)を、メタモアが直接運営する空間以外から呼んだ。 |
| 403 | not_yours | 広告主:他人のファイルidを使った。 |
| 404 | no_slot | その名前・idの広告枠がない。 |
| 404 | not_found | そのキャンペーン・ファイルがない。 |
| 409 | not_listed | 一覧に載っていない(承認前・非表示)空間。 |
| 409 | payout_info_required | 広告掲載同意をオンにしようとしたが、精算情報の種別(個人・事業者)と連絡先(携帯電話かメール)がない。空間管理の収益化(/owner/revenue?id=<空間 id>)で入力する。 |
| 409 | advertiser_required | 広告主:広告主情報(PUT /api/ads/advertiser)を入れる前にキャンペーンを申し込む、または決済しようとした。 |
| 409 | biz_doc_required | 広告主:事業者の広告主が事業者登録証の写し(PUT /api/ads/advertiser/doc)をアップロードする前に決済、または空間固定契約を申し込んだ。 |
| 409 | business_only | 広告主:個人の広告主が事業者登録証の写しをアップロードしようとした。 |
| 400 | bad_doc | 広告主:事業者登録証の写しがPDF・JPG・PNGではない。 |
| 413 | doc_too_big | 広告主:事業者登録証の写しが5MBを超えた。 |
| 503 | advertiser_unavailable | 広告主:サーバーに広告主情報の暗号化キーがなく、受け付けられない。 |
| 409 | email_not_linked | 広告主:個人の広告主のメールが、このメタモアアカウントにログインしたメールではない。 |
| 409 | name_taken | 同じ名前の枠がすでにある。 |
| 409 | slot_limit | 空間ごとに空間運営者の枠30個まで、未確認のSDK枠5個まで。 |
| 409 | slot_taken | その期間に別の空間固定契約が入っている枠。 |
| 409 | tier_too_low | 1日の空間クリックが最も低い等級に届かない空間の枠を、空間固定契約で選んだ。slot_idsにその枠。 |
| 409 | not_for_sale | 空間固定契約の単価がない。 |
| 409 | under_minimum | 最低出稿媒体費より少ない。min_spend_won、spend_wonが届く。 |
| 409 | no_click_history | 空間クリックの履歴がまだない空間の枠を、CPM・空間固定契約で選んだ(インプレッション量・等級を測れない)。CPA・表示時間型のみ可能。slot_ids、billingsが届く。 |
| 409 | over_inventory | CPM予算が、選んだ枠の予想viewableインプレッションの上限を超えた。max_budget_wonが届く。 |
| 409 | rejected_file | 審査でブロックされたファイルをキャンペーンに使った。 |
| 409 | wrong_state | その状態ではできないこと(審査中のキャンペーンの停止など)。 |
| 409 | stale | 管理者:審査画面を開いた後にキャンペーンが変わった(decideのversionが現在のものと異なる)。新しく確認して再度決定。 |
| 409 | already_paid | すでに決済したキャンペーンで決済を再度開こうとした。 |
| 409 | not_paid | 管理者:決済が終わっていないキャンペーンの精算を承認しようとした。 |
| 409 | held | 管理者:保留中の取り分があるキャンペーンの精算を承認しようとした(保留を先に判定)。 |
| 424 | hrum_failed | 決済(Hrum)に接続できなかった。しばらくしてから再度。 |
| 503 | pay_not_ready | 決済をまだ開けない(サーバー設定前)。 |
| 409 | model_missing | 管理者:モデル制作依頼のキャンペーンにモデルを付ける前に承認した。 |
| 413 | model_too_big | モデルファイルが6MBを超えた。 |
| 429 | too_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