Metamoa
Favoriten Ranking

Metamoa-3D-Anzeigen · 3D ads

Auf einen Blick

Metamoa-3D-Anzeigen platzieren das 3D-Modell, Werbegebäude oder die Werbefigur eines Werbetreibenden auf Werbeplätzen in Web-Metaverse-Räumen, zählen nur, was Menschen tatsächlich gesehen und getan haben, rechnen danach ab und teilen den Anteil mit den Raumbetreibern. Als Werbe- und Werbeagenturgeschäft nehmen wir Kunden von Großunternehmen bis zu kleinen und mittleren Unternehmen an.

Echter Bildschirm · Moa Campsite
Echter Bildschirm · Moa Campsite
Echter Bildschirm · Läden im Moa Campsite (Eigenwerbung)
Echter Bildschirm · Läden im Moa Campsite (Eigenwerbung)
Echter Bildschirm · Hof von AI Butta
Echter Bildschirm · Hof von AI Butta
Echter Bildschirm · Walking Into Van Gogh
Echter Bildschirm · Walking Into Van Gogh

4 Produkte und Abrechnung

Alle Beträge sind Nettopreise zzgl. MwSt.

ProduktbillingWas gezählt wirdStückpreis
CPM (sichtbare Impressionen)cpm1 sichtbare Impression = das Modell ist mindestens zu einem festgelegten Anteil und länger als eine festgelegte Zeit ununterbrochen auf dem Bildschirm (bei sichtbarem Tab)₩8,000 pro 1,000 sichtbare
CPA · ModellklickcpaEin Tippen oder Klicken auf das Werbemodell. Führt der Klick weiter zu einem Eintritt in den Markenraum, wird nur dieser 1 Eintritt berechnet₩700 pro 1 Klick
CPA · Eintritt in den MarkenraumcpaAuf die Anzeige tippen und in den Markenraum (brand_url) gelangen. Gezählt per Server-Weiterleitung (/ads/go); einmal pro Tag je Person und Kampagne₩1,000 pro 1 Eintritt
AnzeigedauertimeGesamte Zeit, in der die Anzeige nach einer sichtbaren Impression angezeigt wurde (nur bei Eingaben, bis zu einem Tageslimit je Person und Modell)₩1,000 pro 1,000 sichtbare Sekunden
Fester PlatzvertragfixedFür einen festen Zeitraum (bis zu einem Monat). Sie nutzen den vertraglich gebuchten Werbeplatz in diesem Zeitraum exklusiv (pro Platz). Impressionen werden nicht garantiertSiehe Stufentabelle unten

Stufen des festen Platzvertrags

Die Stufe richtet sich nach dem Median der bereinigten täglichen Raumklicks der letzten 14 Tage des Raums, in dem der Platz liegt (ohne eigene Besuche des Betreibers, Rechenzentrumsnetze und automatisierte Browser; metamoas „Betreten“ zählt nur nach der Menschenprüfung). Plätze in Räumen unterhalb der niedrigsten Stufe werden nicht als fester Vertrag verkauft, sondern nur leistungsbasiert. Die Vertragslaufzeit ist entweder wöchentlich (7 Tage) oder monatlich (30 Tage).

StufeTägliche RaumklicksWöchentlich (1 Platz)Monatlich (1 Platz)
S1,000 oder mehr₩50,000₩180,000
A300~999₩15,000₩50,000
B100~299₩5,000₩18,000

Zählformeln

Datumsangaben sind Tage nach koreanischer Zeit (ad_daily). Beträge sind Nettopreise ohne Bruchteile eines Won. Von einer Regel erfasste Ereignisse werden nicht gezählt und nach Grund getrennt erfasst (ad_excluded).

Umsatzbeteiligungsstufen für Raumbetreiber

Die Werbeeinnahmen (der Werbe-Media-Betrag je Raum, Nettopreis nach Abzug ungültigen Traffics) werden zwischen Raumbetreiber und Metamoa im Verhältnis der Stufe geteilt. Gültig ab 11.11.2026. Frühe Registrierung: https://metamoa.com/ads/partners

StufeWerRaumbetreiber : Metamoa
PlatinWer zuerst kommt: Raumbetreiber 1 bis 109:1
GoldRaumbetreiber 11 bis 100 (90 Personen)8:2
SilberRaumbetreiber danach7:3
BronzeRaumbetreiber, die ab dem 1.1.2027 einen neuen Vertrag abschließen6:4

Die Anteile können künftig je nach Werbeleistung angepasst werden.

Werbeplätze

Die Raumbetreiber legen selbst fest, wo in ihrem eigenen Metaverse Anzeigen stehen. Werbetreibende wählen Plätze oder erhalten Empfehlungen, und auch feste Verträge werden pro Platz geschlossen. Die Platzliste kann in der Raumverwaltung eingesehen und ein- und ausgeschaltet werden.

FeldFormatBedeutung
name1 bis 40 ZeichenEin Name, der im Raum nur einmal vorkommt
kindfloor · wall · air · characterBodenmodell · Wandschild · Luftbanner · stehende oder umherlaufende Werbefigur
position[x, y, z] MeterPosition der Mitte des Bodens der Platzbox (Raumkoordinaten)
rotation[x, y, z] Grad (-360 bis 360)Drehung des Platzes. Standard [0, 0, 0]
size[Breite, Höhe, Tiefe] Meter (0.1 bis 200)Die Box, in die die Anzeige kommt. Die Anzeige wird passend zu dieser Box vergrößert oder verkleinert
scale[min, max] fach (0.05 bis 20)Größenfaktor je Raum: Beim Einpassen in die Box wird die Anzeige nur innerhalb dieses Bereichs ihrer Originalgröße skaliert. Standard [0.25, 4]
roam0 bis 50 Metercharacter-Plätze: der Radius, in dem die Figur umherläuft (0 bedeutet stehend)
industriesListe der Branchen-IDsBranchen, die dieser Platz annimmt. Leer bedeutet alle Branchen
enabledtrue · falseAusgeschaltet werden auf diesem Platz keine Anzeigen ausgespielt

