Metamoa
รายการโปรด อันดับ

โฆษณา 3D ของ Metamoa · 3D ads

ภาพรวม

โฆษณา 3D ของ Metamoa นำโมเดล 3D อาคารโฆษณา หรือตัวละครโฆษณาของผู้ลงโฆษณาไปวางในตำแหน่งโฆษณาภายในพื้นที่เมตาเวิร์สบนเว็บ นับเฉพาะสิ่งที่คนเห็นและทำจริง เก็บค่าโฆษณาตามนั้น และแบ่งส่วนแบ่งให้ผู้ดูแลพื้นที่ ในฐานะธุรกิจโฆษณาและตัวแทนโฆษณา เรารับตั้งแต่บริษัทใหญ่ไปจนถึงธุรกิจขนาดกลางและเล็ก

หน้าจอจริง · Moa Campsite
หน้าจอจริง · Moa Campsite
หน้าจอจริง · ร้านใน Moa Campsite (โฆษณาของเราเอง)
หน้าจอจริง · ร้านใน Moa Campsite (โฆษณาของเราเอง)
หน้าจอจริง · ลานของ AI Butta
หน้าจอจริง · ลานของ AI Butta
หน้าจอจริง · Walking Into Van Gogh
หน้าจอจริง · Walking Into Van Gogh

สินค้า 4 แบบและการคิดเงิน

จำนวนเงินทั้งหมดเป็นราคาก่อนภาษี ไม่รวม VAT

สินค้าbillingสิ่งที่นับราคาต่อหน่วย
CPM (การแสดงผลแบบ viewable)cpmการแสดงผล viewable 1 ครั้ง = โมเดลอยู่ในจอไม่น้อยกว่าสัดส่วนที่กำหนด ต่อเนื่องนานเกินเวลาที่กำหนด (ขณะที่แท็บแสดงอยู่)₩8,000 ต่อ viewable 1,000 ครั้ง
CPA · คลิกโมเดลcpaแตะหรือคลิกโมเดลโฆษณา หากคลิกแล้วเข้าต่อไปถึงพื้นที่แบรนด์ จะคิดเงินเฉพาะการเข้า 1 ครั้ง₩700 ต่อการคลิก 1 ครั้ง
CPA · เข้าพื้นที่แบรนด์cpaกดโฆษณาแล้วเข้าไปยังพื้นที่แบรนด์ (brand_url) นับผ่านการเปลี่ยนเส้นทางของเซิร์ฟเวอร์ (/ads/go) คนเดียวกันและแคมเปญเดียวกันนับวันละครั้ง₩1,000 ต่อการเข้า 1 ครั้ง
เวลาแสดงผลtimeเวลาสะสมที่โฆษณาถูกมองเห็นหลังการแสดงผล viewable (เฉพาะเมื่อมีการโต้ตอบ สูงสุดถึงเพดานรายวันต่อคนต่อโมเดล)₩1,000 ต่อ viewable 1,000 วินาที
สัญญาตำแหน่งคงที่fixedตามระยะเวลา (สูงสุดหนึ่งเดือน) ใช้ตำแหน่งโฆษณาที่ทำสัญญาแต่ผู้เดียวตลอดช่วงนั้น (ต่อตำแหน่ง) ไม่รับประกันจำนวนการแสดงผลดูตารางระดับด้านล่าง

ระดับของสัญญาตำแหน่งคงที่

ระดับกำหนดจากค่ามัธยฐานของจำนวนคลิกพื้นที่ต่อวันที่สะอาดใน 14 วันล่าสุดของพื้นที่ที่ตำแหน่งนั้นอยู่ (ไม่นับการเข้าชมของผู้ดำเนินการเอง เครือข่ายศูนย์ข้อมูล และเบราว์เซอร์อัตโนมัติ และ “เข้า” ของ metamoa นับเฉพาะที่ผ่านการยืนยันว่าเป็นคน) ตำแหน่งในพื้นที่ที่ไม่ถึงระดับต่ำสุดจะไม่ขายเป็นสัญญาตำแหน่งคงที่ รับเฉพาะแบบตามผลลัพธ์ ระยะสัญญาเลือกได้ระหว่างรายสัปดาห์ 7 วัน หรือรายเดือน 30 วัน

ระดับคลิกพื้นที่ต่อวันรายสัปดาห์ (1 ตำแหน่ง)รายเดือน (1 ตำแหน่ง)
S1,000 ขึ้นไป₩50,000₩180,000
A300~999₩15,000₩50,000
B100~299₩5,000₩18,000

สูตรการนับ

วันที่นับเป็นรายวันตามเวลาเกาหลี (ad_daily) จำนวนเงินเป็นราคาก่อนภาษีที่ตัดเศษต่ำกว่าหนึ่งวอนทิ้ง เหตุการณ์ที่ติดกฎจะไม่นับ และนับแยกตามเหตุผล (ad_excluded)

ระดับการแบ่งรายได้ของผู้ดูแลพื้นที่

รายได้โฆษณา (ยอดสื่อโฆษณาต่อพื้นที่ ราคาก่อนภาษีหลังหักทราฟฟิกที่ไม่ถูกต้อง) แบ่งระหว่างผู้ดูแลพื้นที่กับ Metamoa ตามสัดส่วนของระดับ มีผลตั้งแต่ 11/11/2026 ข้อมูลการลงทะเบียนก่อน: https://metamoa.com/ads/partners

