Filtros para segmentos de clientes baseados na Shopify

Criamos este guia de referência para ajudar você a entender melhor os recursos usados para criar segmentos de clientes por filtros-padrão da Shopify, como nomes de filtro, operadores e valores.

Nesta página

Data do checkout abandonado

Data do checkout abandonado

Nome: abandoned_checkout_date

Inclui clientes pela data em que eles abandonaram o carrinho pela última vez.

Operadores	Exatamente na data: `=` Não ocorreu na data: `!=` Na data ou antes dela: `<=` Antes da data: `<` Na data ou depois dela: `>=` Depois da data: `>` Entre as datas: `BETWEEN {date1} AND {date2}` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores
Formato	Data absoluta: `YYYY-MM-DD` Exemplos de ajuste de data: `-4w`, `-10y` Data nomeada: Hoje: `= today` Ontem: `= yesterday` Nos últimos 7 dias: `>= 7_days_ago` Nos últimos 30 dias: `>= 30_days_ago` Nos últimos 90 dias: `>= 90_days_ago` Nos últimos 12 meses: `>= 12_months_ago` As datas denominadas são valores-padrão e não podem ser alteradas. Para datas personalizadas, use o ajuste de data.
Exemplo	Inclua clientes que abandonaram o carrinho pela última vez na última semana: `abandoned_checkout_date >= 7_days_ago` Inclua clientes que abandonaram o carrinho pela última vez nos oito meses anteriores: `abandoned_checkout_date > -8m`
Observações	Valores de data representam dias inteiros e dependem do fuso horário da loja.

## Aniversário

Nome: anniversary

Inclui clientes pela data do evento associado ao parâmetro de data.

Parâmetros de função	Especifique o evento que você quer filtrar. Por exemplo: `'metafields.facts.birth_date'`
Operadores	`MATCHES`: o parâmetro é verdadeiro. `NOT_MATCHES`: o parâmetro é falso. `IS NULL`: o parâmetro não existe. `IS NOT NULL`: o parâmetro existe. Para datas, os operadores disponíveis incluem: É igual a: `=` Não é igual a: `!=` Maior que: `>` Menor que: `<` Menor ou igual a: `<=` Maior ou igual a: `>=` Entre: `BETWEEN`
Valores	`date`
Formato	Data absoluta: `YYYY-MM-DD` Exemplos de ajuste de data: `+4w`, `+3m` Datas ou intervalos nomeados: Hoje: `= today` Nos próximos 7 dias: `BETWEEN today AND +7d` Nos próximos 30 dias: `BETWEEN today AND +30d`
Exemplo	Incluir clientes com aniversário nos próximos 30 dias: `anniversary MATCHES ('metafields.facts.birth_date') BETWEEN today AND +30d`
Observações	O filtro `anniversary` não considera o ano. Valores de data representam dias inteiros e dependem do fuso horário da loja. Para filtrar em datas de nascimento, você precisa ativar o metacampo-padrão `facts.birth_date` ou criar um metacampo personalizado. Saiba mais sobre como adicionar metacampos-padrão ou como criar definições de metacampos personalizados.

## Valor gasto

Nome: amount_spent

Inclui clientes por quantidade de dinheiro gasto na loja.

Operadores	É igual a: `=` Não é igual a: `!=` Maior que: `>` Menor que: `<` Menor ou igual a: `<=` Maior ou igual a: `>=` Entre: `BETWEEN`
Valores
Formato	Intervalo de números: `# AND #` Número: `#` Número decimal: o separador decimal é o ponto (.). Já separadores de milhares, vírgulas e espaços não são aceitos, assim como números formatados de acordo com o idioma.
Exemplo	Inclua clientes que gastaram de 1 a 999,99 na loja: `amount_spent BETWEEN 1 AND 999.99`
Observações	A moeda usada é a que você definiu para a loja, portanto não é preciso especificá-la com a inclusão de um símbolo. `BETWEEN` inclui os valores iniciais e finais. Por exemplo, `amount_spent BETWEEN 1 AND 100` contém clientes que gastaram pelo menos 1 e no máximo 100.

## Cidades

Nome: customer_cities

Inclui clientes com endereço na cidade especificada. Vale destacar que clientes com vários endereços podem ser incluídos em mais de um segmento que usa este filtro.

Operadores	Contém a cidade exata: `CONTAINS` Não contém a cidade exata: `NOT CONTAINS` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores
Formato	`countryCode-regionCode-cityCode`
Exemplo	Inclua clientes que tenham um endereço em Nova York: `customer_cities CONTAINS 'US-NY-NewYorkCity'`
Observações	Para localizar a cidade, basta digitar o nome e selecionar o valor correto na lista exibida.

## Empresas

Nome: companies

Inclui clientes de empresas configurados como clientes B2B.

