Iklan 3D Metamoa · 3D ads
Pendaftaran awal operator ruang · lihat tingkat bagi hasil
Sekilas
Iklan 3D Metamoa menempatkan model 3D, gedung iklan, atau karakter iklan milik pengiklan di slot iklan di dalam ruang metaverse web, hanya menghitung apa yang benar-benar dilihat dan dilakukan orang, menagih biaya iklan berdasarkan itu, dan membagi porsinya kepada operator ruang. Sebagai usaha periklanan dan agensi iklan, kami menerima mulai dari perusahaan besar hingga usaha kecil dan menengah.
- Operator ruang: di Monetisasi pada konsol ruang (/owner/revenue), gunakan 「Daftar untuk iklan」 (cek ketentuan, info pembayaran, slot iklan) → pasang satu baris skrip dan slot iklan, selesai.
- Pengiklan: masuk dengan akun Metamoa di /ads/manage → unggah model 3D (glb), atau pilih gedung iklan lalu tambahkan gambar atau tekstur, atau pilih properti dan iklan untuk karakter iklan dasar → pilih sendiri ruang tayang atau gunakan 「Rekomendasi」 → jenis penagihan, anggaran, dan periode → tayang setelah ditinjau.
- Belum punya model? Pilih 「Minta dibuatkan model」 dan kami akan membuatnya. Model milik Anda sendiri juga kami terima. Karakter iklan dasar gratis berapa pun nilainya.
- Ada empat cara penagihan: CPM (tayangan viewable), CPA (klik model, masuk ke ruang merek), waktu tayang (total waktu terlihat), dan kontrak slot tetap (per periode, slot eksklusif). Semua nominal adalah (harga sebelum pajak, belum termasuk PPN).
- Ukuran model iklan dapat disesuaikan oleh operator ruang atau Metamoa tergantung ruangnya.