ระดับกลุ่มผู้ดูแลพื้นที่ : Metamoa
แพลทินัมมาก่อนได้ก่อน: ผู้ดูแลพื้นที่ลำดับที่ 1~109:1
โกลด์ผู้ดูแลพื้นที่ลำดับที่ 11~100 (90 คน)8:2
ซิลเวอร์ผู้ดูแลพื้นที่หลังจากนั้น7:3
บรอนซ์ผู้ดูแลพื้นที่ที่ทำสัญญาใหม่ตั้งแต่ 1/1/20276: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เมื่อปิด ตำแหน่งนี้จะไม่มีโฆษณาแสดง

ขนาดของโมเดลโฆษณาอาจถูกปรับโดยผู้ดูแลพื้นที่หรือ Metamoa ตามแต่ละพื้นที่

โฆษณาตัวละครแสดงเฉพาะในตำแหน่ง character ส่วนโฆษณาโมเดลและอาคารแสดงเฉพาะในตำแหน่ง floor, wall, air

SDK (คีย์โฆษณาสาธารณะ) สร้างได้เฉพาะตำแหน่งใหม่ และตำแหน่งที่สร้างแบบนั้นจะอยู่ในสถานะปิด ผู้ดูแลพื้นที่ต้องตรวจสอบและเปิดในหน้าจัดการพื้นที่ก่อน โฆษณาจึงจะแสดง ตำแหน่งที่มีอยู่แล้ว (ชื่อเดียวกัน) SDK แก้ไขไม่ได้และจะส่งกลับตามเดิม ตำแหน่ง SDK ที่ปิดอยู่มีได้สูงสุด 5 ตำแหน่งต่อพื้นที่ นับแยกจากตำแหน่งของผู้ดูแลพื้นที่ 30 ตำแหน่ง กลุ่ม IP หนึ่งสร้างได้สูงสุดวันละ 20 ตำแหน่ง และตำแหน่ง SDK ที่ผู้ดูแลพื้นที่ไม่เคยเปิดเลยภายใน 7 วันจะถูกลบ (ตำแหน่งที่เคยเปิดแล้วและตำแหน่งที่แคมเปญใช้อยู่จะไม่ถูกลบ) เมื่อเปิดแล้วจะนับรวมใน 30 ตำแหน่งของผู้ดูแลพื้นที่ การเปลี่ยนกล่อง ประเภท อุตสาหกรรมของตำแหน่ง และการเปิดปิด ทำได้เฉพาะด้วยการเข้าสู่ระบบหน้าจัดการพื้นที่หรือคีย์พื้นที่

id อุตสาหกรรม: game (เกม) · fashion (แฟชั่น ความงาม) · food (อาหารและเครื่องดื่ม) · tech (ไอที อิเล็กทรอนิกส์) · finance (การเงิน) · edu (การศึกษา) · travel (ท่องเที่ยว สันทนาการ) · culture (วัฒนธรรม บันเทิง) · auto (ยานยนต์) · public (ภาครัฐ ไม่แสวงกำไร) · etc (อื่นๆ)

พื้นที่ละไม่เกิน 30 ตำแหน่ง API ตำแหน่งใช้คีย์พื้นที่ (mm_live_) หรือการเข้าสู่ระบบหน้าจัดการพื้นที่:

GET    https://metamoa.com/api/space/{space_id}/ads/slots
POST   https://metamoa.com/api/space/{space_id}/ads/slots          {"name":"plaza-front","kind":"floor","position":[0,0,-8],"rotation":[0,90,0],"size":[4,4,4],"scale":[0.5,2],"industries":["game","food"]}
POST   https://metamoa.com/api/space/{space_id}/ads/slots          {"name":"gate-greeter","kind":"character","position":[3,0,-4],"size":[1.2,2.2,1.2],"roam":3}
PATCH  https://metamoa.com/api/space/{space_id}/ads/slots/{slot_id} {"enabled": false, "scale": [0.5, 1.5]}
DELETE https://metamoa.com/api/space/{space_id}/ads/slots/{slot_id}