Die Größe eines Werbemodells kann je nach Raum vom Raumbetreiber oder von Metamoa angepasst werden.

Figurenanzeigen gehen nur auf character-Plätze, Modell- und Gebäudeanzeigen nur auf floor-, wall- und air-Plätze.

Das SDK (öffentlicher Anzeigenschlüssel) kann nur neue Plätze anlegen, und so angelegte Plätze sind zunächst ausgeschaltet; Anzeigen werden erst ausgespielt, wenn der Raumbetreiber sie in der Raumverwaltung prüft und einschaltet. Einen bestehenden Platz (gleicher Name) kann das SDK nicht ändern und gibt ihn unverändert zurück. Bis zu 5 ausgeschaltete SDK-Plätze je Raum, getrennt von den 30 Betreiberplätzen gezählt. Eine IP-Gruppe kann bis zu 20 pro Tag anlegen, und SDK-Plätze, die der Raumbetreiber innerhalb von 7 Tagen nie eingeschaltet hat, werden gelöscht (einmal eingeschaltete und von einer Kampagne genutzte Plätze nicht). Eingeschaltet zählen sie zu den 30 Betreiberplätzen. Box, Art oder Branchen eines Platzes ändern und ihn ein- oder ausschalten geht nur mit einer Anmeldung in der Raumverwaltung oder dem Raumschlüssel.

Branchen-IDs: game (Spiele) · fashion (Mode, Beauty) · food (Essen und Getränke) · tech (IT, Elektronik) · finance (Finanzen) · edu (Bildung) · travel (Reisen, Freizeit) · culture (Kultur, Unterhaltung) · auto (Autos) · public (öffentlich, gemeinnützig) · etc (Sonstiges)

Bis zu 30 Plätze je Raum. Die Platz-API nutzt den Raumschlüssel (mm_live_) oder eine Anmeldung in der Raumverwaltung:

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}

Raumbetreiber: Schritte zur Einrichtung

  1. In 「Für Anzeigen registrieren」 der Monetarisierung der Raumverwaltung (https://metamoa.com/owner/revenue?id=<Raum-ID>) die Bedingungen bestätigen und Anzeigen starten.
  2. Die Skriptzeile aus dem Bereich 「Anzeigen-API」 desselben Bildschirms ans Ende von <head> oder <body> Ihrer Raumseite setzen. Der Anzeigenschlüssel (mm_adpub_) darf öffentlich sein (den Raumschlüssel mm_live_ dort niemals einfügen).
  3. Bei einem three.js-Raum attach und slot aufrufen, nachdem die Szene aufgebaut ist. Ein Platz wird beim ersten Aufruf ausgeschaltet registriert. Anzeigen werden ausgespielt, sobald Sie ihn in 「Werbeplätze」 der Raumverwaltung einschalten (Sie können ihn auch per Platz-API von Anfang an eingeschaltet anlegen).
  4. Sobald die Anzeige zu sehen ist, sind Sie fertig. Sichtbare Impressionen, Klicks und Anzeigedauer sendet das SDK selbst, und für Eintritte in den Markenraum öffnet das SDK beim Tippen auf die Anzeige /ads/go, und der Server zählt.
  5. In 「Werbeplätze」 der Raumverwaltung Plätze ein- und ausschalten und den 30-Tage-Bericht (vor und nach den Regeln) sowie Ihren Anteil ansehen (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 });
});

Andere Engines als three.js (Babylon.js, PlayCanvas, Unity WebGL usw.) holen die Anzeige mit serve, zeichnen sie selbst und senden die Ereignisse: ads.serve(name) → { ad }, ads.report(name, event). Für Eintritte ad.enter_url in einem neuen oder demselben Fenster öffnen. Die Spezifikation steht unten in 「Ereignisspezifikation」.

Wie das SDK zählt

Durch die Tür eintreten

Sie können einem Werbegebäude oder Ihrem eigenen 3D-Modell eine Tür geben. Es ist eine Tür, kein Portal: Wenn jemand durch die Tür hineingeht, bleibt der aktuelle Raum bestehen, und der Markenraum öffnet sich in einem neuen Fenster (neuer Tab). "door": true im creative der Kampagne setzen (nur wenn kind model oder building ist), und brand_url ist erforderlich (sonst 400 invalid, fields brand_url). Das ad von serve enthält dann 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 } }

Regeln, damit sich die Tür nicht ständig neu öffnet (unbedingt einhalten)

  1. Wer sich der Tür auf weniger als 1.2 m nähert, öffnet den Markenraum (enter_url mit &via=door) einmal in einem neuen Fenster.
  2. Nach dem Schließen des neuen Fensters und der Rückkehr öffnet sich die Tür nicht erneut, auch wenn man sich in oder nahe der Tür etwas bewegt.
  3. Sie öffnet sich erst wieder, nachdem man sich weiter als 3 m von der Tür entfernt hat und zurückkommt (Eintrittsabstand 1.2 m < Austrittsabstand 3 m).
  4. Sie öffnet sich nicht, solange der Tab ausgeblendet ist oder das Fenster keinen Fokus hat, und nach der Rückkehr muss man den Türbereich einmal verlassen. Sie öffnet sich nicht, wenn man beim Öffnen der Seite bereits in der Tür steht.
  5. Das Öffnen durch Tippen oder Klicken auf das Gebäude funktioniert wie bisher (bei jedem Klick). Die Türregeln gelten nur für das Hineingehen.
  6. Blockiert der Browser das neue Fenster, erscheint unten auf dem Bildschirm eine Schaltfläche 「<Marke> öffnen」. Erst ein Tippen darauf öffnet es (sie verschwindet, wenn man die Tür verlässt, ohne zu tippen).

