ProductRecommendations

A query productRecommendations retorna produtos recomendados a partir de um produto base. Pode ser utilizada para montar vitrines ou carrosséis personalizados em páginas de produto (PDP), com recomendações mais relevantes.

Requisição

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
productId	Long	Sim	ID do produto que será utilizado como base para gerar recomendações.
algorithm	Enum ProductRecommendationAlgorithm	Não	Define o critério de similaridade dos produtos recomendados. Por padrão, utiliza DEFAULT. Veja a tabela de opções abaixo.
sortKey	Enum ProductSortKeys	Não	Define o critério de ordenação dos produtos recomendados. Só tem efeito quando o algorithm diferente de DEFAULT é utilizado. Ex: SALES, PRICE
sortDirection	Enum SortDirection (ASC, DESC)	Não	Direção da ordenação. Funciona junto com sortKey.
quantity	Int	Não	Quantidade de produtos recomendados a serem retornados. Por padrão é 5
partnerAccessToken	String	Não	Token de parceiro, utilizado para filtrar os produtos disponíveis conforme a segmentação da loja.

Algoritmos disponíveis

Valor (algorithm)	Recomendação baseada em...
DEFAULT	Produtos similares (modo padrão)
CATEGORY	Mesma categoria
BRAND	Mesma marca
GENDER	Mesmo gênero (masculino, feminino etc.)
COLLECTION	Mesma coleção
AUTHOR	Mesmo autor (livros, editoriais)
PUBLISHER	Mesma editora

🚧

Observação:

O sortKey e sortDirection só funcionam se você estiver usando um algoritmo diferente de DEFAULT.

Campos retornados

Os campos de retorno da query productRecommendations são os mesmos utilizados naquery products. Você pode selecionar apenas os campos que desejar, como productName, alias, prices, spotAttributes, available, entre outros.

Exemplo de uso (DEFAULT)

query {
  productRecommendations(productId: 227820) {
    alias
    productName
    productId
    prices {
      price
    }
    spotAttributes
  }
}

Mostrar resposta

Text

{
  "data": {
    "productRecommendations": [
      {
        "alias": "baixela-18-pecas-deva-premium-fine-china-lemon-flavour-157385",
        "productName": "Baixela 18 peças Deva Premium Fine China Lemon Flavour",
        "productId": 157385,
        "prices": {
          "price": 2399
        },
        "spotAttributes": []
      },
      {
        "alias": "baixela-24-pecas-deva-premium-fine-china-lemon-flavour-157387",
        "productName": "Baixela 24 peças Deva Premium Fine China Lemon Flavour",
        "productId": 157387,
        "prices": {
          "price": 2999
        },
        "spotAttributes": []
      },
      {
        "alias": "baixela-24-pecas-deva-premium-fine-china-rosa-garden-157370",
        "productName": "Baixela 24 peças Deva Premium Fine China Rosa Garden",
        "productId": 157370,
        "prices": {
          "price": 2899
        },
        "spotAttributes": []
      },
      {
        "alias": "bothyi-tigela-de-ceramica-matcha-227817",
        "productName": "Bothyi Tigela de cerâmica Matcha",
        "productId": 227817,
        "prices": {
          "price": 134.9
        },
        "spotAttributes": []
      },
      {
        "alias": "conjunto-de-4-pecas-para-matcha-—-kit-de-iniciacao-tradicional-com-batedor-colher-suporte-e-tigela-227819",
        "productName": "Conjunto de 4 Peças para Matcha — Kit de Iniciação Tradicional com Batedor, Colher, Suporte e Tigela",
        "productId": 227819,
        "prices": {
          "price": 178.9
        },
        "spotAttributes": []
      }
    ]
  }
}

Dica de uso

Você pode montar carrosséis diferentes por página de produto, como:

• “Produtos da mesma marca”
• “Você também pode gostar” (baseado em categoria)
• “Mais vendidos desta coleção”

Basta ajustar os parâmetros da query para refletir o tipo de recomendação desejada.