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
- Valor gasto
- Cidades
- Empresas
- Países ou regiões
- 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
- Nível de gasto previsto
- Status da assinatura de produto
- Produtos comprados
- Status da assinatura por SMS
- Estados ou províncias
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. |
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 NOT NULL Não é um cliente B2B: companies 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. |
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.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 :
|
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. |
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 para especificar e filtrar um determinado produto comprado por um cliente. tag (opcional): use para especificar e filtrar uma determinada tag nos produtos comprados. since (opcional): use para especificar a data de início do evento.until (opcional): use para especificar a data de término do evento.
|
---|---|
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: -4w , -10y Data nomeada:
|
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 'vemelho' since January 1, 2022 until today: products_purchased(tag: 'Vermelho', since: 2022-01-01, until: today) = true Nos últimos 30 dias: products_purchased(since: 30_days_ago) = 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
|
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. |