Operadores	Contém o ID exato da empresa: `CONTAINS` Não contém o ID exato da empresa: `NOT CONTAINS` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores	ID da empresa
Formato
Exemplo	É um cliente B2B : `companies IS NOT NULL` Não é um cliente B2B : `companies IS NULL` Inclua clientes afiliados a uma empresa específica: `companies CONTAINS 3778915041302`
Observações	Quando você cria o segmento de clientes, é possível selecionar a empresa por nome na lista exibida. Outra alternativa é começar a digitar o título da empresa e selecionar a opção na lista. O ID da empresa, e não o nome, é inserido no código. Mas, quando você passa o mouse sobre ele, vê o nome da empresa.

## Países ou regiões

Nome: customer_countries

Inclui clientes com endereço no país ou na região especificada. Vale destacar que clientes com vários endereços podem ser incluídos em mais de um segmento que usa este filtro.

Operadores	Contém o local exato: `CONTAINS` Não contém o local exato: `NOT CONTAINS` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores	Use o código ISO de duas letras do país.
Formato
Exemplo	Inclua clientes que tenham um endereço nos Estados Unidos: `customer_countries CONTAINS 'US'`
Observações	Para localizar o país, basta digitar o nome e selecionar o valor correto na lista exibida.

## Criado pelo ID do app

Nome: created_by_app_id

Inclui clientes que foram criados pelo app especificado.

Operadores	É igual a: `=` Não é igual a: `!=`
Valores	O ID do app para segmentar.
Formato	ID do app
Exemplo	Inclua clientes que foram criados no admin da Shopify: `created_by_app_id = 1830279`
Observações	Quando você cria o segmento de clientes, é possível selecionar um app pelo nome na lista exibida. Outra alternativa é começar a digitar o nome do app e selecionar a opção na lista. O ID do app, não o nome, é inserido no código. Quando o cursor é passado sobre esse ID, o nome do app é exibido.

## Status da conta de cliente

Nome: customer_account_status

Inclui clientes que têm o status de conta de cliente especificado.

Operadores	É igual a: `=` Não é igual a: `!=`
Valores	Recusado: `'DECLINED'` o cliente recebeu um convite para criar uma conta, mas recusou. Desabilitado: `'DISABLED'` o cliente não criou uma conta, ou sua loja está usando as novas contas de cliente. Habilitado: `'ENABLED'` o cliente não criou uma conta. Convidado: `'INVITED'` o cliente recebeu um convite para criar uma conta, mas ainda não aceitou nem recusou.
Formato
Exemplo	Inclua clientes que receberam convite para criar uma conta, mas recusaram: `customer_account_status = 'DECLINED'`
Observações

## Data de inclusão do cliente

Nome: customer_added_date

Inclui clientes pela data em que foram adicionados à loja.

Operadores	Exatamente na data: `=` Não nesta data: `!=` Nesta data ou antes: `<=` Antes da data: `<` Nesta data ou depois: `>=` Após a data: `>` Entre as datas: `BETWEEN {date1} AND {date2}`
Valores
Formato	Data absoluta: `YYYY-MM-DD` Exemplos de ajuste de data: `-4w`, `-10y` Data nomeada: Hoje: `= today` Ontem: `= yesterday` Nos últimos 7 dias: `>= 7_days_ago` Nos últimos 30 dias: `>= 30_days_ago` Nos últimos 90 dias: `>= 90_days_ago` Nos últimos 12 meses: `>= 12_months_ago` As datas denominadas são valores-padrão e não podem ser alteradas. Para datas personalizadas, use o ajuste de data.
Exemplo	Inclua clientes que foram adicionados na última semana: `customer_added_date >= 7_days_ago` Inclua clientes que foram adicionados nos últimos oito meses: `customer_added_date > -8m` Inclua clientes que foram adicionados durante um intervalo de datas específico: `customer_added_date BETWEEN 2022-12-01 AND 2022-12-31`
Observações	Valores de data representam dias inteiros e dependem do fuso horário da loja.

## Domínio do e-mail de contato

Nome: customer_email_domain

Inclui clientes com endereço de e-mail do domínio especificado. Vale lembrar que o nome de domínio aparece no e-mail após o símbolo @, por exemplo: gmail.com.

Operadores	É igual a: `=` Não é igual a: `!=` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores	O uso de nomes de domínio não está limitado às sugestões abaixo. Você pode inserir manualmente uma opção válida: Gmail: `'gmail.com'` Yahoo: `'yahoo.com'` ou `'yahoo.ca'` Hotmail: `'hotmail.com'` AOL: `'aol.com'` MSN: `'msn.com'` Live: `'live.com'` Outlook: `'outlook.com'`
Formato
Exemplo	Inclua clientes com domínio de e-mail shopify.com: `customer_email_domain = 'shopify.com'`
Observações

## Idioma do cliente

Nome: customer_language

Inclui clientes por idioma usado para se comunicar com a loja.