Türposition: ein Knoten namens door im glb, falls vorhanden; sonst zeichnet das SDK eine Standardtür unten mittig an der Vorderseite der Anzeige (+Z). Der Abstand ist der Bodenabstand von der laufenden Figur zur Vorderseite der Tür. Übergeben Sie attach einen walker (das Object3D der laufenden Figur oder eine Funktion, die {x, y, z} zurückgibt). Ohne ihn wird die Kameraposition verwendet.

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

Räume, die ad.door selbst mit einer anderen Engine als three.js zeichnen, müssen dieselben Regeln einhalten: Nach einmaligem Öffnen nicht erneut öffnen, bevor der Läufer exit_m verlassen hat, und nachdem der Tab ausgeblendet war und zurückkam, nicht bevor er den Türbereich einmal verlassen hat.

Damit Rein- und Rausgehen das Budget nicht aufbraucht

Bot- und Betrugsregeln

Auf dem Server durchlaufen Ereignisse nacheinander die folgenden Regeln. Greift auch nur eine, wird das Ereignis aus dem Bericht genommen und unter dem Namen dieser Regel separat erfasst. Jede Regel wird in bot_rules von data/ads-config.json ein- und ausgeschaltet.

RegelWas sie tutAktuell
Bot-UA (ua_bot)Suchroboter, Vorschaudienste, Skripte (curl, python, headless usw.) und Anfragen ohne User-Agent werden ausgeschlossen.An
Automatisierte Browser (headless)Browser mit eingeschaltetem navigator.webdriver, HeadlessChrome, PhantomJS, Electron, jsdom sowie Anfragen ohne Accept-Language werden ausgeschlossen. Das ist eine Messdefinition und zählt nicht als Abwehr gegen Skripte.An
Tab-Sichtbarkeit und Fokus (visibility_focus)Impressionen zählen nur, solange der Tab sichtbar ist (document.visibilityState = visible) und das Fenster den Fokus hat; die Anzeigedauer nur, solange der Tab sichtbar ist. Das ist eine Messdefinition.An
Sichtbarkeitsprüfung (min_view)Mindestens ein festgelegter Anteil des Modells muss auf dem Bildschirm bleiben, mindestens auf einer festgelegten Fläche, länger als eine festgelegte Zeit für 1 Impression. Das ist eine Messdefinition.An
Wiederholungslimits je Person und Internetadresse (repeat_limit)Impressionen und Klicks derselben Person und desselben Modells zählen einmal in einer festgelegten Zeit; Eintritte (inkl. Tür) einmal pro Tag und bis zu einer festgelegten Anzahl über festgelegte Tage. Was das Stundenlimit einer Internetadressgruppe, die täglichen neuen Zuschauer je Raum oder die täglichen Impressionen, Klicks und Eintritte je Kampagne und Raum übersteigt, wird ausgeschlossen. Eintrittslimits werden mit den Ereignisprotokollen des Servers erneut geprüft, sodass auch ein Serverneustart nichts vergessen lässt.An
Vom Server signierte Tokens (signed_token)Ereignisse müssen das von serve vergebene signierte Token (HMAC) tragen. Zuschauer und Internetadressgruppe zum serve-Zeitpunkt sind im Token signiert; Impressionen von einer anderen Adresse werden ausgeschlossen, ebenso Impressionen, bevor seit serve eine festgelegte Zeit vergangen ist. Ein Token zählt innerhalb seiner Gültigkeit höchstens je eine Impression, einen Klick und einen Eintritt. Das Kampagnenbudget wird beim Zählen erneut geprüft, und Ereignisse darüber hinaus werden nicht gezählt (budget).An
Messung der Anzeigedauer (view_time)Die Anzeigedauer zählt nur, wenn es dazwischen Kamera- oder Zeigereingaben gibt, und nur bis zu den Tageslimits je Token, je Person und Modell sowie je Internetadresse und Modell.An
Eigener Traffic des Raumbetreibers (owner_traffic)Ereignisse von einer Internetadresse, die die Raumverwaltung dieses Raums geöffnet hat, werden für eine festgelegte Anzahl von Tagen ausgeschlossen.An
Spuren menschlicher Eingaben (human_input)Nur Klicks, die der Browser als menschliche Eingabe markiert (isTrusted), zählen. Bei Impressionen wird die Zahl der Eingaben nicht beachtet (Menschen, die still zuschauen, Tastatur- und Screenreader-Nutzer).An
Anomalieüberwachung und Zurückhaltung (anomaly)Impressionen, die eine Person über eine festgelegte Zahl pro Tag hinaus gesehen hat, werden ausgeschlossen. CPA-Klicks und -Eintritte zählen bis zu einem automatischen Tageskontingent je Raum, der Rest wird zurückgehalten. Überschreiten die Klick- und Eintrittsrate (verglichen mit dem Netzwerk ohne diesen Raum), Impressionen pro Raumklick, neue Zuschauer pro Internetadresse, der Rechenzentrumsanteil, Wiederholungen von derselben Adresse oder Eintritte pro Klick ihre Schwellen, wird der Anteil dieses Raums für den Monat zurückgehalten und ein Administrator entscheidet.An
Rechenzentrumsnetze (asn)Ist das von Cloudflare hinzugefügte x-mm-asn (AS-Nummer) ein Cloud- oder Hosting-Netz, wird das Ereignis ausgeschlossen, und ist dieser Anteil groß, wird der Raum zurückgehalten. Vertraut wird nur, wenn der geheime Header (origin-auth), den eine Cloudflare Transform Rule mitliefert, mit dem env-Wert des Servers übereinstimmt; andernfalls gilt das Netz des Ereignisses als 「unbekannt」, und der Rechenzentrumsanteil wird nur aus Ereignissen mit bekanntem Netz gemessen.An
Menschenprüfung beim Eintritt (turnstile)Ein Eintritt in den Markenraum (/ads/go) zählt erst nach bestandenem Cloudflare Turnstile auf der Metamoa-Domain. Schlägt er fehl, wird der Besucher trotzdem in den Markenraum geleitet, nur der Eintritt wird nicht gezählt. Eintritte, die ohne Schlüssel kamen, werden zurückgehalten.An
Menschenprüfung bei Impressionen (turnstile_imp)Das SDK führt Cloudflare Turnstile in einem versteckten metamoa-Fenster aus und hängt den erhaltenen Pass (an dieses Netz und diesen Raum gebunden) an Impressionen. Ein Pass zählt; eine fehlgeschlagene Prüfung wird ausgelassen. Ohne Pass wird nur diese Impression zurückgehalten; am Monatsende wird sie nach dem nicht prüfbaren Anteil des Raums freigegeben oder verworfen (ein Admin kann sie freigeben). Die Anzeige wird immer unverändert gezeigt.An

