Referência de dados quadrados

O que você vai aprender

Saiba quais dados são sincronizados do Square para o Klaviyo, como visualizá-los e quais propriedades os eventos do Square contêm. Além disso, saiba como visualizar seus dados do Square no Klaviyo.

Antes de começar

Se ainda não o fez, leia nosso artigo sobre como começar a usar o Square para obter instruções passo a passo sobre como integrar sua loja antes de continuar com este artigo.

Como visualizar seus dados

Para verificar a sincronização de dados do Square com o Klaviyo:

1. Em sua conta Klaviyo, selecione a guia integrações .
2. Selecione Square na lista de integrações habilitadas.
3. Selecione a guia Data (Dados ) na parte superior.

Aqui, o senhor verá os dados recentes sincronizados do Square para o Klaviyo e uma barra de progresso de sincronização para a sincronização de dados históricos.

Se estiver tendo problemas com a sincronização, o senhor pode selecionar Restart importar aqui para reiniciar a sincronização de dados históricos.

Dados sincronizados do Square

Os eventos do Square Online são sincronizados com o Klaviyo em tempo real, e os eventos do Square POS são sincronizados a cada 30 minutos. 

Os dados sincronizados do Square para o Klaviyo incluem:

• Visitantes conhecidos do site rastreados como eventos Active on Site (se o senhor deixou a configuração JavaScript no local marcada)
• Cancelamento de assinaturas de e-mail
• Informações do cliente associadas a eventos de pedidos
• Seu catálogo Square (incluindo itens somente para PDV)
• Os seguintes eventos:
  • Checkout abandonado
  • Pedido feito
  • Produto encomendado
  • Pedido reembolsado
  • Pedido cancelado
  • Pedido parcial atendido
  • Pedido atendido

Os eventos de pedido do Square POS serão sincronizados com o Klaviyo (e os perfis do Klaviyo serão criados) se houver um endereço de e-mail e/ou número de telefone associado ao pedido que o cliente compartilhou diretamente com sua empresa.

Os eventos Square terão uma propriedade chamada source name que mostrará se o evento é de um PDV ou on-line/web, para que o senhor possa segmentar esses eventos no Klaviyo.

Detalhes das informações do cliente

As informações do perfil do cliente são sincronizadas do Square para o Klaviyo com as seguintes propriedades:

• E-mail
  Endereço de e-mail do cliente
• Primeiro nome
  Primeiro nome do cliente (obrigatório)
• Sobrenome
  Sobrenome do cliente
• Cidade
  Cidade do cliente
• Estado/Região
  Estado do cliente
• Código postal
  CEP do cliente
• País de origem
  País do cliente
• Número de telefone
  Número de telefone do cliente. A Klaviyo só criará perfis somente para telefone se o senhor tiver configurado o Klaviyo SMS
• Aniversário
  A data de nascimento do cliente, se fornecida
• Grupos quadrados
  Grupos quadrados associados ao cliente. Atualmente, isso não inclui os Square Segments

Consentimento por e-mail

A plataforma Square é uma plataforma de consentimento de marketing "opt-out". Isso significa que qualquer pessoa que forneça seu endereço de e-mail não teve a oportunidade de consentir explicitamente com seu marketing por e-mail. Em vez disso, a Klaviyo marcará as pessoas que tiverem email_unsubscribed definido como false no Square como "Never Subscribed" (Nunca se inscreveu) na Klaviyo, e as que tiverem email_unsubscribed definido como true no Square como "Unsubscribed" (Não se inscreveu) na Klaviyo.

Consentimento por SMS

Atualmente, os assinantes de SMS coletados no Square Online não podem ser sincronizados com o Klaviyo. O senhor pode coletar o consentimento de SMS por meio de um formulário da Klaviyo no seu site Square.

Detalhes do item do catálogo

Os itens do catálogo são sincronizados do Square para o Klaviyo com as seguintes propriedades:

• Nome do item
• ID do item
• Descrição do item
• Preço do item
• SKU
• URL
• URL da imagem
• Quantidade de estoque
• Política de inventário
• Categoria
• Publicado
• Variantes

Eventos sincronizados e suas propriedades

Checkout abandonado

Esse evento é acionado 1 hora após o abandono de um carrinho em uma loja Square Online e pode ser usado em um fluxo de carrinho abandonado.

Para que esse evento seja sincronizado com o Klaviyo, o senhor deve primeiro desativar os e-mails de carrinho abandonado no Square. Para isso:

