Anúncios 3D da Metamoa · 3D ads
Cadastro antecipado de operadores · ver os níveis de repasse de receita
Visão geral
Os anúncios 3D da Metamoa colocam o modelo 3D, o prédio publicitário ou o personagem publicitário do anunciante em espaços de anúncio dentro de espaços de metaverso na web, contam apenas o que as pessoas realmente viram e fizeram, cobram por isso e repassam uma parte aos operadores de espaços. Como empresa de publicidade e agência de publicidade, atendemos de grandes empresas a pequenas e médias.
- Operadores de espaços: em Monetização do painel do espaço (/owner/revenue), use 「Cadastrar para anúncios」 (confirmação dos termos, dados de pagamento, espaços de anúncio) → adicione uma linha de script e os espaços de anúncio, e pronto.
- Anunciantes: entre com uma conta Metamoa em /ads/manage → envie um modelo 3D (glb), ou escolha um prédio publicitário e adicione uma imagem ou textura, ou escolha um acessório e um anúncio para um personagem publicitário básico → escolha você mesmo os espaços ou use 「Recomendar」 → tipo de cobrança, orçamento e período → veiculação após a revisão.
- Não tem modelo? Escolha 「Pedir um modelo」 e nós fazemos para você. Também aceitamos o seu próprio modelo. Os personagens publicitários básicos são gratuitos em qualquer valor.
- Quatro formas de cobrança: CPM (impressões visíveis), CPA (cliques no modelo, entradas no espaço da marca), tempo de exibição (tempo total exibido) e contratos de espaço fixo (por um período, o espaço com exclusividade). Todos os valores são (preço de fornecimento, sem IVA).
- O tamanho de um modelo publicitário pode ser ajustado pelo operador do espaço ou pela Metamoa conforme o espaço.