Operadores	É igual a: `=` Não é igual a: `!=` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores	Use o código de idioma de duas letras ISO 639-1.
Formato	Os valores a seguir são exemplos de alguns códigos ISO comuns de idioma. Os dados não estão limitados a esses códigos. É possível inserir manualmente outros códigos válidos, mas os valores sugeridos no editor são os únicos disponíveis nos dados do cliente. Inglês: `'en'` Francês: `'fr'` Espanhol: `'es'` Alemão: `'de'` Italiano: `'it'` Japonês: `'ja'` Russo: `'ru'`
Exemplo	Inclua clientes que se comunicam com sua loja em inglês: `customer_language = 'en'` Exclua clientes que se comunicam com sua loja em inglês canadense: `customer_language != 'en-CA'`
Observações	Você pode adicionar o código da localidade ISO ao valor e, dessa forma, especificar um dialeto para o idioma. Por exemplo, use `'en-US'` para Estados Unidos e `'en-GB'` para Reino Unido ou `'pt-PT'` para Portugal e `'pt-BR'` para Brasil. O valor do filtro funciona como um curinga quando apenas o prefixo do idioma é especificado. Por exemplo, se o valor do filtro for `'en'`, os resultados incluirão clientes cujo idioma está definido como `'en'`, como `'en-GB'`, `'en-CA'` e assim por diante.

## Tags do cliente

Nome: customer_tags

Inclui clientes com base nas tags.

Operadores	Contém a tag exata: `CONTAINS` Não contém a tag exata: `NOT CONTAINS` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores	O nome de uma tag de cliente.
Formato
Exemplo	Inclua clientes que têm a tag GoldStatus: `customer_tags CONTAINS 'GoldStatus'`
Observações	As tags não diferenciam maiúsculas de minúsculas. Saiba mais sobre tags e considerações relacionadas.

## Cliente em uma determinada distância

Nome: customer_within_distance

Inclui clientes que estão a uma distância específica do local salvo.

Parâmetros de função	Use apenas um parâmetro de distância para cada filtro. `coordinates` (obrigatório): para especificar a localização que você quer usar para criar o segmento. `distance_km` (obrigatório): para especificar o raio de distância em que você quer pesquisar clientes. `distance_mi` (obrigatório): para especificar o raio de distância em que você quer pesquisar clientes.
Operadores	`MATCHES`: o parâmetro é verdadeiro. `NOT_MATCHES`: o parâmetro é falso. `IS NULL`: o parâmetro não existe. `IS NOT NULL`: o parâmetro existe.
Valor
Formato	Formato aceito para `coordinates`: Número (latitude), número (longitude) Formatos aceitos para coordenadas (latitude, longitude): Número: `#` Formato aceito para `distance_mi` e `distance_km`: Número: `#`
Exemplo	Este filtro requer coordenadas e um parâmetro de distância para funcionar. Filtre clientes que tenham um endereço no raio de 10 milhas (16 km) das coordenadas (45.419190, -75.696727): `customer_within_distance MATCHES (coordinates = (45.419190, -75.696727), distance_mi = 10 )` O filtro pode ser usado com outros filtros para restringir ainda mais sua lista de clientes. Por exemplo: Filtre clientes que tenham endereço dentro de 20 quilômetros de coordenadas (43.634,-79.412) e fez pelo menos um pedido: `customer_within_distance MATCHES (coordinates = (43.634,-79.412), distance_km = 20 ) AND number_of_orders > 0`
Observações	O Shopify Segmentation converte automaticamente seus locais salvos em um par de coordenadas exibidas como valores selecionáveis ao usar esse filtro. Se sua loja tiver salvar localmente, Shopify Magic traduzirá automaticamente o par de coordenadas para o nome local. Por exemplo: "clientes que têm um endereço a 16 km da 'Loja de Salt Lake City' local".

## Eventos de e-mail

Nome: shopify_email.EVENT

Inclui clientes com base em eventos de e-mail selecionados. Entre os eventos aceitos (EVENT) estão:

Rejeitado: bounced
Clicado: clicked
Entregue: delivered
Marcado como spam: marked_as_spam
Aberto: opened
Cancelou inscrição: unsubscribed