4 produk dan penagihan
Semua nominal adalah harga sebelum pajak, belum termasuk PPN.
| Produk | billing | Yang dihitung | Harga satuan |
|---|---|---|---|
| CPM (tayangan viewable) | cpm | 1 tayangan viewable = model berada di layar minimal sebesar porsi yang ditentukan, tanpa terputus lebih lama dari waktu yang ditentukan (saat tab terlihat) | ₩8,000 per 1,000 viewable |
| CPA · klik model | cpa | Ketuk atau klik pada model iklan. Jika setelah klik berlanjut masuk ke ruang merek, hanya 1 kali masuk itu yang ditagih | ₩700 per 1 klik |
| CPA · masuk ke ruang merek | cpa | Mengetuk iklan lalu masuk ke ruang merek (brand_url). Dihitung lewat pengalihan server (/ads/go); sekali sehari per orang dan kampanye | ₩1,000 per 1 kali masuk |
| Waktu tayang | time | Total waktu iklan terlihat setelah tayangan viewable (hanya saat ada interaksi, sampai batas harian per orang dan model) | ₩1,000 per 1,000 detik viewable |
| Kontrak slot tetap | fixed | Per periode (maksimal satu bulan). Anda memakai slot iklan yang dikontrak secara eksklusif selama periode itu (per slot). Jumlah tayangan tidak dijamin | Lihat tabel tingkat di bawah |
Tingkat kontrak slot tetap
Tingkat ditentukan dari median klik ruang harian yang bersih dalam 14 hari terakhir pada ruang tempat slot itu berada (tanpa kunjungan operator sendiri, jaringan pusat data, dan peramban otomatis; “Masuk” di metamoa hanya dihitung setelah pemeriksaan manusia). Slot di ruang yang belum mencapai tingkat terendah tidak dijual sebagai kontrak slot tetap, hanya diterima sebagai iklan berbasis kinerja. Periode kontrak adalah mingguan (7 hari) atau bulanan (30 hari).
| Tingkat | Klik ruang harian | Mingguan (1 slot) | Bulanan (1 slot) |
|---|---|---|---|
| S | 1,000 ke atas | ₩50,000 | ₩180,000 |
| A | 300~999 | ₩15,000 | ₩50,000 |
| B | 100~299 | ₩5,000 | ₩18,000 |
- Belanja minimum: biaya media ₩10,000 (harga sebelum pajak, belum termasuk PPN), tidak termasuk biaya pembuatan model. Untuk iklan berbasis kinerja yang dihitung adalah anggarannya; untuk kontrak slot tetap, total nilai kontraknya.
- Iklan berbasis kinerja (CPM, CPA, waktu tayang) hanya menagih apa yang benar-benar dihitung, dan kampanye berhenti tayang begitu belanjanya mencapai anggaran (budget_won).
- Kontrak CPM hanya diterima sampai 70% dari perkiraan tayangan viewable slot yang dipilih (klik ruang harian × 0.7 × jumlah hari) (409 over_inventory).
- Iklan CPA dan waktu tayang tidak diblokir, tetapi jika anggaran lebih besar dari perkiraan belanja, /ads/manage memberi tahu sebelum pengajuan: pada perkiraan tayangan viewable yang sama, CPA dikalikan rasio klik acuan 2% × harga yang lebih besar antara harga klik dan harga masuk, dan waktu tayang dikalikan 60 detik per orang per hari (spend_estimate dari GET /api/ads/options).
- Slot dengan kontrak slot tetap hanya menayangkan kampanye itu selama periodenya, dan kontrak tetap lain untuk slot yang sama dengan tanggal yang tumpang tindih tidak diterima (409 slot_taken). Slot dikunci saat peninjauan menyetujuinya: pengajuan yang menunggu peninjauan tidak mengunci slot, dan kontrak yang disetujui lebih dulu yang menang. Jika ada hari model tidak tampil atau trafik turun lebih dari 30%, kami menggantinya dengan pengembalian dana proporsional atau perpanjangan.
- Penagihan dan tingkat berdasarkan laporan hasil pengukuran Metamoa sendiri (tayangan viewable, klik, masuk, waktu tayang, klik ruang).
Rumus penghitungan
Tanggal dihitung per hari menurut waktu Korea (ad_daily). Nominal adalah harga sebelum pajak dengan pecahan di bawah satu won dibuang. Peristiwa yang terkena aturan tidak dihitung dan dicatat terpisah menurut alasannya (ad_excluded).
- Tayangan viewable imps = jumlah peristiwa
impyang lolos semua aturan - Klik clicks =
clickyang lolos, masuk enters = masuk (/ads/go) yang lolos, converted = klik yang berlanjut masuk dengan token yang sama - Waktu tayang view_ms = jumlah ms peristiwa
timeyang lolos (hanya token yang tayangannya sudah dihitung, maksimal 15,000ms per peristiwa, sampai batas harian per orang dan model) - Nominal CPM = floor(imps × cpm_won ÷ 1,000)
- Nominal CPA = (clicks − converted) × click_won + enters × enter_won
- Nominal waktu tayang = floor(view_ms ÷ 1,000 × time_1000s_won ÷ 1,000)
- Nominal kontrak slot tetap = jumlah harga tingkat untuk setiap slot yang dikontrak. Jika hanya sebagian periode yang dihitung, per slot floor(harga × hari kontrak dalam periode itu ÷ hari kontrak)
- Porsi operator ruang = floor(nominal per ruang × persentase tingkat operator ruang itu (%) ÷ 100). Nominal adalah harga media sebelum pajak setelah trafik tidak sah dikurangi; biaya pembuatan model dan ruang tidak dibagi. Tingkat: lihat 「Tingkat bagi hasil operator ruang」 di bawah.
Tingkat bagi hasil operator ruang
Pendapatan iklan (nominal media iklan per ruang, harga sebelum pajak setelah trafik tidak sah dikurangi) dibagi antara operator ruang dan Metamoa sesuai rasio tingkatnya. Berlaku sejak 11/11/2026. Info pendaftaran awal: https://metamoa.com/ads/partners
| Tingkat | Sasaran | Operator ruang : Metamoa |
|---|---|---|
| Platinum | Siapa cepat dia dapat: operator ruang ke-1~10 | 9:1 |
| Emas | Operator ruang ke-11~100 (90 orang) | 8:2 |
| Perak | Operator ruang setelahnya | 7:3 |
| Perunggu | Operator ruang yang membuat kontrak baru mulai 1/1/2027 | 6:4 |
Rasio dapat disesuaikan di kemudian hari sesuai kinerja iklan.
- Operator ruang = satu akun pemilik yang mendaftarkan ruang di Metamoa dan masuk ke konsol ruang. Urutannya sesuai waktu masing-masing pertama kali menyalakan 「Persetujuan iklan」 di konsol ruang, diberi nomor satu per satu oleh server.
- Tingkat yang sudah ditetapkan tetap berlaku, dan ruang lain milik operator yang sama juga mendapat tingkat yang sama.
- Operator ruang yang membuat kontrak baru mulai 1/1/2027 pukul 0.00 (waktu Korea) adalah Perunggu, apa pun urutannya.
- Tingkat dan rasio saya: panel 「Iklan 3D」 di konsol ruang, partner dari GET /api/space/{id}/ads. Kursi tersisa: seats dari GET /api/ads/partners.
- Kursi tersisa sekarang: Platinum 0/10 · Emas 80/90
Cek ketentuan dan persetujuan iklan
Ketentuan layanan kini memuat klausul penayangan iklan (Pasal 4-4). Untuk menerima iklan, operator ruang melakukan dua hal sekaligus di 「Daftar untuk iklan」 pada Monetisasi konsol ruang.
- Cek ketentuan: centang cek ketentuan di langkah 1 「Daftar untuk iklan」 pada konsol ruang (/owner/revenue?id=<id ruang>). Hanya bisa di konsol ruang (dengan kunci ruang hasilnya 403 owner_page_only).
- Persetujuan iklan: menyala bersama cek ketentuan, lalu dinyalakan dan dimatikan per ruang di layar yang sama. Untuk menyalakannya, jenis info pembayaran dan kontak harus ada (jika tidak, 409 payout_info_required). Hanya saat menyala, API iklan ruang itu (satu baris skrip, kunci iklan) muncul; saat dimatikan, iklan langsung berhenti (serve 403 ads_off).
Catatan persetujuan: ruang, siapa (hash email login operator ruang di konsol ruang itu), kapan, versi ketentuan yang mana (data-ads-version dari terms.html), serta nyala/mati disimpan menumpuk tanpa dihapus (ad_consents).
Ruang yang belum cek ketentuan, mematikan persetujuan iklan, atau tidak terdaftar di daftar tidak mendapat iklan.
Slot iklan
Operator ruang sendiri yang menentukan di mana iklan berdiri di dalam metaverse mereka. Pengiklan memilih per slot atau menerima rekomendasi, dan kontrak slot tetap juga dibuat per slot. Daftar slot dapat dilihat serta dinyalakan dan dimatikan di konsol ruang.
| Kolom | Format | Arti |
|---|---|---|
| name | 1~40 karakter | Nama yang tidak kembar di dalam ruang |
| kind | floor · wall · air · character | Model di lantai · papan nama dinding · spanduk melayang · karakter iklan yang berdiri atau berjalan-jalan |
| position | [x, y, z] meter | Posisi tengah lantai kotak slot (koordinat ruang) |
| rotation | [x, y, z] derajat (-360~360) | Rotasi slot. Bawaan [0, 0, 0] |
| size | [lebar, tinggi, kedalaman] meter (0.1~200) | Kotak tempat iklan masuk. Iklan diperbesar atau diperkecil agar pas dengan kotak ini |
| scale | [min, maks] kali (0.05~20) | Skala ukuran per ruang: saat dipaskan ke kotak, iklan hanya diskalakan dalam rentang ini dari ukuran aslinya. Bawaan [0.25, 4] |
| roam | 0~50 meter | Slot character: radius karakter berjalan-jalan (0 berarti berdiri) |
| industries | Daftar id industri | Industri yang diterima slot ini. Kosong berarti semua industri |
| enabled | true · false | Jika dimatikan, slot ini tidak menayangkan iklan |
Ukuran model iklan dapat disesuaikan oleh operator ruang atau Metamoa tergantung ruangnya.
Iklan karakter hanya tayang di slot character; iklan model dan gedung hanya di slot floor, wall, dan air.
SDK (kunci iklan publik) hanya dapat membuat slot baru, dan slot yang dibuat dengan cara itu masuk dalam keadaan mati; iklan baru tayang setelah operator ruang memeriksa dan menyalakannya di konsol ruang. Slot yang sudah ada (nama sama) tidak dapat diubah oleh SDK dan dikembalikan apa adanya. Slot SDK yang mati maksimal 5 per ruang, dihitung terpisah dari 30 slot operator. Satu grup IP dapat membuat maksimal 20 per hari, dan slot SDK yang tidak pernah dinyalakan operator dalam 7 hari akan dihapus (slot yang pernah dinyalakan dan slot yang dipakai kampanye tidak dihapus). Setelah dinyalakan, slot itu masuk dalam 30 slot operator. Mengubah kotak, jenis, atau industri slot dan menyalakan atau mematikannya hanya bisa dengan login konsol ruang atau kunci ruang.
Id industri: game (gim) · fashion (fesyen, kecantikan) · food (makanan dan minuman) · tech (TI, elektronik) · finance (keuangan) · edu (pendidikan) · travel (wisata, rekreasi) · culture (budaya, hiburan) · auto (otomotif) · public (publik, nirlaba) · etc (lainnya)
Maksimal 30 slot per ruang. API slot memakai kunci ruang (mm_live_) atau login konsol ruang:
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}Operator ruang: langkah pemasangan
- Di 「Daftar untuk iklan」 pada Monetisasi konsol ruang (
https://metamoa.com/owner/revenue?id=<id ruang>), centang cek ketentuan lalu mulai iklan. - Taruh satu baris skrip dari panel 「API iklan」 di layar yang sama di akhir <head> atau <body> halaman ruang Anda. Kunci iklan (mm_adpub_) boleh dipublikasikan (jangan pernah menaruh kunci ruang mm_live_ di sana).
- Untuk ruang three.js, panggil attach dan slot setelah adegan dibuat. Slot terdaftar dalam keadaan mati saat pertama kali dipanggil. Iklan tayang begitu Anda menyalakannya di 「Slot iklan」 pada konsol ruang (Anda juga bisa membuatnya langsung menyala sejak awal dengan API slot).
- Begitu iklan terlihat, selesai. Tayangan viewable, klik, dan waktu tayang dikirim sendiri oleh SDK, dan untuk masuk ke ruang merek, SDK membuka /ads/go saat iklan diketuk lalu server yang menghitung.
- Di 「Slot iklan」 pada konsol ruang, nyalakan dan matikan slot serta lihat laporan 30 hari (sebelum dan sesudah aturan) dan porsi Anda (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 });
});
Mesin selain three.js (Babylon.js, PlayCanvas, Unity WebGL, dll.) mengambil iklan dengan serve, menggambarnya sendiri, dan mengirim peristiwa: ads.serve(name) → { ad }, ads.report(name, event). Untuk masuk, cukup buka ad.enter_url di jendela baru atau jendela yang sama. Spesifikasinya ada di 「Spesifikasi peristiwa」 di bawah.
Cara SDK menghitung
- Tayangan viewable: ketika minimal porsi yang ditentukan dari model berada di dalam pandangan kamera, dengan ukuran di layar minimal luas yang ditentukan, lebih lama dari waktu yang ditentukan selama tab terlihat, SDK mengirim 1 tayangan (sekali per token serve).
- Waktu tayang: setelah tayangan, selama iklan tetap terlihat dengan syarat di atas, SDK menjumlahkan dan mengirim setiap 5 detik, bersama jumlah input kamera dan penunjuk di antaranya (berhenti saat tab disembunyikan).
- Jika respons serve memuat vid, simpan di browser itu dan kirim bersama serve berikutnya (GET /ads/v1/serve?…&vid=). Hanya vid yang ditandatangani server untuk jaringan itu yang dibaca. Server menggabungkan vid dan grup IP yang terhubung lalu menandatangani orang itu ke dalam token. Tayangan baru dihitung sekitar 2 detik setelah serve.
- Klik: ketukan atau klik pada iklan mengirim
click, dan jika iklan punya ruang merek, enter_url (/ads/go) dibuka di jendela baru. Server menghitung masuknya lalu mengantar pengunjung ke ruang merek. - Pintu: jika ada ad.door, berjalan masuk lewat pintu membuka enter_url sekali di jendela baru. Kapan terbuka lagi: lihat 「Masuk lewat pintu」 di bawah.
- Id browser (vid) diberikan server dan disimpan SDK di localStorage. Hanya dipakai untuk batas pengulangan. Informasi pribadi seperti nama atau kontak tidak dikirim.
- Iklan diambil ulang setiap 30 menit (token baru). Karakter di slot character berjalan pelan di dalam radius roam.
Masuk lewat pintu
Anda dapat memasang pintu pada gedung iklan atau model 3D Anda sendiri. Ini pintu, bukan portal: saat seseorang berjalan masuk lewat pintu, ruang saat ini tetap seperti semula dan ruang merek terbuka di jendela baru (tab baru). Tambahkan "door": true pada creative kampanye (hanya jika kind adalah model atau building), dan brand_url wajib ada (jika tidak, 400 invalid, fields brand_url). ad dari serve kemudian datang dengan 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 } }
Aturan agar pintu tidak terus terbuka lagi (wajib dipatuhi)
- Berjalan masuk dalam jarak 1.2m di depan pintu membuka ruang merek (enter_url dengan &via=door) sekali di jendela baru.
- Setelah menutup jendela yang baru terbuka lalu kembali, bergerak sedikit di dalam atau dekat pintu tidak membuka pintu lagi.
- Pintu baru terbuka lagi setelah berjalan keluar lebih jauh dari 3m dari pintu lalu masuk kembali (jarak masuk 1.2m < jarak keluar 3m).
- Pintu tidak terbuka selama tab disembunyikan atau jendela tidak fokus, dan setelah kembali harus keluar dari area pintu sekali. Pintu juga tidak terbuka jika saat halaman dibuka Anda sudah berdiri di dalam pintu.
- Membuka dengan mengetuk atau mengklik gedung tetap seperti biasa (setiap klik). Aturan pintu hanya berlaku untuk berjalan masuk.
- Jika browser memblokir jendela baru, tombol 「Buka <merek>」 muncul di bagian bawah layar. Baru terbuka jika tombol itu diketuk (tombol hilang jika Anda meninggalkan pintu tanpa mengetuk).
Posisi pintu: node bernama door di dalam glb jika ada; jika tidak, SDK menggambar pintu bawaan di tengah bawah sisi depan iklan (+Z). Jaraknya adalah jarak lantai dari karakter yang berjalan ke depan pintu. Berikan walker ke attach (Object3D karakter yang berjalan atau fungsi yang mengembalikan {x, y, z}). Tanpa itu, posisi kamera yang dipakai.
ads.attach({ THREE, GLTFLoader, scene, camera, renderer, walker: player }); // player: the walking character (Object3D)
Ruang yang menggambar ad.door sendiri dengan mesin selain three.js juga harus mematuhi aturan yang sama: setelah terbuka sekali, jangan buka lagi sampai pejalan keluar dari exit_m, dan setelah tab disembunyikan lalu kembali, sampai pejalan keluar dari area pintu sekali.
Agar keluar-masuk tidak menguras anggaran
- Masuk lewat pintu dihitung dengan harga yang sama dengan 1 kali masuk CPA (harga dan belanja minimum tidak berubah).
- Masuk per orang (id browser dari server + grup alamat internet) per kampanye dihitung sekali setiap 24 jam, maksimal 3 kali dalam 30 hari. Grup alamat internet yang sama maksimal 3 kali per hari per kampanye dan ruang.
- Masuk yang melebihi itu tetap mengantar pengunjung ke ruang merek tetapi tidak ditagih, hanya dicatat (alasan pengecualian repeat_limit). Diperiksa ulang dengan catatan peristiwa server (hanya hash), sehingga tidak terlupa meski server dinyalakan ulang.
- Masuk dengan token serve yang sama dihitung sekali, dan hanya untuk token yang tayangannya sudah dihitung lebih dulu (aturan pemeriksaan bot dan kecurangan tetap berlaku).
Aturan pemeriksaan bot dan kecurangan
Di server, peristiwa melewati aturan di bawah secara berurutan. Jika salah satu saja terkena, peristiwa dikeluarkan dari laporan dan dicatat terpisah dengan nama aturan itu. Setiap aturan dinyalakan dan dimatikan di bot_rules pada data/ads-config.json.
| Aturan | Fungsinya | Saat ini |
|---|---|---|
UA bot (ua_bot) | Robot pencari, pratinjau, skrip (curl, python, headless, dll.), dan permintaan tanpa User-Agent dikeluarkan. | Nyala |
Browser otomatis (headless) | Browser dengan navigator.webdriver menyala, HeadlessChrome, PhantomJS, Electron, jsdom, dan permintaan tanpa Accept-Language dikeluarkan. Ini definisi pengukuran, tidak dihitung sebagai pertahanan terhadap skrip. | Nyala |
Visibilitas dan fokus tab (visibility_focus) | Tayangan hanya dihitung saat tab terlihat (document.visibilityState = visible) dan jendela fokus; waktu tayang hanya saat tab terlihat. Ini definisi pengukuran. | Nyala |
Penentuan viewable (min_view) | Minimal porsi yang ditentukan dari model harus tetap di layar, minimal seluas yang ditentukan, lebih lama dari waktu yang ditentukan agar dihitung 1 tayangan. Ini definisi pengukuran. | Nyala |
Batas pengulangan per orang dan alamat internet (repeat_limit) | Tayangan dan klik dari orang dan model yang sama dihitung sekali dalam waktu yang ditentukan; masuk (termasuk lewat pintu) sekali sehari dan sampai jumlah yang ditentukan selama hari yang ditentukan. Yang melebihi batas per jam satu grup alamat internet, penonton baru harian per ruang, atau tayangan, klik, dan masuk harian per kampanye dan ruang dikeluarkan. Batas masuk diperiksa ulang dengan catatan peristiwa server, sehingga tidak terlupa meski server dinyalakan ulang. | Nyala |
Token bertanda tangan server (signed_token) | Peristiwa harus membawa token bertanda tangan (HMAC) yang diberikan serve. Penonton dan grup alamat internet saat serve ditandatangani di dalam token; tayangan dari alamat lain dikeluarkan, begitu pula tayangan sebelum waktu yang ditentukan berlalu sejak serve. Token hanya menghitung masing-masing satu tayangan, klik, dan masuk dalam masa berlakunya. Anggaran kampanye diperiksa ulang saat menghitung, dan peristiwa yang melebihinya tidak dihitung (budget). | Nyala |
Pengukuran waktu tayang (view_time) | Waktu tayang hanya dihitung jika ada input kamera atau penunjuk di antaranya, dan hanya sampai batas harian per token, per orang dan model, serta per alamat internet dan model. | Nyala |
Trafik operator ruang sendiri (owner_traffic) | Peristiwa dari alamat internet yang pernah membuka konsol ruang itu dikeluarkan selama jumlah hari yang ditentukan. | Nyala |
Jejak input manusia (human_input) | Hanya klik yang ditandai browser sebagai input manusia (isTrusted) yang dihitung. Tayangan tidak melihat jumlah input (orang yang menonton diam, pengguna keyboard dan pembaca layar). | Nyala |
Pemantauan anomali dan penahanan (anomaly) | Tayangan yang dilihat satu orang melebihi jumlah yang ditentukan per hari dikeluarkan. Klik dan masuk CPA dihitung sampai kuota otomatis harian per ruang, sisanya ditahan. Jika rasio klik dan masuk (dibandingkan jaringan tanpa ruang itu), tayangan per klik ruang, penonton baru per alamat internet, porsi pusat data, pengulangan dari alamat yang sama, atau masuk per klik melewati ambangnya, porsi ruang itu untuk bulan itu ditahan dan admin yang memutuskan. | Nyala |
Jaringan pusat data (asn) | Jika x-mm-asn (nomor AS) yang ditambahkan Cloudflare adalah jaringan cloud atau hosting, peristiwa itu dikeluarkan, dan jika porsinya besar, ruang ditahan. Hanya dipercaya bila header rahasia (origin-auth) yang ditambahkan bersama oleh Cloudflare Transform Rule cocok dengan nilai env server; jika tidak, jaringan peristiwa itu dianggap 「tidak diketahui」 dan porsi pusat data hanya diukur dari peristiwa yang jaringannya diketahui. | Nyala |
Verifikasi manusia saat masuk (turnstile) | Masuk ke ruang merek (/ads/go) baru dihitung setelah lolos Cloudflare Turnstile di domain Metamoa. Jika gagal, pengguna tetap diantar ke ruang merek dan hanya masuknya yang tidak dihitung. Masuk yang datang saat belum ada kunci ditahan. | Nyala |
Pemeriksaan manusia untuk tayangan (turnstile_imp) | SDK menjalankan Cloudflare Turnstile di jendela metamoa tersembunyi dan melampirkan pass yang didapat (terikat ke jaringan dan ruang itu) pada tayangan. Pass dihitung; pemeriksaan yang gagal dikecualikan. Tanpa pass hanya tayangan itu yang ditahan; di akhir bulan dilepas atau dibatalkan menurut porsi yang tak dapat diperiksa di ruang itu (admin dapat melepasnya). Iklan selalu tampil apa adanya. | Nyala |
- Klik dan masuk hanya dihitung jika tayangan token itu sudah dihitung lebih dulu (jika tidak, no_impression).
- Saat tabel yang diingat server penuh, server tidak menghapus catatan yang masa berlakunya belum habis; server berhenti menghitung peristiwa baru (capacity). Gagal dalam keadaan tertutup.
Spesifikasi peristiwa
Permintaan SDK hanya diterima dari situs ruang itu sendiri. Untuk domain milik operator ruang, harus domain terdaftar yang sama; untuk host bersama seperti github.io atau vercel.app, nama host harus persis sama; dan untuk ruang di bawah suatu jalur (github.io/<repositori>, claude.ai), jalur Referer juga harus berada di bawahnya (SDK mengirim Referer lengkap). Semua dengan CORS terbuka, JSON. sendBeacon (text/plain) juga diterima.
Mengambil iklan · 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"
}
]
}
}
Jika ad bernilai null, saat ini tidak ada iklan untuk slot itu. Jika kind adalah model, letakkan glb dari model_url; jika building, letakkan glb gedung lalu jika mode adalah image, pasang gambar image_url pada setiap nama mesh di faces, dan jika texture, pasang image_url di seluruh texture.meshes, diulang sebanyak repeat. Jika character, berdirikan glb karakter, pasang properti di prop.attach, lalu taruh gambar image_url atau huruf text pada papannya. Semuanya disesuaikan dengan kotak slot.size, tetapi hanya diskalakan dalam slot.scale dari ukuran aslinya.
Mendaftarkan slot · 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 (같은 이름의 자리를 바꾸지 않고 그대로)
Mengirim peristiwa · 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 | Kolom | Arti |
|---|---|---|
| imp | token, ms, area, inside, vis, focus, inputs, wd | ms: waktu terlihat tanpa terputus, area: luas model dibanding luas layar (0~1), inside: porsi model di dalam layar (0~1), vis·focus: tab terlihat dan jendela fokus, inputs: input kamera dan penunjuk selama itu, wd: navigator.webdriver |
| time | token, ms, vis, inputs, wd | Waktu terlihat sejak time terakhir (maksimal 15,000ms) dan jumlah input di antaranya |
| click | token, trusted, wd | Iklan diketuk atau diklik. trusted: input manusia (isTrusted) |
Tayangan dihitung dengan pass pemeriksaan manusia yang didapat SDK dari jendela metamoa tersembunyi (Cloudflare Turnstile). Iklan langsung tampil tanpa menunggunya. Jika situs Anda mengirim Content-Security-Policy, tambahkan https://metamoa.com ke frame-src. Jika jendela diblokir atau tidak ada pass, tayangan itu ditahan; setelah bulan berakhir tayangan dilepas bila porsi yang tak dapat diperiksa di ruang itu 20% atau kurang, dan dibatalkan bila lebih.
Maksimal 20 sekaligus. Peristiwa tidak membawa vid; penonton diambil dari nilai di dalam token. Peristiwa yang salah dan token ruang lain hanya dihitung sebagai excluded.
Masuk · go
Masuk hanya dihitung setelah /ads/go di domain Metamoa memastikan dengan Cloudflare Turnstile bahwa itu manusia (jika ada kunci, layar verifikasi kecil muncul 1~2 detik). Jika verifikasi gagal, orang itu tetap menuju ruang merek dan hanya masuknya yang tidak dihitung.
GET https://metamoa.com/ads/go?t={serve 토큰}
→ 302 Location: {brand_url} (노출이 센 토큰이면 입장을 센 뒤 브랜드 공간으로. 캠페인이 집행 중·기간 안이고 토큰이 유효 시간 안일 때만 검수에서 승인된 brand_url로 가고, 아니면 Location: /)Gedung iklan, karakter, dan spesifikasi unggahan
Pengiklan tanpa model memilih salah satu gedung iklan atau karakter iklan dasar dari kami. Untuk gedung, pilih salah satu dari dua cara: gambar (satu gambar di setiap papan yang ditentukan) · tekstur (satu tekstur atau pola di seluruh permukaan gedung).
Untuk tekstur, unduh templat bawaan (PNG persegi), sunting, lalu unggah dengan ukuran yang sama (1024~2048px). Garis merah muda pada templat bergaris adalah batas potongan permukaan: warnai bagian dalam potongan dan hasilnya tampil di permukaan itu.
Pada toko iklan (shop-ad), satu gambar yang diunggah tampil di depan, samping, belakang, dan atas: papan nama depan, kedua sisi, belakang, dan papan di atap punya rasio yang sama, sehingga terbaca dari sisi mana pun, bahkan saat dilihat dari atas. Toko ini punya pintu, jadi 「Masuk lewat pintu」 ("door": true) bisa dipakai.
Karakter iklan dasar gratis berapa pun nilainya. Mereka berdiri atau berjalan-jalan di slot character, memegang properti yang dipasang pada tulangnya seperti papan kalung, kartu identitas, papan pegang, balon, bendera, atau tas belanja, dan papan properti memuat gambar iklan atau huruf papan nama (maksimal 12 karakter). Kucing, anjing, dan Vincent hanya bisa memakai properti yang dikalungkan di leher.
| Karakter | id | Properti yang bisa dipegang | Lisensi |
|---|---|---|---|
| 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 | Milik sendiri (FLOAT Co., Ltd.) |
| Kucing bulu pendek Nyangjupgo | cat_short | prop-neck-sign prop-badge | CC BY 4.0 |
| Kucing bulu panjang Nyangjupgo | cat_long | prop-neck-sign prop-badge | CC BY 4.0 |
| Munchkin Nyangjupgo | cat_munchkin | prop-neck-sign prop-badge | CC BY 4.0 |
| Corgi Nyangjupgo | dog_corgi | prop-neck-sign prop-badge | CC BY 4.0 |
| Properti | id | Rasio gambar · ukuran minimum |
|---|---|---|
| Papan kalung (tipe kartu identitas) | prop-badge | 720:1024, minimal 360×512px |
| Balon | prop-balloon | 1024:1024, minimal 512×512px |
| Bendera tangan | prop-flag | 1024:688, minimal 512×344px |
| Papan yang dikalungkan | prop-neck-sign | 1024:720, minimal 512×360px |
| Papan pegang | prop-picket | 1024:720, minimal 512×360px |
| Tas belanja | prop-shopping-bag | 1024:1024, minimal 512×512px |
- Format gambar: PNG · JPEG · WEBP, maksimal 2MB, lebar dan tinggi maksimal 4096px, toleransi rasio maksimal 2%. Gambar yang diunggah disimpan ulang sebagai WebP (informasi foto dihapus).
- Model 3D: satu berkas biner glTF 2.0 (.glb), maksimal 6MB, tekstur di dalam berkas, tanpa alamat luar (uri).
- Berkas yang diunggah diperiksa formatnya dari isinya (magic byte): gambar hanya diterima sebagai PNG, JPEG, atau WebP (tidak menerima SVG, HTML, dll.) lalu dibuat ulang sebagai WebP, dan model hanya sebagai biner glTF 2.0. Berkas iklan hanya disajikan dengan tipe tetap (image/webp, model/gltf-binary), nosniff, dan kebijakan sandbox, sehingga tidak pernah dijalankan sebagai skrip.
- Ukuran model iklan dapat disesuaikan oleh operator ruang atau Metamoa tergantung ruangnya.
- Berkas model dan karakter ada di bawah /ads/models/ dan hanya disajikan sebagai respons yang tidak mengizinkan skrip (tipe tetap, nosniff, sandbox). Daftar dan sumbernya ada di docs/ads/MODELS.md; untuk mengubahnya, buat ulang data/ads-buildings.json dan berkasnya bersama-sama dengan scripts/ads-import-models.mjs.
Atribusi model
Sebagian besar model dasar adalah CC0 (domain publik) atau buatan sendiri; yang di bawah ini CC BY sehingga sumbernya dicantumkan. Semuanya telah diubah oleh FLOAT Co., Ltd. (ukuran, sisi iklan, dll.).
- Billboard berdiri: "Blank Billboard" by Jarlan Perez (https://poly.pizza/m/1E0d2B7bC8e), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), diubah oleh FLOAT Co., Ltd.
- Booth pop-up: "Carnival Booth" by sirkitree (https://poly.pizza/m/4NizXJZsuO2), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), diubah oleh FLOAT Co., Ltd.
- Papan iklan halte bus: "Bus Stop" by Zsky (https://poly.pizza/m/OWczicNWhO), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), diubah oleh FLOAT Co., Ltd.
- Papan berdiri tipe A: "Sandwich Board" by Anonymous (https://poly.pizza/m/ejy0W_7cHWT), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), diubah oleh FLOAT Co., Ltd.
- Kucing bulu pendek Nyangjupgo: "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, diubah menjadi voxel oleh FLOAT Co., Ltd.
- Kucing bulu panjang Nyangjupgo: "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, diubah menjadi voxel oleh FLOAT Co., Ltd.
- Munchkin Nyangjupgo: "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, diubah menjadi voxel oleh FLOAT Co., Ltd.
- Corgi Nyangjupgo: "Dog" by Polyfork (https://polyfork.dev/asset/dog-base), CC BY 4.0, diubah menjadi voxel oleh FLOAT Co., Ltd.
Minta dibuatkan model
Saat pengiklan memilih 「Minta dibuatkan model」, kami membuat model 3D, memasangnya ke kampanye, lalu meninjaunya. Kirim bahan pembuatan (foto produk, logo, gambar teknis) ke [email protected] beserta nomor kampanye.
| Tingkat | grade | Biaya pembuatan | Gratis mulai belanja media ini |
|---|---|---|---|
| Produk sederhana · papan nama | simple | ₩50,000 (harga sebelum pajak, belum termasuk PPN) | ₩500,000 |
| Produk detail | precise | ₩100,000 (harga sebelum pajak, belum termasuk PPN) | ₩1,000,000 |
| Karakter baru | character | ₩100,000 (harga sebelum pajak, belum termasuk PPN) | ₩1,000,000 |
- Batas gratis dilihat dari belanja media sebenarnya (total seluruh periode kontrak, maksimal 3 bulan, tidak termasuk pemodelan, PPN, dan trafik tidak sah).
- Model yang dibuat gratis hanya diberi hak pakai untuk penayangan di Metamoa (hak cipta milik Metamoa; pengalihan dengan membayar biaya pembuatan), dengan 1 kali revisi. Jika pengiklan membatalkan atau mengurangi belanja karena alasannya sendiri, biaya pembuatan ditagih secara proporsional: biaya pembuatan × (1 − belanja media sebenarnya ÷ batas gratis). Model berbayar mendapat 2 kali revisi.
- Karakter iklan dasar (karakter Perkemahan Moa dan Nyangjupgo) dapat dipakai gratis berapa pun nilainya, tanpa permintaan pembuatan.
Pengiklan: langkah pendaftaran mandiri
- Masuk dengan akun Metamoa di https://metamoa.com/ads/manage (pendaftaran di jendela yang sama).
- Buat kampanye: nama, merek, industri, dan alamat ruang merek (saat memakai CPA masuk).
- Materi iklan: ① unggah model 3D Anda sendiri (glb) ② pilih gedung iklan → gambar per papan untuk tipe gambar, satu tekstur untuk tipe tekstur ③ pilih karakter iklan dasar + properti → gambar atau huruf papan nama di papan properti ④ minta dibuatkan model (pilih tingkat). Spesifikasi dan pratinjau ditampilkan.
- Ruang tayang: dari daftar ruang yang menyetujui iklan, pilih sendiri slot berdasarkan kategori, jumlah orang yang sedang online, dan klik ruang harian, atau ketuk 「Rekomendasi」 untuk paket ruang yang disesuaikan dengan industri, kategori, dan trafik.
- Tentukan jenis penagihan (CPM, CPA, waktu tayang, kontrak slot tetap), anggaran, dan periode lalu ajukan → menunggu peninjauan.
- Setelah lolos peninjauan (konten cabul, kekerasan, dugaan pelanggaran hak cipta, dll.), iklan tayang. Kampanye yang berjalan dapat dijeda dan dinyalakan lagi, dan Anda dapat melihat tayangan viewable, klik, masuk, dan waktu tayang setiap hari.
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>)
Materi karakter: {"kind": "character", "character_id": "bangjang", "prop": "prop-picket", "image": "as_…"} atau "text": "Susu Berkilau" sebagai ganti "image". Kontrak slot tetap: "billing": "fixed", "fixed_period": "week" | "month", end_day = start_day + periode − 1. Permintaan model: {"kind": "request", "grade": "simple", "note": "…"}.
Materi gedung dan model sendiri dapat diberi dua hal lagi (opsional): "tagline": "deskripsi satu baris" (maksimal 30 karakter, hanya huruf — tanpa tag, kurung sudut, atau kurung kurawal (400 invalid, fields creative), ditinjau bersama materi) digambar pada strip di bawah papan nama toko iklan atau gedung (mesh ad_tagline) dan dikirim sebagai ad.tagline { text, mesh, aspect } dari serve. "door": true adalah 「Masuk lewat pintu」 (brand_url wajib). Sama dengan kolom 「Deskripsi satu baris」 dan 「Masuk lewat pintu」 di langkah 2 /ads/manage.
Peninjauan
- Model, gambar, dan kampanye yang diunggah menunggu peninjauan (review) sebelum tayang. Jika admin menyetujui, iklan tayang (active); jika ditolak, rejected dan alasannya disimpan.
- Gambar lebih dulu diperiksa saat diunggah dengan pemeriksaan gambar AI terhadap konten cabul, kekerasan, serta logo atau karakter milik orang lain, dan langsung diblokir jika terdeteksi (rejected). Jika pemeriksaan tidak bisa dijalankan, admin memeriksanya langsung.
- Model dibuka dan diperiksa langsung oleh admin. Konten cabul, kekerasan, atau dugaan pelanggaran hak cipta akan ditolak.
Kode galat
Isi galat adalah { "error": "<kode>", "message": "<satu baris tentang langkah berikutnya>" }; galat kolom datang dengan fields, batas datang dengan retry_after.
| HTTP | error | Arti |
|---|---|---|
| 400 | invalid | Format kolom salah. fields berisi kolom yang salah. |
| 400 | bad_model | Bukan glb, bukan glTF 2.0, atau berisi alamat luar (uri). Alasannya ada di reason. |
| 400 | bad_image | Format, ukuran, atau rasio gambar tidak sesuai spesifikasi. reason (format · bytes · too_large · too_small · aspect) dan spec dikirim. |
| 400 | bad_building | default_building slot bukan id gedung atau papan dari GET /ads/v1/buildings (kosong boleh). |
| 400 | slot_unavailable | Slot yang dipilih tidak menerima iklan, tidak menerima industri itu, atau tidak cocok dengan jenis materi (karakter hanya di slot karakter). slot_ids berisi slot tersebut. |
| 401 | unauthorized | Tidak ada kunci ruang atau login konsol ruang, atau salah. |
| 401 | sign_in | Pengiklan: belum login akun Metamoa, atau sudah kedaluwarsa. |
| 403 | owner_required | Ada kunci ruang, tetapi operator ruang belum diverifikasi. |
| 403 | owner_page_only | Mencoba cek ketentuan atau persetujuan iklan dengan kunci ruang (hanya bisa di konsol ruang). |
| 403 | bad_ad_key | SDK: space dan key (mm_adpub_) tidak cocok. |
| 403 | terms_required | Ruang itu belum melakukan cek ketentuan penayangan iklan. |
| 403 | ads_off | Ruang itu mematikan persetujuan iklan. |
| 403 | origin_mismatch | Permintaan SDK tidak berasal dari situs ruang itu (domain yang sama). |
| 404 | not_house | Iklan milik kami (GET /ads/v1/house) dipanggil dari ruang yang tidak dioperasikan langsung oleh Metamoa. |
| 403 | not_yours | Pengiklan: memakai id berkas milik orang lain. |
| 404 | no_slot | Tidak ada slot iklan dengan nama atau id itu. |
| 404 | not_found | Kampanye atau berkas itu tidak ada. |
| 409 | not_listed | Ruang yang tidak terdaftar di daftar (sebelum disetujui atau disembunyikan). |
| 409 | payout_info_required | Mencoba menyalakan persetujuan iklan tanpa jenis info pembayaran (perorangan atau badan usaha) dan kontak (ponsel atau email). Isi di Monetisasi konsol ruang (/owner/revenue?id=<id ruang>). |
| 409 | advertiser_required | Pengiklan: mencoba mengajukan atau membayar kampanye sebelum mengisi info pengiklan (PUT /api/ads/advertiser). |
| 409 | biz_doc_required | Pengiklan: pengiklan badan usaha mencoba membayar atau mengajukan kontrak slot tetap sebelum mengunggah salinan surat izin usaha (PUT /api/ads/advertiser/doc). |
| 409 | business_only | Pengiklan: pengiklan perorangan mencoba mengunggah salinan surat izin usaha. |
| 400 | bad_doc | Pengiklan: salinan surat izin usaha bukan PDF, JPG, atau PNG. |
| 413 | doc_too_big | Pengiklan: salinan surat izin usaha melebihi 5MB. |
| 503 | advertiser_unavailable | Pengiklan: server tidak memiliki kunci enkripsi info pengiklan sehingga tidak dapat menerimanya. |
| 409 | email_not_linked | Pengiklan: email pengiklan perorangan bukan email yang dipakai login ke akun Metamoa ini. |
| 409 | name_taken | Slot dengan nama yang sama sudah ada. |
| 409 | slot_limit | Maksimal 30 slot operator per ruang, dan maksimal 5 slot SDK yang belum dikonfirmasi. |
| 409 | slot_taken | Slot yang sudah memiliki kontrak slot tetap lain pada periode itu. |
| 409 | tier_too_low | Memilih slot di ruang yang klik ruang hariannya belum mencapai tingkat terendah sebagai kontrak slot tetap. slot_ids berisi slot tersebut. |
| 409 | not_for_sale | Tidak ada harga kontrak slot tetap. |
| 409 | under_minimum | Di bawah belanja media minimum. min_spend_won dan spend_won dikirim. |
| 409 | no_click_history | Memilih CPM atau kontrak slot tetap untuk slot di ruang yang belum punya riwayat klik ruang (tayangan dan tingkat tidak dapat diukur). Hanya CPA dan waktu tayang yang bisa. slot_ids dan billings dikirim. |
| 409 | over_inventory | Anggaran CPM melebihi batas perkiraan tayangan viewable slot yang dipilih. max_budget_won dikirim. |
| 409 | rejected_file | Memakai berkas yang diblokir saat peninjauan untuk kampanye. |
| 409 | wrong_state | Hal yang tidak bisa dilakukan pada status itu (menjeda kampanye yang sedang ditinjau, dll.). |
| 409 | stale | Admin: kampanye berubah setelah layar peninjauan dibuka (version pada decide berbeda dari yang sekarang). Lihat lagi lalu putuskan ulang. |
| 409 | already_paid | Mencoba membuka pembayaran lagi untuk kampanye yang sudah dibayar. |
| 409 | not_paid | Admin: mencoba menyetujui penyelesaian kampanye yang pembayarannya belum selesai. |
| 409 | held | Admin: mencoba menyetujui penyelesaian kampanye yang memiliki porsi tertahan (putuskan penahanan lebih dulu). |
| 424 | hrum_failed | Tidak dapat terhubung ke pembayaran (Hrum). Coba lagi sebentar lagi. |
| 503 | pay_not_ready | Pembayaran belum bisa dibuka (sebelum server diatur). |
| 409 | model_missing | Admin: menyetujui kampanye permintaan model sebelum model dipasang. |
| 413 | model_too_big | Berkas model melebihi 6MB. |
| 429 | too_many | Terlalu banyak permintaan. Tunggu selama detik Retry-After. |
Semua jalur
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