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. Na sua conta Klaviyo, clique no nome da sua empresa ou organização no canto inferior esquerdo e, em seguida, clique em Integrations (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 Import 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