Metamoa-3D-Anzeigen · 3D ads
Frühe Registrierung für Raumbetreiber · Umsatzbeteiligungsstufen ansehen
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.
- Raumbetreiber: In der Monetarisierung der Raumverwaltung (/owner/revenue) 「Für Anzeigen registrieren」 nutzen (Bedingungen bestätigen, Auszahlungsdaten, Werbeplätze) → eine Zeile Skript und die Werbeplätze einfügen, fertig.
- Werbetreibende: Unter /ads/manage mit einem Metamoa-Konto anmelden → ein 3D-Modell (glb) hochladen, ein Werbegebäude wählen und Bild oder Textur einfügen oder für eine Basis-Werbefigur ein Requisit und eine Anzeige wählen → Räume selbst wählen oder 「Empfehlen」 nutzen → Abrechnungsart, Budget und Zeitraum → Ausspielung nach der Prüfung.
- Kein Modell? Wählen Sie 「Modell anfragen」, und wir erstellen eines für Sie. Wir nehmen auch Ihr eigenes Modell an. Basis-Werbefiguren sind unabhängig vom Betrag kostenlos.
- Vier Abrechnungsarten: CPM (sichtbare Impressionen), CPA (Modellklicks, Eintritte in den Markenraum), Anzeigedauer (gesamte angezeigte Zeit) und feste Platzverträge (für einen Zeitraum, der Platz exklusiv). Alle Beträge sind (Nettopreis, zzgl. MwSt.).
- Die Größe eines Werbemodells kann je nach Raum vom Raumbetreiber oder von Metamoa angepasst werden.