Ereignisspezifikation

SDK-Anfragen werden nur von der eigenen Website des Raums angenommen. Bei der eigenen Domain des Betreibers dieselbe registrierbare Domain; bei gemeinsamen Hosts wie github.io oder vercel.app genau derselbe Hostname; und bei Räumen unter einem Pfad (github.io/<Repository>, claude.ai) muss auch der Referer-Pfad darunter liegen (das SDK sendet den vollständigen Referer). Alles mit offenem CORS, JSON. sendBeacon (text/plain) wird ebenfalls angenommen.

Eine Anzeige abrufen · 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"
      }
    ]
  }
}

Ist ad null, gibt es für diesen Platz gerade keine Anzeige. Ist kind model, das glb von model_url platzieren; bei building das Gebäude-glb platzieren und dann bei mode image das Bild von image_url auf jeden mesh-Namen in faces legen, bei texture image_url über alle texture.meshes legen, wiederholt gemäß repeat. Bei character das Figuren-glb aufstellen, das Requisit an prop.attach befestigen und auf dessen Tafel das Bild von image_url oder die Buchstaben von text setzen. Alles passt sich der Box slot.size an, wird aber nur innerhalb von slot.scale der Originalgröße skaliert.

Einen Platz registrieren · 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 (같은 이름의 자리를 바꾸지 않고 그대로)

Ereignisse senden · 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 }
typeFeldBedeutung
imptoken, ms, area, inside, vis, focus, inputs, wdms: ununterbrochen angezeigte Zeit, area: Modellfläche im Verhältnis zur Bildschirmfläche (0 bis 1), inside: Anteil des Modells innerhalb des Bildschirms (0 bis 1), vis·focus: Tab sichtbar und Fensterfokus, inputs: Kamera- und Zeigereingaben in der Zwischenzeit, wd: navigator.webdriver
timetoken, ms, vis, inputs, wdSeit dem letzten time angezeigte Zeit (bis 15,000 ms) und Anzahl der Eingaben dazwischen
clicktoken, trusted, wdDie Anzeige wurde angetippt oder angeklickt. trusted: menschliche Eingabe (isTrusted)

Impressionen zählen mit dem Pass der Menschenprüfung, den das SDK aus einem versteckten metamoa-Fenster (Cloudflare Turnstile) erhält. Die Anzeige erscheint sofort, ohne darauf zu warten. Sendet Ihre Seite eine Content-Security-Policy, fügen Sie https://metamoa.com zu frame-src hinzu. Ist das Fenster blockiert oder fehlt der Pass, wird diese Impression zurückgehalten; nach Monatsende wird sie freigegeben, wenn der nicht prüfbare Anteil des Raums höchstens 20% beträgt, sonst verworfen.

Bis zu 20 auf einmal. Ereignisse enthalten keine vid; der Zuschauer ergibt sich aus dem Wert im Token. Falsche Ereignisse und Tokens eines anderen Raums werden nur als excluded gezählt.

Eintritt · go

Ein Eintritt zählt erst, nachdem /ads/go auf der Metamoa-Domain mit Cloudflare Turnstile geprüft hat, dass es ein Mensch ist (mit Schlüssel erscheint 1 bis 2 Sekunden lang ein kleiner Prüfbildschirm). Schlägt die Prüfung fehl, gelangt die Person trotzdem in den Markenraum, nur der Eintritt wird nicht gezählt.

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

Werbegebäude, Figuren und Upload-Spezifikationen

Werbetreibende ohne Modell wählen eines unserer Werbegebäude oder eine Basis-Werbefigur. Bei Gebäuden eine von zwei Varianten wählen: Bild (je ein Bild auf jeder festgelegten Tafel) · Textur (eine Textur oder ein Muster über die gesamte Gebäudeoberfläche).