1. Faça login no Square e navegue até sua página de visão geral
2. Select Communications > Carrinhos abandonados
3. Selecione Disable (Desativar)

As propriedades de nível superior do evento no Klaviyo são:

• $valor
  Valor total no carrinho
• Itens
  Itens incluídos no pedido
• Coleções
  Coleções vinculadas aos itens incluídos no pedido
• Contagem de itens
  Número total de itens incluídos no pedido

Pedido feito

Esse evento é acionado quando um evento de pedido é feito em uma loja Square Online ou em um terminal POS.

As propriedades de nível superior do evento no Klaviyo são:

• $valor
  Valor total do pedido
• Itens
  Itens incluídos no pedido
• Coleções
  Coleções vinculadas aos itens incluídos no pedido
• Contagem de itens
  Número total de itens incluídos no pedido
• Códigos de desconto
  Códigos de desconto aplicados ao pedido
• Total de descontos
  Valor total do desconto
• Nome da fonte
  Origem do pedido (Square Online, POS)
• Nome do local
  Nome do local quadrado

Produto encomendado

Esse evento é acionado quando um evento de pedido é feito em uma loja Square Online ou em um terminal POS. Um evento Ordered Product é acionado para cada item em um pedido feito.

As propriedades de nível superior do evento no Klaviyo são:

• $valor
  Valor total do pedido
• Nome do produto
  Nome do produto solicitado
• Nome da variante
  Nome da variante do produto
• SKU
  Produto SKU
• ID do produto
  Identificador do produto
• ID da variante
  Identificador da variante
• Quantidade de produtos
  Número de produtos
• Coleções
  Coleções vinculadas ao produto
• Opção de variante
  Opção de variante do produto pedido
• Opção de modificador
  Opções de modificador aplicadas ao pedido

Pedido reembolsado

Esse evento é acionado quando um pedido é reembolsado em uma loja Square Online ou em um terminal POS.

As propriedades de nível superior do evento no Klaviyo são:

• $valor
  Valor total do pedido
• URL do recibo
  URL do recibo do pedido
• Nome da fonte
  Origem do pedido (Square Online, POS)
• Nome do local
  Nome do local quadrado

Pedido cancelado

Esse evento é acionado quando um cliente cria um pedido em sua loja, mas depois cancela o pedido inteiro. O evento que a Klaviyo rastreia inclui todas as informações sobre os itens que alguém comprou, inclusive os nomes e as imagens dos produtos. Não há suporte para cancelamentos parciais.

As propriedades de nível superior do evento no Klaviyo são:

• $valor
  Valor total do pedido
• Itens
  Itens incluídos no pedido
• Coleções
  Coleções vinculadas aos itens incluídos no pedido
• Contagem de itens
  Número total de itens incluídos no pedido
• Códigos de desconto
  Códigos de desconto aplicados ao pedido
• Total de descontos
  Valor total do desconto
• Nome da fonte
  Origem do pedido (Square Online, POS)
• Nome do local
  Nome do local quadrado

Pedido parcial atendido

Um evento de Pedido parcial atendido será registrado se um pedido for enviado em vários atendimentos, e um evento será registrado para cada atendimento parcial.

As propriedades de nível superior do evento no Klaviyo são:

• $valor
  Valor total do cumprimento
• Itens
  Itens incluídos no atendimento
• Coleções
  Coleções vinculadas aos itens incluídos no cumprimento
• Contagem de itens
  Número total de itens incluídos no cumprimento
• Códigos de desconto
  Códigos de desconto aplicados ao pedido
• Total de descontos
  Valor total do desconto
• Source Name
  Fonte do pedido (Square Online, POS)
• Nomedo local
  Nome do local da praça

Pedido atendido

Esse evento é acionado quando um pedido é atendido em uma loja Square Online ou em um terminal POS. Um evento de pedido atendido será registrado no último atendimento, se houver vários vinculados a um pedido.

As propriedades de nível superior do evento no Klaviyo são:

• $valor
  Valor total do pedido
• Itens
  Itens incluídos no pedido
• Coleções
  Coleções vinculadas aos itens incluídos no pedido
• Contagem de itens
  Número total de itens incluídos no pedido
• Códigos de desconto
  Códigos de desconto aplicados ao pedido
• Total de descontos
  Valor total do desconto
• FulfillmentStatus
  Status do fulfillment
• Source Name
  Fonte do pedido (Square Online, POS)
• Nomedo local
  Nome do local da praça

Recursos adicionais

• Como começar a usar o Square
• Introdução aos segmentos
• Introdução aos fluxos