4 Produkte und Abrechnung
Alle Beträge sind Nettopreise zzgl. MwSt.
| Produkt | billing | Was gezählt wird | Stückpreis |
|---|---|---|---|
| CPM (sichtbare Impressionen) | cpm | 1 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 · Modellklick | cpa | Ein 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 Markenraum | cpa | Auf 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 |
| Anzeigedauer | time | Gesamte 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 Platzvertrag | fixed | Für einen festen Zeitraum (bis zu einem Monat). Sie nutzen den vertraglich gebuchten Werbeplatz in diesem Zeitraum exklusiv (pro Platz). Impressionen werden nicht garantiert | Siehe 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).
| Stufe | Tägliche Raumklicks | Wöchentlich (1 Platz) | Monatlich (1 Platz) |
|---|---|---|---|
| S | 1,000 oder mehr | ₩50,000 | ₩180,000 |
| A | 300~999 | ₩15,000 | ₩50,000 |
| B | 100~299 | ₩5,000 | ₩18,000 |
- Mindestausgabe: Mediaausgabe ₩10,000 (Nettopreis, zzgl. MwSt.), ohne Modellerstellungsgebühren. Bei leistungsbasierten Anzeigen zählt das Budget, bei festen Verträgen die Summe der Vertragsbeträge.
- Leistungsbasierte Anzeigen (CPM, CPA, Anzeigedauer) berechnen nur, was tatsächlich gezählt wurde, und eine Kampagne wird nicht mehr ausgespielt, sobald ihre Ausgaben das Budget (budget_won) erreichen.
- Ein CPM-Vertrag wird nur bis zu 70 % der erwarteten sichtbaren Impressionen der gewählten Plätze angenommen (tägliche Raumklicks × 0.7 × Tage) (409 over_inventory).
- CPA- und Anzeigedauer-Anzeigen werden nicht blockiert, aber wenn das Budget die erwarteten Ausgaben übersteigt, weist /ads/manage vor der Anfrage darauf hin: Auf dieselben erwarteten sichtbaren Impressionen multipliziert CPA mit der Klickraten-Basis von 2 % × dem höheren von Klick- und Eintrittspreis, die Anzeigedauer mit 60 Sekunden pro Person und Tag (spend_estimate von GET /api/ads/options).
- Ein Platz mit festem Vertrag zeigt in dem Zeitraum nur diese Kampagne, und für denselben Platz wird kein weiterer fester Vertrag mit überlappenden Daten angenommen (409 slot_taken). Der Platz wird bei der Freigabe in der Prüfung reserviert: Anfragen, die auf die Prüfung warten, reservieren keine Plätze, und der zuerst freigegebene Vertrag gewinnt. Wurde das Modell an einigen Tagen nicht angezeigt oder fällt der Traffic um mehr als 30 %, gleichen wir das mit einer anteiligen Erstattung oder Verlängerung aus.
- Abrechnung und Stufen basieren auf Metamoas eigenen gemessenen Berichten (sichtbare Impressionen, Klicks, Eintritte, Anzeigedauer, Raumklicks).
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).
- Sichtbare Impressionen imps = Anzahl der
imp-Ereignisse, die alle Regeln bestanden haben - Klicks clicks = bestandene
clicks, Eintritte enters = bestandene Eintritte (/ads/go), converted = Klicks, die mit demselben Token zu einem Eintritt führten - Anzeigedauer view_ms = Summe der ms bestandener
time-Ereignisse (nur Tokens, deren Impression gezählt wurde, bis 15,000 ms pro Ereignis, bis zum Tageslimit je Person und Modell) - CPM-Betrag = floor(imps × cpm_won ÷ 1,000)
- CPA-Betrag = (clicks − converted) × click_won + enters × enter_won
- Anzeigedauer-Betrag = floor(view_ms ÷ 1,000 × time_1000s_won ÷ 1,000)
- Betrag des festen Vertrags = Summe der Stufenpreise jedes gebuchten Platzes. Wird nur ein Teil des Zeitraums gezählt, je Platz floor(Preis × Vertragstage in diesem Zeitraum ÷ Vertragstage)
- Anteil des Raumbetreibers = floor(Betrag je Raum × Stufenanteil des Betreibers dieses Raums (%) ÷ 100). Der Betrag ist der Media-Nettopreis nach Abzug ungültigen Traffics; Gebühren für Modell- und Raumerstellung werden nicht geteilt. Stufen: 「Umsatzbeteiligungsstufen für Raumbetreiber」 unten.
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
| Stufe | Wer | Raumbetreiber : Metamoa |
|---|---|---|
| Platin | Wer zuerst kommt: Raumbetreiber 1 bis 10 | 9:1 |
| Gold | Raumbetreiber 11 bis 100 (90 Personen) | 8:2 |
| Silber | Raumbetreiber danach | 7:3 |
| Bronze | Raumbetreiber, die ab dem 1.1.2027 einen neuen Vertrag abschließen | 6:4 |
Die Anteile können künftig je nach Werbeleistung angepasst werden.
- Raumbetreiber = ein Eigentümerkonto, das einen Raum bei Metamoa registriert hat und sich in der Raumverwaltung anmeldet. Die Reihenfolge richtet sich nach dem Zeitpunkt, zu dem jeder erstmals 「Einwilligung in Anzeigen」 in der Raumverwaltung eingeschaltet hat, vom Server einzeln nummeriert.
- Eine einmal festgelegte Stufe bleibt bestehen, und andere Räume desselben Betreibers erhalten dieselbe Stufe.
- Raumbetreiber, die ab dem 1.1.2027 um 0:00 Uhr (koreanische Zeit) einen neuen Vertrag abschließen, sind unabhängig von ihrer Reihenfolge Bronze.
- Ihre Stufe und Ihr Anteil: der Bereich 「3D-Anzeigen」 der Raumverwaltung, partner von GET /api/space/{id}/ads. Freie Plätze: seats von GET /api/ads/partners.
- Aktuell freie Plätze: Platin 0/10 · Gold 80/90
Bestätigung der Bedingungen und Einwilligung in Anzeigen
Die Nutzungsbedingungen enthalten nun eine Klausel zur Anzeigenschaltung (Artikel 4-4). Um Anzeigen zu erhalten, erledigt der Raumbetreiber in 「Für Anzeigen registrieren」 der Monetarisierung der Raumverwaltung zwei Dinge auf einmal.
- Bestätigung der Bedingungen: In Schritt 1 von 「Für Anzeigen registrieren」 in der Raumverwaltung (/owner/revenue?id=<Raum-ID>) die Bedingungen bestätigen. Das geht nur in der Raumverwaltung (mit einem Raumschlüssel ergibt es 403 owner_page_only).
- Einwilligung in Anzeigen: wird zusammen mit der Bestätigung der Bedingungen eingeschaltet und danach im selben Bildschirm je Raum ein- und ausgeschaltet. Zum Einschalten werden die Art der Auszahlungsdaten und ein Kontakt benötigt (sonst 409 payout_info_required). Nur wenn sie eingeschaltet ist, erscheint die Anzeigen-API des Raums (eine Zeile Skript, Anzeigenschlüssel); beim Ausschalten werden sofort keine Anzeigen mehr ausgespielt (serve 403 ads_off).
Einwilligungsprotokoll: der Raum, wer (ein Hash der Anmelde-E-Mail des Raumbetreibers für diese Raumverwaltung), wann, welche Bedingungsversion (data-ads-version von terms.html) und ein/aus werden ohne Löschen gespeichert (ad_consents).
Räume, die die Bedingungen nicht bestätigt, die Einwilligung in Anzeigen ausgeschaltet haben oder nicht gelistet sind, erhalten keine Anzeigen.
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.
| Feld | Format | Bedeutung |
|---|---|---|
| name | 1 bis 40 Zeichen | Ein Name, der im Raum nur einmal vorkommt |
| kind | floor · wall · air · character | Bodenmodell · Wandschild · Luftbanner · stehende oder umherlaufende Werbefigur |
| position | [x, y, z] Meter | Position 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] |
| roam | 0 bis 50 Meter | character-Plätze: der Radius, in dem die Figur umherläuft (0 bedeutet stehend) |
| industries | Liste der Branchen-IDs | Branchen, die dieser Platz annimmt. Leer bedeutet alle Branchen |
| enabled | true · false | Ausgeschaltet 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
- In 「Für Anzeigen registrieren」 der Monetarisierung der Raumverwaltung (
https://metamoa.com/owner/revenue?id=<Raum-ID>) die Bedingungen bestätigen und Anzeigen starten. - 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).
- 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).
- 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.
- 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
- Sichtbare Impression: Wenn mindestens ein festgelegter Anteil des Modells im Kamerabild ist, mit einer Bildschirmgröße von mindestens einer festgelegten Fläche, länger als eine festgelegte Zeit bei sichtbarem Tab, sendet es 1 Impression (einmal pro serve-Token).
- Anzeigedauer: Nach der Impression summiert es, solange die Anzeige unter den obigen Bedingungen sichtbar bleibt, und sendet alle 5 Sekunden, zusammen mit der Anzahl der Kamera- und Zeigereingaben dazwischen (stoppt, wenn der Tab ausgeblendet wird).
- Enthält die serve-Antwort eine vid, diese in dem Browser speichern und beim nächsten serve mitsenden (GET /ads/v1/serve?…&vid=). Gelesen wird nur eine vid, die der Server für dieses Netz signiert hat. Der Server kombiniert vid und verbindende IP-Gruppe und signiert diese Person in das Token. Eine Impression wird erst etwa 2 Sekunden nach serve gezählt.
- Klick: Ein Tippen oder Klicken auf die Anzeige sendet
click, und hat die Anzeige einen Markenraum, wird enter_url (/ads/go) in einem neuen Fenster geöffnet. Der Server zählt den Eintritt und leitet den Besucher in den Markenraum weiter. - Tür: Ist ad.door vorhanden, öffnet das Hineingehen durch die Tür enter_url einmal in einem neuen Fenster. Wann sie sich wieder öffnet: siehe 「Durch die Tür eintreten」 unten.
- Die Browser-ID (vid) vergibt der Server, das SDK speichert sie in localStorage. Sie dient nur für Wiederholungslimits. Persönliche Daten wie Namen oder Kontakte werden nicht gesendet.
- Anzeigen werden alle 30 Minuten neu abgerufen (neues Token). Figuren auf character-Plätzen laufen langsam innerhalb des roam-Radius.
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)
- 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.
- 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.
- 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).
- 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.
- 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.
- 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
- Ein Eintritt durch die Tür wird zum selben Preis wie 1 CPA-Eintritt gezählt (Preis und Mindestausgabe unverändert).
- Eintritte je Person (Browser-ID vom Server + Internetadressgruppe) und Kampagne werden einmal alle 24 Stunden gezählt, bis zu 3-mal in 30 Tagen. Dieselbe Internetadressgruppe höchstens 3-mal pro Tag je Kampagne und Raum.
- Darüber hinausgehende Eintritte leiten den Besucher zwar in den Markenraum, werden aber nicht berechnet, sondern nur protokolliert (Ausschlussgrund repeat_limit). Sie werden mit den Ereignisprotokollen des Servers (nur Hashes) erneut geprüft, sodass auch ein Serverneustart nichts vergessen lässt.
- Ein Eintritt mit demselben serve-Token wird einmal gezählt, und nur bei Tokens, deren Impression zuerst gezählt wurde (die Bot- und Betrugsregeln unverändert).
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.
| Regel | Was sie tut | Aktuell |
|---|---|---|
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 |
- Klicks und Eintritte zählen nur, wenn die Impression dieses Tokens zuerst gezählt wurde (sonst no_impression).
- Sind die vom Server geführten Tabellen voll, löscht er keine Einträge, deren Frist noch läuft, sondern zählt keine neuen Ereignisse mehr (capacity). Er schließt im Fehlerfall.
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 }
| type | Feld | Bedeutung |
|---|---|---|
| imp | token, ms, area, inside, vis, focus, inputs, wd | ms: 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 |
| time | token, ms, vis, inputs, wd | Seit dem letzten time angezeigte Zeit (bis 15,000 ms) und Anzahl der Eingaben dazwischen |
| click | token, trusted, wd | Die 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).
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.
| Figur | id | Mögliche Requisiten | Lizenz |
|---|---|---|---|
| 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 | Eigen (FLOAT Co., Ltd.) |
| Nyangjupgo Kurzhaarkatze | cat_short | prop-neck-sign prop-badge | CC BY 4.0 |
| Nyangjupgo Langhaarkatze | cat_long | prop-neck-sign prop-badge | CC BY 4.0 |
| Nyangjupgo Munchkin | cat_munchkin | prop-neck-sign prop-badge | CC BY 4.0 |
| Nyangjupgo Corgi | dog_corgi | prop-neck-sign prop-badge | CC BY 4.0 |
| Requisit | id | Bildverhältnis · Mindestgröße |
|---|---|---|
| Halsschild (Ausweistyp) | prop-badge | 720:1024, mindestens 360×512 px |
| Ballon | prop-balloon | 1024:1024, mindestens 512×512 px |
| Handfahne | prop-flag | 1024:688, mindestens 512×344 px |
| Um den Hals getragenes Schild | prop-neck-sign | 1024:720, mindestens 512×360 px |
| Handschild | prop-picket | 1024:720, mindestens 512×360 px |
| Einkaufstasche | prop-shopping-bag | 1024:1024, mindestens 512×512 px |
- Bildformate: PNG · JPEG · WEBP, bis 2 MB, bis 4096 px Breite und Höhe, Verhältnistoleranz bis 2 %. Hochgeladene Bilder werden erneut als WebP gespeichert (Fotometadaten werden entfernt).
- 3D-Modell: eine glTF-2.0-Binärdatei (.glb), bis 6 MB, Texturen in der Datei, keine externen Adressen (uri).
- Hochgeladene Dateien werden anhand ihres Inhalts (Magic Bytes) geprüft: Bilder werden nur als PNG, JPEG oder WebP angenommen (kein SVG, HTML usw.) und als WebP neu erzeugt, Modelle nur als glTF-2.0-Binär. Werbedateien werden nur mit festem Typ (image/webp, model/gltf-binary), nosniff und Sandbox-Richtlinie ausgeliefert und laufen daher nie als Skript.
- Die Größe eines Werbemodells kann je nach Raum vom Raumbetreiber oder von Metamoa angepasst werden.
- Modell- und Figurendateien liegen unter /ads/models/ und werden nur mit Antworten ausgeliefert, die keine Skripte erlauben (fester Typ, nosniff, Sandbox). Liste und Quellen stehen in docs/ads/MODELS.md; zum Ändern data/ads-buildings.json und die Dateien gemeinsam mit scripts/ads-import-models.mjs neu erzeugen.
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.).
- Stehende Plakatwand: "Blank Billboard" by Jarlan Perez (https://poly.pizza/m/1E0d2B7bC8e), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), angepasst von FLOAT Co., Ltd.
- Pop-up-Stand: "Carnival Booth" by sirkitree (https://poly.pizza/m/4NizXJZsuO2), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), angepasst von FLOAT Co., Ltd.
- Bushaltestellen-Werbetafel: "Bus Stop" by Zsky (https://poly.pizza/m/OWczicNWhO), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), angepasst von FLOAT Co., Ltd.
- Kundenstopper: "Sandwich Board" by Anonymous (https://poly.pizza/m/ejy0W_7cHWT), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), angepasst von FLOAT Co., Ltd.
- Nyangjupgo Kurzhaarkatze: "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, von FLOAT Co., Ltd. in Voxel umgesetzt
- Nyangjupgo Langhaarkatze: "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, von FLOAT Co., Ltd. in Voxel umgesetzt
- Nyangjupgo Munchkin: "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, von FLOAT Co., Ltd. in Voxel umgesetzt
- Nyangjupgo Corgi: "Dog" by Polyfork (https://polyfork.dev/asset/dog-base), CC BY 4.0, von FLOAT Co., Ltd. in Voxel umgesetzt
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].
| Stufe | grade | Erstellungsgebühr | Kostenlos ab dieser Mediaausgabe |
|---|---|---|---|
| Einfaches Produkt · Schild | simple | ₩50,000 (Nettopreis, zzgl. MwSt.) | ₩500,000 |
| Detailliertes Produkt | precise | ₩100,000 (Nettopreis, zzgl. MwSt.) | ₩1,000,000 |
| Neue Figur | character | ₩100,000 (Nettopreis, zzgl. MwSt.) | ₩1,000,000 |
- Die Schwelle für die Kostenfreiheit ist die tatsächliche Mediaausgabe (Summe über die gesamte Vertragslaufzeit, bis zu 3 Monate, ohne Modellierung, MwSt. und ungültigen Traffic).
- Ein kostenlos erstelltes Modell kommt mit einer Lizenz nur zur Ausspielung auf Metamoa (das Urheberrecht bleibt bei Metamoa; eine Übertragung gegen die Erstellungsgebühr), mit 1 Überarbeitungen. Kündigt oder kürzt der Werbetreibende, wird die Erstellungsgebühr anteilig berechnet: Erstellungsgebühr × (1 − tatsächliche Mediaausgabe ÷ Schwelle für die Kostenfreiheit). Kostenpflichtige Modelle erhalten 2 Überarbeitungen.
- Basis-Werbefiguren (die Figuren des Moa-Camps und von Nyangjupgo) sind unabhängig vom Betrag ohne Erstellungsanfrage kostenlos nutzbar.
Werbetreibende: Schritte der Selbstregistrierung
- Unter https://metamoa.com/ads/manage mit einem Metamoa-Konto anmelden (Registrierung im selben Fenster).
- Kampagne erstellen: Name, Marke, Branche und Adresse des Markenraums (bei Eintritts-CPA).
- 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.
- 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.
- Abrechnungsart (CPM, CPA, Anzeigedauer, fester Platzvertrag), Budget und Zeitraum festlegen und anfragen → wartet auf Prüfung.
- 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
- Hochgeladene Modelle und Bilder sowie Kampagnen warten vor der Ausspielung auf die Prüfung (review). Gibt ein Administrator frei, wird ausgespielt (active); bei Ablehnung bleiben rejected und der Grund erhalten.
- Bilder werden beim Hochladen zuerst per KI-Bildprüfung auf Obszönität, Gewalt sowie fremde Logos oder Figuren geprüft und bei einem Treffer sofort blockiert (rejected). Kann die Prüfung nicht laufen, sieht ein Administrator sie sich an.
- Modelle öffnet und prüft ein Administrator. Obszönität, Gewalt oder Verdacht auf Urheberrechtsverletzung führen zur Ablehnung.
Fehlercodes
Der Fehlerinhalt ist { "error": "<Code>", "message": "<eine Zeile zum nächsten Schritt>" }; Feldfehler kommen mit fields, Limits mit retry_after.
| HTTP | error | Bedeutung |
|---|---|---|
| 400 | invalid | Ein Feld hat ein falsches Format. fields nennt die falschen Felder. |
| 400 | bad_model | Kein glb, kein glTF 2.0 oder enthält eine externe Adresse (uri). Der Grund steht in reason. |
| 400 | bad_image | Format, Größe oder Seitenverhältnis des Bildes entsprechen nicht der Spezifikation. reason (format · bytes · too_large · too_small · aspect) und spec werden mitgeliefert. |
| 400 | bad_building | Das default_building des Platzes ist keine Gebäude- oder Schild-ID aus GET /ads/v1/buildings (leer ist erlaubt). |
| 400 | slot_unavailable | Der 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. |
| 401 | unauthorized | Kein Raumschlüssel und keine Anmeldung in der Raumverwaltung, oder falsch. |
| 401 | sign_in | Werbetreibende: keine Anmeldung mit einem Metamoa-Konto, oder sie ist abgelaufen. |
| 403 | owner_required | Ein Raumschlüssel ist vorhanden, aber der Raumbetreiber ist noch nicht bestätigt. |
| 403 | owner_page_only | Bestätigung der Bedingungen oder Einwilligung in Anzeigen mit einem Raumschlüssel versucht (geht nur in der Raumverwaltung). |
| 403 | bad_ad_key | SDK: space und key (mm_adpub_) passen nicht zusammen. |
| 403 | terms_required | Dieser Raum hat die Bedingungen zur Anzeigenschaltung nicht bestätigt. |
| 403 | ads_off | Dieser Raum hat die Einwilligung in Anzeigen ausgeschaltet. |
| 403 | origin_mismatch | Die SDK-Anfrage kam nicht von der Website dieses Raums (gleiche Domain). |
| 404 | not_house | Unsere eigenen Anzeigen (GET /ads/v1/house) wurden aus einem Raum aufgerufen, den Metamoa nicht selbst betreibt. |
| 403 | not_yours | Werbetreibende: die Datei-ID einer anderen Person verwendet. |
| 404 | no_slot | Kein Werbeplatz mit diesem Namen oder dieser ID. |
| 404 | not_found | Diese Kampagne oder Datei existiert nicht. |
| 409 | not_listed | Ein Raum, der nicht gelistet ist (vor der Freigabe oder ausgeblendet). |
| 409 | payout_info_required | Versucht, 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. |
| 409 | advertiser_required | Werbetreibende: versucht, eine Kampagne anzufragen oder zu bezahlen, bevor die Werbetreibendendaten (PUT /api/ads/advertiser) eingetragen wurden. |
| 409 | biz_doc_required | Werbetreibende: Ein Unternehmen hat versucht zu bezahlen oder einen festen Platzvertrag anzufragen, bevor eine Kopie der Gewerbeanmeldung (PUT /api/ads/advertiser/doc) hochgeladen wurde. |
| 409 | business_only | Werbetreibende: Eine Privatperson hat versucht, eine Kopie einer Gewerbeanmeldung hochzuladen. |
| 400 | bad_doc | Werbetreibende: Die Kopie der Gewerbeanmeldung ist kein PDF, JPG oder PNG. |
| 413 | doc_too_big | Werbetreibende: Die Kopie der Gewerbeanmeldung ist größer als 5 MB. |
| 503 | advertiser_unavailable | Werbetreibende: Der Server hat keinen Verschlüsselungsschlüssel für Werbetreibendendaten und kann sie daher nicht annehmen. |
| 409 | email_not_linked | Werbetreibende: Die E-Mail einer Privatperson ist nicht die E-Mail, mit der dieses Metamoa-Konto angemeldet ist. |
| 409 | name_taken | Ein Platz mit demselben Namen existiert bereits. |
| 409 | slot_limit | Bis zu 30 Betreiberplätze je Raum und bis zu 5 unbestätigte SDK-Plätze. |
| 409 | slot_taken | Ein Platz, der in diesem Zeitraum bereits einen anderen festen Platzvertrag hat. |
| 409 | tier_too_low | Als festen Platzvertrag einen Platz in einem Raum gewählt, dessen tägliche Raumklicks unter der niedrigsten Stufe liegen. slot_ids nennt diese Plätze. |
| 409 | not_for_sale | Es gibt keinen Preis für feste Platzverträge. |
| 409 | under_minimum | Unter der Mindest-Mediaausgabe. min_spend_won und spend_won werden mitgeliefert. |
| 409 | no_click_history | CPM 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. |
| 409 | over_inventory | Das CPM-Budget übersteigt das Limit der erwarteten sichtbaren Impressionen der gewählten Plätze. max_budget_won wird mitgeliefert. |
| 409 | rejected_file | Eine in der Prüfung blockierte Datei in einer Kampagne verwendet. |
| 409 | wrong_state | Etwas, das in diesem Zustand nicht möglich ist (eine Kampagne in Prüfung pausieren usw.). |
| 409 | stale | Administrator: 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. |
| 409 | already_paid | Versucht, die Zahlung für eine bereits bezahlte Kampagne erneut zu öffnen. |
| 409 | not_paid | Administrator: versucht, die Abrechnung einer Kampagne freizugeben, deren Zahlung nicht abgeschlossen ist. |
| 409 | held | Administrator: versucht, die Abrechnung einer Kampagne mit zurückgehaltenem Anteil freizugeben (zuerst über die Zurückhaltung entscheiden). |
| 424 | hrum_failed | Keine Verbindung zur Zahlung (Hrum). Gleich noch einmal versuchen. |
| 503 | pay_not_ready | Die Zahlung kann noch nicht geöffnet werden (Server noch nicht eingerichtet). |
| 409 | model_missing | Administrator: eine Kampagne mit Modellanfrage freigegeben, bevor das Modell angehängt wurde. |
| 413 | model_too_big | Die Modelldatei ist größer als 6 MB. |
| 429 | too_many | Zu 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