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
- Aniversário
- Valor gasto
- Cidades
- Empresas
- Países ou regiões
- Criado pelo ID do app
- Status da conta de cliente
- Data de inclusão do cliente
- Domínio do e-mail de contato
- Idioma do cliente
- Tags do cliente
- Eventos de e-mail
- Status da assinatura por e-mail
- Data do último pedido
- Quantidade de pedidos
- Pedidos realizados
- Nível de gasto previsto
- Status da assinatura de produto
- Produtos comprados
- Status da assinatura por SMS
- Estados ou províncias
- Eventos de vitrine
Data do checkout abandonado
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:
|
Exemplo |
Inclua clientes que abandonaram o carrinho pela última vez na semana passada: Inclua clientes que abandonaram o carrinho pela última vez nos oito meses anteriores: |
Observações | Valores de data representam dias inteiros e dependem do fuso horário da loja. |
Aniversário
anniversary()
Inclui clientes pela data do evento associado ao parâmetro de data.
Parâmetros de função |
date (obrigatório): use para especificar em qual evento você quer filtrar. |
---|---|
Operadores |
Exatamente na data: = Entre datas: BETWEEN <date1> AND <date2> |
Valores | |
Formato |
Data absoluta: YYYY-MM-DD Exemplos de ajuste de data: +4w , +3m Data nomeada:
|
Exemplo |
Incluir clientes com aniversário nos próximos 30 dias: |
Observações |
|
Valor gasto
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 |
|
Cidades
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
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 Inclui clientes afiliados a uma empresa específica: companies CONTAINS 3778915041302 |
Observações |
|
Países ou regiões
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
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 |
|
Status da conta de cliente
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.Habilitado: 'ENABLED' O cliente criou uma conta.Convite: 'INVITED' O cliente recebeu um convite para criar uma conta.
|
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
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:
|
Exemplo |
Inclua clientes adicionados na última semana: Inclua clientes adicionados nos últimos oito meses: Inclua clientes adicionados durante um período específico: |
Observações | Valores de data representam dias inteiros e dependem do fuso horário da loja. |
Domínio do e-mail de contato
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.com:'gmail.com' yahoo.com: 'yahoo.com' hotmail.com: 'hotmail.com' aol.com: 'aol.com' msn.com: 'msn.com' live.com: 'live.com' outlook.com: 'outlook.com' yahoo.ca: 'yahoo.ca'
|
Formato | |
Exemplo | Inclua clientes com domínio de e-mail shopify.com:customer_email_domain = 'shopify.com'
|
Observações |
Idioma do cliente
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 a loja em inglês: Exclua os clientes que se comunicam com a loja em inglês canadense: |
Observações |
|
Tags do cliente
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. |
Eventos de e-mail
shopify_email.EVENT()
Inclui clientes com base em eventos de e-mail selecionados. Entre os eventos (EVENT) aceitos 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_at_least (opcional): use esse parâmetro para especificar o número mínimo de vezes que um evento de e-mail ocorreu.count_at_most (opcional): use esse parâmetro para especificar o número máximo de vezes que um evento de e-mail ocorreu.count (opcional): use esse parâmetro para especificar o número exato de vezes que um evento de e-mail ocorreu.since (opcional): use esse parâmetro para especificar a data de início do evento.until (opcional): use esse parâmetro para especificar a data de término do evento. |
---|---|
Operadores |
É igual a: = Não é igual a: != |
Valor |
true , false
|
Formato | Formatos aceitos para activity_id :
ID (valor único)List <ID> : um conjunto de valores com "OR" implícito. Os valores de List são separados por vírgulas e aparecem entre parênteses, como (1, 2, 3) . Há um limite de 500 IDs de atividade em uma lista.Formatos de Date aceitos para since e until :Data absoluta: YYYY-MM-DD Exemplos de ajuste de data: Sete dias atrás: :-7d Quatro semanas atrás: :-4w Três meses atrás: :-3m Um ano atrás: :-1y Data com nome: :today , :yesterday As datas denominadas são valores-padrão e não podem ser alteradas. Para personalizá-las, use uma compensação 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_at_least , count_at_most , count : Número: # |
Exemplo | Especifique se um evento de e-mail aconteceu usando um operador = ou != :shopify_email.opened(activity_id: 135195754518) = false shopify_email.opened(activity_id: 135195754518) != true Use o parâmetro activity_id para especificar o ID da atividade de marketing que você quer filtrar:shopify_email.delivered(activity_id: 135195754518) = true Use o parâmetro since para especificar a data de início de um evento de e-mail:shopify_email.delivered(activity_id: 135195754518, since: 2022-01-01) = false Use o parâmetro until para especificar a data de término de um evento de e-mail:shopify_email.delivered(activity_id: 135195754518, until: 2022-01-01) = true Use os parâmetros since e until para especificar as datas de início e término de um evento de e-mail:shopify_email.bounced(activity_id: 135195754518, since: 12_months_ago, until: today) = false
|
Observações |
|
Status da assinatura por e-mail
email_subscription_status
Inclui clientes de acordo com o 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 assinante: 'NOT_SUBSCRIBED' O cliente não assinou o e-mail marketing.Assinante: 'SUBSCRIBED' O cliente assinou o e-mail marketing.Pendente: 'PENDING' O cliente está no processo de assinatura do e-mail marketing.Inválido: 'INVALID' O estado de marketing do endereço de e-mail do cliente é inválido.
|
Formato | |
Exemplo | Inclua clientes que se inscreveram no e-mail marketing:email_subscription_status = 'SUBSCRIBED'
|
Observações |
Data do último pedido
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:
|
Exemplo |
Inclua clientes que realizaram o último pedido na semana passada: Inclua clientes que realizaram o último pedido há oito meses: |
Observações | Valores de data representam dias inteiros e dependem do fuso horário da loja. |
Quantidade de pedidos
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
orders_placed()
Inclui clientes que fizeram pedidos ou gastaram um determinado valor durante um período especificado.
Parâmetros de função |
|
---|---|
Operadores |
É igual a: Não é igual a: |
Valores |
true , false
|
Formato |
Formatos aceitos para Formatos aceitos para Formatos aceitos para Formatos de 7 dias atrás: Data com nome:
As datas nomeadas são valores-padrão e não podem ser alteradas. |
Exemplo | Especificar se um pedido foi feito com uso de um operador = ou != :
Filtrar os clientes que fizeram mais de três pedidos (inclusive) nos últimos seis meses:
Filtrar os clientes que gastaram mais de US$ 1.000 (inclusive) nos últimos três meses:
Filtrar os clientes que gastaram menos de US$ 100 (inclusive) na última semana:
Filtrar os clientes que gastaram mais de US$ 1.000 (inclusive) e fizeram mais de três pedidos (inclusive) desde 1º de janeiro de 2023:
No caso dos períodos, não importa a ordem os parâmetros Entre 1º de janeiro de 2023 e 1º de junho de 2023 (inclusive):
Entre 1º de janeiro de 2023 e 1º de junho de 2023 (inclusive):
|
Observações |
|
Nível de gasto previsto
predicted_spend_tier
Inclui clientes que estão dentro do nível de gasto previsto especificado.
É importante lembrar que o filtro só é disponibilizado para lojas com mais de cem vendas.
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
product_subscription_status
Inclui clientes que têm o status de assinatura do produto especificado.
O filtro só aparece para lojas que usam um app de assinatura.
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
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_at_least (opcional): use este parâmetro para especificar a quantidade mínima de produtos comprados por pedido.quantity_at_most (opcional): use este parâmetro para especificar a quantidade máxima de produtos comprados por pedido.quantity (opcional): use este parâmetro para especificar a quantidade de produtos comprados por pedido.sum_quantity_at_least (opcional): use este parâmetro para especificar a quantidade mínima de produtos comprados em todos os pedidos.sum_quantity_at_most (opcional): use este parâmetro para especificar a quantidade máxima de produtos comprados em todos os pedidos.sum_quantity (opcional): use este parâmetro para especificar a quantidade de produtos comprados em todos os pedidos.since (opcional): use este parâmetro para especificar uma data de início do evento.tag (opcional): tag (opcional): use para especificar e filtrar uma determinada tag nos produtos comprados.until (opcional): use este parâmetro para especificar a data de término do evento.
|
---|---|
Operadores | É igual a: = Não é igual a: != |
Valor |
true , false
|
Formato |
Formatos aceitos para tag :String (valor único)Formatos aceitos para id : ID (valor único)List <ID> : um conjunto de valores fornecidos como uma lista. Por exemplo: (1012132033639, 2012162031638, 32421429314657) . Há um limite de 500 IDs de produtos em uma lista.Formatos de Date aceitos para since e until :Data absoluta: YYYY-MM-DD Exemplos de ajuste de data: Sete dias atrás :-7d Quatro semanas atrás :-4w Três meses atrás :-3m Um ano atrás :-1y Data com nome :today , :yesterday As datas nomeadas são valores-padrão e não podem ser alteradas. Formatos aceitos para quantity_at_least , quantity_at_most , quantity : Número: # Formatos aceitos para sum_quantity_at_least , sum_quantity_at_most , sum_quantity : Número: # |
Exemplo |
Usar um operador = ou != para especificar se um produto foi comprado: products_purchased() != true products_purchased(id: 2012162031638) = true products_purchased(id: (2012162031638, 1012132033639)) = false products_purchased(tag: 'red') = true Filtrar clientes que compraram um produto específico entre 1º de janeiro de 2022 e hoje: products_purchased(id: 1012132033639, since: 2022-01-01, until: today) = true Filtrar clientes que compraram um produto com a tag 'vermelho' entre 1º de janeiro de 2022 e hoje: products_purchased(tag: 'Red', since: 2022-01-01, until: today) = true Nos últimos 30 dias: products_purchased(since: -30d) = true Até 1º de janeiro de 2022: products_purchased(until: 2022-01-01) = true No caso dos períodos, não importa a ordem os parâmetros products_purchased(id: 1012132033639, since: 2022-01-01, until: 2022-06-01) = true Entre 1º de janeiro de 2022 e 1º de junho de 2022 (inclusive): products_purchased(id: 1012132033639, until: 2022-06-01, since: 2022-01-01) = true Filtrar os clientes que compraram vários produtos recentemente com uma tag específica: products_purchased(tag: 'product_tag', sum_quantity_at_least: 3, since: -90d) = true
|
Observações |
|
Status da assinatura por SMS
sms_subscription_status
Inclui clientes de acordo com o 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
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. |
Eventos de vitrine
storefront.EVENT()
Inclui clientes com base em eventos de vitrine. Entre os eventos (EVENT) aceitos 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.since (opcional): use esse parâmetro para especificar a data de início do evento.until (opcional): use esse parâmetro para especificar a data final do evento.count_at_least (opcional): use esse parâmetro para especificar o número mínimo de visualizações de um produto ou uma coleção.count_at_most (opcional): use esse parâmetro para especificar o número máximo de visualizações de um produto ou uma coleção.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 |
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 | É igual a: = Não é igual a: != |
Valor |
true , false
|
Formato |
Formatos aceitos para id :
ID (valor único)
List <ID> : um conjunto de valores apresentados como lista. Por exemplo: (1012132033639, 2012162031638, 32421429314657) . Há um limite de 500 IDs de produtos em uma lista.Formatos aceitos para tag :
String (valor único)Formatos de YYYY-MM-DD Exemplos de ajuste de data:
As datas denominadas são valores padrão e não podem ser alteradas.Para datas personalizadas, use uma compensação de data. |
Exemplo |
Para especificar se um evento de vitrine aconteceu, use um operador = ou != : storefront.product_viewed() = true storefront.collection_viewed() = false Use o parâmetro id para especificar os produtos que você que filtrar:storefront.product_viewed(id: 2012162031638) = true storefront.collection_viewed(id: (2012162031638, 456, 789)) = true Use o parâmetro tag para as tags de produto que você quer filtrar: storefront.product_viewed(tag: 'jeans') = true Use o parâmetro since para especificar uma data de início para um evento de vitrine:storefront.product_viewed(id: 2012162031638, since: 2023-04-03) = true storefront.collection_viewed(id: 2012162031638, since:-30d) = true Use o parâmetro until para especificar uma data final para um evento de vitrine:storefront.product_viewed(id: 2012162031638, until: 2023-04-30) = true storefront.collection_viewed(id: 2012162031638, until:-7d) = true Use os parâmetros since e until para especificar a data de início e de término de um evento de vitrine:storefront.product_viewed(id: 2012162031638, since: 2023-04-03, until: 2023-04-30) = true storefront.collection_viewed(id: 2012162031638, since: -90d, until: -30d) = true Filtre os clientes que viram um produto específico nos últimos 30 dias: storefront.product_viewed(id: 2012162031638, since: -30d) = true Filtre os clientes que viram uma coleção específica desde 1º de janeiro de 2023 até hoje: storefront.collection_viewed(id: 2012162031638, since: 2023-01-01, until: today) = true No caso dos períodos, não importa a ordem os parâmetros storefront.collection_viewed(id: 2012162031638, since: 2023-01-01, until: 2023-06-01) = true Entre 1º de janeiro de 2023 e hoje (inclusive): storefront.collection_viewed(id: 2012162031638, until: today, since: 2023-01-01,) = true
|
Observações |
|