ModellArtStandardgröße (m)FaktorBild: WerbeflächenTextur: Vorlagen herunterladen
Fahnenbanner (banner-flag)Bannermasten3.7×3.5×0.40.5~2.52048:1072, mindestens 1024×536 pxhttps://metamoa.com/ads/models/banner-flag/banner-flag.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/banner-flag/banner-flag.texture-template.png
Hängebanner-Mast (banner-hanging)Bannermasten1.9×3×0.20.5~2.51088:2048, mindestens 544×1024 pxhttps://metamoa.com/ads/models/banner-hanging/banner-hanging.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/banner-hanging/banner-hanging.texture-template.png
Bannerturm (banner-tower)Bannermasten1.2×4×1.20.5~2.5656:1024, mindestens 328×512 pxhttps://metamoa.com/ads/models/banner-tower/banner-tower.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/banner-tower/banner-tower.texture-template.png
Werbetafel (billboard-board)Bildschirme · Plakatwände1.9×2.4×1.50.5~31024:944, mindestens 512×472 pxhttps://metamoa.com/ads/models/billboard-board/billboard-board.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/billboard-board/billboard-board.texture-template.png
Niedrige Plakatwand (billboard-low)Bildschirme · Plakatwände4×2.2×0.60.5~32048:784, mindestens 1024×392 pxhttps://metamoa.com/ads/models/billboard-low/billboard-low.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/billboard-low/billboard-low.texture-template.png
Stehende Plakatwand (billboard-stand)Bildschirme · Plakatwände8×4.8×2.50.5~22048:848, mindestens 1024×424 pxhttps://metamoa.com/ads/models/billboard-stand/billboard-stand.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/billboard-stand/billboard-stand.texture-template.png
Große Plakatwand (billboard-tall)Bildschirme · Plakatwände6×6×2.90.5~32048:1136, mindestens 1024×568 pxhttps://metamoa.com/ads/models/billboard-tall/billboard-tall.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/billboard-tall/billboard-tall.texture-template.png
3-stöckige Läden (bld-3f-shop)Gebäude9.4×11×9.40.5~22048:480, mindestens 1024×240 pxhttps://metamoa.com/ads/models/bld-3f-shop/bld-3f-shop.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/bld-3f-shop/bld-3f-shop.texture-template.png
Klassisches Gebäude (bld-classic)Gebäude11.6×14×10.80.5~22048:608, mindestens 1024×304 pxhttps://metamoa.com/ads/models/bld-classic/bld-classic.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/bld-classic/bld-classic.texture-template.png
Eckladen (bld-corner-shop)Gebäude6.6×10×6.60.5~22048:704, mindestens 1024×352 pxhttps://metamoa.com/ads/models/bld-corner-shop/bld-corner-shop.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/bld-corner-shop/bld-corner-shop.texture-template.png
Mittelhohes Gebäude (bld-midrise)Gebäude11.8×16×12.40.5~22048:1152, mindestens 1024×576 pxhttps://metamoa.com/ads/models/bld-midrise/bld-midrise.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/bld-midrise/bld-midrise.texture-template.png
Laden mit Dachterrasse (bld-shop-roof)Gebäude9.9×10×12.20.5~22048:560, mindestens 1024×280 pxhttps://metamoa.com/ads/models/bld-shop-roof/bld-shop-roof.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/bld-shop-roof/bld-shop-roof.texture-template.png
Hochhaus (bld-tower)Gebäude15.1×32×15.10.5~1.51632:2048, mindestens 816×1024 pxhttps://metamoa.com/ads/models/bld-tower/bld-tower.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/bld-tower/bld-tower.texture-template.png
Läden mit 2 Einheiten (bld-twin-shop)Gebäude16.5×9×10.20.5~22048:832, mindestens 1024×416 pxhttps://metamoa.com/ads/models/bld-twin-shop/bld-twin-shop.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/bld-twin-shop/bld-twin-shop.texture-template.png
Pop-up-Stand (booth-carnival)Pop-up-Stände3.5×3.2×1.90.6~22048:336, mindestens 1024×168 pxhttps://metamoa.com/ads/models/booth-carnival/booth-carnival.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/booth-carnival/booth-carnival.texture-template.png
Marktstand (booth-market)Pop-up-Stände3.3×3×1.50.6~22048:400, mindestens 1024×200 pxhttps://metamoa.com/ads/models/booth-market/booth-market.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/booth-market/booth-market.texture-template.png
Pop-up-Pavillon (booth-pavilion)Pop-up-Stände3.1×4×3.70.6~21024:352, mindestens 512×176 pxhttps://metamoa.com/ads/models/booth-pavilion/booth-pavilion.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/booth-pavilion/booth-pavilion.texture-template.png
Eventzelt (booth-tent)Pop-up-Stände3×2.1×30.6~2.52048:416, mindestens 1024×208 pxhttps://metamoa.com/ads/models/booth-tent/booth-tent.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/booth-tent/booth-tent.texture-template.png
Bushaltestellen-Werbetafel (busstop-shelter)Bildschirme · Plakatwände3.7×2.6×2.40.7~1.5512:1024, mindestens 256×512 pxhttps://metamoa.com/ads/models/busstop-shelter/busstop-shelter.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/busstop-shelter/busstop-shelter.texture-template.png
Foodcart (cart-food)Wagen · Sonnenschirme1.5×2.6×30.7~1.81024:656, mindestens 512×328 pxhttps://metamoa.com/ads/models/cart-food/cart-food.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/cart-food/cart-food.texture-template.png
Sonnenschirm (cart-parasol)Wagen · Sonnenschirme2×2.6×2.30.6~2https://metamoa.com/ads/models/cart-parasol/cart-parasol.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/cart-parasol/cart-parasol.texture-template.png
Kiosk (kiosk-ticket)Kioske0.8×1.8×0.80.8~1.5880:1024, mindestens 440×512 pxhttps://metamoa.com/ads/models/kiosk-ticket/kiosk-ticket.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/kiosk-ticket/kiosk-ticket.texture-template.png
Container-Showroom (showroom-container)Showrooms6.1×3×2.90.5~22048:912, mindestens 1024×456 pxhttps://metamoa.com/ads/models/showroom-container/showroom-container.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/showroom-container/showroom-container.texture-template.png
Kundenstopper (sign-aframe)Einfache Schilder und Tafeln0.5×1×0.40.6~2.5544:1024, mindestens 272×512 pxhttps://metamoa.com/ads/models/sign-aframe/sign-aframe.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/sign-aframe/sign-aframe.texture-template.png
Pfeilwegweiser (sign-arrow)Einfache Schilder und Tafeln1×2.2×0.20.5~2.51024:768, mindestens 512×384 pxhttps://metamoa.com/ads/models/sign-arrow/sign-arrow.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/sign-arrow/sign-arrow.texture-template.png
Menüaufsteller (sign-menu)Einfache Schilder und Tafeln0.9×1.4×0.50.5~2.5640:1024, mindestens 320×512 pxhttps://metamoa.com/ads/models/sign-menu/sign-menu.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/sign-menu/sign-menu.texture-template.png
Mastschild (sign-pole)Einfache Schilder und Tafeln0.6×2.6×0.30.5~2.5784:1024, mindestens 392×512 pxhttps://metamoa.com/ads/models/sign-pole/sign-pole.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/sign-pole/sign-pole.texture-template.png
Steckschild (sign-stake)Einfache Schilder und Tafeln0.7×1.2×0.60.5~3800:1024, mindestens 400×512 pxhttps://metamoa.com/ads/models/sign-stake/sign-stake.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/sign-stake/sign-stake.texture-template.png
Wandschild (sign-wall)Einfache Schilder und Tafeln1.2×0.8×00.5~41024:672, mindestens 512×336 pxhttps://metamoa.com/ads/models/sign-wall/sign-wall.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/sign-wall/sign-wall.texture-template.png
Wandbanner (sign-wall-banner)Einfache Schilder und Tafeln1×2×0.30.5~3528:1024, mindestens 264×512 pxhttps://metamoa.com/ads/models/sign-wall-banner/sign-wall-banner.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/sign-wall-banner/sign-wall-banner.texture-template.png
Bühnenbildschirm (stage-screen)Bildschirme · Plakatwände12×5.5×12.70.5~1.52048:352, mindestens 1024×176 pxhttps://metamoa.com/ads/models/stage-screen/stage-screen.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/stage-screen/stage-screen.texture-template.png
Getränkeautomat (vending-drink)Verkaufsautomaten1.3×1.9×1.20.8~1.5848:1024, mindestens 424×512 pxhttps://metamoa.com/ads/models/vending-drink/vending-drink.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/vending-drink/vending-drink.texture-template.png
Kapselautomat (vending-gacha)Verkaufsautomaten0.6×1.4×0.60.8~1.5912:1024, mindestens 456×512 pxhttps://metamoa.com/ads/models/vending-gacha/vending-gacha.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/vending-gacha/vending-gacha.texture-template.png
Vitrinenkühlschrank (vending-showcase)Verkaufsautomaten0.9×2×0.80.8~1.5432:1024, mindestens 216×512 pxhttps://metamoa.com/ads/models/vending-showcase/vending-showcase.texture-default.png · Vorlage mit Linien https://metamoa.com/ads/models/vending-showcase/vending-showcase.texture-template.png
Werbeladen (shop-ad)Gebäude4.2×3.6×3.30.6~22048:1024, mindestens 1024×512 px (ein Bild auf Vorder-, Seiten-, Rück- und Oberseite)