Parâmetros de função	`activity_id` (opcional): use esse parâmetro para selecionar o ID da atividade de marketing que você quer filtrar. `count` (opcional): use esse parâmetro para especificar o número de vezes que um evento de e-mail ocorreu. `date` (optional): use esse parâmetro para especificar a data do evento.
Operadores	`MATCHES`: usado quando o evento aconteceu. `NOT_MATCHES`: usado quando o evento não aconteceu. `IS NULL`: o parâmetro não existe. `IS NOT NULL`: o parâmetro existe. Para datas, os operadores disponíveis incluem: É igual a: `=` Não é igual a: `!=` Maior que: `>` Menor que: `<` Menor ou igual a: `<=` Maior ou igual a: `>=` Entre: `BETWEEN`
Valor
Formato	Formatos aceitos para `activity_id`: `=` (valor único) `IN` : um conjunto de valores separados por vírgulas com "OR" implícito, entre parênteses. Por exemplo: `(activity_id IN 1, 2, 3)`. Há um limite de 500 IDs de atividade em um conjunto. Formatos de data suportados para `date`: Data absoluta: `YYYY-MM-DD` Exemplos de ajuste de data: 7 dias atrás: `-7d` 4 semanas atrás: `-4w` Há três meses: `-3m` 1 ano atrás: `-1y` Data nomeada: `today`, `yesterday` As datas nomeadas são valores-padrão e não podem ser alteradas. Para personalizá-las, use o ajuste de data. Eventos de e-mail estão disponíveis para os últimos 26 meses, com dados a partir de março de 2022. Formatos aceitos para `count`: Número: `#`
Exemplo	Especifique se um evento de e-mail aconteceu usando um operador `MATCHES` ou `NOT MATCHES`: `shopify_email.opened MATCHES (activity_id = 135195754518)` `shopify_email.opened NOT MATCHES (activity_id = 135195754518)` Use o parâmetro `activity_id` para especificar o ID da atividade de marketing que você quer filtrar: `shopify_email.delivered MATCHES (activity_id = 135195754518)` Use o parâmetro `date` e o operador `>=` para especificar a data de início de um evento de e-mail: `shopify_email.delivered NOT_MATCHES (activity_id = 135195754518, date >= 2022-01-01)` Use o parâmetro `date` e o operador `<=` para especificar a data de término de um evento de e-mail: `shopify_email.delivered MATCHES (activity_id = 135195754518, date <= 2022-01-01)` Use o parâmetro `date` e o operador `BETWEEN` para especificar as datas de início e término de um evento de e-mail: `shopify_email.bounced NOT_MATCHES (activity_id = 135195754518, BETWEEN -12m AND today)`
Observações	Ao criar um segmento de cliente usando o parâmetro `activity_id`, é possível selecionar a atividade de marketing pelo nome na lista exibida. Devido à retenção de dados, a ausência dos parâmetros `date` significa que os resultados serão filtrados para os últimos 26 meses, sem data definida de início ou de término. A ausência de `activity_id` significa que o filtro inclui todas as atividades de e-mail da Shopify.

## Status da assinatura por e-mail

Nome: email_subscription_status

Inclui clientes com base no status de assinatura de e-mail marketing.

Operadores	É igual a: `=` Não é igual a: `!=` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores	Não inscrito: `'NOT_SUBSCRIBED'` O cliente não se inscreveu no seu e-mail de marketing. Inscrito: `'SUBSCRIBED'` O cliente está inscrito no seu e-mail de marketing. pendente: `'PENDING'` O cliente está em processo de assinatura do seu e-mail marketing . Inválido: `'INVALID'` O estado de marketing do endereço de e-mail do cliente é inválido. Cancelado: `'UNSUBSCRIBED'` O cliente cancelou a assinatura do seu e-mail marketing . Remover informações: `'REDACTED'` O e-mail do cliente teve informações removidas.
Formato
Exemplo	Inclua clientes que se inscreveram no e-mail marketing: `email_subscription_status = 'SUBSCRIBED'`
Observações

## Data do primeiro pedido

Nome: first_order_date

Inclui clientes que realizaram o primeiro pedido na data especificada.

Operadores	Exatamente na data: `=` Não ocorreu na data: `!=` Na data ou antes dela: `<=` Antes da data: `<` Na data ou depois dela: `>=` Depois da data: `>` Entre as datas: `BETWEEN {date1} AND {date2}` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores
Formato	Data absoluta: `YYYY-MM-DD` Exemplos de ajuste de data: `-4w`, `-10y` Data nomeada: Hoje: `= today` Ontem: `= yesterday` Nos últimos 7 dias: `>= 7_days_ago` Nos últimos 30 dias: `>= 30_days_ago` Nos últimos 90 dias: `>= 90_days_ago` Nos últimos 12 meses: `>= 12_months_ago` As datas denominadas são valores-padrão e não podem ser alteradas. Para datas personalizadas, use o ajuste de data.
Exemplo	Inclui clientes que fizeram o primeiro pedido na última semana: `first_order_date >= 7_days_ago` Inclui clientes que fizeram o primeiro pedido há oito meses: `first_order_date > -8m`
Observações	Valores de data representam dias inteiros e dependem do fuso horário da loja.

## Data do último pedido

Nome: last_order_date

Inclui clientes que realizaram o último pedido na data especificada.

Operadores	Exatamente na data: `=` Não ocorreu na data: `!=` Na data ou antes dela: `<=` Antes da data: `<` Na data ou depois dela: `>=` Depois da data: `>` Entre as datas: `BETWEEN {date1} AND {date2}` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores
Formato	Data absoluta: `YYYY-MM-DD` Exemplos de ajuste de data: `-4w`, `-10y` Data nomeada: Hoje: `= today` Ontem: `= yesterday` Nos últimos 7 dias: `>= 7_days_ago` Nos últimos 30 dias: `>= 30_days_ago` Nos últimos 90 dias: `>= 90_days_ago` Nos últimos 12 meses: `>= 12_months_ago` As datas denominadas são valores-padrão e não podem ser alteradas. Para datas personalizadas, use o ajuste de data.
Exemplo	Inclui clientes que fizeram o último pedido na última semana: `last_order_date >= 7_days_ago` Inclui clientes que fizeram o último pedido há oito meses: `last_order_date > -8m`
Observações	Valores de data representam dias inteiros e dependem do fuso horário da loja.