ผู้ดูแลพื้นที่: ขั้นตอนการติดตั้ง

  1. ใน 「ลงทะเบียนรับโฆษณา」 ของเมนูสร้างรายได้ในหน้าจัดการพื้นที่ (https://metamoa.com/owner/revenue?id=<id พื้นที่>) ติ๊กยืนยันข้อกำหนดแล้วเริ่มโฆษณา
  2. นำสคริปต์หนึ่งบรรทัดจากช่อง 「API โฆษณา」 ในหน้าจอเดียวกันไปใส่ท้าย <head> หรือ <body> ของหน้าพื้นที่ คีย์โฆษณา (mm_adpub_) เปิดเผยได้ (ห้ามใส่คีย์พื้นที่ mm_live_)
  3. ถ้าเป็นพื้นที่ three.js ให้เรียก attach และ slot หลังจากสร้างฉากแล้ว ตำแหน่งจะถูกลงทะเบียนในสถานะปิดเมื่อเรียกครั้งแรก เมื่อเปิดใน 「ตำแหน่งโฆษณา」 ของหน้าจัดการพื้นที่ โฆษณาจะเริ่มแสดง (จะสร้างให้เปิดตั้งแต่แรกด้วย API ตำแหน่งก็ได้)
  4. เมื่อโฆษณาปรากฏก็เสร็จ การแสดงผล viewable คลิก และเวลาที่ถูกมองเห็น SDK ส่งให้เอง ส่วนการเข้าพื้นที่แบรนด์ เมื่อกดโฆษณา SDK จะเปิด /ads/go แล้วเซิร์ฟเวอร์เป็นผู้นับ
  5. ใน 「ตำแหน่งโฆษณา」 ของหน้าจัดการพื้นที่ เปิดปิดตำแหน่ง และดูสถิติ 30 วัน (ก่อนและหลังใช้กฎ) กับส่วนแบ่ง (GET /api/space/{space_id}/ads/stats)
<script src="https://metamoa.com/ads/sdk.js" data-space="{space_id}" data-key="{mm_adpub_…}" async></script>
import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
// after your scene, camera and renderer exist:
(window.metamoaAdsReady = window.metamoaAdsReady || []).push((ads) => {
  ads.attach({ THREE, GLTFLoader, scene, camera, renderer });
  ads.slot({ name: 'plaza-front', kind: 'floor', position: [0, 0, -8], rotation: [0, 0, 0], size: [4, 4, 4] });
  ads.slot({ name: 'north-wall', kind: 'wall', position: [0, 3, -15], size: [6, 3.4, 0.4] });
  ads.slot({ name: 'gate-greeter', kind: 'character', position: [3, 0, -4], size: [1.2, 2.2, 1.2], roam: 3 });
});

เอนจินที่ไม่ใช่ three.js (Babylon.js, PlayCanvas, Unity WebGL ฯลฯ) รับโฆษณาด้วย serve แล้ววาดเอง และส่งเหตุการณ์: ads.serve(name) → { ad }, ads.report(name, event) สำหรับการเข้า เปิด ad.enter_url ในหน้าต่างใหม่หรือหน้าต่างเดิมก็ได้ ข้อกำหนดดูที่ 「ข้อกำหนดเหตุการณ์」 ด้านล่าง

วิธีที่ SDK นับ

เดินเข้าทางประตู

ติดประตูให้อาคารโฆษณาหรือโมเดล 3D ของคุณได้ นี่คือประตู ไม่ใช่พอร์ทัล: เมื่อคนเดินเข้าทางประตู พื้นที่ปัจจุบันยังอยู่เหมือนเดิม และพื้นที่แบรนด์จะเปิดในหน้าต่างใหม่ (แท็บใหม่) ใส่ "door": true ใน creative ของแคมเปญ (เฉพาะเมื่อ kind เป็น model หรือ building) และต้องมี brand_url (ถ้าไม่มีจะได้ 400 invalid, fields brand_url) ad ของ serve จะมี door มาด้วย

"creative": { "kind": "building", "building_id": "bld-corner-shop", "mode": "image", "images": { … }, "door": true }
serve → "ad": { …, "enter_url": "https://metamoa.com/ads/go?t=<serve 토큰>", "door": { "node": "door", "enter_m": 1.2, "exit_m": 3 } }

กฎที่ทำให้ประตูไม่เปิดซ้ำไปเรื่อยๆ (ต้องปฏิบัติตาม)

  1. เมื่อเดินเข้ามาในระยะ 1.2m หน้าประตู จะเปิดพื้นที่แบรนด์ (enter_url ที่มี &via=door) ในหน้าต่างใหม่หนึ่งครั้ง
  2. หลังปิดหน้าต่างที่เปิดใหม่แล้วกลับมา แม้จะขยับเล็กน้อยในประตูหรือใกล้ประตู ประตูก็จะไม่เปิดอีก
  3. ต้องเดินออกไปไกลจากประตูเกิน 3m แล้วกลับเข้ามา ประตูจึงจะเปิดอีกครั้ง (ระยะเข้า 1.2m < ระยะออก 3m)
  4. ขณะที่แท็บถูกซ่อนหรือหน้าต่างไม่ได้โฟกัส ประตูจะไม่เปิด และเมื่อกลับมาแล้วต้องออกจากเขตประตูหนึ่งครั้ง หากตอนเปิดหน้ายืนอยู่ในประตูอยู่แล้วก็จะไม่เปิด
  5. การแตะหรือคลิกอาคารเพื่อเปิดยังทำได้เหมือนเดิม (ทุกครั้งที่คลิก) กฎประตูใช้เฉพาะกับการเดินเข้าไป
  6. หากเบราว์เซอร์บล็อกหน้าต่างใหม่ ปุ่ม 「เปิด <แบรนด์>」 จะแสดงที่ด้านล่างของจอ ต้องกดปุ่มนั้นจึงจะเปิด (ถ้าออกจากประตูโดยไม่กด ปุ่มจะหายไป)

ตำแหน่งประตู: ถ้าใน glb มีโหนดชื่อ door จะใช้โหนดนั้น ถ้าไม่มี SDK จะวาดประตูเริ่มต้นที่พื้นกึ่งกลางด้านหน้าโฆษณา (+Z) ระยะคือระยะบนพื้นจากตัวละครที่เดินถึงหน้าประตู โปรดส่ง walker ให้ attach (Object3D ของตัวละครที่เดิน หรือฟังก์ชันที่คืนค่า {x, y, z}) ถ้าไม่มีจะวัดจากตำแหน่งกล้อง

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

พื้นที่ที่วาด ad.door เองด้วยเอนจินที่ไม่ใช่ three.js ก็ต้องปฏิบัติตามกฎข้างต้นเหมือนกัน: หลังเปิดหนึ่งครั้งแล้ว จะไม่เปิดอีกจนกว่าจะออกนอก exit_m และหลังจากแท็บถูกซ่อนแล้วกลับมา จะไม่เปิดอีกจนกว่าจะออกจากเขตประตูหนึ่งครั้ง

เพื่อไม่ให้การเดินเข้าออกกินงบประมาณ

กฎตรวจสอบบอตและการฉ้อโกง

บนเซิร์ฟเวอร์ เหตุการณ์จะผ่านกฎด้านล่างตามลำดับ หากติดกฎใดกฎหนึ่งจะถูกตัดออกจากสถิติและนับแยกตามชื่อกฎนั้น กฎแต่ละข้อเปิดปิดได้ใน bot_rules ของ data/ads-config.json

กฎสิ่งที่ทำปัจจุบัน
UA บอต (ua_bot)ตัดโรบอตค้นหา ตัวแสดงตัวอย่าง สคริปต์ (curl, python, headless ฯลฯ) และคำขอที่ไม่มี User-Agent ออกเปิด
เบราว์เซอร์อัตโนมัติ (headless)ตัดเบราว์เซอร์ที่เปิด navigator.webdriver, HeadlessChrome, PhantomJS, Electron, jsdom และคำขอที่ไม่มี Accept-Language ออก นี่คือนิยามการวัด ไม่นับเป็นการป้องกันสคริปต์เปิด
การมองเห็นและโฟกัสของแท็บ (visibility_focus)การแสดงผลนับเฉพาะเมื่อแท็บแสดงอยู่ (document.visibilityState = visible) และหน้าต่างมีโฟกัส ส่วนเวลาที่ถูกมองเห็นนับเฉพาะเมื่อแท็บแสดงอยู่ นี่คือนิยามการวัดเปิด
การตัดสิน viewable (min_view)โมเดลต้องอยู่ในจอไม่น้อยกว่าสัดส่วนที่กำหนด มีพื้นที่ไม่น้อยกว่าที่กำหนด และต่อเนื่องนานเกินเวลาที่กำหนด จึงนับเป็นการแสดงผล 1 ครั้ง นี่คือนิยามการวัดเปิด
การจำกัดการซ้ำต่อคนและที่อยู่อินเทอร์เน็ต (repeat_limit)การแสดงผลและคลิกของคนเดียวกันกับโมเดลเดียวกันนับหนึ่งครั้งในช่วงเวลาที่กำหนด การเข้า (รวมการเดินเข้าทางประตู) นับวันละครั้งและไม่เกินจำนวนที่กำหนดในจำนวนวันที่กำหนด ส่วนที่เกินเพดานรายชั่วโมงของกลุ่มที่อยู่อินเทอร์เน็ตหนึ่ง จำนวนผู้ชมใหม่ต่อวันต่อพื้นที่ หรือจำนวนการแสดงผล คลิก และการเข้าต่อวันต่อแคมเปญต่อพื้นที่ จะถูกตัดออก การจำกัดการเข้าตรวจซ้ำด้วยบันทึกเหตุการณ์ของเซิร์ฟเวอร์ จึงไม่ลืมแม้เซิร์ฟเวอร์รีสตาร์ตเปิด
โทเค็นที่เซิร์ฟเวอร์ลงนาม (signed_token)เหตุการณ์ต้องแนบโทเค็นที่ลงนาม (HMAC) ซึ่ง serve ให้มา ผู้ชมและกลุ่มที่อยู่อินเทอร์เน็ตตอน serve ถูกลงนามไว้ในโทเค็น การแสดงผลที่มาจากที่อยู่อื่นจะถูกตัดออก และการแสดงผลก่อนเวลาที่กำหนดหลัง serve ก็ถูกตัดออกด้วย โทเค็นนับการแสดงผล คลิก และการเข้าได้อย่างละครั้งภายในเวลาที่มีผล งบประมาณแคมเปญจะตรวจอีกครั้งตอนนับ และเหตุการณ์ที่เกินจะไม่นับ (budget)เปิด
การวัดเวลาแสดงผล (view_time)เวลาที่ถูกมองเห็นนับเฉพาะเมื่อมีการป้อนกล้องหรือตัวชี้ในช่วงนั้น และนับได้ถึงเพดานต่อโทเค็น ต่อวันต่อคนต่อโมเดล และต่อวันต่อที่อยู่อินเทอร์เน็ตต่อโมเดลเท่านั้นเปิด
ทราฟฟิกของผู้ดูแลพื้นที่เอง (owner_traffic)เหตุการณ์ที่มาจากที่อยู่อินเทอร์เน็ตที่เคยเปิดหน้าจัดการของพื้นที่นั้นจะถูกตัดออกตามจำนวนวันที่กำหนดเปิด
ร่องรอยการป้อนของมนุษย์ (human_input)คลิกนับเฉพาะที่เบราว์เซอร์ระบุว่าเป็นการป้อนของมนุษย์ (isTrusted) การแสดงผลไม่ดูจำนวนการป้อน (คนที่ดูนิ่งๆ ผู้ใช้คีย์บอร์ดและโปรแกรมอ่านหน้าจอ)เปิด
การเฝ้าระวังค่าผิดปกติและการระงับไว้ (anomaly)การแสดงผลที่คนหนึ่งเห็นเกินจำนวนที่กำหนดต่อวันจะถูกตัดออก คลิกและการเข้าแบบ CPA นับถึงจำนวนที่รับรองอัตโนมัติต่อวันต่อพื้นที่ ส่วนที่เกินจะถูกระงับไว้ หากอัตราคลิกและการเข้า (เทียบกับเครือข่ายที่ไม่รวมพื้นที่นั้น) การแสดงผลต่อคลิกพื้นที่ ผู้ชมใหม่ต่อที่อยู่อินเทอร์เน็ต สัดส่วนดาต้าเซ็นเตอร์ การซ้ำจากที่อยู่เดียวกัน หรือการเข้าต่อคลิก เกินเกณฑ์ ส่วนแบ่งของพื้นที่นั้นในเดือนนั้นจะถูกระงับไว้และผู้ดูแลระบบเป็นผู้ตัดสินเปิด
เครือข่ายดาต้าเซ็นเตอร์ (asn)หาก x-mm-asn (หมายเลข AS) ที่ Cloudflare แนบมาเป็นเครือข่ายคลาวด์หรือโฮสติ้ง เหตุการณ์นั้นจะถูกตัดออก และถ้าสัดส่วนนั้นมาก พื้นที่จะถูกระงับไว้ จะเชื่อถือเฉพาะเมื่อเฮดเดอร์ลับ (origin-auth) ที่ Cloudflare Transform Rule แนบมาด้วยตรงกับค่า env ของเซิร์ฟเวอร์ หากไม่มี เครือข่ายของเหตุการณ์นั้นจะถือเป็น 「ไม่ทราบ」 และสัดส่วนดาต้าเซ็นเตอร์จะวัดจากเหตุการณ์ที่ทราบเครือข่ายเท่านั้นเปิด
การยืนยันว่าเป็นคนตอนเข้า (turnstile)การเข้าพื้นที่แบรนด์ (/ads/go) ต้องผ่าน Cloudflare Turnstile บนโดเมนของ Metamoa จึงจะนับ แม้ไม่ผ่าน ผู้ใช้ก็ยังถูกส่งไปยังพื้นที่แบรนด์ เพียงแต่ไม่นับการเข้า การเข้าที่มาตอนไม่มีคีย์จะถูกระงับไว้เปิด
การยืนยันว่าเป็นคนสำหรับการแสดงผล (turnstile_imp)SDK เรียก Cloudflare Turnstile ในหน้าต่าง metamoa ที่ซ่อนอยู่ แล้วแนบพาสที่ได้ (ผูกกับเครือข่ายและพื้นที่นั้น) ไปกับการแสดงผล ผ่านแล้วนับ ตรวจไม่ผ่านไม่นับ ถ้าไม่มีพาสจะพักไว้เฉพาะการแสดงผลนั้น และเมื่อจบเดือนจะปล่อยหรือยกเลิกตามสัดส่วนที่ตรวจไม่ได้ของพื้นที่ (ผู้ดูแลปล่อยได้) โฆษณาแสดงตามปกติเสมอเปิด

ข้อกำหนดเหตุการณ์

คำขอ 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 ให้วาง glb ของ model_url ถ้าเป็น building ให้วาง glb ของอาคาร แล้วถ้า mode เป็น image ให้ติดรูป image_url บนชื่อ mesh ใน faces ถ้าเป็น texture ให้ติด image_url ทั่วทั้ง texture.meshes ซ้ำตามจำนวน 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 ได้จากหน้าต่าง metamoa ที่ซ่อนอยู่ (Cloudflare Turnstile) โฆษณาแสดงทันทีโดยไม่ต้องรอ หากเว็บไซต์ของคุณส่ง Content-Security-Policy ให้เพิ่ม https://metamoa.com ใน frame-src หากหน้าต่างถูกบล็อกหรือไม่มีพาส การแสดงผลนั้นจะถูกพักไว้ และหลังจบเดือนจะปล่อยถ้าสัดส่วนที่ตรวจไม่ได้ของพื้นที่ไม่เกิน 20% และยกเลิกถ้าเกิน

ส่งได้ครั้งละไม่เกิน 20 รายการ เหตุการณ์ไม่ส่ง vid ผู้ชมใช้ค่าที่อยู่ในโทเค็น เหตุการณ์ที่ผิดและโทเค็นของพื้นที่อื่นจะนับเป็น excluded เท่านั้น

การเข้า · go

การเข้าจะนับหลังจาก /ads/go บนโดเมนของ Metamoa ยืนยันด้วย Cloudflare Turnstile ว่าเป็นคนเท่านั้น (เมื่อมีคีย์ จะมีหน้าจอยืนยันเล็กๆ แสดง 1~2 วินาที) แม้ยืนยันไม่ผ่าน คนนั้นก็ยังไปยังพื้นที่แบรนด์ เพียงแต่ไม่นับการเข้า

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

อาคารโฆษณา ตัวละคร และข้อกำหนดการอัปโหลด

ผู้ลงโฆษณาที่ไม่มีโมเดลเลือกอาคารโฆษณาหรือตัวละครโฆษณาพื้นฐานที่เราให้ได้ อาคารเลือกได้หนึ่งในสองแบบ: แบบรูปภาพ (ใส่รูปหนึ่งรูปบนแต่ละแผ่นป้ายที่กำหนด) · แบบเท็กซ์เจอร์ (เท็กซ์เจอร์หรือลวดลายหนึ่งแผ่นทั่วผิวอาคาร)

โมเดลประเภทขนาดเริ่มต้น (m)อัตราส่วนแบบรูปภาพ: ด้านโฆษณาแบบเท็กซ์เจอร์: ดาวน์โหลดแม่แบบ
แบนเนอร์ธง (banner-flag)เสาแบนเนอร์3.7×3.5×0.40.5~2.52048:1072 ตั้งแต่ 1024×536px ขึ้นไปhttps://metamoa.com/ads/models/banner-flag/banner-flag.texture-default.png · แม่แบบที่มีเส้น https://metamoa.com/ads/models/banner-flag/banner-flag.texture-template.png
เสาแบนเนอร์แนวตั้ง (banner-hanging)เสาแบนเนอร์1.9×3×0.20.5~2.51088:2048 ตั้งแต่ 544×1024px ขึ้นไปhttps://metamoa.com/ads/models/banner-hanging/banner-hanging.texture-default.png · แม่แบบที่มีเส้น https://metamoa.com/ads/models/banner-hanging/banner-hanging.texture-template.png
หอแบนเนอร์ (banner-tower)เสาแบนเนอร์1.2×4×1.20.5~2.5656:1024 ตั้งแต่ 328×512px ขึ้นไปhttps://metamoa.com/ads/models/banner-tower/banner-tower.texture-default.png · แม่แบบที่มีเส้น https://metamoa.com/ads/models/banner-tower/banner-tower.texture-template.png
ป้ายโฆษณา (billboard-board)จอ LED · บิลบอร์ด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)จอ LED · บิลบอร์ด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)จอ LED · บิลบอร์ด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)จอ LED · บิลบอร์ด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)จอ LED · บิลบอร์ด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)จอ LED · บิลบอร์ด12×5.5×12.70.5~1.52048:352 ตั้งแต่ 1024×176px ขึ้นไปhttps://metamoa.com/ads/models/stage-screen/stage-screen.texture-default.png · แม่แบบที่มีเส้น https://metamoa.com/ads/models/stage-screen/stage-screen.texture-template.png
ตู้กดเครื่องดื่ม (vending-drink)ตู้จำหน่ายอัตโนมัติ1.3×1.9×1.20.8~1.5848:1024 ตั้งแต่ 424×512px ขึ้นไปhttps://metamoa.com/ads/models/vending-drink/vending-drink.texture-default.png · แม่แบบที่มีเส้น https://metamoa.com/ads/models/vending-drink/vending-drink.texture-template.png
ตู้กาชาปอง (vending-gacha)ตู้จำหน่ายอัตโนมัติ0.6×1.4×0.60.8~1.5912:1024 ตั้งแต่ 456×512px ขึ้นไปhttps://metamoa.com/ads/models/vending-gacha/vending-gacha.texture-default.png · แม่แบบที่มีเส้น https://metamoa.com/ads/models/vending-gacha/vending-gacha.texture-template.png
ตู้แช่โชว์ (vending-showcase)ตู้จำหน่ายอัตโนมัติ0.9×2×0.80.8~1.5432:1024 ตั้งแต่ 216×512px ขึ้นไปhttps://metamoa.com/ads/models/vending-showcase/vending-showcase.texture-default.png · แม่แบบที่มีเส้น https://metamoa.com/ads/models/vending-showcase/vending-showcase.texture-template.png
ร้านโฆษณา (shop-ad)อาคาร4.2×3.6×3.30.6~22048:1024 ตั้งแต่ 1024×512px ขึ้นไป (รูปเดียวแสดงที่ด้านหน้า ด้านข้าง ด้านหลัง และด้านบน)