Für Texturen die Standardvorlage (quadratisches PNG) herunterladen, bearbeiten und in derselben Größe (1024 bis 2048 px) hochladen. Die rosa Linien der Vorlage mit Linien sind die Grenzen der Oberflächenteile: Innerhalb eines Teils malen, und es erscheint auf dieser Oberfläche.

Beim Werbeladen (shop-ad) wird das eine hochgeladene Bild auf Vorder-, Seiten-, Rück- und Oberseite angezeigt: Frontschild, beide Seiten, Rückseite und Dachtafel haben dasselbe Seitenverhältnis, sodass es von jeder Seite lesbar ist, selbst von oben. Er hat eine Tür, daher kann 「Durch die Tür eintreten」 ("door": true) genutzt werden.

Basis-Werbefiguren sind unabhängig vom Betrag kostenlos. Sie stehen oder laufen auf character-Plätzen umher, tragen an ihren Knochen befestigte Requisiten wie ein Halsschild, einen Ausweis, ein Handschild, einen Ballon, eine Fahne oder eine Einkaufstasche, und die Requisitentafel trägt ein Werbebild oder Schildbuchstaben (bis zu 12 Zeichen). Die Katzen, der Hund und Vincent können nur um den Hals getragene Requisiten nutzen.

FiguridMögliche RequisitenLizenz
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-badgeEigen (FLOAT Co., Ltd.)
Nyangjupgo Kurzhaarkatzecat_shortprop-neck-sign prop-badgeCC BY 4.0
Nyangjupgo Langhaarkatzecat_longprop-neck-sign prop-badgeCC BY 4.0
Nyangjupgo Munchkincat_munchkinprop-neck-sign prop-badgeCC BY 4.0
Nyangjupgo Corgidog_corgiprop-neck-sign prop-badgeCC BY 4.0
RequisitidBildverhältnis · Mindestgröße
Halsschild (Ausweistyp)prop-badge720:1024, mindestens 360×512 px
Ballonprop-balloon1024:1024, mindestens 512×512 px
Handfahneprop-flag1024:688, mindestens 512×344 px
Um den Hals getragenes Schildprop-neck-sign1024:720, mindestens 512×360 px
Handschildprop-picket1024:720, mindestens 512×360 px
Einkaufstascheprop-shopping-bag1024:1024, mindestens 512×512 px