## Quantidade de pedidos

Nome: number_of_orders

Inclui clientes pelo número de pedidos feitos na loja.

Operadores	É igual a: `=` Não é igual a: `!=` Maior que: `>` Menor que: `<` Menor ou igual a: `<=` Maior ou igual a: `>=` Entre: `BETWEEN`
Valores	O valor inserido precisa ser um número inteiro.
Formato	Intervalo de números: `# AND #` Número: `#`
Exemplo	Inclua clientes que já fizeram mais de dez pedidos: `number_of_orders > 10`
Observações	`BETWEEN` inclui os valores iniciais e finais. Por exemplo, `number_of_orders BETWEEN 1 AND 100` contém clientes que fizeram no mínimo um pedido e no máximo cem pedidos.

## Pedidos realizados

Nome: orders_placed

Inclui clientes que fizeram pedidos ou gastaram um determinado valor durante um período especificado.

Parâmetros de função	`app_id` (opcional): use esse parâmetro para especificar qual app criou o pedido. `location_id` (opcional): use esse parâmetro para especificar de qual local o pedido foi feito. `count` (opcional): use esse parâmetro para especificar o número exato de vezes que um pedido foi realizado. `amount` (opcional): use esse parâmetro para especificar o valor exato gasto em um pedido. `sum_amount` (opcional): use esse parâmetro para especificar o valor gasto em todos os pedidos. `date` (opcional): use esse parâmetro para especificar a data do evento.
Operadores	`MATCHES`: o parâmetro é verdadeiro. `NOT_MATCHES`: o parâmetro é falso. `IS NULL`: o parâmetro não existe. `IS NOT NULL`: o parâmetro existe. Para datas, os operadores disponíveis incluem: É igual a: `=` Não é igual a: `!=` Maior que: `>` Menor que: `<` Menor ou igual a: `<=` Maior ou igual a: `>=` Entre: `BETWEEN`
Valores
Formato	Formatos aceitos para `count`, `amount` e `sum_amount`: Número: `#` Formatos aceitos para `date`: Data absoluta: `YYYY-MM-DD` Exemplos de ajuste de data: Há sete dias: `-7d` Ha quatro semanas: `-4w` Há três meses: `-3m` Há um ano: `-1y` Data com nome: Hoje: `today` Ontem: `yesterday` As datas nomeadas são valores-padrão e não podem ser alteradas.
Exemplo	Especifique se um pedido foi feito usando um operador `MATCHES` ou `NOT_MATCHES` : `orders_placed MATCHES ()` `orders_placed NOT_MATCHES ()` Filtrar clientes que fizeram mais de 3 pedidos (inclusive) nos últimos 6 meses: `orders_placed MATCHES (count >= 3, date >= -6m)` Filtrar clientes que gastaram mais de US$ 1.000 (inclusive) nos últimos 90 dias: `orders_placed MATCHES (sum_amount >= 1000, date >= -90d)` Filtrar clientes que gastaram menos de US$ 100 (inclusive) nos últimos 7 dias: `orders_placed MATCHES (sum_amount <= 100, date >= -7d)` Filtrar clientes que gastaram mais de US$ 1.000 (inclusive) e fizeram mais de 3 pedidos (inclusive) desde 1º de janeiro de 2023: `orders_placed MATCHES (sum_amount >= 1000, count >= 3, date >= 2023-01-01)` Use o parâmetro `date` e o operador `BETWEEN` para especificar um intervalo de datas específico. Você pode se expressar entre 1º de janeiro de 2023 e 1º de junho de 2023 (inclusive) da seguinte maneira: `orders_placed MATCHES (count >= 3, BETWEEN 2023-01-01 AND 2023-06-01)`
Observações	Ao passar o cursor sobre o valor, a moeda usada para filtrar os clientes é exibida. Ao passar o cursor sobre a sintaxe `amount`, `sum_amount`, a descrição da sintaxe é exibida. A ausência de `parameters` significa que o filtro inclui todos os pedidos feitos em qualquer momento.

## Nível de gasto previsto

NOME: predicted_spend_tier

Inclui clientes que estão dentro do nível de gasto previsto especificado. Saiba mais sobre o nível de gasto previsto.

Operadores	É igual a: `=` Não é igual a: `!=` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores	`'HIGH'` `'MEDIUM'` `'LOW'`
Formato
Exemplo	Inclua clientes que estão no nível `ALTO`: `predicted_spend_tier = 'HIGH'`
Observações

## Status da assinatura de produto

Nome: product_subscription_status