แบบเท็กซ์เจอร์ให้ดาวน์โหลดแม่แบบเริ่มต้น (PNG สี่เหลี่ยมจัตุรัส) ไปแก้ แล้วอัปโหลดในขนาดเดิม (1024~2048px) เส้นสีชมพูของแม่แบบที่มีเส้นคือขอบของชิ้นพื้นผิว ระบายเฉพาะด้านในชิ้นก็จะแสดงบนพื้นผิวนั้น

ร้านโฆษณา (shop-ad) แสดงรูปที่อัปโหลดหนึ่งรูปที่ด้านหน้า ด้านข้าง ด้านหลัง และด้านบน: ป้ายด้านหน้า ทั้งสองข้าง ด้านหลัง และแผ่นป้ายบนหลังคาล้วนมีสัดส่วนเดียวกัน จึงอ่านได้จากทุกทิศ แม้มองลงมาจากด้านบน มีประตูจึงใช้ 「เดินเข้าทางประตู」 ("door": true) ได้

ตัวละครโฆษณาพื้นฐานใช้ฟรีไม่ว่าจะใช้จ่ายเท่าไร ยืนหรือเดินไปมาในตำแหน่ง character ถือพร็อพที่ติดกับกระดูก เช่น ป้ายห้อยคอ บัตรพนักงาน ป้ายถือ ลูกโป่ง ธง ถุงช้อปปิ้ง และแผ่นป้ายของพร็อพใส่รูปโฆษณาหรือตัวอักษรป้ายได้ (ไม่เกิน 12 ตัวอักษร) แมว สุนัข และ Vincent ใช้ได้เฉพาะพร็อพที่ห้อยคอ

