Skip to main content
Esta página é o catálogo completo por trás do editor de Strategies: todos os gatilhos e os operadores que cada um aceita, todas as ações, os filtros globais e como uma Strategy é avaliada. Ela complementa o passo a passo Criando estratégias - recorra a ela quando precisar dos detalhes completos de uma opção específica. Uma regra combina gatilhos (o quando) com ações (o então), e você pode combinar até cinco gatilhos sob uma única opção AND / OR: com AND, todos os gatilhos precisam corresponder; com OR, basta um. As seções abaixo seguem essa estrutura - primeiro Gatilhos e Ações, depois os controles no nível da Strategy que se aplicam a todas as regras: ordenação das regras, Filtros globais e o Catch all.

​
Gatilhos

Os gatilhos determinam quando uma regra dispara. Tipos de gatilho disponíveis:

​
Gatilhos de produto

Segmentam com base nos produtos no contexto (o carrinho do comprador, o pedido recém-concluído ou o produto sendo visualizado):
  • Specific product(s) - corresponde a produtos específicos da Shopify por ID
  • Collection - corresponde a produtos que pertencem a coleções específicas
  • Tag(s) - corresponde a produtos com tags específicas (por exemplo, “sale”, “summer”)
  • Title - corresponde ao título do produto
  • Vendor - corresponde ao nome do fornecedor/marca
  • Type - corresponde ao campo de tipo de produto (por exemplo, “Apparel”, “Electronics”)
  • Handle - corresponde ao slug da URL do produto
  • Metafield - corresponde a pares de namespace/chave/valor de metafields personalizados
  • Selling plan - corresponde a produtos de “subscription” ou “one-time”. Só é avaliado quando o contexto da requisição fornece um selling plan para o produto - as superfícies de upsell de checkout e de pós-compra da Aftersell não enviam isso, então o gatilho não corresponderá nelas, a menos que uma integração personalizada o forneça explicitamente

​
Gatilhos de cliente

Segmentam com base em quem é o comprador:
  • Customer tag - por exemplo, “VIP”, “loyalty-gold”
  • Country code - país de cobrança
  • Province code - província/estado de cobrança
  • Locale - locale do cliente (por exemplo, “en-US”)
  • Accepts marketing - status de consentimento de marketing
  • Order count - número de pedidos anteriores
  • Total spent - gasto total ao longo do tempo

​
Gatilhos de carrinho

Segmentam com base no estado geral do carrinho:
  • Cart subtotal - por exemplo, subtotal maior que $50
  • Item count - quantidade total de itens no carrinho
  • Line count - número de itens de linha distintos
  • Cart attribute - atributos de carrinho personalizados definidos pela API de carrinho da Shopify
  • Cart note - o campo de observação do carrinho

​
Gatilhos de localização

Segmentam com base no destino de envio do comprador e na moeda da loja:
  • Shipping country - país de destino do envio
  • Shipping province - província/estado de destino do envio
  • Shipping method - método de envio selecionado
  • Store currency - o código da moeda ativa da loja

​
Gatilhos de marketing

Segmentam com base na URL da página em que o comprador chegou:
  • URL - corresponde a uma parte da URL de entrada, para que você possa segmentar uma campanha ou canal específico correspondendo a um parâmetro incorporado na URL (por exemplo, utm_source=newsletter)

​
Gatilhos de tempo

Segmentam com base em quando a requisição é avaliada, no horário da loja:
  • Day of week - o dia atual
  • Hour of day - a hora atual

​
Gatilhos dinâmicos

  • Always match - um gatilho sem condição que sempre dispara. Use-o para fazer uma regra ser executada em toda requisição (isso é diferente do Catch all no nível da Strategy, que só dispara quando nenhuma outra regra corresponde).
Nem todo gatilho é preenchido em todas as superfícies. O checkout, por exemplo, envia apenas o contexto de produto e de carrinho - gatilhos de cliente, localização e marketing não corresponderão ali. Veja os guias Implementando Strategies para saber o que cada superfície envia.

​
Operadores

Cada gatilho usa um operador para definir como o valor é comparado. Os operadores disponíveis dependem do tipo de gatilho. Nem todo operador está disponível para todos os gatilhos:
  • Operadores de lista (Contains any / all e suas negações) se aplicam a campos de vários valores, como tags, coleções, tags de cliente e produtos específicos.
  • Operadores de texto (Equals, Contains e suas negações) se aplicam a campos de texto de valor único, como título, fornecedor, handle, locale, país e URL.
  • Operadores numéricos se aplicam a campos como subtotal do carrinho, contagem de itens, contagem de linhas, contagem de pedidos, gasto total e hora do dia. Os operadores numéricos não têm variantes “does not”.
  • Alguns campos suportam apenas Equals e Does not equal - selling plan, dia da semana e consentimento de marketing.

​
Ações

As ações criam a experiência que você quer entregar ao cliente. É aqui que você decide quais produtos exibir, como exibi-los e quaisquer dados adicionais a enviar junto com eles. Uma regra pode ter várias ações configuradas em conjunto para montar a experiência completa. Em cada regra, todas as ações configuradas contribuem para um único conjunto combinado. Por exemplo, uma regra com uma ação de produto específico, uma ação de coleção e uma ação baseada em tags retornará produtos das três fontes juntas. Se um produto corresponder a várias fontes, ele é deduplicado.

