โฆษณา 3D ของ Metamoa · 3D ads
ลงทะเบียนก่อนสำหรับผู้ดูแลพื้นที่ · ดูระดับการแบ่งรายได้
ภาพรวม
โฆษณา 3D ของ Metamoa นำโมเดล 3D อาคารโฆษณา หรือตัวละครโฆษณาของผู้ลงโฆษณาไปวางในตำแหน่งโฆษณาภายในพื้นที่เมตาเวิร์สบนเว็บ นับเฉพาะสิ่งที่คนเห็นและทำจริง เก็บค่าโฆษณาตามนั้น และแบ่งส่วนแบ่งให้ผู้ดูแลพื้นที่ ในฐานะธุรกิจโฆษณาและตัวแทนโฆษณา เรารับตั้งแต่บริษัทใหญ่ไปจนถึงธุรกิจขนาดกลางและเล็ก
- ผู้ดูแลพื้นที่: ในเมนูสร้างรายได้ของหน้าจัดการพื้นที่ (/owner/revenue) ใช้ 「ลงทะเบียนรับโฆษณา」 (ยืนยันข้อกำหนด ข้อมูลการรับเงิน ตำแหน่งโฆษณา) → ใส่สคริปต์หนึ่งบรรทัดและตำแหน่งโฆษณาก็เสร็จ
- ผู้ลงโฆษณา: เข้าสู่ระบบด้วยบัญชี Metamoa ที่ /ads/manage → อัปโหลดโมเดล 3D (glb) หรือเลือกอาคารโฆษณาแล้วใส่รูปหรือเท็กซ์เจอร์ หรือเลือกพร็อพและโฆษณาให้ตัวละครโฆษณาพื้นฐาน → เลือกพื้นที่แสดงเองหรือใช้ 「แนะนำ」 → วิธีคิดเงิน งบประมาณ และระยะเวลา → เริ่มแสดงหลังตรวจสอบ
- ถ้าไม่มีโมเดล เลือก 「ขอให้ทำโมเดล」 แล้วเราจะทำให้ ส่งโมเดลของคุณมาเองก็ได้ ตัวละครโฆษณาพื้นฐานใช้ฟรีไม่ว่าจะใช้จ่ายเท่าไร
- คิดเงินได้สี่แบบ: CPM (การแสดงผลแบบ viewable), CPA (คลิกโมเดล, เข้าพื้นที่แบรนด์), เวลาแสดงผล (เวลาที่ถูกมองเห็นสะสม) และสัญญาตำแหน่งคงที่ (ตามระยะเวลา ใช้ตำแหน่งแต่ผู้เดียว) จำนวนเงินทั้งหมดเป็น (ราคาก่อนภาษี ไม่รวม VAT)
- ขนาดของโมเดลโฆษณาอาจถูกปรับโดยผู้ดูแลพื้นที่หรือ Metamoa ตามแต่ละพื้นที่