ตัวละคร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.)
แมวขนสั้น Nyangjupgocat_shortprop-neck-sign prop-badgeCC BY 4.0
แมวขนยาว Nyangjupgocat_longprop-neck-sign prop-badgeCC BY 4.0
แมวมันช์กิ้น Nyangjupgocat_munchkinprop-neck-sign prop-badgeCC BY 4.0
คอร์กี้ Nyangjupgodog_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 (ราคาก่อนภาษี ไม่รวม VAT)₩500,000
สินค้าละเอียดprecise₩100,000 (ราคาก่อนภาษี ไม่รวม VAT)₩1,000,000
ตัวละครใหม่character₩100,000 (ราคาก่อนภาษี ไม่รวม VAT)₩1,000,000

ผู้ลงโฆษณา: ขั้นตอนลงทะเบียนด้วยตนเอง

  1. เข้าสู่ระบบด้วยบัญชี Metamoa ที่ https://metamoa.com/ads/manage (สมัครในหน้าต่างเดียวกัน)
  2. สร้างแคมเปญ: ชื่อ แบรนด์ อุตสาหกรรม และที่อยู่พื้นที่แบรนด์ (เมื่อใช้ CPA การเข้า)
  3. ชิ้นงานโฆษณา: ① อัปโหลดโมเดล 3D ของคุณ (glb) ② เลือกอาคารโฆษณา → แบบรูปภาพใส่รูปทีละแผ่น แบบเท็กซ์เจอร์ใส่เท็กซ์เจอร์หนึ่งแผ่น ③ เลือกตัวละครโฆษณาพื้นฐาน + พร็อพ → ใส่รูปหรือตัวอักษรป้ายบนแผ่นพร็อพ ④ ขอให้ทำโมเดล (เลือกระดับ) จะแสดงข้อกำหนดและตัวอย่าง
  4. พื้นที่แสดง: จากรายการพื้นที่ที่ยินยอมแสดงโฆษณา ดูหมวดหมู่ จำนวนผู้เข้าใช้ตอนนี้ และคลิกพื้นที่ต่อวัน แล้วเลือกตำแหน่งเอง หรือกด 「แนะนำ」 เพื่อรับชุดพื้นที่ที่ตรงกับอุตสาหกรรม หมวดหมู่ และทราฟฟิก
  5. กำหนดวิธีคิดเงิน (CPM, CPA, เวลาแสดงผล, สัญญาตำแหน่งคงที่) งบประมาณ และระยะเวลา แล้วส่งคำขอ → รอตรวจสอบ
  6. เมื่อผ่านการตรวจสอบ (อนาจาร ความรุนแรง สงสัยละเมิดลิขสิทธิ์ ฯลฯ) จะเริ่มแสดง แคมเปญที่กำลังแสดงหยุดและเปิดใหม่ได้ และดูการแสดงผล viewable คลิก การเข้า และเวลาที่ถูกมองเห็นได้ทุกวัน