Inclui clientes que têm o status de assinatura do produto especificado.

Operadores	É igual a: `=` Não é igual a: `!=` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores	Ativo (`'SUBSCRIBED'`): o cliente tem uma assinatura de produto ativa. Cancelado (`'CANCELLED'`): o cliente cancelou a assinatura do produto. Vencido (`'EXPIRED'`): a assinatura do produto do cliente venceu. Falha (`'FAILED'`): o cliente tem um pagamento com falha. Nunca assinou (`'NEVER_SUBSCRIBED'`): o cliente nunca fez a assinatura. Pausado (`'PAUSED'`): o cliente pausou a assinatura do produto.
Formato
Exemplo	Inclua clientes que tenham uma assinatura de produto ativa: `product_subscription_status = 'SUBSCRIBED'`
Observações

## Produtos comprados

Nome: products_purchased

Inclui clientes que compraram o produto especificado. Além disso, é possível incluir clientes que compraram o produto durante um período especificado.

Parâmetros de função	`id` (opcional): use este parâmetro para especificar e filtrar um determinado produto comprado por um cliente. `quantity` (opcional): use este parâmetro para especificar a quantidade de produtos comprados por pedido. `sum_quantity` (opcional): use este parâmetro para especificar a quantidade de produtos comprados em todos os pedidos. `date` (opcional): use esse parâmetro para especificar a data do evento. `tag` (opcional): tag (opcional): use para especificar e filtrar uma determinada tag nos produtos comprados.
Operadores	`MATCHES`: o parâmetro é verdadeiro. `NOT_MATCHES`: o parâmetro é falso. `IS NULL`: o parâmetro não existe. `IS NOT NULL`: o parâmetro existe. Para datas, os operadores disponíveis incluem: É igual a: `=` Não é igual a: `!=` Maior que: `>` Menor que: `<` Menor ou igual a: `<=` Maior ou igual a: `>=` Entre: `BETWEEN`
Valor
Formato	Formatos aceitos para `tag`: `string` (valor único) Formatos aceitos para `id`: `=` (valor único) `IN` : um conjunto de valores separados por vírgulas com "OR" implícito, entre parênteses. Por exemplo: `(id IN 1012132033639, 2012162031638, 32421429314657)`. Há um limite de 500 IDs de produtos em um conjunto. Formatos `date` aceitos: Data absoluta: `YYYY-MM-DD` Exemplos de ajuste de data: Há sete dias: `-7d` Ha quatro semanas: `-4w` Há três meses: `-3m` Há um ano: `-1y` Data nomeada: `today`, `yesterday` As datas nomeadas são valores-padrão e não podem ser alteradas. Formatos aceitos para `quantity` e `sum_quantity`: Número: `#`
Exemplo	Especifique se um produto foi comprado usando um operador `MATCHES` ou `NOT_MATCHES` : `products_purchased MATCHES (id = 2012162031638)` `products_purchased NOT_MATCHES (id IN 2012162031638, 1012132033639)` `products_purchased MATCHES (tag = 'red')` Filtrar cliente que comprou determinado produto desde 1º de janeiro de 2022 até hoje: `products_purchased MATCHES (id = 1012132033639, BETWEEN 2022-01-01 AND today)` Filtrar cliente que comprou um produto com a tag `'red'` desde 1º de janeiro de 2022 até hoje: `products_purchased MATCHES (tag = 'red', BETWEEN 2022-01-01 AND today)` Nos últimos 30 dias: `products_purchased MATCHES (date >= -30d)` Até 1º de janeiro de 2022: `products_purchased MATCHES (date <= 2022-01-01)` Use o parâmetro `date` e o operador `BETWEEN` para especificar um intervalo de datas específico. Você pode expressar entre 1º de janeiro de 2022 e 1º de junho de 2022 (inclusive) da seguinte maneira: `products_purchased MATCHES (id = 1012132033639, BETWEEN 2022-01-01 AND 2022-06-01)` Filtrar os clientes que compraram vários produtos recentemente com uma tag específica: `products_purchased MATCHES (tag = 'product_tag', sum_quantity >= 3, date >= -90d)`
Observações	Quando você usar o parâmetro `id` para criar o segmento de clientes, é possível selecionar o produto por nome ou imagem na lista exibida. Outra opção é começar a digitar o título do item e selecioná-lo na lista. O ID do produto, e não o título, é inserido no código. Por isso, quando você passa o mouse sobre ele, vê o ID, o título e a imagem do item. A ausência de ambos os parâmetros `date` significa que os resultados serão filtrados para sempre, sem data de início ou término definida. A ausência de parâmetros significa que o filtro inclui todos os produtos comprados em qualquer momento.

## Grupo RFM

Nome: rfm_group

Inclui clientes de acordo com o grupo da RFM em que estão categorizados. Saiba mais sobre a análise de clientes da RFM.

