VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API atual/Referência completa

Conversão da página do produto

Ferramentas para aumentar as vendas na página do produto: testes A/B, selos de prova social, histórico de preço, compre junto e personalização.

A página do produto (PDP) é onde o cliente decide comprar. Esta seção reúne três ferramentas do administrador para melhorá-la: experimentos A/B (compare duas versões de um elemento e veja qual converte mais), as configurações de conversão (selos de "vendidos nos últimos 30 dias", gráfico de preço, "compre junto", perguntas e respostas, pontos por avaliação) e a personalização (reordenar listagens pelo interesse de cada cliente).

Pontos-chave
  • Todos os recursos de conversão vêm desligados por padrão. Ligue um de cada vez e meça.
  • Um experimento compara a versão A (a atual) com a B (a nova) para uma parte dos visitantes, e só pode ter um experimento em andamento por elemento.
  • Declarar vencedor exige 200 exposições por variante e confiança estatística de 95%; a plataforma calcula isso para você.
  • As métricas (exposição, carrinho, pedido, receita) são registradas pelo servidor, nunca pela vitrine.
  • Estas rotas exigem o privilégio manage_settings.

Como funciona

Ciclo de um experimento

draft→running→completed | stopped
statusSignificado
draftCriado, ainda não mostrado a ninguém.
runningEm andamento: parte dos visitantes vê a versão B.
completedEncerrado com um vencedor declarado (winner: a ou b).
stoppedParado sem vencedor. Todos voltam a ver a versão A.
  1. Criar

    Escolha o elemento (element_key), o valor da versão B e a porcentagem de visitantes que vê a B.

  2. Iniciar

    Passe de draft para running.

  3. Acompanhar

    Leia as estatísticas até haver amostra e confiança suficientes.

  4. Encerrar

    Aplique o vencedor, ou pare o teste.

Conceitos-chave

Quem vê qual versão

A divisão é por visitante: o cliente logado é identificado pelo id de usuário e o visitante anônimo pelo identificador de sessão que a vitrine envia. Um mesmo visitante vê sempre a mesma versão enquanto o teste durar.

Elementos testáveis

cta_label (texto do botão de compra), social_proof_badges (selos de prova social), price_history_badge (selo de histórico de preço) e reviews_position (posição das avaliações).

Endpoints

Método e caminhoPara que serveAutenticaçãoPágina
GET /api/v1/admin/pdp-experimentsLista experimentosadministradorExperimentos A/B
POST /api/v1/admin/pdp-experimentsCria experimentoadministradorExperimentos A/B
PUT /api/v1/admin/pdp-experiments/{id}/startIniciaadministradorExperimentos A/B
GET /api/v1/admin/pdp-experiments/{id}/statsEstatísticasadministradorExperimentos A/B
PUT /api/v1/admin/pdp-experiments/{id}/stopParaadministradorExperimentos A/B
PUT /api/v1/admin/pdp-experiments/{id}/apply-winnerAplica o vencedoradministradorExperimentos A/B
GET /api/v1/admin/pdp-conversao/settingsLê os recursos de conversãoadministradorRecursos de conversão
PUT /api/v1/admin/pdp-conversao/settingsGrava uma seçãoadministradorRecursos de conversão
GET /api/v1/admin/personalization/settingsLê a personalizaçãoadministradorPersonalização
PUT /api/v1/admin/personalization/settingsGrava a personalizaçãoadministradorPersonalização
GET /api/v1/admin/personalization/upliftGanho da personalizaçãoadministradorPersonalização

Erros comuns

  • Iniciar um segundo experimento do mesmo elemento. 409: já há um em andamento.
  • Declarar vencedor cedo demais. A rota deixa, mas as estatísticas avisam por can_declare_winner. Respeite o aviso.
  • Mandar winner diferente de a ou b. Dá 500 com a explicação em detail.
  • Esperar que aplicar o vencedor mude texto de botão sozinho. Só alguns elementos têm configuração persistida.
  • Mandar a seção errada em PUT /pdp-conversao/settings. 400 invalid section.

Próximos passos

Experimentos A/B
Criar e acompanhar um teste.
Recursos de conversão
Ligar selos e compre junto.
Personalização
Reordenar por interesse.
Anterior
Importações em andamento
Próxima
Experimentos A/B
Nesta página
  • Como funciona
  • Ciclo de um experimento
  • Conceitos-chave
  • Quem vê qual versão
  • Elementos testáveis
  • Endpoints
  • Erros comuns
  • Próximos passos