PUT  https://metamoa.com/api/ads/assets?kind=image&building=billboard-low&face=main   (본문: 이미지 파일)
PUT  https://metamoa.com/api/ads/assets?kind=image&prop=prop-neck-sign                    (본문: 이미지 파일)
POST https://metamoa.com/api/ads/recommend {"industry": "food", "count": 5}
POST https://metamoa.com/api/ads/campaigns
{
  "name": "겨울 우유 3D",
  "brand": "반짝 우유",
  "industry": "food",
  "billing": "cpm",
  "budget_won": 500000,
  "start_day": "2026-12-01",
  "end_day": "2026-12-31",
  "targeting": "recommend",
  "slot_ids": [
    "sl_k2m9x0a1b2c3d4e5"
  ],
  "brand_url": "https://milk.example/space",
  "creative": {
    "kind": "building",
    "building_id": "billboard-low",
    "mode": "image",
    "images": {
      "main": "as_a1b2c3d4e5f6g7h8"
    }
  }
}
(헤더: X-Account-Token: mm1.… · X-Device-Id: <기기 id>)

ชิ้นงานตัวละคร: {"kind": "character", "character_id": "bangjang", "prop": "prop-picket", "image": "as_…"} หรือ "text": "นมวิบวับ" แทน "image" สัญญาตำแหน่งคงที่: "billing": "fixed", "fixed_period": "week" | "month", end_day = start_day + ระยะเวลา − 1 ขอให้ทำโมเดล: {"kind": "request", "grade": "simple", "note": "…"}