Modellnachweise

Die meisten Basismodelle sind CC0 (Public Domain) oder selbst erstellt; die folgenden sind CC BY, daher werden ihre Quellen genannt. FLOAT Co., Ltd. hat alle angepasst (Größe, Werbeflächen usw.).

Modell anfragen

Wählt ein Werbetreibender 「Modell anfragen」, erstellen wir das 3D-Modell, fügen es der Kampagne hinzu und prüfen es dann. Senden Sie die Unterlagen (Produktfotos, Logo, Zeichnungen) mit der Kampagnennummer an [email protected].

StufegradeErstellungsgebührKostenlos ab dieser Mediaausgabe
Einfaches Produkt · Schildsimple₩50,000 (Nettopreis, zzgl. MwSt.)₩500,000
Detailliertes Produktprecise₩100,000 (Nettopreis, zzgl. MwSt.)₩1,000,000
Neue Figurcharacter₩100,000 (Nettopreis, zzgl. MwSt.)₩1,000,000

Werbetreibende: Schritte der Selbstregistrierung

  1. Unter https://metamoa.com/ads/manage mit einem Metamoa-Konto anmelden (Registrierung im selben Fenster).
  2. Kampagne erstellen: Name, Marke, Branche und Adresse des Markenraums (bei Eintritts-CPA).
  3. Werbemittel: ① eigenes 3D-Modell (glb) hochladen ② ein Werbegebäude wählen → bei Bild ein Bild je Tafel, bei Textur eine Textur ③ Basis-Werbefigur + Requisit wählen → Bild oder Schildbuchstaben auf der Requisitentafel ④ Modell anfragen (Stufe wählen). Spezifikationen und Vorschau werden angezeigt.
  4. Räume: Aus der Liste der Räume, die Anzeigen zugestimmt haben, Plätze selbst nach Kategorie, aktuell Anwesenden und täglichen Raumklicks wählen oder 「Empfehlen」 tippen, um ein auf Branche, Kategorie und Traffic abgestimmtes Raumpaket zu erhalten.
  5. Abrechnungsart (CPM, CPA, Anzeigedauer, fester Platzvertrag), Budget und Zeitraum festlegen und anfragen → wartet auf Prüfung.
  6. Nach bestandener Prüfung (Obszönität, Gewalt, Verdacht auf Urheberrechtsverletzung usw.) wird ausgespielt. Eine laufende Kampagne kann pausiert und wieder eingeschaltet werden, und Sie sehen täglich sichtbare Impressionen, Klicks, Eintritte und Anzeigedauer.
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>)

Figuren-Werbemittel: {"kind": "character", "character_id": "bangjang", "prop": "prop-picket", "image": "as_…"} oder "text": "Glitzermilch" statt "image". Fester Platzvertrag: "billing": "fixed", "fixed_period": "week" | "month", end_day = start_day + Zeitraum − 1. Modellanfrage: {"kind": "request", "grade": "simple", "note": "…"}.

Gebäude- und eigene Modell-Werbemittel können zwei weitere Angaben enthalten (optional): "tagline": "einzeilige Beschreibung" (bis 30 Zeichen, nur Buchstaben — keine Tags, spitzen oder geschweiften Klammern (400 invalid, fields creative), wird mit dem Werbemittel geprüft) wird auf den Streifen unter dem Schild des Werbeladens oder Gebäudes gezeichnet (mesh ad_tagline) und kommt als ad.tagline { text, mesh, aspect } von serve. "door": true ist 「Durch die Tür eintreten」 (brand_url erforderlich). Das sind dieselben Felder 「Einzeilige Beschreibung」 und 「Durch die Tür eintreten」 wie in Schritt 2 von /ads/manage.

Prüfung

Fehlercodes

Der Fehlerinhalt ist { "error": "<Code>", "message": "<eine Zeile zum nächsten Schritt>" }; Feldfehler kommen mit fields, Limits mit retry_after.