Lista de possíveis operadores e valores de grupos da RFM, incluindo exemplos.
Operadores	É igual a: `=` Não é igual a: `!=` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores	Inativos: `'DORMANT'` Em risco: `'AT_RISK'` Anteriormente fidelizados: `'PREVIOUSLY_LOYAL'` Precisam de atenção: `'NEEDS_ATTENTION'` Quase perdidos: `'ALMOST_LOST'` Fidelizados: `'LOYAL'` Promissores: `'PROMISING'` Ativos: `'ACTIVE'` Novos: `'NEW'` Campeões: `'CHAMPIONS'` Clientes em potencial: `'PROSPECTS'`
Formato
Exemplo	Incluir clientes no grupo da RFM Precisam de atenção: `rfm_group = 'NEEDS_ATTENTION'`
Observações

## Status da assinatura por SMS

Nome: sms_subscription_status

Inclui clientes com base no status de assinatura de marketing por SMS. Saiba mais sobre como coletar as informações de contato do cliente.

Operadores	É igual a: `=` Não é igual a: `!=` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores	Assinante: `'SUBSCRIBED'` O cliente assinou marketing por SMS. Pendente: `'PENDING'` O cliente está no processo de assinatura de marketing por SMS. Removido: `'REDACTED'` O cliente tem uma remoção de informações pendente devido a uma solicitação de apagamento do GDPR. Assinatura cancelada: `'UNSUBSCRIBED'` O cliente cancelou a assinatura do marketing por SMS. Não assinante: `'NOT_SUBSCRIBED'` O cliente nunca assinou marketing por SMS.
Formato
Exemplo	Inclua clientes que se inscreveram para receber marketing por SMS: `sms_subscription_status = 'SUBSCRIBED'`
Observações

## Estados ou províncias

Nome: customer_regions

Inclui clientes com endereço na região especificada dentro do país. Vale destacar que clientes com vários endereços podem ser incluídos em mais de um segmento que usa este filtro.

Operadores	Contém o local exato: `CONTAINS` Não contém o local exato: `NOT CONTAINS` Não existe: `IS NULL` Existe: `IS NOT NULL`
Valores	Use o código de país ISO com o código de subdivisão ISO 3166-2.
Formato
Exemplo	Inclui clientes com endereço no estado de Nova York: `customer_regions CONTAINS 'US-NY'`
Observações	Para localizar a região, basta digitar o nome e selecionar o valor correto na lista exibida.

## Contas de crédito na loja

Nome: store_credit_accounts

Inclui os clientes que têm saldo de crédito na sua loja.

Parâmetros de função	`balance` (opcional): use este parâmetro para especificar o saldo atual da conta de crédito na loja do cliente. `currency` (opcional): use este parâmetro para especificar a moeda do saldo de crédito na loja do cliente. `next_expiry_date` (opcional): use este parâmetro para especificar a data do crédito na loja não gasto com vencimento mais próximo. `last_credit_date` (opcional): use este parâmetro para especificar a data em que o cliente recebeu crédito na loja pela última vez.
Operadores	`MATCHES`: o parâmetro é verdadeiro. `NOT_MATCHES`: o parâmetro é falso. `IS NULL`: o parâmetro não existe. `IS NOT NULL`: o parâmetro existe. Para datas, os operadores disponíveis incluem: É igual a: `=` Não é igual a: `!=` Maior que: `>` Menor que: `<` Menor ou igual a: `<=` Maior ou igual a: `>=` Entre: `BETWEEN`
Valores
Formato	Formatos aceitos para `currency`: Código da moeda: por exemplo `USD` Formatos aceitos para `balance`: Número: `#` Formatos aceitos para `next_expiry_date` e `last_credit_date`: Datas absolutas: `YYY-MM-DD` Exemplos de ajuste de data: 7 dias atrás: `-7d` 4 semanas atrás: `-4w` 3 meses atrás: `-3m` 1 ano atrás: `-1y` Datas nomeadas: Hoje: `today` Ontem: `yesterday` As datas nomeadas são valores-padrão e não podem ser alteradas.
Exemplo	Filtrar cliente com saldo em conta crédito na loja maior ou igual a 1 em qualquer moeda: `store_credit_accounts MATCHES (balance >= 1)` Filtrar cliente com saldo em conta crédito na loja maior ou igual a $1 US$: `store_credit_accounts MATCHES (balance >= 1, currency: 'USD')` Filtrar cliente com crédito na loja com vencimento nos próximos 7 dias: `store_credit_accounts MATCHES (next_expiry_date <= +7d)` Filtrar clientes que receberam crédito na loja pela última vez há mais de 1 mês, mas ainda têm saldo disponível para gastar: `store_credit_accounts MATCHES (last_credit_date <= -1m, balance >= 1)`
Observações	Os clientes têm uma conta de crédito na loja, caso você já tenha emitido crédito para eles. O saldo nessa conta pode ser maior ou igual a 0. As contas de crédito na loja são específicas de uma moeda. Se você não incluir um parâmetro `currency` no segmento, o filtro retornará todas as contas de crédito na loja, independentemente do tipo de moeda. Um cliente pode ter de 0 a muitas contas de crédito na loja, dependendo de quantas moedas você aceita. Por exemplo, se você emitir crédito na loja para um cliente em dólar americano e canadense, ele terá duas contas de crédito na loja.