ชิ้นงานอาคารและโมเดลของตนเองใส่เพิ่มได้อีกสองอย่าง (ไม่บังคับ): "tagline": "คำอธิบายหนึ่งบรรทัด" (ไม่เกิน 30 ตัวอักษร เฉพาะตัวอักษร — ห้ามแท็ก วงเล็บแหลม วงเล็บปีกกา (400 invalid, fields creative) ตรวจสอบพร้อมชิ้นงาน) จะวาดบนแถบใต้ป้ายของร้านโฆษณาหรืออาคาร (mesh ad_tagline) และส่งมาใน ad.tagline { text, mesh, aspect } ของ serve ส่วน "door": true คือ 「เดินเข้าทางประตู」 (ต้องมี brand_url) เหมือนกับช่อง 「คำอธิบายหนึ่งบรรทัด」 และ 「เดินเข้าทางประตู」 ในขั้นที่ 2 ของ /ads/manage

การตรวจสอบ

รหัสข้อผิดพลาด

เนื้อหาข้อผิดพลาดคือ { "error": "<รหัส>", "message": "<สิ่งที่ต้องทำต่อหนึ่งบรรทัด>" } ข้อผิดพลาดของช่องจะมี fields มาด้วย และขีดจำกัดจะมี retry_after มาด้วย