4 produtos e cobrança
Todos os valores são preços de fornecimento, sem IVA.
| Produto | billing | O que é contado | Preço unitário |
|---|---|---|---|
| CPM (impressões visíveis) | cpm | 1 impressão visível = o modelo fica na tela em pelo menos uma proporção definida, por mais que um tempo definido sem interrupção (com a aba visível) | ₩8,000 a cada 1,000 visíveis |
| CPA · clique no modelo | cpa | Um toque ou clique no modelo publicitário. Se o clique levar a uma entrada no espaço da marca, só essa 1 entrada é cobrada | ₩700 a cada 1 clique |
| CPA · entrada no espaço da marca | cpa | Tocar no anúncio e entrar no espaço da marca (brand_url). Contado por um redirecionamento do servidor (/ads/go); uma vez por dia por pessoa e campanha | ₩1,000 a cada 1 entrada |
| Tempo de exibição | time | Tempo total em que o anúncio foi exibido após uma impressão visível (só enquanto há interação, até um limite diário por pessoa e modelo) | ₩1,000 a cada 1,000 segundos visíveis |
| Contrato de espaço fixo | fixed | Por um período definido (até um mês). Você usa com exclusividade o espaço de anúncio contratado nesse período (por espaço). Impressões não são garantidas | Veja a tabela de níveis abaixo |
Níveis do contrato de espaço fixo
O nível é definido pela mediana dos cliques diários limpos no espaço nos últimos 14 dias do espaço onde fica o slot (sem as visitas do próprio operador, redes de data center e navegadores automatizados; o “Entrar” da metamoa só conta após a verificação humana). Slots em espaços abaixo do nível mais baixo não são vendidos como contrato fixo, só como anúncios por desempenho. O período do contrato é semanal (7 dias) ou mensal (30 dias).
| Nível | Cliques diários no espaço | Semanal (1 slot) | Mensal (1 slot) |
|---|---|---|---|
| S | 1,000 ou mais | ₩50,000 | ₩180,000 |
| A | 300~999 | ₩15,000 | ₩50,000 |
| B | 100~299 | ₩5,000 | ₩18,000 |
- Investimento mínimo: investimento em mídia de ₩10,000 (preço de fornecimento, sem IVA), sem contar a taxa de criação do modelo. Nos anúncios por desempenho conta o orçamento; nos contratos fixos, a soma dos valores do contrato.
- Os anúncios por desempenho (CPM, CPA, tempo de exibição) cobram só o que foi realmente contado, e uma campanha para de veicular quando o gasto atinge o orçamento (budget_won).
- Um contrato CPM só é aceito até 70% das impressões visíveis previstas dos slots escolhidos (cliques diários no espaço × 0.7 × dias) (409 over_inventory).
- Anúncios CPA e por tempo de exibição não são bloqueados, mas se o orçamento for maior que o gasto previsto, /ads/manage avisa antes do pedido: sobre as mesmas impressões visíveis previstas, o CPA multiplica pela taxa de cliques de referência de 2% × o maior entre os preços de clique e de entrada, e o tempo de exibição por 60 segundos por pessoa por dia (spend_estimate de GET /api/ads/options).
- Um slot com contrato fixo exibe só essa campanha no período, e nenhum outro contrato fixo é aceito para o mesmo slot em datas sobrepostas (409 slot_taken). O slot é reservado quando a revisão o aprova: pedidos aguardando revisão não reservam slots, e vence o contrato aprovado primeiro. Se o modelo não aparecer em alguns dias ou o tráfego cair mais de 30%, compensamos com reembolso proporcional ou prorrogação.
- A cobrança e os níveis se baseiam nos relatórios medidos pela própria Metamoa (impressões visíveis, cliques, entradas, tempo de exibição, cliques no espaço).
Fórmulas de contagem
As datas são dias no horário da Coreia (ad_daily). Os valores são preços de fornecimento, descartadas as frações de won. Eventos barrados por uma regra não são contados e são registrados à parte por motivo (ad_excluded).
- Impressões visíveis imps = número de eventos
impque passaram por todas as regras - Cliques clicks =
clicks aprovados, entradas enters = entradas aprovadas (/ads/go), converted = cliques que levaram a uma entrada com o mesmo token - Tempo de exibição view_ms = soma dos ms dos eventos
timeaprovados (só tokens cuja impressão foi contada, até 15,000ms por evento, até o limite diário por pessoa e modelo) - Valor CPM = floor(imps × cpm_won ÷ 1,000)
- Valor CPA = (clicks − converted) × click_won + enters × enter_won
- Valor por tempo de exibição = floor(view_ms ÷ 1,000 × time_1000s_won ÷ 1,000)
- Valor do contrato fixo = soma dos preços de nível de cada slot contratado. Quando só parte do período é contada, por slot floor(preço × dias de contrato dentro desse período ÷ dias de contrato)
- Parte do operador do espaço = floor(valor por espaço × percentual do nível do operador desse espaço (%) ÷ 100). O valor é o preço de fornecimento de mídia após remover o tráfego inválido; taxas de criação de modelos e espaços não são divididas. Níveis: 「Níveis de repasse de receita aos operadores de espaços」 abaixo.
Níveis de repasse de receita aos operadores de espaços
A receita publicitária (o valor de mídia publicitária por espaço, preço de fornecimento após remover o tráfego inválido) é dividida entre o operador do espaço e a Metamoa conforme o percentual do nível. Em vigor desde 11/11/2026. Cadastro antecipado: https://metamoa.com/ads/partners
| Nível | Quem | Operador do espaço : Metamoa |
|---|---|---|
| Platina | Por ordem de chegada: operadores de espaços 1 a 10 | 9:1 |
| Ouro | Operadores de espaços 11 a 100 (90 pessoas) | 8:2 |
| Prata | Operadores de espaços seguintes | 7:3 |
| Bronze | Operadores de espaços que fecharem novo contrato a partir de 1/1/2027 | 6:4 |
As proporções poderão ser ajustadas futuramente conforme o desempenho dos anúncios.
- Operador do espaço = uma conta proprietária que cadastrou um espaço na Metamoa e entra no painel do espaço. A ordem é o momento em que cada um ativou pela primeira vez 「Consentimento para anúncios」 no painel do espaço, numerado um a um pelo servidor.
- Um nível, uma vez definido, é mantido, e os outros espaços do mesmo operador têm o mesmo nível.
- Operadores de espaços que fecharem novo contrato a partir de 1/1/2027 às 0h (horário da Coreia) são Bronze, independentemente da ordem.
- Seu nível e percentual: o painel 「Anúncios 3D」 do painel do espaço, partner de GET /api/space/{id}/ads. Vagas restantes: seats de GET /api/ads/partners.
- Vagas restantes agora: Platina 0/10 · Ouro 80/90
Confirmação dos termos e consentimento para anúncios
Os termos de uso agora incluem uma cláusula de veiculação de anúncios (artigo 4-4). Para receber anúncios, o operador do espaço faz duas coisas de uma vez em 「Cadastrar para anúncios」 de Monetização do painel do espaço.
- Confirmação dos termos: marque a confirmação dos termos na etapa 1 de 「Cadastrar para anúncios」 no painel do espaço (/owner/revenue?id=<id do espaço>). Só funciona no painel do espaço (com uma chave do espaço dá 403 owner_page_only).
- Consentimento para anúncios: ativado junto com a confirmação dos termos e depois ativado e desativado por espaço na mesma tela. Para ativar, são necessários o tipo de dados de pagamento e um contato (senão 409 payout_info_required). Só quando está ativado aparece a API de anúncios do espaço (uma linha de script, chave de anúncios); ao desativar, os anúncios param na hora (serve 403 ads_off).
Registro de consentimento: o espaço, quem (um hash do e-mail de login do operador nesse painel), quando, qual versão dos termos (data-ads-version de terms.html) e ativado/desativado são guardados sem exclusão (ad_consents).
Espaços que não confirmaram os termos, desativaram o consentimento para anúncios ou não estão listados não recebem anúncios.
Espaços de anúncio (slots)
Os operadores decidem onde os anúncios ficam dentro do próprio metaverso. Os anunciantes escolhem slots ou recebem recomendações, e os contratos fixos também são feitos por slot. A lista de slots pode ser vista, ativada e desativada no painel do espaço.
| Campo | Formato | Significado |
|---|---|---|
| name | 1 a 40 caracteres | Um nome que não se repete no espaço |
| kind | floor · wall · air · character | Modelo no chão · placa de parede · banner aéreo · personagem publicitário parado ou andando |
| position | [x, y, z] metros | Posição do centro do piso da caixa do slot (coordenadas do espaço) |
| rotation | [x, y, z] graus (-360 a 360) | Rotação do slot. Padrão [0, 0, 0] |
| size | [largura, altura, profundidade] metros (0.1 a 200) | A caixa onde vai o anúncio. O anúncio é ampliado ou reduzido para caber nessa caixa |
| scale | [mín, máx] vezes (0.05 a 20) | Escala de tamanho por espaço: ao caber na caixa, o anúncio só é escalado dentro dessa faixa do tamanho original. Padrão [0.25, 4] |
| roam | 0 a 50 metros | slots character: o raio em que o personagem anda (0 significa parado) |
| industries | Lista de ids de setor | Setores que este slot aceita. Vazio significa todos os setores |
| enabled | true · false | Desativado, nenhum anúncio é exibido neste slot |
O tamanho de um modelo publicitário pode ser ajustado pelo operador do espaço ou pela Metamoa conforme o espaço.
Anúncios de personagem vão só para slots character; anúncios de modelo e prédio só para slots floor, wall e air.
O SDK (chave pública de anúncios) só pode criar slots novos, e os slots criados assim entram desativados; os anúncios só aparecem depois que o operador confere e ativa no painel do espaço. O SDK não pode alterar um slot existente (mesmo nome) e o devolve como está. Até 5 slots de SDK desativados por espaço, contados à parte dos 30 slots do operador. Um grupo de IP pode criar até 20 por dia, e slots de SDK que o operador nunca ativou em 7 dias são excluídos (slots ativados alguma vez e slots usados por uma campanha não são excluídos). Quando ativados, contam dentro dos 30 slots do operador. Alterar a caixa, o tipo ou os setores de um slot e ativá-lo ou desativá-lo só funciona com login no painel ou com a chave do espaço.
Ids de setor: game (jogos) · fashion (moda, beleza) · food (alimentos e bebidas) · tech (TI, eletrônicos) · finance (finanças) · edu (educação) · travel (viagem, lazer) · culture (cultura, entretenimento) · auto (automóveis) · public (público, sem fins lucrativos) · etc (outros)
Até 30 slots por espaço. A API de slots usa a chave do espaço (mm_live_) ou o login no painel do espaço:
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}Operadores de espaços: passos de instalação
- Em 「Cadastrar para anúncios」 de Monetização do painel do espaço (
https://metamoa.com/owner/revenue?id=<id do espaço>), marque a confirmação dos termos e comece os anúncios. - Coloque a linha de script do painel 「API de anúncios」 da mesma tela no fim do <head> ou do <body> da página do seu espaço. A chave de anúncios (mm_adpub_) pode ser pública (nunca coloque ali a chave do espaço mm_live_).
- Em um espaço three.js, chame attach e slot depois de montar a cena. O slot é registrado desativado na primeira chamada. Os anúncios aparecem quando você o ativa em 「Espaços de anúncio」 do painel (também pode criá-lo já ativado com a API de slots).
- Quando o anúncio aparece, está pronto. O SDK envia sozinho as impressões visíveis, cliques e tempo de exibição, e para entradas no espaço da marca o SDK abre /ads/go ao tocar no anúncio e o servidor conta.
- Em 「Espaços de anúncio」 do painel do espaço, ative e desative slots e veja o relatório de 30 dias (antes e depois das regras) e a sua parte (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 });
});
Motores que não são three.js (Babylon.js, PlayCanvas, Unity WebGL etc.) recebem o anúncio com serve, desenham por conta própria e enviam os eventos: ads.serve(name) → { ad }, ads.report(name, event). Para entradas, abra ad.enter_url em uma janela nova ou na mesma. A especificação está em 「Especificação de eventos」 abaixo.
Como o SDK conta
- Impressão visível: quando pelo menos uma proporção definida do modelo está dentro da visão da câmera, com tamanho na tela de pelo menos uma área definida, por mais que um tempo definido com a aba visível, envia 1 impressão (uma vez por token de serve).
- Tempo de exibição: após a impressão, enquanto o anúncio continua visível nas condições acima, acumula e envia a cada 5 segundos, junto com o número de entradas de câmera e ponteiro no intervalo (para quando a aba é ocultada).
- Se a resposta de serve trouxer um vid, guarde-o nesse navegador e envie-o no próximo serve (GET /ads/v1/serve?…&vid=). Só é lido um vid que o servidor assinou para essa rede. O servidor combina o vid e o grupo de IP de conexão e assina essa pessoa dentro do token. Uma impressão só é contada cerca de 2 segundos após o serve.
- Clique: um toque ou clique no anúncio envia
clicke, se o anúncio tiver um espaço da marca, abre enter_url (/ads/go) em uma janela nova. O servidor conta a entrada e leva o visitante ao espaço da marca. - Porta: se houver ad.door, entrar andando pela porta abre enter_url uma vez em uma janela nova. Quando ela abre de novo: veja 「Entrar pela porta」 abaixo.
- O id do navegador (vid) é dado pelo servidor e guardado pelo SDK no localStorage. É usado só para limites de repetição. Nenhuma informação pessoal, como nomes ou contatos, é enviada.
- Os anúncios são buscados de novo a cada 30 minutos (novo token). Personagens em slots character andam devagar dentro do raio roam.
Entrar pela porta
Você pode colocar uma porta em um prédio publicitário ou no seu próprio modelo 3D. É uma porta, não um portal: quando alguém entra andando pela porta, o espaço atual continua como está e o espaço da marca abre em uma janela nova (nova aba). Coloque "door": true no creative da campanha (só quando kind é model ou building), e brand_url é obrigatório (senão 400 invalid, fields brand_url). O ad do serve então vem com 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 } }
Regras para a porta não reabrir sem parar (obrigatórias)
- Ao chegar andando a menos de 1.2m da porta, o espaço da marca (enter_url com &via=door) abre uma vez em uma janela nova.
- Depois de fechar a janela nova e voltar, mexer-se um pouco dentro ou perto da porta não a abre de novo.
- Ela só reabre depois de se afastar mais de 3m da porta e voltar (distância de entrada 1.2m < distância de saída 3m).
- Não abre enquanto a aba está oculta ou a janela está sem foco, e ao voltar é preciso sair da área da porta uma vez. Não abre se você já estiver dentro da porta quando a página abrir.
- Tocar ou clicar no prédio para abri-lo funciona como antes (a cada clique). As regras da porta valem só para entrar andando.
- Se o navegador bloquear a janela nova, aparece um botão 「Abrir <marca>」 na parte de baixo da tela. Só abre ao tocar nesse botão (ele some se você sair da porta sem tocar).
Posição da porta: um nó chamado door no glb, se houver; senão o SDK desenha uma porta padrão no centro inferior da frente do anúncio (+Z). A distância é a distância no chão do personagem que anda até a frente da porta. Passe para attach um walker (o Object3D do personagem que anda ou uma função que retorne {x, y, z}). Sem ele, usa-se a posição da câmera.
ads.attach({ THREE, GLTFLoader, scene, camera, renderer, walker: player }); // player: the walking character (Object3D)
Espaços que desenham ad.door por conta própria com um motor que não é three.js devem seguir as mesmas regras: depois de abrir uma vez, não abrir de novo até o andador sair de exit_m, e depois que a aba foi ocultada e voltou, até ele sair da área da porta uma vez.
Para que entrar e sair não esgote o orçamento
- Uma entrada pela porta é contada pelo mesmo preço de 1 entrada CPA (preço e investimento mínimo inalterados).
- As entradas por pessoa (o id de navegador dado pelo servidor + grupo de endereços de internet) e campanha são contadas uma vez a cada 24 horas, até 3 vezes em 30 dias. O mesmo grupo de endereços de internet tem até 3 vezes por dia por campanha e espaço.
- Entradas além disso ainda levam o visitante ao espaço da marca, mas não são cobradas, só registradas (motivo de exclusão repeat_limit). Elas são conferidas de novo com os registros de eventos do servidor (só hashes), então nada é esquecido quando o servidor reinicia.
- Uma entrada com o mesmo token de serve é contada uma vez, e só para tokens cuja impressão foi contada antes (as regras antibot e antifraude como estão).
Regras antibot e antifraude
No servidor, os eventos passam pelas regras abaixo, em ordem. Se qualquer uma barrar, o evento sai do relatório e é registrado à parte com o nome dessa regra. Cada regra é ativada e desativada em bot_rules de data/ads-config.json.
| Regra | O que faz | Agora |
|---|---|---|
UA de bot (ua_bot) | Robôs de busca, pré-visualizações, scripts (curl, python, headless etc.) e requisições sem User-Agent são excluídos. | Ativada |
Navegadores automatizados (headless) | Navegadores com navigator.webdriver ativado, HeadlessChrome, PhantomJS, Electron, jsdom e requisições sem Accept-Language são excluídos. É uma definição de medição, não conta como defesa contra scripts. | Ativada |
Visibilidade e foco da aba (visibility_focus) | Impressões só contam enquanto a aba está visível (document.visibilityState = visible) e a janela tem foco; o tempo de exibição, só enquanto a aba está visível. É uma definição de medição. | Ativada |
Verificação de visibilidade (min_view) | Pelo menos uma proporção definida do modelo precisa ficar na tela, com pelo menos uma área definida, por mais que um tempo definido para 1 impressão. É uma definição de medição. | Ativada |
Limites de repetição por pessoa e endereço de internet (repeat_limit) | Impressões e cliques da mesma pessoa e modelo contam uma vez em um tempo definido; entradas (incluindo a porta), uma vez por dia e até um número definido em dias definidos. O que passar do limite por hora de um grupo de endereços de internet, dos novos espectadores diários por espaço ou das impressões, cliques e entradas diários por campanha e espaço é excluído. Os limites de entrada são conferidos de novo com os registros de eventos do servidor, então nada é esquecido quando o servidor reinicia. | Ativada |
Tokens assinados pelo servidor (signed_token) | Os eventos precisam trazer o token assinado (HMAC) dado pelo serve. O espectador e o grupo de endereços de internet no momento do serve são assinados dentro do token; impressões vindas de outro endereço são excluídas, assim como impressões antes de passar um tempo definido desde o serve. Um token conta no máximo uma impressão, um clique e uma entrada cada dentro da validade. O orçamento da campanha é conferido de novo na contagem, e eventos além dele não são contados (budget). | Ativada |
Medição do tempo de exibição (view_time) | O tempo de exibição só conta quando há entrada de câmera ou ponteiro no intervalo, e só até os limites diários por token, por pessoa e modelo, e por endereço de internet e modelo. | Ativada |
Tráfego do próprio operador (owner_traffic) | Eventos de um endereço de internet que abriu o painel desse espaço são excluídos por um número definido de dias. | Ativada |
Sinais de interação humana (human_input) | Só contam cliques que o navegador marca como interação humana (isTrusted). Impressões não olham o número de interações (pessoas assistindo paradas, usuários de teclado e leitores de tela). | Ativada |
Monitoramento de anomalias e retenções (anomaly) | Impressões que uma pessoa viu acima de um número definido por dia são excluídas. Cliques e entradas CPA contam até uma cota diária automática por espaço, e o restante fica retido. Se a taxa de cliques e entradas (comparada à rede sem esse espaço), impressões por clique no espaço, novos espectadores por endereço de internet, a parcela de data centers, repetições do mesmo endereço ou entradas por clique passarem dos limites, a parte desse espaço no mês fica retida e um administrador decide. | Ativada |
Redes de data center (asn) | Se o x-mm-asn (número AS) adicionado pelo Cloudflare for uma rede de nuvem ou hospedagem, o evento é excluído, e se essa parcela for grande, o espaço fica retido. Só é confiável quando o cabeçalho secreto (origin-auth) que uma Cloudflare Transform Rule adiciona junto bate com o valor env do servidor; senão, a rede do evento fica como 「desconhecida」 e a parcela de data centers é medida só com eventos de rede conhecida. | Ativada |
Verificação humana na entrada (turnstile) | Uma entrada no espaço da marca (/ads/go) só conta depois de passar pelo Cloudflare Turnstile no domínio da Metamoa. Se falhar, o visitante ainda vai para o espaço da marca e só a entrada não é contada. Entradas que chegaram sem chave ficam retidas. | Ativada |
Verificação humana de impressões (turnstile_imp) | O SDK executa o Cloudflare Turnstile em uma janela oculta da metamoa e anexa às impressões o passe obtido (vinculado àquela rede e espaço). Um passe conta; uma verificação que falhou é excluída. Sem passe, só aquela impressão fica retida; ao fim do mês ela é liberada ou anulada conforme a proporção não verificável do espaço (um administrador pode liberá-la). O anúncio sempre aparece como está. | Ativada |
- Cliques e entradas só contam quando a impressão desse token foi contada antes (senão no_impression).
- Quando as tabelas que o servidor guarda ficam cheias, ele não apaga registros cujo prazo ainda não venceu; para de contar eventos novos (capacity). Falha de modo fechado.
Especificação de eventos
Requisições do SDK só são aceitas do próprio site desse espaço. Para o domínio próprio do operador, o mesmo domínio registrável; para hosts compartilhados como github.io ou vercel.app, exatamente o mesmo nome de host; e para espaços sob um caminho (github.io/<repositório>, claude.ai), o caminho do Referer também precisa estar abaixo (o SDK envia o Referer completo). Tudo com CORS aberto, JSON. sendBeacon (text/plain) também é aceito.
Receber um anúncio · 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"
}
]
}
}
Se ad for null, não há anúncio para esse slot agora. Se kind for model, coloque o glb de model_url; se for building, coloque o glb do prédio e, se mode for image, aplique a imagem de image_url em cada nome de mesh de faces, e se for texture, aplique image_url em todos os texture.meshes, repetida conforme repeat. Se for character, coloque de pé o glb do personagem, prenda o acessório em prop.attach e coloque na placa dele a imagem de image_url ou as letras de text. Tudo se ajusta à caixa slot.size, mas só é escalado dentro de slot.scale do tamanho original.
Registrar um slot · slots
POST https://metamoa.com/ads/v1/slots
{
"space": "{space_id}",
"key": "{mm_adpub_…}",
"name": "plaza-front",
"kind": "floor",
"position": [
0,
0,
-8
],
"rotation": [
0,
90,
0
],
"size": [
4,
4,
4
],
"scale": [
0.5,
2
],
"industries": [
"game",
"food"
]
}
→ 201 { "slot": {…, "enabled": false} } (새 자리, 공간운영자가 켤 때까지 꺼짐) · 200 (같은 이름의 자리를 바꾸지 않고 그대로)
Enviar eventos · 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 | Campo | Significado |
|---|---|---|
| imp | token, ms, area, inside, vis, focus, inputs, wd | ms: tempo exibido sem interrupção, area: área do modelo em relação à área da tela (0 a 1), inside: parcela do modelo dentro da tela (0 a 1), vis·focus: aba visível e foco da janela, inputs: entradas de câmera e ponteiro no intervalo, wd: navigator.webdriver |
| time | token, ms, vis, inputs, wd | Tempo exibido desde o último time (até 15,000ms) e o número de entradas no intervalo |
| click | token, trusted, wd | O anúncio foi tocado ou clicado. trusted: interação humana (isTrusted) |
As impressões contam com o passe de verificação humana que o SDK obtém de uma janela oculta da metamoa (Cloudflare Turnstile). O anúncio aparece na hora, sem esperar por ele. Se o seu site envia uma Content-Security-Policy, adicione https://metamoa.com ao frame-src. Se a janela for bloqueada ou não houver passe, a impressão fica retida; ao fim do mês ela é liberada se a proporção não verificável do espaço for de 20% ou menos, e anulada acima disso.
Até 20 por vez. Os eventos não levam vid; o espectador vem do valor dentro do token. Eventos errados e tokens de outro espaço só contam como excluded.
Entrada · go
Uma entrada só conta depois que /ads/go, no domínio da Metamoa, confirma com o Cloudflare Turnstile que é uma pessoa (quando há chave, aparece uma pequena tela de verificação por 1 a 2 segundos). Se a verificação falhar, a pessoa ainda vai para o espaço da marca e só a entrada não é contada.
GET https://metamoa.com/ads/go?t={serve 토큰}
→ 302 Location: {brand_url} (노출이 센 토큰이면 입장을 센 뒤 브랜드 공간으로. 캠페인이 집행 중·기간 안이고 토큰이 유효 시간 안일 때만 검수에서 승인된 brand_url로 가고, 아니면 Location: /)Prédios publicitários, personagens e especificações de envio
Anunciantes sem modelo escolhem um dos nossos prédios publicitários ou personagens publicitários básicos. Para prédios, escolha uma de duas formas: imagem (uma imagem em cada placa definida) · textura (uma textura ou padrão em toda a superfície do prédio).
Para texturas, baixe o modelo-base padrão (PNG quadrado), edite e envie no mesmo tamanho (1024 a 2048px). As linhas rosa da base com linhas são as bordas das partes da superfície: pinte dentro de uma parte e ela aparece nessa superfície.
Na loja publicitária (shop-ad), a única imagem enviada aparece na frente, nas laterais, no fundo e no topo: a placa da frente, os dois lados, o fundo e a placa do teto têm a mesma proporção, então dá para ler de qualquer lado, até olhando de cima. Ela tem porta, então dá para usar 「Entrar pela porta」 ("door": true).
Os personagens publicitários básicos são gratuitos em qualquer valor. Eles ficam parados ou andam em slots character, seguram acessórios presos aos ossos, como placa de pescoço, crachá, plaquinha de mão, balão, bandeira ou sacola de compras, e a placa do acessório leva uma imagem publicitária ou letras de placa (até 12 caracteres). Os gatos, o cachorro e Vincent só podem usar acessórios no pescoço.
| Personagem | id | Acessórios que pode segurar | Licença |
|---|---|---|---|
| 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 | Próprio (FLOAT Co., Ltd.) |
| Gato de pelo curto Nyangjupgo | cat_short | prop-neck-sign prop-badge | CC BY 4.0 |
| Gato de pelo longo Nyangjupgo | cat_long | prop-neck-sign prop-badge | CC BY 4.0 |
| Munchkin Nyangjupgo | cat_munchkin | prop-neck-sign prop-badge | CC BY 4.0 |
| Corgi Nyangjupgo | dog_corgi | prop-neck-sign prop-badge | CC BY 4.0 |
| Acessório | id | Proporção da imagem · tamanho mínimo |
|---|---|---|
| Placa de pescoço (tipo crachá) | prop-badge | 720:1024, pelo menos 360×512px |
| Balão | prop-balloon | 1024:1024, pelo menos 512×512px |
| Bandeira de mão | prop-flag | 1024:688, pelo menos 512×344px |
| Placa pendurada no pescoço | prop-neck-sign | 1024:720, pelo menos 512×360px |
| Plaquinha de mão | prop-picket | 1024:720, pelo menos 512×360px |
| Sacola de compras | prop-shopping-bag | 1024:1024, pelo menos 512×512px |
- Formatos de imagem: PNG · JPEG · WEBP, até 2MB, até 4096px de largura e altura, tolerância de proporção até 2%. As imagens enviadas são salvas de novo como WebP (os metadados da foto são removidos).
- Modelo 3D: um arquivo binário glTF 2.0 (.glb), até 6MB, texturas dentro do arquivo, sem endereços externos (uri).
- Os arquivos enviados são verificados pelo conteúdo (bytes mágicos): imagens só são aceitas como PNG, JPEG ou WebP (nada de SVG, HTML etc.) e refeitas como WebP, e modelos só como binário glTF 2.0. Os arquivos de anúncio só são servidos com tipo fixo (image/webp, model/gltf-binary), nosniff e política sandbox, então nunca rodam como script.
- O tamanho de um modelo publicitário pode ser ajustado pelo operador do espaço ou pela Metamoa conforme o espaço.
- Os arquivos de modelos e personagens ficam em /ads/models/ e só são servidos como respostas que não permitem script (tipo fixo, nosniff, sandbox). A lista e as fontes estão em docs/ads/MODELS.md; para alterar, gere de novo data/ads-buildings.json e os arquivos juntos com scripts/ads-import-models.mjs.
Créditos dos modelos
A maioria dos modelos básicos é CC0 (domínio público) ou feita internamente; os abaixo são CC BY, por isso as fontes são citadas. A FLOAT Co., Ltd. modificou todos (tamanho, faces de anúncio etc.).
- Outdoor de pé: "Blank Billboard" by Jarlan Perez (https://poly.pizza/m/1E0d2B7bC8e), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), modificado pela FLOAT Co., Ltd.
- Estande pop-up: "Carnival Booth" by sirkitree (https://poly.pizza/m/4NizXJZsuO2), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), modificado pela FLOAT Co., Ltd.
- Painel de ponto de ônibus: "Bus Stop" by Zsky (https://poly.pizza/m/OWczicNWhO), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), modificado pela FLOAT Co., Ltd.
- Cavalete tipo A: "Sandwich Board" by Anonymous (https://poly.pizza/m/ejy0W_7cHWT), CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/), modificado pela FLOAT Co., Ltd.
- Gato de pelo curto Nyangjupgo: "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, convertido em voxels pela FLOAT Co., Ltd.
- Gato de pelo longo Nyangjupgo: "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, convertido em voxels pela FLOAT Co., Ltd.
- Munchkin Nyangjupgo: "Cat" by Polyfork (https://polyfork.dev/asset/cat-base), CC BY 4.0, convertido em voxels pela FLOAT Co., Ltd.
- Corgi Nyangjupgo: "Dog" by Polyfork (https://polyfork.dev/asset/dog-base), CC BY 4.0, convertido em voxels pela FLOAT Co., Ltd.
Pedir um modelo
Quando um anunciante escolhe 「Pedir um modelo」, fazemos o modelo 3D, anexamos à campanha e depois revisamos. Envie os materiais (fotos do produto, logo, desenhos) para [email protected] com o número da campanha.
| Nível | grade | Taxa de criação | Grátis a partir deste investimento em mídia |
|---|---|---|---|
| Produto simples · placa | simple | ₩50,000 (preço de fornecimento, sem IVA) | ₩500,000 |
| Produto detalhado | precise | ₩100,000 (preço de fornecimento, sem IVA) | ₩1,000,000 |
| Personagem novo | character | ₩100,000 (preço de fornecimento, sem IVA) | ₩1,000,000 |
- O limite de gratuidade é o investimento real em mídia (a soma de todo o período do contrato, até 3 meses, sem modelagem, IVA e tráfego inválido).
- Um modelo feito de graça vem com licença para exibição só na Metamoa (os direitos autorais ficam com a Metamoa; a cessão, mediante a taxa de criação), com 1 revisões. Se o anunciante cancelar ou reduzir o investimento, a taxa de criação é cobrada proporcionalmente: taxa de criação × (1 − investimento real em mídia ÷ limite de gratuidade). Modelos pagos têm 2 revisões.
- Os personagens publicitários básicos (os personagens do Acampamento Moa e de Nyangjupgo) são gratuitos em qualquer valor, sem pedido de criação.
Anunciantes: passos do cadastro próprio
- Entre com uma conta Metamoa em https://metamoa.com/ads/manage (o cadastro, na mesma janela).
- Criar uma campanha: nome, marca, setor e endereço do espaço da marca (ao usar CPA de entrada).
- Peça: ① envie seu próprio modelo 3D (glb) ② escolha um prédio publicitário → uma imagem por placa no modo imagem, uma textura no modo textura ③ escolha um personagem publicitário básico + acessório → uma imagem ou letras de placa na placa do acessório ④ peça um modelo (escolha um nível). As especificações e uma prévia aparecem.
- Espaços: na lista de espaços que consentiram com anúncios, escolha você mesmo os slots por categoria, pessoas online agora e cliques diários no espaço, ou toque em 「Recomendar」 para um conjunto de espaços ajustado ao setor, à categoria e ao tráfego.
- Defina o tipo de cobrança (CPM, CPA, tempo de exibição, contrato de espaço fixo), o orçamento e o período e faça o pedido → aguardando revisão.
- Ao passar na revisão (obscenidade, violência, suspeita de violação de direitos autorais etc.), começa a veicular. Uma campanha em andamento pode ser pausada e reativada, e você vê todos os dias as impressões visíveis, cliques, entradas e tempo de exibição.
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>)
Peça com personagem: {"kind": "character", "character_id": "bangjang", "prop": "prop-picket", "image": "as_…"} ou "text": "Leite Brilhante" no lugar de "image". Contrato de espaço fixo: "billing": "fixed", "fixed_period": "week" | "month", end_day = start_day + período − 1. Pedido de modelo: {"kind": "request", "grade": "simple", "note": "…"}.
Peças de prédio e de modelo próprio aceitam mais duas coisas (opcional): "tagline": "descrição de uma linha" (até 30 caracteres, só letras — sem tags, sinais de menor/maior ou chaves (400 invalid, fields creative), revisada junto com a peça) é desenhada na faixa abaixo da placa da loja publicitária ou do prédio (mesh ad_tagline) e vem como ad.tagline { text, mesh, aspect } do serve. "door": true é 「Entrar pela porta」 (brand_url obrigatório). São os mesmos campos 「Descrição de uma linha」 e 「Entrar pela porta」 da etapa 2 de /ads/manage.
Revisão
- Modelos e imagens enviados e campanhas aguardam revisão (review) antes de veicular. Quando um administrador aprova, veicula (active); se rejeitado, ficam registrados rejected e o motivo.
- As imagens são primeiro verificadas no envio por uma análise de imagem com IA em busca de obscenidade, violência e logos ou personagens de terceiros, e bloqueadas na hora se detectadas (rejected). Se a análise não puder rodar, um administrador olha.
- Os modelos são abertos e verificados por um administrador. Obscenidade, violência ou suspeita de violação de direitos autorais levam à rejeição.
Códigos de erro
O corpo do erro é { "error": "<código>", "message": "<uma linha sobre o que fazer a seguir>" }; erros de campo vêm com fields, e limites com retry_after.
| HTTP | error | Significado |
|---|---|---|
| 400 | invalid | Um campo está com formato errado. fields traz os campos errados. |
| 400 | bad_model | Não é glb, não é glTF 2.0 ou contém um endereço externo (uri). O motivo vem em reason. |
| 400 | bad_image | O formato, o tamanho ou a proporção da imagem não batem com a especificação. Vêm reason (format · bytes · too_large · too_small · aspect) e spec. |
| 400 | bad_building | O default_building do slot não é um id de prédio ou placa de GET /ads/v1/buildings (vazio pode). |
| 400 | slot_unavailable | O slot escolhido não aceita anúncios, não aceita esse setor ou não combina com o tipo de peça (personagens só em slots de personagem). slot_ids traz esses slots. |
| 401 | unauthorized | Sem chave do espaço ou login no painel do espaço, ou incorreto. |
| 401 | sign_in | Anunciante: sem login com conta Metamoa, ou expirou. |
| 403 | owner_required | Há chave do espaço, mas o operador do espaço ainda não foi verificado. |
| 403 | owner_page_only | Tentou confirmar os termos ou o consentimento para anúncios com uma chave do espaço (só funciona no painel do espaço). |
| 403 | bad_ad_key | SDK: space e key (mm_adpub_) não batem. |
| 403 | terms_required | Esse espaço não confirmou os termos de veiculação de anúncios. |
| 403 | ads_off | Esse espaço desativou o consentimento para anúncios. |
| 403 | origin_mismatch | A requisição do SDK não veio do site desse espaço (mesmo domínio). |
| 404 | not_house | Nossos próprios anúncios (GET /ads/v1/house) foram chamados de um espaço que a Metamoa não opera diretamente. |
| 403 | not_yours | Anunciante: usou o id de arquivo de outra pessoa. |
| 404 | no_slot | Não há slot de anúncio com esse nome ou id. |
| 404 | not_found | Essa campanha ou arquivo não existe. |
| 409 | not_listed | Um espaço que não está listado (antes da aprovação ou oculto). |
| 409 | payout_info_required | Tentou ativar o consentimento para anúncios sem o tipo de dados de pagamento (pessoa física ou empresa) e um contato (celular ou e-mail). Preencha em Monetização do painel do espaço (/owner/revenue?id=<id do espaço>). |
| 409 | advertiser_required | Anunciante: tentou pedir ou pagar uma campanha antes de preencher os dados do anunciante (PUT /api/ads/advertiser). |
| 409 | biz_doc_required | Anunciante: um anunciante empresa tentou pagar ou pedir um contrato de espaço fixo antes de enviar a cópia do comprovante de registro empresarial (PUT /api/ads/advertiser/doc). |
| 409 | business_only | Anunciante: um anunciante pessoa física tentou enviar uma cópia de comprovante de registro empresarial. |
| 400 | bad_doc | Anunciante: a cópia do comprovante de registro empresarial não é PDF, JPG ou PNG. |
| 413 | doc_too_big | Anunciante: a cópia do comprovante de registro empresarial passa de 5MB. |
| 503 | advertiser_unavailable | Anunciante: o servidor não tem chave de criptografia para os dados do anunciante, então não pode recebê-los. |
| 409 | email_not_linked | Anunciante: o e-mail de um anunciante pessoa física não é o e-mail usado no login desta conta Metamoa. |
| 409 | name_taken | Já existe um slot com o mesmo nome. |
| 409 | slot_limit | Até 30 slots do operador por espaço, e até 5 slots de SDK não confirmados. |
| 409 | slot_taken | Um slot que já tem outro contrato de espaço fixo nesse período. |
| 409 | tier_too_low | Escolheu como contrato de espaço fixo um slot de um espaço cujos cliques diários estão abaixo do nível mais baixo. slot_ids traz esses slots. |
| 409 | not_for_sale | Não há preço de contrato de espaço fixo. |
| 409 | under_minimum | Abaixo do investimento mínimo em mídia. Vêm min_spend_won e spend_won. |
| 409 | no_click_history | Escolheu CPM ou contrato de espaço fixo para slots de espaços ainda sem histórico de cliques (não dá para medir impressões nem nível). Só funcionam CPA e tempo de exibição. Vêm slot_ids e billings. |
| 409 | over_inventory | O orçamento CPM passa do limite de impressões visíveis previstas dos slots escolhidos. Vem max_budget_won. |
| 409 | rejected_file | Usou em uma campanha um arquivo bloqueado na revisão. |
| 409 | wrong_state | Algo que não pode ser feito nesse estado (pausar uma campanha em revisão etc.). |
| 409 | stale | Administrador: a campanha mudou depois que a tela de revisão foi aberta (a version de decide difere da atual). Veja de novo e decida de novo. |
| 409 | already_paid | Tentou abrir de novo o pagamento de uma campanha já paga. |
| 409 | not_paid | Administrador: tentou aprovar o acerto de uma campanha cujo pagamento não terminou. |
| 409 | held | Administrador: tentou aprovar o acerto de uma campanha com parte retida (decida a retenção primeiro). |
| 424 | hrum_failed | Não foi possível conectar ao pagamento (Hrum). Tente de novo em instantes. |
| 503 | pay_not_ready | O pagamento ainda não pode ser aberto (antes da configuração do servidor). |
| 409 | model_missing | Administrador: aprovou uma campanha de pedido de modelo antes de anexar o modelo. |
| 413 | model_too_big | O arquivo do modelo passa de 6MB. |
| 429 | too_many | Requisições demais. Aguarde os segundos de Retry-After. |
Todos os caminhos
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