HTTPerrorBedeutung
400invalidEin Feld hat ein falsches Format. fields nennt die falschen Felder.
400bad_modelKein glb, kein glTF 2.0 oder enthält eine externe Adresse (uri). Der Grund steht in reason.
400bad_imageFormat, Größe oder Seitenverhältnis des Bildes entsprechen nicht der Spezifikation. reason (format · bytes · too_large · too_small · aspect) und spec werden mitgeliefert.
400bad_buildingDas default_building des Platzes ist keine Gebäude- oder Schild-ID aus GET /ads/v1/buildings (leer ist erlaubt).
400slot_unavailableDer gewählte Platz nimmt keine Anzeigen an, nimmt diese Branche nicht an oder passt nicht zur Art des Werbemittels (Figuren nur auf Figurenplätzen). slot_ids nennt diese Plätze.
401unauthorizedKein Raumschlüssel und keine Anmeldung in der Raumverwaltung, oder falsch.
401sign_inWerbetreibende: keine Anmeldung mit einem Metamoa-Konto, oder sie ist abgelaufen.
403owner_requiredEin Raumschlüssel ist vorhanden, aber der Raumbetreiber ist noch nicht bestätigt.
403owner_page_onlyBestätigung der Bedingungen oder Einwilligung in Anzeigen mit einem Raumschlüssel versucht (geht nur in der Raumverwaltung).
403bad_ad_keySDK: space und key (mm_adpub_) passen nicht zusammen.
403terms_requiredDieser Raum hat die Bedingungen zur Anzeigenschaltung nicht bestätigt.
403ads_offDieser Raum hat die Einwilligung in Anzeigen ausgeschaltet.
403origin_mismatchDie SDK-Anfrage kam nicht von der Website dieses Raums (gleiche Domain).
404not_houseUnsere eigenen Anzeigen (GET /ads/v1/house) wurden aus einem Raum aufgerufen, den Metamoa nicht selbst betreibt.
403not_yoursWerbetreibende: die Datei-ID einer anderen Person verwendet.
404no_slotKein Werbeplatz mit diesem Namen oder dieser ID.
404not_foundDiese Kampagne oder Datei existiert nicht.
409not_listedEin Raum, der nicht gelistet ist (vor der Freigabe oder ausgeblendet).
409payout_info_requiredVersucht, die Einwilligung in Anzeigen ohne Art der Auszahlungsdaten (Privatperson oder Unternehmen) und Kontakt (Mobiltelefon oder E-Mail) einzuschalten. In der Monetarisierung der Raumverwaltung (/owner/revenue?id=<Raum-ID>) eintragen.
409advertiser_requiredWerbetreibende: versucht, eine Kampagne anzufragen oder zu bezahlen, bevor die Werbetreibendendaten (PUT /api/ads/advertiser) eingetragen wurden.
409biz_doc_requiredWerbetreibende: Ein Unternehmen hat versucht zu bezahlen oder einen festen Platzvertrag anzufragen, bevor eine Kopie der Gewerbeanmeldung (PUT /api/ads/advertiser/doc) hochgeladen wurde.
409business_onlyWerbetreibende: Eine Privatperson hat versucht, eine Kopie einer Gewerbeanmeldung hochzuladen.
400bad_docWerbetreibende: Die Kopie der Gewerbeanmeldung ist kein PDF, JPG oder PNG.
413doc_too_bigWerbetreibende: Die Kopie der Gewerbeanmeldung ist größer als 5 MB.
503advertiser_unavailableWerbetreibende: Der Server hat keinen Verschlüsselungsschlüssel für Werbetreibendendaten und kann sie daher nicht annehmen.
409email_not_linkedWerbetreibende: Die E-Mail einer Privatperson ist nicht die E-Mail, mit der dieses Metamoa-Konto angemeldet ist.
409name_takenEin Platz mit demselben Namen existiert bereits.
409slot_limitBis zu 30 Betreiberplätze je Raum und bis zu 5 unbestätigte SDK-Plätze.
409slot_takenEin Platz, der in diesem Zeitraum bereits einen anderen festen Platzvertrag hat.
409tier_too_lowAls festen Platzvertrag einen Platz in einem Raum gewählt, dessen tägliche Raumklicks unter der niedrigsten Stufe liegen. slot_ids nennt diese Plätze.
409not_for_saleEs gibt keinen Preis für feste Platzverträge.
409under_minimumUnter der Mindest-Mediaausgabe. min_spend_won und spend_won werden mitgeliefert.
409no_click_historyCPM oder festen Platzvertrag für Plätze in Räumen ohne bisherige Raumklicks gewählt (Impressionen und Stufe nicht messbar). Nur CPA und Anzeigedauer sind möglich. slot_ids und billings werden mitgeliefert.
409over_inventoryDas CPM-Budget übersteigt das Limit der erwarteten sichtbaren Impressionen der gewählten Plätze. max_budget_won wird mitgeliefert.
409rejected_fileEine in der Prüfung blockierte Datei in einer Kampagne verwendet.
409wrong_stateEtwas, das in diesem Zustand nicht möglich ist (eine Kampagne in Prüfung pausieren usw.).
409staleAdministrator: Die Kampagne hat sich nach dem Öffnen des Prüfbildschirms geändert (version von decide weicht von der aktuellen ab). Erneut ansehen und neu entscheiden.
409already_paidVersucht, die Zahlung für eine bereits bezahlte Kampagne erneut zu öffnen.
409not_paidAdministrator: versucht, die Abrechnung einer Kampagne freizugeben, deren Zahlung nicht abgeschlossen ist.
409heldAdministrator: versucht, die Abrechnung einer Kampagne mit zurückgehaltenem Anteil freizugeben (zuerst über die Zurückhaltung entscheiden).
424hrum_failedKeine Verbindung zur Zahlung (Hrum). Gleich noch einmal versuchen.
503pay_not_readyDie Zahlung kann noch nicht geöffnet werden (Server noch nicht eingerichtet).
409model_missingAdministrator: eine Kampagne mit Modellanfrage freigegeben, bevor das Modell angehängt wurde.
413model_too_bigDie Modelldatei ist größer als 6 MB.
429too_manyZu viele Anfragen. Die Retry-After-Sekunden abwarten.

Alle Pfade

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