## Eventos de vitrine

Nome: storefront.EVENT

Inclui clientes com base em eventos de vitrine. Entre os eventos aceitos (EVENT) estão:

Produto visualizado: product_viewed
Coleção visualizada: collection_viewed

Parâmetros de função	`id` (opcional): use esse parâmetro para especificar os produtos ou as coleções em que você quer aplicar o filtro. `date` (optional): use esse parâmetro para especificar uma data do evento. `count` (opcional): use esse parâmetro para especificar o número exato de visualizações de um produto ou uma coleção. Parâmetros específicos do evento do produto: `tag` (opcional): use para especificar a tag de produto que você quer filtrar. Esse parâmetro tem o mesmo comportamento da filtragem por cada ID de produto com a tag.
Operadores	`MATCHES`: o parâmetro é verdadeiro. `NOT_MATCHES`: o parâmetro é falso. `IS NULL`: o parâmetro não existe. `IS NOT NULL`: o parâmetro existe. Para datas, os operadores disponíveis incluem: É igual a: `=` Não é igual a: `!=` Maior que: `>` Menor que: `<` Menor ou igual a: `<=` Maior ou igual a: `>=` Entre: `BETWEEN`
Valor
Formato	Formatos aceitos para `id`: `=` (valor único) `IN` : um conjunto de valores separados por vírgulas com "OR" implícito, entre parênteses. Por exemplo: `(id IN 1012132033639, 2012162031638, 32421429314657)`. Há um limite de 500 IDs de produtos ou coleções em um conjunto. Formatos aceitos para `tag`: `string` (valor único) Formatos `date` aceitos: Data absoluta: `YYYY-MM-DD` Exemplos de ajuste de data: Há sete dias: `-7d` Ha quatro semanas: `-4w` Há três meses: `-3m` Há um ano: `-1y` Data denominadas: Hoje: `today` Ontem: `yesterday` Estão disponíveis os eventos de vitrine dos últimos 26 meses, com datas a partir de maio de 2023. As datas denominadas são valores-padrão e não podem ser alteradas. Para datas personalizadas, use o ajuste de data.
Exemplo	Para especificar se um evento de vitrine aconteceu, use um operador `MATCHES` or `NOT_MATCHES`: `storefront.product_viewed MATCHES()` `storefront.collection_viewed NOT_MATCHES ()` Use o parâmetro `id` para especificar os produtos que você que filtrar `storefront.product_viewed MATCHES (id = 2012162031638)` `storefront.collection_viewed MATCHES (id IN 2012162031638, 456, 789)` Use o parâmetro `tag` para as tags de produto que você quer filtrar: `storefront.product_viewed MATCHES (tag = 'jeans')` Use o parâmetro `date` e o operador `>=`para especificar uma data de início para um evento de vitrine: `storefront.product_viewed MATCHES (id = 2012162031638, date >= 2023-04-03)` `storefront.collection_viewed MATCHES (id = 2012162031638, date >= -30d)` Use o parâmetro `date` e o operador `<=` para especificar uma data final para um evento de vitrine: `storefront.product_viewed MATCHES (id = 2012162031638, date <= 2023-04-30)` `storefront.collection_viewed MATCHES (id = 2012162031638, date <= -7d)` Use o parâmetro `date` e o operador `BETWEEN` para especificar as datas de início e de término de um evento de vitrine: `storefront.product_viewed MATCHES (id = 2012162031638, BETWEEN 2023-04-03 AND 2023-04-30)` `storefront.collection_viewed MATCHES (id = 2012162031638, BETWEEN -90d AND -30d)` Filtrar clientes que visualizaram um produto específico nos últimos 30 dias: `storefront.product_viewed MATCHES (id = 2012162031638, date >= -30d)` Filtrar clientes que visualizaram uma coleção específica desde 1º de janeiro de 2023 até hoje: `storefront.collection_viewed MATCHES (id = 2012162031638, BETWEEN 2023-01-01 AND today)`
Observações	Quando você usa o parâmetro `id` para criar o segmento de clientes, é possível selecionar na lista exibida o produto ou a coleção por nome ou imagem. Outra opção é começar a digitar o título do item e selecioná-lo na lista. No código é inserido o ID do produto ou da coleção, e não o título. Quando você passa o cursor sobre o ID, o título e a imagem do produto ou da coleção são exibidos. As coleções usam a imagem salva como miniatura da coleção, se aplicável. Caso contrário, é mostrado um marcador de posição. Devido à retenção de dados, a ausência dos parâmetros `date` significa que os resultados serão filtrados para os últimos 26 meses, sem data definida de início ou de término. A ausência de `id` significa que o filtro inclui todos os produtos.