Ajuda
Fazer login

Filtros de segmento de clientes baseados na Shopify

Use este guia de referência para entender os nomes de filtro, operadores e valores usados para criar segmentos de clientes baseados nos filtros-padrão da Shopify.

Nesta página

Data do checkout abandonado

Nome: abandoned_checkout_date

Inclui clientes com base na data em que abandonaram o carrinho pela última vez.

Operadores É a data: =
Não é a data: !=
É na data ou antes: <=
É antes da data: <
É na data ou depois: >=
É 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 deslocamento de data: -4w, -10y
Data nomeada:
  • Hoje: = today
  • Ontem: = yesterday
As datas nomeadas são valores-padrão e não podem ser alteradas. Para datas personalizadas, use um deslocamento de data.

Exemplo Inclua clientes que abandonaram o carrinho pela última vez na semana passada:
abandoned_checkout_date >= -7d

Incluir clientes que abandonaram o carrinho pela última vez nos últimos oito meses:
abandoned_checkout_date > -8m



ObservaçõesOs valores de data se baseiam em 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 da função Especifique o evento a ser usado como filtro. Por exemplo: 'metafields.facts.birth_date'
Operadores IS NULL: o parâmetro não existe.
IS NOT NULL: o parâmetro existe.

Para datas, os operadores disponíveis são:
É igual a: =
Não é igual a: !=
Entre: BETWEEN





Valores date
Formato Data absoluta: YYYY-MM-DD
Exemplos de deslocamento 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 que fazem aniversário nos próximos 30 dias:
anniversary ('metafields.facts.birth_date') BETWEEN today AND +30d
Observações

Valor gasto

Nome: amount_spent

Inclui clientes com base em quanto dinheiro gastaram 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 ponto (.) é usado como separador decimal.
Separadores de milhar, como vírgulas ou espaços, não são aceitos.
Números formatados específicos do idioma não são aceitos.



Exemplo Incluir clientes que gastaram de 1 a 999.99 na loja:
amount_spent BETWEEN 1 AND 999.99
Observações
  • A moeda usada se baseia na moeda selecionada para a loja. Não especifique a moeda com um símbolo.
  • BETWEEN inclui os valores inicial e final. Por exemplo, amount_spent BETWEEN 1 AND 100 inclui clientes que gastaram no mínimo 1 e no máximo 100.

Cidades

Nome: customer_cities

Inclui clientes com endereço na cidade especificada. Clientes com vários endereços podem ser incluídos em mais de um segmento de clientes que usa esse 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 Incluir clientes com endereço em Nova York:
customer_cities CONTAINS 'US-NY-NewYorkCity'
Observações Para encontrar uma cidade, comece a digitar o nome e selecione o valor correspondente na lista exibida.

Empresas

Nome: companies

Inclui clientes de empresas que foram configuradas 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


ValoresID da empresa
Formato
Exemplo É cliente B2B:
companies IS NOT NULL
Não é cliente B2B:
companies IS NULL
Inclui clientes afiliados a uma empresa específica:
companies CONTAINS 3778915041302






Observações
  • Ao criar o segmento de clientes, é possível selecionar a empresa pelo nome na lista exibida. Outra opção é começar a digitar o nome da empresa e selecioná-la na lista.
  • O ID da empresa, e não o nome, é inserido no código. Ao passar o cursor sobre o ID da empresa, o nome da empresa é exibido.

Países ou regiões

Nome: customer_countries

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

Operadores Contém esta localização exata: CONTAINS
Não contém esta localização exata: NOT CONTAINS
Não existe: IS NULL
Existe: IS NOT NULL


Valores Use o código de país de duas letras do padrão ISO.
Formato
Exemplo Inclua clientes com endereço nos Estados Unidos:
customer_countries CONTAINS 'US'
Observações Para encontrar um país, comece a digitar o nome dele e selecione o valor apropriado na lista exibida.

Criado por ID do app

Nome: created_by_app_id

Inclui clientes que foram criados pelo app especificado.

Operadores É igual a: =
Não é igual a: !=
ValoresO ID do app para a segmentação.
FormatoID do app
Exemplo Inclua clientes que foram criados no admin da Shopify:
created_by_app_id = 1830279
Observações
  • Ao criar o segmento de clientes, é possível selecionar um app pelo nome na lista exibida. Outra opção é começar a digitar o nome do app e selecioná-lo na lista.
  • O ID do app, e não o nome, é inserido no código. Ao passar o cursor sobre o ID do app, o nome do app é exibido.