HTTPerrorความหมาย
400invalidรูปแบบช่องผิด fields จะบอกช่องที่ผิด
400bad_modelไม่ใช่ glb ไม่ใช่ glTF 2.0 หรือมีที่อยู่ภายนอก (uri) เหตุผลอยู่ใน reason
400bad_imageรูปแบบ ขนาด หรือสัดส่วนรูปไม่ตรงข้อกำหนด จะมี reason (format · bytes · too_large · too_small · aspect) และ spec มาด้วย
400bad_buildingdefault_building ของตำแหน่งไม่ใช่ id อาคารหรือป้ายของ GET /ads/v1/buildings (เว้นว่างได้)
400slot_unavailableตำแหน่งที่เลือกไม่รับโฆษณา ไม่รับอุตสาหกรรมนั้น หรือไม่ตรงกับประเภทชิ้นงาน (ตัวละครใช้ได้เฉพาะตำแหน่งตัวละคร) slot_ids จะบอกตำแหน่งนั้น
401unauthorizedไม่มีหรือผิดคีย์พื้นที่หรือการเข้าสู่ระบบหน้าจัดการพื้นที่
401sign_inผู้ลงโฆษณา: ไม่ได้เข้าสู่ระบบบัญชี Metamoa หรือหมดอายุแล้ว
403owner_requiredมีคีย์พื้นที่แต่ยังไม่ได้ยืนยันผู้ดูแลพื้นที่
403owner_page_onlyพยายามยืนยันข้อกำหนดหรือยินยอมแสดงโฆษณาด้วยคีย์พื้นที่ (ทำได้เฉพาะในหน้าจัดการพื้นที่)
403bad_ad_keySDK: space กับ key (mm_adpub_) ไม่ตรงกัน
403terms_requiredพื้นที่นั้นยังไม่ได้ยืนยันข้อกำหนดการแสดงโฆษณา
403ads_offพื้นที่นั้นปิดการยินยอมแสดงโฆษณา
403origin_mismatchคำขอ SDK ไม่ได้มาจากเว็บไซต์ของพื้นที่นั้น (โดเมนเดียวกัน)
404not_houseเรียกโฆษณาของเรา (GET /ads/v1/house) จากที่ที่ไม่ใช่พื้นที่ที่ Metamoa ดูแลเอง
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ผู้ลงโฆษณา: อีเมลของผู้ลงโฆษณาบุคคลไม่ใช่อีเมลที่ใช้เข้าสู่ระบบบัญชี Metamoa นี้
409name_takenมีตำแหน่งชื่อเดียวกันอยู่แล้ว
409slot_limitพื้นที่ละไม่เกิน 30 ตำแหน่งของผู้ดูแลพื้นที่ และไม่เกิน 5 ตำแหน่ง SDK ที่ยังไม่ยืนยัน
409slot_takenตำแหน่งที่มีสัญญาตำแหน่งคงที่อื่นในช่วงนั้นแล้ว
409tier_too_lowเลือกเป็นสัญญาตำแหน่งคงที่สำหรับตำแหน่งในพื้นที่ที่คลิกพื้นที่ต่อวันไม่ถึงระดับต่ำสุด slot_ids จะบอกตำแหน่งนั้น
409not_for_saleไม่มีราคาสัญญาตำแหน่งคงที่
409under_minimumน้อยกว่าค่าสื่อขั้นต่ำ จะมี min_spend_won, spend_won มาด้วย
409no_click_historyเลือก CPM หรือสัญญาตำแหน่งคงที่สำหรับตำแหน่งในพื้นที่ที่ยังไม่มีประวัติคลิกพื้นที่ (วัดปริมาณการแสดงผลและระดับไม่ได้) เลือกได้เฉพาะ CPA และเวลาแสดงผล จะมี slot_ids, billings มาด้วย
409over_inventoryงบ CPM เกินเพดานการแสดงผล viewable ที่คาดไว้ของตำแหน่งที่เลือก จะมี max_budget_won มาด้วย
409rejected_fileใช้ไฟล์ที่ถูกบล็อกในการตรวจสอบกับแคมเปญ
409wrong_stateสิ่งที่ทำไม่ได้ในสถานะนั้น (หยุดแคมเปญที่กำลังตรวจสอบ ฯลฯ)
409staleผู้ดูแลระบบ: แคมเปญเปลี่ยนไปหลังเปิดหน้าตรวจสอบ (version ของ decide ไม่ตรงกับปัจจุบัน) ให้ดูใหม่แล้วตัดสินอีกครั้ง
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