Referência de dados do Square

O que você vai aprender

Saiba quais dados são sincronizados do Square para a Klaviyo, como visualizá-los e quais propriedades os eventos do Square contêm.

Antes de começar

Se você ainda não leu, confira nosso artigo sobre Guia de introdução ao Square para ver instruções passo a passo de como integrar sua loja antes de continuar com este artigo.

Como ver seus dados

Verifique se a sua integração da Square está ativada. Para verificar a sincronização de dados da Square para a Klaviyo:

1. Na sua conta da Klaviyo, selecione Integrações na navegação à esquerda.
2. Selecione Square na lista.
3. Selecione a guia Dados na parte superior.

Aqui, você verá dados recentes sincronizados do Square para o Klaviyo e uma barra de progresso enquanto a sincronização dos seus dados históricos estiver em andamento.

Se você estiver com problemas com a sincronização, selecione Reiniciar importação na seção dados históricos para reiniciar uma sincronização histórica incompleta ou Reimportar para executá-la novamente depois que ela for concluída. Você precisa de permissão para gerenciar integrações para usar esses controles.

Dados sincronizados do Square

Eventos do Square Online são sincronizados com o Klaviyo em tempo real, e 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 Com atividade no site (se você deixou a configuração de JavaScript no site marcada)
• Cancelamento de inscrição de e-mail
• Informações do cliente associadas a eventos de pedido
• Seu catálogo do Square (incluindo itens apenas de PDV)
• Os seguintes eventos:
  • Checkout abandonado
  • Pedido Realizado
  • Produto Encomendado
  • Pedido Reembolsado
  • Pedido Cancelado
  • Pedido Parcialmente Atendido
  • Pedido Atendido

Os eventos de pedidos do Square POS serão sincronizados com a Klaviyo (e perfis da 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 a sua empresa.

Eventos no nível do pedido, como Placed Order e Refunded Order, incluem uma propriedade Source Name que identifica a origem, como Square Online ou POS, para que você possa segmentar esses eventos no Klaviyo. Essa propriedade não é incluída nos eventos Ordered Product ou Abandoned Checkout.

Detalhes das informações do cliente

Os perfis de clientes são sincronizados do Square para a Klaviyo se houver um endereço de e-mail e/ou número de telefone associado ao cliente, que o cliente compartilhou diretamente com a sua empresa. Os perfis sincronizados do Square para a Klaviyo podem incluir as seguintes propriedades, dependendo dos dados disponíveis no Square:

• E-mail
  Endereço de e-mail do cliente
• Nome
  Nome do cliente, se o nome e o sobrenome estiverem disponíveis
• Sobrenome
  Sobrenome do cliente, se o nome e o sobrenome estiverem disponíveis
• Cidade
  Cidade do cliente
• Estado/região
  Estado do cliente
• CEP
  CEP do cliente
• País
  País do cliente
• Número de telefone
  Número de telefone do cliente. A Klaviyo só criará perfis somente com telefone se você tiver configurado o Klaviyo SMS
• Aniversário
  A data de nascimento do cliente, se fornecida
• Grupos do Square
  Grupos do Square associados ao cliente. No momento, isso não inclui os Segmentos do Square

Consentimento de e-mail

A integração do Square sincroniza o status de cancelar inscrição de e-mail, mas não sincroniza o consentimento de opt-in de e-mail. Quando email_unsubscribed é verdadeiro no Square, o Klaviyo marca o cliente como cancelar inscrição. Quando é falso, a sincronização não altera o status de inscrever-se de e-mail de um perfil existente. Perfis novos sem consentimento de e-mail são marcados como Nunca inscrito.

consentimento para SMS

No momento, o consentimento por SMS coletado no Square Online não pode ser sincronizado com a Klaviyo. Você pode coletar consentimento por 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 a 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 inventário
• Política de estoque
• Categoria
• Publicado
• Variantes

Eventos sincronizados e suas propriedades

Checkout abandonado

Este evento é acionado 1 hora após um carrinho ser abandonado em uma loja Square Online e pode ser usado em um fluxo de carrinho abandonado. O Square precisa fornecer um registro de cliente com um endereço de e-mail ou número de telefone válido para que o evento seja sincronizado.

Para que esse evento seja sincronizado com a Klaviyo, primeiro você precisa 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. Selecione Comunicações > Carrinho abandonado
3. Selecione Desabilitar

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

• $value
  Valor total no carrinho
• Itens
  Itens incluídos no carrinho
• Coleções
  Coleções vinculadas aos itens incluídos no carrinho

Os eventos Checkout abandonado não incluem uma propriedade Quantidade de itens de nível superior.

Pedido Realizado

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

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

• $value
  Valor total do pedido
• Items
  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
  Nomes dos descontos aplicados ao pedido
• Total de descontos
  Valor total do desconto
• Nome da origem
  Origem do pedido (Square Online, POS)
• Nome do local
  Nome do local do Square

Produto Encomendado

Esse evento é acionado quando um pedido é feito em uma loja do Square Online ou em um terminal de PDV. Para produtos do catálogo vendidos em unidades inteiras, um evento Ordered Product é acionado para cada unidade comprada, até 100 eventos por linha do pedido. Para produtos vendidos por peso ou outra unidade fracionária, 1 evento representa a quantidade total comprada.

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

• $value
  Valor da quantidade do produto representada por este evento, incluindo modificadores e excluindo impostos
• Nome
  Nome do produto que o destinatário comprou
• Variante
  Nome da variante do produto
• SKU
  SKU do produto
• ID do produto
  Identificador do produto
• ID da variante
  Identificador da variante
• Quantidade
  1 para cada evento de unidade inteira ou a quantidade total comprada para um produto vendido em unidades fracionadas
• Coleções
  Coleções vinculadas ao produto
• Opção de variante: [option name]
  Valor da opção de variante nomeada para o produto pedido
• Opções do modificador: [modifier list name]
  Opções de modificador selecionadas da lista de modificadores nomeada para o produto 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:

• $value
  Valor reembolsado
• URL do recibo
  URL do recibo do pedido
• Nome da origem
  Origem do pedido (Square Online, POS)
• Nome do local
  Nome do local do Square

Pedido Cancelado

Esse evento é acionado quando um cliente cria um pedido na sua loja, mas depois cancela o pedido inteiro. O evento que a Klaviyo rastreia inclui todas as informações do produto sobre os itens que alguém comprou, incluindo nomes e imagens dos produtos. Cancelamentos parciais não são compatíveis.

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

• $value
  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
  Nomes dos descontos aplicados ao pedido
• Total de descontos
  Valor total do desconto
• Nome da origem
  Origem do pedido (Square Online, POS)
• Nome do local
  Nome do local do Square

Pedido Parcialmente Atendido

Um evento Fulfilled Partial Order é registrado para cada envio, entrega ou retirada concluída, enquanto outros atendimentos permanecem incompletos. Quando todos os atendimentos são concluídos, o atendimento final é registrado como Fulfilled Order. Se o Square não fornecer detalhes do item para um atendimento parcial, o evento conterá detalhes do pedido inteiro.

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

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

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:

• $value
  Valor total do pedido
• Items
  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
  Nomes dos descontos aplicados ao pedido
• Total de descontos
  Valor total do desconto
• Status do processamento
  Status do pedido informado pelo Square
• Nome da origem
  Origem do pedido (Square Online, POS)
• Nome do local
  Nome do local do Square

Recursos adicionais