สินค้า 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 ตำแหน่ง) |
|---|---|---|---|
| S | 1,000 ขึ้นไป | ₩50,000 | ₩180,000 |
| A | 300~999 | ₩15,000 | ₩50,000 |
| B | 100~299 | ₩5,000 | ₩18,000 |
- ใช้จ่ายขั้นต่ำ: ค่าสื่อ ₩10,000 (ราคาก่อนภาษี ไม่รวม VAT) ไม่รวมค่าทำโมเดล แบบตามผลลัพธ์ดูจากงบประมาณ สัญญาตำแหน่งคงที่ดูจากยอดรวมมูลค่าสัญญา
- แบบตามผลลัพธ์ (CPM, CPA, เวลาแสดงผล) คิดเงินเฉพาะที่นับได้จริง และเมื่อยอดใช้จ่ายถึงงบประมาณ (budget_won) แคมเปญนั้นจะหยุดแสดง
- สัญญา CPM รับได้ไม่เกิน 70% ของการแสดงผล viewable ที่คาดไว้ของตำแหน่งที่เลือก (คลิกพื้นที่ต่อวัน × 0.7 × จำนวนวัน) (409 over_inventory)
- แบบ CPA และเวลาแสดงผลไม่ถูกบล็อก แต่ถ้างบประมาณมากกว่ายอดใช้จ่ายที่คาดไว้ /ads/manage จะแจ้งก่อนส่งคำขอ: บนการแสดงผล viewable ที่คาดไว้เดียวกัน CPA คูณด้วยอัตราคลิกอ้างอิง 2% × ราคาที่สูงกว่าระหว่างราคาคลิกกับราคาเข้า ส่วนเวลาแสดงผลคูณด้วย 60 วินาทีต่อคนต่อวัน (spend_estimate ของ GET /api/ads/options)
- ตำแหน่งที่มีสัญญาตำแหน่งคงที่จะแสดงเฉพาะแคมเปญนั้นตลอดช่วงสัญญา และไม่รับสัญญาคงที่อื่นในตำแหน่งเดียวกันที่ช่วงเวลาทับกัน (409 slot_taken) ตำแหน่งถูกจองเมื่อผ่านการอนุมัติ: คำขอที่รอตรวจสอบไม่จองตำแหน่ง และสัญญาที่ได้รับอนุมัติก่อนเป็นฝ่ายได้ หากมีวันที่โมเดลไม่แสดงหรือทราฟฟิกลดลงเกิน 30% เราจะชดเชยด้วยการคืนเงินตามสัดส่วนวันหรือขยายเวลา
- การคิดเงินและระดับอ้างอิงจากรายงานที่ Metamoa วัดจริง (การแสดงผล viewable คลิก การเข้า เวลาที่ถูกมองเห็น คลิกพื้นที่)
สูตรการนับ
วันที่นับเป็นรายวันตามเวลาเกาหลี (ad_daily) จำนวนเงินเป็นราคาก่อนภาษีที่ตัดเศษต่ำกว่าหนึ่งวอนทิ้ง เหตุการณ์ที่ติดกฎจะไม่นับ และนับแยกตามเหตุผล (ad_excluded)
- การแสดงผล viewable imps = จำนวนเหตุการณ์
impที่ผ่านทุกกฎ - คลิก clicks = จำนวน
clickที่ผ่าน, การเข้า enters = จำนวนการเข้า (/ads/go) ที่ผ่าน, converted = จำนวนที่คลิกแล้วเข้าต่อด้วยโทเค็นเดียวกัน - เวลาที่ถูกมองเห็น view_ms = ผลรวม ms ของเหตุการณ์
timeที่ผ่าน (เฉพาะโทเค็นที่นับการแสดงผลแล้ว สูงสุด 15,000ms ต่อเหตุการณ์ และสูงสุดถึงเพดานรายวันต่อคนต่อโมเดล) - ยอด 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) ยอดคือราคาสื่อก่อนภาษีหลังหักทราฟฟิกที่ไม่ถูกต้อง ค่าทำโมเดลและค่าสร้างพื้นที่ไม่นำมาแบ่ง ระดับดูที่ 「ระดับการแบ่งรายได้ของผู้ดูแลพื้นที่」 ด้านล่าง
ระดับการแบ่งรายได้ของผู้ดูแลพื้นที่
รายได้โฆษณา (ยอดสื่อโฆษณาต่อพื้นที่ ราคาก่อนภาษีหลังหักทราฟฟิกที่ไม่ถูกต้อง) แบ่งระหว่างผู้ดูแลพื้นที่กับ Metamoa ตามสัดส่วนของระดับ มีผลตั้งแต่ 11/11/2026 ข้อมูลการลงทะเบียนก่อน: https://metamoa.com/ads/partners
| ระดับ | กลุ่ม | ผู้ดูแลพื้นที่ : Metamoa |
|---|---|---|
| แพลทินัม | มาก่อนได้ก่อน: ผู้ดูแลพื้นที่ลำดับที่ 1~10 | 9:1 |
| โกลด์ | ผู้ดูแลพื้นที่ลำดับที่ 11~100 (90 คน) | 8:2 |
| ซิลเวอร์ | ผู้ดูแลพื้นที่หลังจากนั้น | 7:3 |
| บรอนซ์ | ผู้ดูแลพื้นที่ที่ทำสัญญาใหม่ตั้งแต่ 1/1/2027 | 6:4 |
สัดส่วนอาจปรับเปลี่ยนได้ในอนาคตตามผลลัพธ์ของโฆษณา
- ผู้ดูแลพื้นที่ = บัญชีเจ้าของที่ลงทะเบียนพื้นที่บน Metamoa และเข้าสู่ระบบหน้าจัดการพื้นที่ ลำดับเรียงตามเวลาที่เปิด 「ยินยอมแสดงโฆษณา」 ในหน้าจัดการพื้นที่เป็นครั้งแรก โดยเซิร์ฟเวอร์ให้หมายเลขทีละราย
- ระดับที่กำหนดแล้วจะคงอยู่ตามเดิม และพื้นที่อื่นของผู้ดูแลพื้นที่คนเดียวกันก็อยู่ในระดับเดียวกัน
- ผู้ดูแลพื้นที่ที่ทำสัญญาใหม่ตั้งแต่ 1/1/2027 เวลา 0:00 น. (เวลาเกาหลี) จะเป็นบรอนซ์ไม่ว่าจะลำดับใด
- ระดับและสัดส่วนของฉัน: ช่อง 「โฆษณา 3D」 ในหน้าจัดการพื้นที่, partner ของ GET /api/space/{id}/ads ที่นั่งที่เหลือ: seats ของ GET /api/ads/partners
- ที่นั่งที่เหลือตอนนี้: แพลทินัม 0/10 · โกลด์ 80/90
การยืนยันข้อกำหนดและการยินยอมแสดงโฆษณา
ข้อกำหนดการใช้งานได้เพิ่มข้อว่าด้วยการแสดงโฆษณา (ข้อ 4-4) แล้ว หากต้องการรับโฆษณา ผู้ดูแลพื้นที่ต้องทำสองอย่างพร้อมกันใน 「ลงทะเบียนรับโฆษณา」 ของเมนูสร้างรายได้ในหน้าจัดการพื้นที่
- ยืนยันข้อกำหนด: ติ๊กยืนยันข้อกำหนดในขั้นที่ 1 ของ 「ลงทะเบียนรับโฆษณา」 ในหน้าจัดการพื้นที่ (/owner/revenue?id=<id พื้นที่>) ทำได้เฉพาะในหน้าจัดการพื้นที่ (ถ้าใช้คีย์พื้นที่จะได้ 403 owner_page_only)
- ยินยอมแสดงโฆษณา: เปิดพร้อมกับการยืนยันข้อกำหนด หลังจากนั้นเปิดปิดได้ทีละพื้นที่ในหน้าจอเดียวกัน การเปิดต้องมีประเภทข้อมูลการรับเงินและช่องทางติดต่อ (ถ้าไม่มีจะได้ 409 payout_info_required) ต้องเปิดก่อน API โฆษณาของพื้นที่นั้น (สคริปต์หนึ่งบรรทัด คีย์โฆษณา) จึงจะแสดง และเมื่อปิด โฆษณาจะหยุดทันที (serve 403 ads_off)
บันทึกการยินยอม: พื้นที่ ใคร (แฮชของอีเมลที่ผู้ดูแลพื้นที่ใช้เข้าสู่ระบบหน้าจัดการพื้นที่นั้น) เมื่อไร ข้อกำหนดฉบับใด (data-ads-version ของ terms.html) และเปิดหรือปิด ถูกเก็บสะสมไว้โดยไม่ลบ (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 | เมื่อปิด ตำแหน่งนี้จะไม่มีโฆษณาแสดง |
ขนาดของโมเดลโฆษณาอาจถูกปรับโดยผู้ดูแลพื้นที่หรือ 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}ผู้ดูแลพื้นที่: ขั้นตอนการติดตั้ง
- ใน 「ลงทะเบียนรับโฆษณา」 ของเมนูสร้างรายได้ในหน้าจัดการพื้นที่ (
https://metamoa.com/owner/revenue?id=<id พื้นที่>) ติ๊กยืนยันข้อกำหนดแล้วเริ่มโฆษณา - นำสคริปต์หนึ่งบรรทัดจากช่อง 「API โฆษณา」 ในหน้าจอเดียวกันไปใส่ท้าย <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 ในหน้าต่างใหม่หรือหน้าต่างเดิมก็ได้ ข้อกำหนดดูที่ 「ข้อกำหนดเหตุการณ์」 ด้านล่าง
วิธีที่ SDK นับ
- การแสดงผล viewable: เมื่อโมเดลอยู่ในภาพกล้องไม่น้อยกว่าสัดส่วนที่กำหนด มีขนาดบนจอไม่น้อยกว่าพื้นที่ที่กำหนด และต่อเนื่องนานเกินเวลาที่กำหนดขณะแท็บแสดงอยู่ จะส่งการแสดงผล 1 ครั้ง (โทเค็น serve ละครั้ง)
- เวลาที่ถูกมองเห็น: หลังการแสดงผล ระหว่างที่โฆษณายังมองเห็นตามเงื่อนไขข้างต้น จะสะสมและส่งทุก 5 วินาที พร้อมจำนวนการป้อนกล้องและตัวชี้ในช่วงนั้น (หยุดเมื่อแท็บถูกซ่อน)
- หากการตอบกลับของ serve มี vid ให้เก็บไว้ในเบราว์เซอร์นั้น แล้วส่งไปด้วยตั้งแต่ serve ครั้งถัดไป (GET /ads/v1/serve?…&vid=) จะอ่านเฉพาะ vid ที่เซิร์ฟเวอร์ลงนามให้เครือข่ายนั้น เซิร์ฟเวอร์รวม vid กับกลุ่ม IP ที่เชื่อมต่อ แล้วลงนามคนนั้นไว้ในโทเค็น การแสดงผลจะนับหลังจาก serve ราว 2 วินาที
- คลิก: เมื่อแตะหรือคลิกโฆษณาจะส่ง
clickและถ้าโฆษณามีพื้นที่แบรนด์ จะเปิด enter_url (/ads/go) ในหน้าต่างใหม่ เซิร์ฟเวอร์นับการเข้าแล้วส่งไปยังพื้นที่แบรนด์ - ประตู: ถ้ามี ad.door เมื่อเดินเข้าทางประตูจะเปิด enter_url ในหน้าต่างใหม่หนึ่งครั้ง เงื่อนไขการเปิดอีกครั้งดูที่ 「เดินเข้าทางประตู」 ด้านล่าง
- id เบราว์เซอร์ (vid) เซิร์ฟเวอร์เป็นผู้ให้ และ SDK เก็บไว้ใน localStorage ใช้เฉพาะการจำกัดการซ้ำ ไม่ส่งข้อมูลส่วนบุคคล เช่น ชื่อหรือช่องทางติดต่อ
- โฆษณาจะรับใหม่ทุก 30 นาที (โทเค็นใหม่) ตัวละครในตำแหน่ง character จะเดินช้าๆ ภายในรัศมี roam
เดินเข้าทางประตู
ติดประตูให้อาคารโฆษณาหรือโมเดล 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.2m หน้าประตู จะเปิดพื้นที่แบรนด์ (enter_url ที่มี &via=door) ในหน้าต่างใหม่หนึ่งครั้ง
- หลังปิดหน้าต่างที่เปิดใหม่แล้วกลับมา แม้จะขยับเล็กน้อยในประตูหรือใกล้ประตู ประตูก็จะไม่เปิดอีก
- ต้องเดินออกไปไกลจากประตูเกิน 3m แล้วกลับเข้ามา ประตูจึงจะเปิดอีกครั้ง (ระยะเข้า 1.2m < ระยะออก 3m)
- ขณะที่แท็บถูกซ่อนหรือหน้าต่างไม่ได้โฟกัส ประตูจะไม่เปิด และเมื่อกลับมาแล้วต้องออกจากเขตประตูหนึ่งครั้ง หากตอนเปิดหน้ายืนอยู่ในประตูอยู่แล้วก็จะไม่เปิด
- การแตะหรือคลิกอาคารเพื่อเปิดยังทำได้เหมือนเดิม (ทุกครั้งที่คลิก) กฎประตูใช้เฉพาะกับการเดินเข้าไป
- หากเบราว์เซอร์บล็อกหน้าต่างใหม่ ปุ่ม 「เปิด <แบรนด์>」 จะแสดงที่ด้านล่างของจอ ต้องกดปุ่มนั้นจึงจะเปิด (ถ้าออกจากประตูโดยไม่กด ปุ่มจะหายไป)
ตำแหน่งประตู: ถ้าใน 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 และหลังจากแท็บถูกซ่อนแล้วกลับมา จะไม่เปิดอีกจนกว่าจะออกจากเขตประตูหนึ่งครั้ง
เพื่อไม่ให้การเดินเข้าออกกินงบประมาณ
- การเข้าทางประตูคิดในราคาเดียวกับการเข้าแบบ CPA 1 ครั้ง (ราคาและการใช้จ่ายขั้นต่ำคงเดิม)
- การเข้าของคนหนึ่งคน (id เบราว์เซอร์ที่เซิร์ฟเวอร์ให้ + กลุ่มที่อยู่อินเทอร์เน็ต) ต่อหนึ่งแคมเปญ นับได้ 24 ชั่วโมงต่อครั้ง และไม่เกิน 3 ครั้งใน 30 วัน กลุ่มที่อยู่อินเทอร์เน็ตเดียวกันไม่เกินวันละ 3 ครั้งต่อแคมเปญต่อพื้นที่
- การเข้าที่เข้าออกเกินกว่านั้นยังส่งไปยังพื้นที่แบรนด์ แต่ไม่คิดเงิน บันทึกไว้เท่านั้น (เหตุผลที่ตัดออก repeat_limit) มีการตรวจซ้ำด้วยบันทึกเหตุการณ์ของเซิร์ฟเวอร์ (เฉพาะแฮช) จึงไม่ลืมแม้เซิร์ฟเวอร์รีสตาร์ต
- การเข้าด้วยโทเค็น serve เดียวกันนับครั้งเดียว และนับเฉพาะโทเค็นที่นับการแสดงผลไปก่อนแล้ว (ตามกฎตรวจสอบบอตและการฉ้อโกงเดิม)
กฎตรวจสอบบอตและการฉ้อโกง
บนเซิร์ฟเวอร์ เหตุการณ์จะผ่านกฎด้านล่างตามลำดับ หากติดกฎใดกฎหนึ่งจะถูกตัดออกจากสถิติและนับแยกตามชื่อกฎนั้น กฎแต่ละข้อเปิดปิดได้ใน 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 ที่ซ่อนอยู่ แล้วแนบพาสที่ได้ (ผูกกับเครือข่ายและพื้นที่นั้น) ไปกับการแสดงผล ผ่านแล้วนับ ตรวจไม่ผ่านไม่นับ ถ้าไม่มีพาสจะพักไว้เฉพาะการแสดงผลนั้น และเมื่อจบเดือนจะปล่อยหรือยกเลิกตามสัดส่วนที่ตรวจไม่ได้ของพื้นที่ (ผู้ดูแลปล่อยได้) โฆษณาแสดงตามปกติเสมอ | เปิด |
- คลิกและการเข้าจะนับเฉพาะเมื่อการแสดงผลของโทเค็นนั้นถูกนับไปก่อนแล้ว (ไม่เช่นนั้นเป็น 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 ให้วาง 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 | ช่อง | ความหมาย |
|---|---|---|
| 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 ได้จากหน้าต่าง 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: /)อาคารโฆษณา ตัวละคร และข้อกำหนดการอัปโหลด
ผู้ลงโฆษณาที่ไม่มีโมเดลเลือกอาคารโฆษณาหรือตัวละครโฆษณาพื้นฐานที่เราให้ได้ อาคารเลือกได้หนึ่งในสองแบบ: แบบรูปภาพ (ใส่รูปหนึ่งรูปบนแต่ละแผ่นป้ายที่กำหนด) · แบบเท็กซ์เจอร์ (เท็กซ์เจอร์หรือลวดลายหนึ่งแผ่นทั่วผิวอาคาร)
แบบเท็กซ์เจอร์ให้ดาวน์โหลดแม่แบบเริ่มต้น (PNG สี่เหลี่ยมจัตุรัส) ไปแก้ แล้วอัปโหลดในขนาดเดิม (1024~2048px) เส้นสีชมพูของแม่แบบที่มีเส้นคือขอบของชิ้นพื้นผิว ระบายเฉพาะด้านในชิ้นก็จะแสดงบนพื้นผิวนั้น
ร้านโฆษณา (shop-ad) แสดงรูปที่อัปโหลดหนึ่งรูปที่ด้านหน้า ด้านข้าง ด้านหลัง และด้านบน: ป้ายด้านหน้า ทั้งสองข้าง ด้านหลัง และแผ่นป้ายบนหลังคาล้วนมีสัดส่วนเดียวกัน จึงอ่านได้จากทุกทิศ แม้มองลงมาจากด้านบน มีประตูจึงใช้ 「เดินเข้าทางประตู」 ("door": true) ได้
ตัวละครโฆษณาพื้นฐานใช้ฟรีไม่ว่าจะใช้จ่ายเท่าไร ยืนหรือเดินไปมาในตำแหน่ง character ถือพร็อพที่ติดกับกระดูก เช่น ป้ายห้อยคอ บัตรพนักงาน ป้ายถือ ลูกโป่ง ธง ถุงช้อปปิ้ง และแผ่นป้ายของพร็อพใส่รูปโฆษณาหรือตัวอักษรป้ายได้ (ไม่เกิน 12 ตัวอักษร) แมว สุนัข และ Vincent ใช้ได้เฉพาะพร็อพที่ห้อยคอ
| ตัวละคร | 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) หนึ่งไฟล์ ไม่เกิน 6MB เท็กซ์เจอร์อยู่ในไฟล์ ไม่มีที่อยู่ภายนอก (uri)
- ไฟล์ที่อัปโหลดจะตรวจรูปแบบจากเนื้อหา (magic byte): รูปรับเฉพาะ PNG, JPEG, WebP (ไม่รับ SVG, HTML ฯลฯ) แล้วสร้างใหม่เป็น WebP ส่วนโมเดลรับเฉพาะไบนารี glTF 2.0 ไฟล์โฆษณาส่งออกด้วยประเภทคงที่ (image/webp, model/gltf-binary), nosniff และนโยบาย sandbox เท่านั้น จึงไม่ถูกรันเป็นสคริปต์
- ขนาดของโมเดลโฆษณาอาจถูกปรับโดยผู้ดูแลพื้นที่หรือ Metamoa ตามแต่ละพื้นที่
- ไฟล์โมเดลและตัวละครอยู่ใต้ /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 (ราคาก่อนภาษี ไม่รวม VAT) | ₩500,000 |
| สินค้าละเอียด | precise | ₩100,000 (ราคาก่อนภาษี ไม่รวม VAT) | ₩1,000,000 |
| ตัวละครใหม่ | character | ₩100,000 (ราคาก่อนภาษี ไม่รวม VAT) | ₩1,000,000 |
- เกณฑ์ฟรีดูจากค่าสื่อที่ใช้จริง (รวมตลอดระยะสัญญา สูงสุด 3 เดือน ไม่รวมค่าทำโมเดล VAT และทราฟฟิกที่ไม่ถูกต้อง)
- โมเดลที่ทำให้ฟรีจะให้เฉพาะสิทธิ์ใช้เพื่อเผยแพร่บน Metamoa (ลิขสิทธิ์เป็นของ Metamoa การโอนต้องชำระค่าทำ) แก้ไขได้ 1 ครั้ง หากผู้ลงโฆษณายกเลิกหรือลดยอดด้วยเหตุของตนเอง จะเรียกเก็บค่าทำตามสัดส่วน: ค่าทำ × (1 − ค่าสื่อที่ใช้จริง ÷ เกณฑ์ฟรี) โมเดลที่ชำระเงินแก้ไขได้ 2 ครั้ง
- ตัวละครโฆษณาพื้นฐาน (ตัวละครของแคมป์ Moa และ Nyangjupgo) ใช้ได้ฟรีโดยไม่ต้องขอให้ทำ ไม่ว่าจะใช้จ่ายเท่าไร
ผู้ลงโฆษณา: ขั้นตอนลงทะเบียนด้วยตนเอง
- เข้าสู่ระบบด้วยบัญชี Metamoa ที่ https://metamoa.com/ads/manage (สมัครในหน้าต่างเดียวกัน)
- สร้างแคมเปญ: ชื่อ แบรนด์ อุตสาหกรรม และที่อยู่พื้นที่แบรนด์ (เมื่อใช้ CPA การเข้า)
- ชิ้นงานโฆษณา: ① อัปโหลดโมเดล 3D ของคุณ (glb) ② เลือกอาคารโฆษณา → แบบรูปภาพใส่รูปทีละแผ่น แบบเท็กซ์เจอร์ใส่เท็กซ์เจอร์หนึ่งแผ่น ③ เลือกตัวละครโฆษณาพื้นฐาน + พร็อพ → ใส่รูปหรือตัวอักษรป้ายบนแผ่นพร็อพ ④ ขอให้ทำโมเดล (เลือกระดับ) จะแสดงข้อกำหนดและตัวอย่าง
- พื้นที่แสดง: จากรายการพื้นที่ที่ยินยอมแสดงโฆษณา ดูหมวดหมู่ จำนวนผู้เข้าใช้ตอนนี้ และคลิกพื้นที่ต่อวัน แล้วเลือกตำแหน่งเอง หรือกด 「แนะนำ」 เพื่อรับชุดพื้นที่ที่ตรงกับอุตสาหกรรม หมวดหมู่ และทราฟฟิก
- กำหนดวิธีคิดเงิน (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_…"} หรือ "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
การตรวจสอบ
- โมเดล รูป และแคมเปญที่อัปโหลดจะอยู่ในสถานะรอตรวจสอบ (review) ก่อนเผยแพร่ เมื่อผู้ดูแลระบบอนุมัติจะเริ่มแสดง (active) ถ้าปฏิเสธจะเก็บ rejected พร้อมเหตุผล
- รูปจะถูกตรวจด้วย AI ตอนอัปโหลดก่อน ว่ามีความอนาจาร ความรุนแรง โลโก้หรือตัวละครของผู้อื่นหรือไม่ ถ้าติดจะบล็อกทันที (rejected) ถ้าตรวจไม่ได้ ผู้ดูแลระบบจะดูเอง
- โมเดลผู้ดูแลระบบจะเปิดดูเอง ถ้าอนาจาร รุนแรง หรือสงสัยละเมิดลิขสิทธิ์จะปฏิเสธ
รหัสข้อผิดพลาด
เนื้อหาข้อผิดพลาดคือ { "error": "<รหัส>", "message": "<สิ่งที่ต้องทำต่อหนึ่งบรรทัด>" } ข้อผิดพลาดของช่องจะมี 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 ของตำแหน่งไม่ใช่ id อาคารหรือป้ายของ GET /ads/v1/buildings (เว้นว่างได้) |
| 400 | slot_unavailable | ตำแหน่งที่เลือกไม่รับโฆษณา ไม่รับอุตสาหกรรมนั้น หรือไม่ตรงกับประเภทชิ้นงาน (ตัวละครใช้ได้เฉพาะตำแหน่งตัวละคร) slot_ids จะบอกตำแหน่งนั้น |
| 401 | unauthorized | ไม่มีหรือผิดคีย์พื้นที่หรือการเข้าสู่ระบบหน้าจัดการพื้นที่ |
| 401 | sign_in | ผู้ลงโฆษณา: ไม่ได้เข้าสู่ระบบบัญชี Metamoa หรือหมดอายุแล้ว |
| 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) จากที่ที่ไม่ใช่พื้นที่ที่ Metamoa ดูแลเอง |
| 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 | ผู้ลงโฆษณา: อีเมลของผู้ลงโฆษณาบุคคลไม่ใช่อีเมลที่ใช้เข้าสู่ระบบบัญชี Metamoa นี้ |
| 409 | name_taken | มีตำแหน่งชื่อเดียวกันอยู่แล้ว |
| 409 | slot_limit | พื้นที่ละไม่เกิน 30 ตำแหน่งของผู้ดูแลพื้นที่ และไม่เกิน 5 ตำแหน่ง SDK ที่ยังไม่ยืนยัน |
| 409 | slot_taken | ตำแหน่งที่มีสัญญาตำแหน่งคงที่อื่นในช่วงนั้นแล้ว |
| 409 | tier_too_low | เลือกเป็นสัญญาตำแหน่งคงที่สำหรับตำแหน่งในพื้นที่ที่คลิกพื้นที่ต่อวันไม่ถึงระดับต่ำสุด 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 | ผู้ดูแลระบบ: แคมเปญเปลี่ยนไปหลังเปิดหน้าตรวจสอบ (version ของ decide ไม่ตรงกับปัจจุบัน) ให้ดูใหม่แล้วตัดสินอีกครั้ง |
| 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