Status da conta de cliente

Nome: customer_account_status

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

Operadores É igual a: =
Não é igual a: !=
Valores Recusado: 'DECLINED' O cliente foi convidado a criar uma conta, mas recusou.
Desativado: 'DISABLED' O cliente não criou uma conta, ou a loja está usando as novas contas de cliente.
Ativado: 'ENABLED' O cliente criou uma conta.
Convidado: 'INVITED' O cliente foi convidado a criar uma conta, mas ainda não aceitou nem recusou.


Formato
Exemplo Inclua clientes que foram convidados a criar uma conta, mas recusaram:
customer_account_status = 'DECLINED'
Observações

Data de adição do cliente

Nome: customer_added_date

Inclui clientes com base na data em que foram adicionados à loja.

Operadores É a data: =
Não é a data: !=
É na data ou antes: <=
É antes da data: <
É na data ou depois: >=
É depois da data: >
É entre as datas: BETWEEN {date1} AND {date2}





Valores
Formato Data absoluta: YYYY-MM-DD
Exemplos de deslocamento de data: -4w, -10y
Data nomeada:
  • Hoje: = today
  • Ontem: = yesterday
As datas nomeadas são valores-padrão e não podem ser alteradas. Para datas personalizadas, use um deslocamento de data.

Exemplo Inclua clientes que foram adicionados na última semana:
customer_added_date >= -7d

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 Os valores de data se baseiam em dias inteiros e dependem do fuso horário da loja.

Domínio do e-mail do cliente

Nome: customer_email_domain

Inclui clientes cujo endereço de e-mail pertence ao domínio especificado. O nome de domínio é a parte do endereço de 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 Os nomes de domínio a seguir são oferecidos como sugestões. Você não precisa se limitar a eles e pode inserir manualmente quaisquer outros nomes de domínio válidos:
  • 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 cujo domínio de e-mail é shopify.com:
customer_email_domain = 'shopify.com'
Observações

Idioma do cliente

Nome: customer_language

Inclui clientes com base no idioma que usam 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 do padrão ISO 639-1.
Formato Os valores a seguir são exemplos de alguns códigos de idioma ISO comuns. Os dados não se limitam a esses códigos, e é possível inserir manualmente quaisquer outros códigos de idioma válidos. No entanto, os valores oferecidos como sugestão 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 a loja em inglês:
customer_language = 'en'

Exclua clientes que se comunicam com a loja em inglês canadense:
customer_language != 'en-CA'



Observações
  • É possível adicionar o código ISO de localidade ao valor para especificar um dialeto para esse idioma. Por exemplo, você pode usar 'en-US' para os Estados Unidos e 'en-GB' para o Reino Unido, ou 'pt-PT' para Portugal e 'pt-BR' para o Brasil.
  • O valor do filtro funciona como um curinga se apenas o prefixo de idioma for especificado. Por exemplo, se o valor do filtro for 'en', os resultados incluirão clientes cujo idioma está definido como 'en' e clientes cujo idioma está definido como 'en-GB', 'en-CA', e assim por diante.

Tags de cliente

Nome: customer_tags

Inclui clientes com base nas tags.

Operadores Contém esta tag exata: CONTAINS
Não contém esta tag exata: NOT CONTAINS
Não existe: IS NULL
Existe: IS NOT NULL


ValoresO nome de uma tag de cliente.
Formato
Exemplo Incluir 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 as tags e suas considerações.

Cliente a uma certa distância

Nome: customer_within_distance

Inclui clientes que estão a uma distância especificada de um local salvo.

