Engajamento e conteúdo
Seis áreas pequenas do painel de administração que ligam a loja a anunciantes, ao app mobile, a formulários públicos e ao RD Station Marketing.
Esta seção reúne áreas de engajamento que não têm seção própria: a publicidade patrocinada do marketplace, as páginas do app mobile, as respostas dos formulários que o público preenche, a integração com o RD Station Marketing (automação de marketing) e duas rotas de compatibilidade que existem só por contrato.
Como funciona
Publicidade patrocinada
O seller cria campanhas e as paga com uma carteira de créditos. A loja liga ou desliga a publicidade e define o piso do leilão. Quando a vitrine pede espaços patrocinados, a plataforma roda um leilão de segundo preço: o vencedor paga o lance do segundo colocado, nunca menos que o piso. O administrador tem três rotas: ler e alterar a configuração e consultar o relatório (Publicidade).
Resposta de formulário
status | Significado |
|---|---|
new | Recebida, ninguém olhou. |
read | Alguém da equipe abriu. |
replied | A equipe já respondeu. |
Conceitos-chave
Módulos
Um módulo é um recurso que cada loja liga ou desliga. A plataforma bloqueia as rotas do módulo desligado com 403 module_disabled.
Privilégios
Cada rota exige um privilégio do grupo do administrador. Em geral: conteúdo (páginas do app, formulários) usa view_content para ler e manage_content para escrever; o RD Station exige manage_settings.
Identificadores e datas
Todos os ids novos são UUID em string. Datas em RFC 3339, UTC.
Endpoints
| Método e caminho | Para que serve | Autenticação | Página |
|---|---|---|---|
GET /api/v1/admin/ads/settings | Lê a configuração de anúncios | administrador | Publicidade |
PUT /api/v1/admin/ads/settings | Altera a configuração | administrador | Publicidade |
GET /api/v1/admin/ads/report | Totais da loja | administrador | Publicidade |
GET /api/v1/admin/mobile-pages | Lista páginas do app | administrador | Páginas do app |
POST /api/v1/admin/mobile-pages | Cria página | administrador | Páginas do app |
PUT /api/v1/admin/mobile-pages/{id} | Altera página | administrador | Páginas do app |
DELETE /api/v1/admin/mobile-pages/{id} | Apaga página | administrador | Páginas do app |
GET /api/v1/admin/form-submissions/{id} | Lê uma resposta | administrador | Respostas de formulário |
PATCH /api/v1/admin/form-submissions/{id}/status | Muda o status | administrador | Respostas de formulário |
DELETE /api/v1/admin/form-submissions/{id} | Apaga a resposta | administrador | Respostas de formulário |
GET /api/v1/admin/rd-station/status | Estado da integração | administrador | RD Station |
POST /api/v1/admin/rd-station/test-connection | Testa as credenciais | administrador | RD Station |
POST /api/v1/admin/rd-station/test-event | Envia evento de teste | administrador | RD Station |
POST /api/v1/admin/rd-station/clear-cache | Limpa os tokens em cache | administrador | RD Station |
POST /api/v1/admin/rd-station/abandoned-run | Roda a varredura de carrinhos | administrador | RD Station |
GET /api/v1/admin/rd-station/logs | Lê o log da integração | administrador | RD Station |
GET /api/v1/admin/app-banners | Compatibilidade, sempre vazia | administrador | Rotas de compatibilidade |
GET /api/v1/admin/notifications | Compatibilidade, sempre vazia | administrador | Rotas de compatibilidade |
Erros comuns
- Chamar uma rota de módulo desligado.
403 module_disabled. Peça a ativação do módulo antes de integrar. - Mandar
PUT /ads/settingsincompleto. O corpo substitui a configuração inteira; campos omitidos são gravados como falso, zero ou vazio (veja a página de publicidade). - Esperar páginas inativas na lista do app. Só aparecem páginas ativas.
- Achar que
PUT /mobile-pages/{id}grava seções. Só os campos da página são gravados. - Usar
statusfora denew,read,repliednas respostas de formulário. É400 INVALID_STATUS. - Tratar o
200do teste de conexão do RD Station como sucesso. Leiaokno corpo.