​
Ações de produto

Os mesmos atributos de produto disponíveis no lado dos gatilhos também estão disponíveis ao definir ações. Você pode retornar produtos com base em:
  • Produtos específicos - escolha manualmente produtos individuais do seu catálogo da Shopify.
  • Coleção - retorna todos os produtos que pertencem a uma coleção específica.
  • Atributos de produto - retorna produtos que correspondem a critérios como tags, fornecedor, tipo de produto ou metafields - os mesmos tipos de atributo usados nos gatilhos.

​
Ações dinâmicas

As ações dinâmicas mudam o que é retornado com base em sinais em tempo real, em vez de uma lista fixa de produtos. Os tipos de ação dinâmica disponíveis incluem:
  • Most popular - os produtos com melhor desempenho da sua loja por volume de vendas, em toda a loja ou limitados a uma coleção.
  • Recently purchased - produtos comprados recentemente em toda a loja.
  • Inherit from when - reutiliza os próprios gatilhos da regra (o “quando”) como seletor de produtos, para que os produtos retornados correspondam aos mesmos critérios com os quais a regra disparou.
  • AI Recommendations - sugestões personalizadas geradas pelo modelo de recomendação da Aftersell.

​
Ações de filtragem

Depois que o conjunto de produtos é montado, você pode configurar quantos produtos são retornados e em que ordem:
  • Sort - controla quais produtos são selecionados:
    • Random - uma seleção aleatória.
    • Price: high → low - os produtos mais caros são retornados primeiro.
    • Price: low → high - os produtos mais baratos são retornados primeiro.
  • Amount/Limit - define o número máximo de produtos a retornar.
  • Type - restringe o conjunto de produtos montado a um único tipo de produto da Shopify. Escolha Equals para uma correspondência exata ou Contains para uma correspondência parcial (ambas não diferenciam maiúsculas de minúsculas). Apenas os produtos cujo tipo corresponde ao valor inserido são mantidos; os demais são removidos antes de o Amount/Limit ser aplicado.
O filtro Type reduz o conjunto de produtos montado pelas suas ações de produto - ele é diferente da ação de produto Product type, que retorna produtos de um determinado tipo. Use o filtro quando quiser restringir o que uma ação mais ampla (como uma ação de coleção ou dinâmica) pode retornar.
O Sort é aplicado primeiro, depois o Amount/Limit. Por exemplo, se a sua ordenação estiver definida como Random, todo o conjunto de produtos é embaralhado antes de o limite ser aplicado - assim, você sempre obtém uma fatia aleatória, e não os mesmos produtos em ordem aleatória.

​
Ações de chave-valor

Opcionalmente, anexe pares de chave-valor a uma regra. Quando a regra corresponde, eles são retornados em meta.data na resposta da API junto com os resultados de produtos. Usos comuns incluem:
  • Texto de banner promocional
  • Rótulos de campanha para análises
Se várias regras corresponderem e emitirem a mesma chave, prevalece o valor da primeira regra correspondente - regras posteriores não podem substituí-lo.

​
Prioridade das regras e ordem de avaliação

As regras dentro de uma Strategy são avaliadas em ordem, uma etapa por vez. A etapa 1 é avaliada primeiro, e assim por diante. Você pode reordenar as regras arrastando e soltando no editor de Strategies. O motor de avaliação:
  1. Avalia os gatilhos de cada regra em relação ao contexto fornecido.
  2. Coleta os produtos de todas as regras correspondentes.
  3. Deduplica e limita o resultado ao máximo configurado (padrão: 20 produtos).

​
Filtros globais

Os filtros globais removem produtos da elegibilidade de seleção em todas as regras de uma Strategy. Você pode acessá-los pelo ícone de filtro ao lado do nome da Strategy, no canto superior esquerdo do editor de Strategies. Filtros globais disponíveis:
  • Exclude out of stock - exclui automaticamente qualquer produto que esteja indisponível para compra no momento.
  • Exclude input products - exclui o(s) produto(s) que acionaram a regra (por exemplo, o produto que o comprador está visualizando em uma PDP), para que você nunca recomende o mesmo produto que o comprador já está vendo.
  • Exclude by product tag - exclui produtos com tags específicas.
  • Exclude by metafield - exclui produtos que correspondam a um namespace/chave/valor de metafield específico.
  • Exclude by product ID - exclui produtos específicos por ID.
  • Require stock at location - mantém apenas produtos com estoque disponível em uma localização escolhida (requer permissões de leitura de estoque e de localização).

​
Catch all

O Catch all é uma regra especial que atua como a etapa final de toda avaliação de Strategy. Ele não tem gatilho; dispara automaticamente se nenhuma outra regra da Strategy corresponder à requisição atual. Quando ativado, o Catch all garante que o seu espaço de recomendação nunca fique vazio. Sua ação pode ser configurada usando qualquer um dos mesmos tipos de ação disponíveis para regras comuns - produtos específicos, coleções, ações dinâmicas etc.
  • Ativar/desativar - liga ou desliga a regra Catch all para a Strategy. Quando desativada, requisições que não correspondem a nenhuma regra retornam vazio.
  • Configurar ações - define o que retornar usando qualquer combinação dos tipos de ação disponíveis, como em qualquer outra regra.
Quando o Catch all dispara, a resposta da API indicará resolution.fallbackUsed: true.