Parâmetros da função Use apenas um parâmetro de distância para cada filtro.
coordinates (obrigatório): use este parâmetro para especificar o local do marcador para criar o segmento.
distance_km (obrigatório): use este parâmetro para especificar o raio de distância para pesquisar clientes.
distance_mi (obrigatório): use este parâmetro para especificar o raio de distância para 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 compatível para coordinates:
  • Número (latitude), Número (longitude)

    • Formato compatível para coordenadas (latitude, longitude):
  • Número: #

    • Formato compatível para distance_mi, distance_km:
  • Número: #




    • Exemplo Este filtro requer coordenadas e um parâmetro de distância para ser válido.

    Filtrar clientes com endereço em um raio de 10 milhas das coordenadas (45.419190, -75.696727):
    customer_within_distance MATCHES (coordinates = (45.419190, -75.696727), distance_mi = 10 )

    O filtro pode ser usado em conjunto com outros filtros para restringir ainda mais a lista de clientes. Por exemplo:
    Filtrar clientes com endereço em um raio de 20 quilômetros das coordenadas (43.634,-79.412) e que fizeram pelo menos um pedido:
    customer_within_distance MATCHES (coordinates = (43.634,-79.412), distance_km = 20 ) AND number_of_orders > 0






    Observações
    • A Shopify Segmentation converte automaticamente os locais salvos em um par de coordenadas, exibindo-os como valores selecionáveis ao usar este filtro.
    • Se a loja tiver locais salvos, o Shopify Magic traduzirá automaticamente o par de coordenadas para o nome do local na tradução mágica. Por exemplo: “Clientes com endereço em um raio de 10 milhas do local 'Salt Lake City Store'”.

    Eventos de e-mail

    Nome: shopify_email.EVENT

    Inclui clientes com base em eventos de e-mail selecionados. Os eventos compatíveis (EVENT) incluem:

    • Devolução: bounced
    • Clique: clicked
    • Entrega: delivered
    • Marcação como spam: marked_as_spam
    • Abertura: opened
    • Cancelamento de inscrição: unsubscribed
    Parâmetros da função activity_id (opcional): use este parâmetro para selecionar o ID da atividade de marketing que quer filtrar.
    count (opcional): use este parâmetro para especificar o número de vezes que um evento de e-mail ocorreu.
    date (opcional): use este parâmetro para especificar a data do evento.



    Operadores MATCHES: usado quando o evento ocorreu.
    NOT_MATCHES: usado quando o evento não ocorreu.
    IS NULL: o parâmetro não existe.
    IS NOT NULL: o parâmetro existe.

    Para datas, os operadores disponíveis são:
    É igual a: =
    Não é igual a: !=
    Maior que: >
    Menor que: <
    Menor ou igual a: <=
    Maior ou igual a: >=
    Entre: BETWEEN











    Valor
    FormatoFormatos compatíveis para activity_id:
  • = (valor único)
  • IN : um conjunto de valores separados por vírgula com um “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 compatíveis para date:
  • Data absoluta: YYYY-MM-DD
  • Exemplos de data relativa:
    • há 7 dias: -7d
    • há 4 semanas: -4w
    • há 3 meses: -3m
    • há 1 ano: -1y
    • Data nomeada: today, yesterday


    • As datas nomeadas são valores-padrão e não podem ser alteradas. Para datas personalizadas, use uma data relativa.

    Os eventos de e-mail estão disponíveis para os últimos 26 meses, com dados a partir de março de 2022.

    Formatos compatíveis para count:
  • Número: #











    • Exemplo Especifique se um evento de e-mail ocorreu 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 uma data de início para 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 uma data de término para 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 de término de um evento de e-mail:
    shopify_email.bounced NOT MATCHES (activity_id = 135195754518, date BETWEEN -12m AND today)













    Observações
    • Ao criar um segmento de clientes com 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 de parâmetros de date significa que os resultados serão filtrados para os últimos 26 meses, sem uma data de início ou término definida.
    • A ausência de activity_id significa que o filtro inclui todas as atividades de e-mail da Shopify.

    Status da assinatura de e-mail

    Nome: email_subscription_status

    Inclui clientes com base no status da assinatura de e-mail de 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 para receber e-mails de marketing.
    Inscrito: 'SUBSCRIBED' O cliente está inscrito para receber e-mails de marketing.
    Pendente: 'PENDING' O cliente está no processo de inscrição para receber e-mails de marketing.
    Inválido: 'INVALID' O status de marketing do endereço de e-mail do cliente é inválido.
    Inscrição cancelada: 'UNSUBSCRIBED' O cliente cancelou a assinatura dos e-mails de marketing.
    Editado: 'REDACTED' O endereço de e-mail do cliente foi editado.




    Formato
    Exemplo Inclua clientes inscritos em e-mails de marketing:
    email_subscription_status = 'SUBSCRIBED'
    Observações

    Data do primeiro pedido

    Nome: first_order_date

    Inclui clientes que fizeram o primeiro pedido na data especificada.

    Operadores É a data: =
    Não é a data: !=
    É na data ou antes: <=
    É antes da data: <
    É na data ou depois: >=
    É 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 deslocamento de data: -4w, -10y
    Data nomeada:
    • Hoje: = today
    • Ontem: = yesterday
    As datas nomeadas são valores-padrão e não podem ser alteradas. Para datas personalizadas, use um deslocamento de data.

    Exemplo Inclua clientes que fizeram o primeiro pedido desde a semana passada:
    first_order_date >= -7d

    Inclua clientes que fizeram o primeiro pedido nos últimos oito meses:
    first_order_date > -8m



    Observações Os valores de data se baseiam em dias inteiros e dependem do fuso horário da loja.

    Data do último pedido

    Nome: last_order_date

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

    Operadores É a data: =
    Não é a data: !=
    É na data ou antes: <=
    É antes da data: <
    É na data ou depois: >=
    É 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 deslocamento de data: -4w, -10y
    Data nomeada:
    • Hoje: = today
    • Ontem: = yesterday
    As datas nomeadas são valores-padrão e não podem ser alteradas. Para datas personalizadas, use um deslocamento de data.

    Exemplo Inclua clientes que fizeram o último pedido desde a semana passada:
    last_order_date >= -7d

    Inclua clientes que fizeram o último pedido nos últimos oito meses:
    last_order_date > -8m



    Observações Os valores de data se baseiam em dias inteiros e dependem do fuso horário da loja.

    Número de pedidos

    Nome: number_of_orders

    Inclui clientes com base no 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





    ValoresO valor inserido deve ser um número inteiro.
    Formato Intervalo de números: # AND #
    Número: #
    Exemplo Inclua clientes que fizeram mais de 10 pedidos:
    number_of_orders > 10
    Observações BETWEEN inclui os valores inicial e final. Por exemplo, number_of_orders BETWEEN 1 AND 100 inclui clientes que fizeram no mínimo 1 pedido e no máximo 100 pedidos.

    Pedidos feitos

    Nome: orders_placed

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

    Parâmetros da função app_id (opcional): use este parâmetro para especificar qual app criou o pedido. Isso inclui apps como o Shopify POS, que tem um ID de app de 129785.
    location_id (opcional): use este parâmetro para especificar de qual local o pedido foi feito. O ID de um local pode ser encontrado no URL do admin da Shopify ao navegar até as informações do local em Locais.
    count (opcional): use este parâmetro para especificar o número exato de vezes que um pedido foi feito.
    amount (opcional): use este parâmetro para especificar o valor exato gasto em um pedido.
    sum_amount (opcional): use este parâmetro para especificar o valor gasto em todos os pedidos.
    date (opcional): use este parâmetro para especificar uma data para o 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 são:
    É igual a: =
    Não é igual a: !=
    Maior que: >
    Menor que: <
    Menor ou igual a: <=
    Maior ou igual a: >=
    Entre: BETWEEN











    Valores
    Formato Formatos compatíveis para count, amount, e sum_amount:
    Número: #

    Formatos compatíveis para date:
    Data absoluta: YYYY-MM-DD
    Exemplos de data relativa:
    • há 7 dias: -7d
    • há 4 semanas: -4w
    • há 3 meses: -3m
    • há 1 ano: -1y
    Data nomeada:
    • 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 MATCHES ou NOT_MATCHES operador:
    orders_placed MATCHES ()
    orders_placed NOT MATCHES ()

    Filtre clientes que fizeram 3 ou mais pedidos nos últimos 6 meses:
    orders_placed MATCHES (count >= 3, date >= -6m)

    Filtre clientes que gastaram US$ 1.000 ou mais nos últimos 90 dias:
    orders_placed MATCHES (sum_amount >= 1000, date >= -90d)

    Filtre clientes que gastaram US$ 100 ou menos nos últimos 7 dias:
    orders_placed MATCHES (sum_amount <= 100, date >= -7d)

    Filtre clientes que gastaram US$ 1.000 ou mais e fizeram 3 ou mais pedidos 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. É possível expressar o período entre 1º de janeiro de 2023 e 1º de junho de 2023 (inclusive) da seguinte forma:
    orders_placed MATCHES (count >= 3, date BETWEEN 2023-01-01 AND 2023-06-01)

    Filtre clientes que fizeram um pedido no local HQ Gift Shop (1122334455) ou no local Main Street (6677889900):
    orders_placed MATCHES (location_id IN (1122334455,6677889900))

    Filtre clientes que gastaram mais de US$ 500 no total no Shopify POS:
    orders_placed MATCHES (app_id = 129785, sum_amount >= 500)






















    Observações
    • Ao passar o cursor sobre o valor, a moeda usada para filtrar os clientes é exibida.
    • Ao passar o cursor sobre a seguinte 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 período.

    Nível de gasto previsto

    NOME: predicted_spend_tier

    Inclui clientes que estão no 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 Incluir clientes que estão no nível HIGH:
    predicted_spend_tier = 'HIGH'
    Observações

    Status da assinatura de produto

    Nome: product_subscription_status

    Inclui clientes com o status de assinatura de produto especificado.

    Operadores É igual a: =
    Não é igual a: !=
    Não existe: IS NULL
    Existe: IS NOT NULL


    Valores Ativa: 'SUBSCRIBED' O cliente tem uma assinatura de produto ativa.
    Cancelada: 'CANCELLED' O cliente cancelou a assinatura de produto.
    Expirada: 'EXPIRED' A assinatura de produto do cliente expirou.
    Com falha: 'FAILED' O cliente tem um pagamento com falha.
    Nunca se inscreveu: 'NEVER_SUBSCRIBED' O cliente nunca fez uma assinatura.
    Pausada: 'PAUSED' O cliente pausou a assinatura de produto.




    Formato
    Exemplo Incluir clientes que têm 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 intervalo de datas especificado.

    Parâmetros da função id (opcional): use este parâmetro para especificar o produto que um cliente comprou e que será usado no filtro.
    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 este parâmetro para especificar uma data para o evento.
    tag (opcional): use este parâmetro para especificar uma tag de produto para os produtos comprados que você quer filtrar.



    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 compatíveis para tag:
    string (valor único)

    Formatos compatíveis para id:
  • = (valor único)
  • IN : um conjunto de valores separados por vírgula com “OR” implícito, entre parênteses. Por exemplo: (id IN (1012132033639, 2012162031638, 32421429314657)). Há um limite de 500 IDs de produto em um conjunto.

    Formatos de data compatíveis:
    Data absoluta: YYYY-MM-DD
    Exemplos de deslocamento de data:
    • há 7 dias: -7d
    • há 4 semanas: -4w
    • há 3 meses: -3m
    • há 1 ano: -1y
    • Data nomeada: today, yesterday
    As datas nomeadas são valores-padrão e não podem ser alteradas.

    Formatos compatíveis para quantity e sum_quantity:
    Número: #










    • Exemplo Especifique se um produto foi comprado com o operador MATCHES ou NOT_MATCHES:
    products_purchased MATCHES (id = 2012162031638)
    products_purchased NOT MATCHES (id IN (2012162031638, 1012132033639)) products_purchased MATCHES (tag = 'red')

    Filtre os clientes que compraram um produto específico desde 1º de janeiro de 2022 até hoje:
    products_purchased MATCHES (id = 1012132033639, date BETWEEN 2022-01-01 AND today)

    Filtre os clientes que compraram um produto com a tag 'red' desde 1º de janeiro de 2022 até hoje:
    products_purchased MATCHES (tag = 'red', date 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. É possível expressar o período entre 1º de janeiro de 2022 e 1º de junho de 2022 (inclusive) da seguinte forma:
    products_purchased MATCHES (id = 1012132033639, date BETWEEN 2022-01-01 AND 2022-06-01)

    Filtrar clientes que compraram recentemente muitos produtos com uma tag específica:
    products_purchased MATCHES (tag = 'product_tag', sum_quantity >= 3, date >= -90d)



















    Observações
    • Ao criar o segmento de clientes com o parâmetro id, é possível selecionar o produto pelo nome ou pela imagem na lista exibida. Outra opção é começar a digitar o título do produto e selecioná-lo na lista.
    • O ID do produto, e não o título do produto, é inserido no código. Ao passar o cursor sobre o ID do produto, o título e a imagem do produto são exibidos.
    • A ausência de ambos os date parâmetros significa que os resultados serão filtrados para todo o período, sem data de início ou término definida.
    • A ausência de qualquer parâmetro significa que o filtro inclui todos os produtos comprados em qualquer período.

    Grupo de RFM

    Nome: rfm_group

    Inclui clientes com base no grupo de RFM em que estão classificados. Saiba mais sobre a análise de clientes RFM.

    Lista de possíveis operadores e valores de grupo de RFM, com 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 fiéis: 'PREVIOUSLY_LOYAL'
    Requerem atenção: 'NEEDS_ATTENTION'
    Quase perdidos: 'ALMOST_LOST'
    Fiéis: 'LOYAL'
    Promissores: 'PROMISING'
    Ativos: 'ACTIVE'
    Novos: 'NEW'
    Defensores: 'CHAMPIONS'
    Potenciais: 'PROSPECTS'









    Formato
    Exemplo Incluir clientes no grupo RFM Requerem atenção:
    rfm_group = 'NEEDS_ATTENTION'
    Observações

    Status da assinatura de SMS

    Nome: sms_subscription_status

    Inclui clientes com base no status de assinatura das mensagens de texto de marketing por SMS. Saiba mais sobre como coletar as informações de contato dos clientes.

    Operadores É igual a: =
    Não é igual a: !=
    Não existe: IS NULL
    Existe: IS NOT NULL


    Valores Inscrito: 'SUBSCRIBED' O cliente está inscrito para receber as mensagens de texto de marketing por SMS.
    Pendente: 'PENDING' O cliente está no processo de inscrição para receber as mensagens de texto de marketing por SMS.
    Removido: 'REDACTED' O cliente tem uma remoção pendente devido a uma solicitação de apagamento do GDPR.
    Inscrição cancelada: 'UNSUBSCRIBED' O cliente cancelou a inscrição para receber as mensagens de texto de marketing por SMS.
    Não inscrito: 'NOT_SUBSCRIBED' O cliente nunca se inscreveu para receber as mensagens de texto de marketing por SMS.



    Formato
    Exemplo Incluir clientes que se inscreveram para receber as mensagens de texto de 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 de um país. Clientes com vários endereços podem ser incluídos em mais de um segmento que usa esse filtro.

    Operadores Contém esta localização exata: CONTAINS
    Não contém esta localização exata: NOT CONTAINS
    Não existe: IS NULL
    Existe: IS NOT NULL


    ValoresUse o código de país ISO com o código de subdivisão ISO 3166-2.
    Formato
    Exemplo Incluir clientes com endereço no estado de Nova York:
    customer_regions CONTAINS 'US-NY'
    Observações Para encontrar uma região, comece a digitar o nome dela e selecione o valor apropriado na lista exibida.

    Contas de crédito na loja

    Nome: store_credit_accounts

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

    Parâmetros da 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 utilizado que expira mais cedo.
    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 são:
    É igual a: =
    Não é igual a: !=
    Maior que: >
    Menor que: <
    Menor ou igual a: <=
    Maior ou igual a: >=
    Entre: BETWEEN











    Valores
    Formato Formatos compatíveis para currency:
    Código da moeda: por exemplo, USD

    Formatos compatíveis para balance:
    Número: #

    Formatos compatíveis para next_expiry_date e last_credit_date:
    Datas absolutas: YYY-MM-DD
    Exemplos de variação de data:
    Há 7 dias: -7d
    Há 4 semanas: -4w
    Há 3 meses: -3m
    Há 1 ano: -1y
    Datas nomeadas:
  • Hoje: today
  • Ontem: yesterday
    • As datas nomeadas são valores padrão e não podem ser alteradas.












    Exemplo Filtrar clientes com saldo na conta de crédito da loja maior ou igual a 1 em qualquer moeda:
    store_credit_accounts MATCHES (balance >= 1)

    Filtrar clientes com saldo na conta de crédito da loja maior ou igual a US$ 1:
    store_credit_accounts MATCHES (balance >= 1, currency: 'USD')

    Filtrar clientes com crédito na loja que expira 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 da loja se você já emitiu crédito na loja para eles. O saldo de crédito na loja de um cliente pode ser maior ou igual a 0.
    • As contas de crédito na loja são específicas para uma moeda. Se você não incluir um parâmetro currency no segmento, o filtro retornará todas as contas de crédito da loja, independentemente do tipo de moeda.
    • Um cliente pode ter de 0 a várias 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 CAD e USD, ele terá 2 contas de crédito na loja.

    Eventos da vitrine virtual

    Nome: storefront.EVENT

    Inclui clientes com base em eventos da vitrine virtual. Os eventos compatíveis (EVENT) incluem o seguinte:

    • Produto visualizado: product_viewed
    • Coleção visualizada: collection_viewed
    Parâmetros da função id (opcional): use este parâmetro para especificar os produtos ou as coleções que você quer filtrar.
    date (opcional): use este parâmetro para especificar uma data para o evento.
    count (opcional): use este parâmetro para especificar o número exato de vezes que um produto ou uma coleção foi visualizado.

    Parâmetros específicos de eventos de produto:
    tag (opcional): use este parâmetro para especificar a tag de produto que você quer usar como filtro. O comportamento é o mesmo que filtrar por todos os IDs de produto com essa 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 compatíveis para id:
  • = (valor único)
  • IN : um conjunto de valores separados por vírgula com “OR” implícito, entre parênteses. Por exemplo: (id IN (1012132033639, 2012162031638, 32421429314657)). Há um limite de 500 IDs de produto ou de coleção em um conjunto.

    Formatos compatíveis para tag: string (valor único)

    Formatos de data formatos: Data absoluta: YYYY-MM-DD
    Exemplos de variação de data:
    • há 7 dias: -7d
    • há 4 semanas: -4w
    • Há 3 meses: -3m
    • há 1 ano: -1y
    Datas nomeadas:
    • Hoje: today
    • Ontem: yesterday
    Os eventos da vitrine virtual estão disponíveis para os últimos 26 meses, com dados a partir de maio de 2023.

    As datas nomeadas são valores-padrão e não podem ser alteradas. Para datas personalizadas, use um deslocamento de data.






    • Exemplo Especifique se um evento da vitrine virtual ocorreu usando um operador MATCHES ou NOT_MATCHES: storefront.product_viewed MATCHES()
    storefront.collection_viewed NOT MATCHES ()

    Use o parâmetro id para especificar os produtos a serem filtrados:
    storefront.product_viewed MATCHES (id = 2012162031638)
    storefront.collection_viewed MATCHES (id IN (2012162031638, 456, 789))

    Use o parâmetro tag para filtrar por tags de produto:
    storefront.product_viewed MATCHES (tag CONTAINS 'jeans')

    Use o parâmetro date e o operador >= para especificar uma data de início para um evento da vitrine virtual:
    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 de término para um evento da vitrine virtual:
    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 da vitrine virtual:
    storefront.product_viewed MATCHES (id = 2012162031638, date BETWEEN 2023-04-03 AND 2023-04-30)
    storefront.collection_viewed MATCHES (id = 2012162031638, date BETWEEN -90d AND -30d)

    Filtre os clientes que visualizaram um produto específico nos últimos 30 dias:
    storefront.product_viewed MATCHES (id = 2012162031638, date >= -30d)

    Filtre os clientes que visualizaram uma coleção específica de 1º de janeiro de 2023 até hoje:
    storefront.collection_viewed MATCHES (id = 2012162031638, date BETWEEN 2023-01-01 AND today)

























    Observações
    • Ao criar o segmento de clientes com o parâmetro id, é possível selecionar o produto ou a coleção pelo nome ou pela imagem na lista exibida. Outra opção é começar a digitar o título do produto ou da coleção e, em seguida, selecioná-lo na lista.
    • O ID do produto ou da coleção, e não o título, é inserido no código. Ao passar 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, quando aplicável. Caso contrário, um marcador de posição de imagem genérico é exibido.
    • Devido à retenção de dados, a ausência de parâmetros de date significa que os resultados serão filtrados para os últimos 26 meses, sem uma data de início ou término definida.
    • A ausência de id significa que o filtro inclui todos os produtos.