Recursos de dados da Shopify

Este artigo fornece uma visão geral dos recursos da Braze para Shopify, incluindo quais dados da Shopify são rastreados e exemplos de cargas úteis, backfill histórico e sincronizações de produtos.

Eventos rastreados do Shopify

A integração com Shopify usa eventos de eCommerce recomendados para capturar comportamentos de compra importantes. Para exemplos de implementação e estratégias de marketing usando esses eventos, consulte Casos de uso de eCommerce.

Importante

A integração do Shopify oferece suporte a webhooks de criação e atualização de clientes do Shopify, que estão localizados nas suas configurações de dados. Quando um perfil de usuário é criado ou atualizado no Shopify, um perfil de usuário correspondente na Braze será criado ou atualizado.

Essas ações não disparam eventos personalizados na Braze e são usadas exclusivamente para sincronizar dados de usuários do Shopify com a Braze. Os dados sincronizados incluem atributos personalizados, atributos padrão e, se ativado na sua configuração, estados de grupo de inscrições.

• exemplo de carga útil
• eventos do shopify

• product viewed
• cart updated
• checkout started
• order placed
• fulfilled order
• partially fulfilled order
• paid order
• order cancelled
• order refunded
• account login

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

{
    "name": "ecommerce.product_viewed",
    "properties": {
        "product_id": "12345",
        "product_name": "product",
        "variant_id": "123",
        "image_url": "www.image-url.com",
        "product_url": "mystorefront.myshopify.com/product",
        "price": 10,
        "currency": "USD",
        "source": "mystorefront.myshopify.com",
        "metadata": {
          "sku": "sku"
        },
        "type": [
          "price_drop",
          "back_in_stock"
        ]
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
    "name": "ecommerce.cart_updated",
    "properties": {
        "cart_id": "Z2NwLXVzLWVhc3QxOjAxSjk3UFg4RlFZMjVTVkRHRlc1RlI3SlRY",
        "currency": "USD",
        "total_value": 2000000,
        "products": [
            {
                "product_id": "8266836345064",
                "product_name": "PANTS!!!",
                "variant_id": "44610569208040",
                "image_url": "https://cdn.shopify.com/s/files/1/0604/4211/6328/files/1200px-Trousers-colourisolated.jpg?v=1689256168",
                "product_url": "https://test-store.myshopify.com/products/pants?variant=44610569208040",
                "quantity": 2,
                "price": 1000000,
                "metadata": {
                    "sku": "007"
                }
            }
        ],
        "source": "https://test-store.myshopify.com",
        "metadata": {}
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

{
    "name": "ecommerce.checkout_started",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "cart_id": "eeafa272cebfd4b22385bc4b645e762c",
        "total_value": 421.88,
        "subtotal_value": 396.88,
        "tax": 15.00,
        "shipping": 10.00,
        "currency": "USD",
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "checkout_id": "123123123",
        "metadata": {
            "checkout_url": "https://checkout.local/548380009/checkouts/123123123/recover?key=example-secret-token"
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

{
    "name": "ecommerce.order_placed",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "cart_id": "eeafa272cebfd4b22385bc4b645e762c",
        "total_value": 421.88,
        "subtotal_value": 396.88,
        "tax": 15.00,
        "shipping": 10.00,
        "currency": "USD",
        "total_discounts": 5,
        "discounts": [],
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "metadata": {
            "order_status_url": "https://apple.myshopify.com/690933842/orders/123456abcd/authenticate?key=abcdefg",
            "order_number": "1234",
            "tags": [
                "heavy",
                "heavy2"
            ],
            "referring_site": "https://www.google.com",
            "payment_gateway_names": [
                "visa",
                "bogus"
            ]
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

{
 "name": "shopify_fulfilled_order",
 "time": "2022-05-23T14:44:34-04:00",
 "properties": {
   "order_id": 4444668657855,
   "line_items": [
     {
       "quantity": 1,
       "product_id": 6143032066239,
       "sku": null,
       "title": "Dark Denim Top",
  "variant_id": 40094740549876,
       "variant_title": "Small Dark Denim Top",


       "vendor": "partners-demo",
       "name": "Dark Denim Top",
       "properties": [],
       "price": "60.00",
       "fulfillment_status": "fulfilled"
     }
   ],
   "shipping": [
     {
       "title": "Standard",
       "price": "0.00"
     }
   ],
   "total_price": "130.66",
   "confirmed": true,
   "total_discounts": "0.00",
   "discount_codes": [],
   "order_number": 1093,
   "order_status_url": "https://test-store.myshopify.com/",
   "cancelled_at": null,
   "tags": "",
   "closed_at": "2022-05-23T14:44:34-04:00",
   "fulfillment_status": "fulfilled",
   "fulfillments": [
     {
       "shipment_status": null,
       "status": "success",
       "tracking_company": "Other",
       "tracking_number": "456",
       "tracking_numbers": [
         "456"
       ],
       "tracking_url": "https://braze.com",
       "tracking_urls": [
         "https://braze.com"
       ],
       "line_items": [
         {
           "fulfillment_status": "fulfilled",
           "name": "Dark Denim Top",
           "price": "60.00",
           "product_id": 6143032066239,
           "quantity": 1,
           "requires_shipping": true,
           "sku": null,
           "title": "Dark Denim Top",
           "variant_id": 40094740549876,
           "variant_title": "Small Dark Denim Top",
           "vendor": "partners-demo"
         }
       ]
     }
   ]
 },
 "braze_id": "123abc123abc"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

{
 "name": "shopify_partially_fulfilled_order",
 "time": "2022-05-23T14:43:34-04:00",
 "properties": {
   "order_id": 4444668657855,
   "line_items": [
     {
       "quantity": 1,
       "product_id": 6143032066239,
       "sku": null,
       "title": "Dark Denim Top",
       "variant_id": 40094740549876,
       "variant_title": "",
       "vendor": "partners-demo",
       "name": "Dark Denim Top",
       "properties": [],
       "price": "60.00",
       "fulfillment_status": "fulfilled"
     }
   ],
   "shipping": [
     {
       "title": "Standard",
       "price": "0.00"
     }
   ],
   "total_price": "130.66",
   "confirmed": true,
   "total_discounts": "0.00",
   "discount_codes": [],
   "order_number": 1093,
   "order_status_url": "https://test-store.myshopify.com/",
   "cancelled_at": null,
   "tags": "",
   "closed_at": null,
   "fulfillment_status": "partial",
   "fulfillments": [
     {
       "shipment_status": null,
       "status": "success",
       "tracking_company": "Other",
       "tracking_number": "123",
       "tracking_numbers": [
         "123"
       ],
       "tracking_url": "https://braze.com",
       "tracking_urls": [
         "https://braze.com"
       ],
       "line_items": [
         {
           "fulfillment_status": "fulfilled",
           "name": "Dark Denim Top",
           "price": "60.00",
           "product_id": 6143032066239,
           "properties": [],
           "quantity": 1,
           "requires_shipping": true,
           "sku": null,
           "title": "Dark Denim Top",
           "variant_id": 40094740549876,
           "variant_title": "",
           "vendor": "partners-demo"
         }
       ]
     }
   ]
 },
 "braze_id": "abc123abc123"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

{
 "name": "shopify_paid_order",
 "time": "2022-05-23T13:52:38-04:00",
 "properties": {
   "order_id": 4444596371647,
   "line_items": [
     {
       "quantity": 1,
       "product_id": 6143033344191,
       "sku": null,
       "title": "LED High Tops",
       "variant_id": 40094740549876,
       "variant_title": null,
       "vendor": "partners-demo",
       "name": "LED High Tops",
       "properties": [],
       "price": "80.00",
       "fulfillment_status": null
     }
   ]
 }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

{
    "name": "ecommerce.order_cancelled",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "cancel_reason": "no longer necessary",
        "total_value": 421.88,
        "subtotal_value": 396.88,
        "tax": 15.00,
        "shipping": 10.00,
        "currency": "USD",
        "total_discounts": 5,
        "discounts": [],
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "metadata": {
            "order_status_url": "https://apple.myshopify.com/690933842/orders/123456abcd/authenticate?key=abcdefg",
            "order_number": "1234",
            "tags": [
                "heavy",
                "heavy2"
            ]
        }
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

{
    "name": "ecommerce.order_refunded",
    "time": "2022-05-23T13:52:38-04:00",
    "properties": {
        "order_id": "820982911946154508",
        "total_value": 421.88,
        "currency": "USD",
        "products": [
            {
                "product_id": "632910392",
                "product_name": "IPod Nano - 8GB",
                "variant_id": "808950810",
                "quantity": 1,
                "price": 199,
                "metadata": {
                    "sku": "IPOD2008PINK"
                }
            }
        ],
        "source": "braze-mock-storefront.myshopify.com",
        "metadata": {
		"order_note": "item was broken"
        }
    }
}

1
2
3
4
5
6

{
	"name": "shopify_account_login",
	"properties": {
	"source": "braze-mock-storefront.myshopify.com"
  }
}

Nota

A Braze depende do Shopify para fornecer as propriedades de evento necessárias (como cart_id ou cart_token) para eventos de eCommerce. Em casos raros, problemas temporários com o Shopify podem fazer com que essas propriedades não sejam recebidas, o que pode causar a perda dos eventos afetados.

• product viewed
• cart updated
• checkout started
• order placed
• fulfilled order
• partially fulfilled order
• paid order
• order cancelled
• order refunded
• account login

Evento: ecommerce.product_viewed
Tipo: Evento recomendado
Disparado: Quando um cliente visualiza uma página de produto
Fonte de dados: SDKs da Braze
Caso de uso: Abandono de navegação

Variável	Modelo Liquid
product_id	{{event_properties.${product_id}}}
product_name	{{event_properties.${product_name}}}
variant_id	{{event_properties.${variant_id}}}
image_url	{{event_properties.${image_url}}}
product_url	<your-store.myshopify.com>{{event_properties.${product_url}}} Adicione o domínio do seu site Shopify antes da URL.
price	{{event_properties.${price}}}
currency	{{event_properties.${currency}}}
source	{{event_properties.${source}}}
sku	{{event_properties.${metadata}[0].sku}}
type	event_properties.${type}

Evento: ecommerce.cart_updated
Tipo: Evento recomendado
Disparado: Quando um cliente adiciona, remove ou atualiza seu carrinho de compras
Fonte de dados: SDKs da Braze
Caso de uso: Abandono de carrinho

Para Canvas de carrinho abandonado, primeiro é necessário adicionar a Liquid tag inicial do carrinho de compras para obter o contexto do carrinho na sua mensagem.

1

{% shopping_cart {{context.${cart_id}}} %}

Depois, você pode adicionar as seguintes Liquid tags do carrinho de compras à sua mensagem.

Variável	Modelo Liquid
cart_id	{{ shopping_cart.cart_id }}
currency	{{ shopping_cart.currency }}
total_value	{{ shopping_cart.total_value }}
product_id	{{ shopping_cart.products[0].product_id }}
product_name	{{ shopping_cart.products[0].product_name }}
variant_id	{{ shopping_cart.products[0].variant_id }}
image_url	{{ shopping_cart.products[0].image_url }}
product_url	{{ shopping_cart.products[0].product_url }}
quantity	{{ shopping_cart.products[0].quantity }}
price	{{ shopping_cart.products[0].price }}
sku	{{ shopping_cart.products[0].metadata[0].sku }}
source	{{ shopping_cart.source }}
metadata (value)	{{ shopping_cart.metadata[0].<add_value_here> }}

Dica

Para saber mais sobre como criar um loop Liquid for para adicionar dinamicamente todos os produtos no seu e-mail, consulte Personalização de produtos de carrinho abandonado para e-mails.

Evento: ecommerce.checkout_started
Tipo: Evento recomendado
Disparado: Quando um usuário navega até a página de checkout
Fonte de dados: REST API da Braze
Caso de uso: Abandono de checkout

Importante

Se um cliente usar o Shop Pay como opção de checkout acelerado, o Shopify pode ignorar determinados eventos de checkout padrão (como o webhook de checkout iniciado do Shopify). Isso significa que a Braze pode não receber os dados necessários para adicionar o alias do token de checkout, o que pode impactar o rastreamento de abandono de checkout e a reconciliação de perfis de usuário.

Para Canvas de checkout abandonado, primeiro é necessário usar a seguinte Liquid tag:

1
2

{% shopping_cart {{context.${cart_id}}} :abort_if_not_abandoned false %}
{{context.${cart_id}}}

Depois, você pode adicionar as seguintes Liquid tags à sua mensagem para referenciar os produtos no seu carrinho no momento do checkout.

Variável	Modelo Liquid
cart_id	{{ shopping_cart.cart_id }}
currency	{{ shopping_cart.currency }}
total_value	{{ shopping_cart.total_value }}
product_id	{{ shopping_cart.products[0].product_id }}
product_name	{{ shopping_cart.products[0].product_name }}
variant_id	{{ shopping_cart.products[0].variant_id }}
image_url	{{ shopping_cart.products[0].image_url }}
product_url	{{ shopping_cart.products[0].product_url }}
quantity	{{ shopping_cart.products[0].quantity }}
price	{{ shopping_cart.products[0].price }}
sku	{{ shopping_cart.products[0].metadata.sku }}
source	{{ shopping_cart.source }}
checkout_url	{{ shopping_cart.metadata[0].checkout_url }}

Evento: ecommerce.order_placed
Tipo: Evento recomendado
Disparado: Quando um usuário conclui com sucesso o processo de checkout e realiza um pedido
Fonte de dados: REST API da Braze
Caso de uso: Confirmação de pedido, redirecionamento pós-compra, upsells ou cross-sells

Variável	Modelo Liquid
cart_id	{{event_properties.${cart_id}}}
currency	{{event_properties.${currency}}}
discounts	{{event_properties.${discounts}}}
order_id	{{event_properties.${order_id}}}
product_id	{{event_properties.${products}[0].product_id}}
product_name	{{event_properties.${products}[0].product_name}}
variant_id	{{event_properties.${products}[0].variant_id}}
quantity	{{event_properties.${products}[0].quantity}}
sku	{{event_properties.${products}[0].metadata.sku}}
total_discounts	{{event_properties.${total_discounts}}}
order_status_url	{{event_properties.${metadata}.order_status_url}}
order_number	{{event_properties.${metadata}.order_number}}
tags	{{event_properties.${metadata}.tags}}
referring_site	{{event_properties.${metadata}.referring_site}}
payment_gateway_names	{{event_properties.${metadata}.payment_gateway_names}}

Dica

O webhook de checkout concluído do Shopify não contém URLs de produto ou URLs de imagem. Sendo assim, você precisa usar a personalização Liquid de Catálogos conforme descrito em Personalização de produtos de carrinho abandonado para e-mails.

Evento: shopify_fulfilled_order
Tipo: Evento personalizado
Disparado: Quando o pedido de um usuário é processado e está pronto para envio
Fonte de dados: REST API da Braze
Caso de uso: (Transacional) Atualização de processamento

Variável	Modelo Liquid
ID do pedido	{{event_properties.${order_id}}}
Preço total	{{event_properties.${total_price}}}
Descontos totais	{{event_properties.${total_discounts}}}
Status de confirmação	{{event_properties.${confirmed}}}
URL de status do pedido	{{event_properties.${order_status_url}}}
Número do pedido	{{event_properties.${order_number}}}
Timestamp de cancelamento	{{event_properties.${cancelled_at}}}
Timestamp de fechamento	{{event_properties.${closed_at}}}
ID do item	{{event_properties.${line_items}[0].product_id}}
Quantidade do item	{{event_properties.${line_items}[0].quantity}}
SKU do item	{{event_properties.${line_items}[0].sku}}
Título do item	{{event_properties.${line_items}[0].title}}
Fornecedor do item	{{event_properties.${line_items}[0].vendor}}
Nome do item	{{event_properties.${line_items}[0].name}}
Propriedades do item	{{event_properties.${line_items}[0].properties}}
Preço do item	{{event_properties.${line_items}[0].price}}
Título do frete	{{event_properties.${shipping}[0].title}}
Preço do frete	{{event_properties.${shipping}[0].price}}
Status de processamento	{{event_properties.${fulfillment_status}}}
Status de envio do processamento	{{event_properties.${fulfillments}[0].shipment_status}}
Status	{{event_properties.${fulfillments}[0].status}}
Transportadora do processamento	{{event_properties.${fulfillments}[0].Fulfillment tracking_company}}
Número de rastreamento do processamento	{{event_properties.${fulfillments}[0].Fulfillment tracking_number}}
Números de rastreamento do processamento	{{event_properties.${fulfillments}[0].Fulfillment tracking_numbers}}
URL de rastreamento do processamento	{{event_properties.${fulfillments}[0].Fulfillment tracking_url}}
URLs de rastreamento do processamento	{{event_properties.${fulfillments}[0].Fulfillment tracking_urls}}
Status de processamento	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
Nome do processamento	{{event_properties.${fulfillments}[0].line_items[0].name}}
Preço do processamento	{{event_properties.${fulfillments}[0].line_items[0].price}}
ID de produto do processamento	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Quantidade do processamento	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Envio do processamento	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
SKU do processamento	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Título do processamento	{{event_properties.${fulfillments}[0].line_items[0].title}}
Fornecedor do processamento	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
ID da variante	{{event_properties.${line_items}[0].variant_id}}
Título da variante	{{event_properties.${line_items}[0].variant_title}}

Evento: shopify_partially_fulfilled_order
Tipo: Evento personalizado
Disparado: Quando parte do pedido de um usuário é processada e está pronta para envio
Fonte de dados: REST API da Braze
Caso de uso: (Transacional) Atualização de processamento

Variável	Modelo Liquid
ID do pedido	{{event_properties.${order_id}}}
Preço total	{{event_properties.${total_price}}}
Descontos totais	{{event_properties.${total_discounts}}}
Status de confirmação	{{event_properties.${confirmed}}}
URL de status do pedido	{{event_properties.${order_status_url}}}
Número do pedido	{{event_properties.${order_number}}}
Timestamp de cancelamento	{{event_properties.${cancelled_at}}}
Timestamp de fechamento	{{event_properties.${closed_at}}}
ID do item	{{event_properties.${line_items}[0].product_id}}
Quantidade do item	{{event_properties.${line_items}[0].quantity}}
SKU do item	{{event_properties.${line_items}[0].sku}}
Título do item	{{event_properties.${line_items}[0].title}}
Fornecedor do item	{{event_properties.${line_items}[0].vendor}}
Nome do item	{{event_properties.${line_items}[0].name}}
Propriedades do item	{{event_properties.${line_items}[0].properties}}
Preço do item	{{event_properties.${line_items}[0].price}}
Título do frete	{{event_properties.${shipping}[0].title}}
Preço do frete	{{event_properties.${shipping}[0].price}}
Status de processamento	{{event_properties.${fulfillment_status}}}
Status de envio do processamento	{{event_properties.${fulfillments}[0].shipment_status}}
Status do processamento	{{event_properties.${fulfillments}[0].status}}
Transportadora do processamento	{{event_properties.${fulfillments}[0].tracking_company}}
Número de rastreamento do processamento	{{event_properties.${fulfillments}[0].tracking_number}}
Números de rastreamento do processamento	{{event_properties.${fulfillments}[0].tracking_numbers}}
URL de rastreamento do processamento	{{event_properties.${fulfillments}[0].tracking_url}}
URLs de rastreamento do processamento	{{event_properties.${fulfillments}[0].tracking_urls}}
Status de processamento	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
Nome do processamento	{{event_properties.${fulfillments}[0].line_items[0].name}}
Preço do processamento	{{event_properties.${fulfillments}[0].line_items[0].price}}
ID de produto do processamento	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Quantidade do processamento	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Envio do processamento	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
SKU do processamento	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Título do processamento	{{event_properties.${fulfillments}[0].line_items[0].title}}
Fornecedor do processamento	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
ID da variante	{{event_properties.${line_items}[0].variant_id}}
Título da variante	{{event_properties.${line_items}[0].variant_title}}

Evento: shopify_paid_order
Tipo: Evento personalizado
Disparado: Quando o pedido de um usuário é marcado como pago no Shopify
Fonte de dados: REST API da Braze
Caso de uso: (Transacional) Confirmação de pagamento

Variável	Modelo Liquid
ID do pedido	{{event_properties.${order_id}}}
Status de confirmação	{{event_properties.${confirmed}}}
URL de status do pedido	{{event_properties.${order_status_url}}}
Número do pedido	{{event_properties.${order_number}}}
Timestamp de cancelamento	{{event_properties.${cancelled_at}}}
Descontos totais	{{event_properties.${total_discounts}}}
Preço total	{{event_properties.${total_price}}}
Tags	{{event_properties.${tags}}}
Códigos de desconto	{{event_properties.${discount_codes}}}
ID do item	{{event_properties.${line_items}[0].product_id}}
Quantidade do item	{{event_properties.${line_items}[0].quantity}}
SKU do item	{{event_properties.${line_items}[0].sku}}
Título do item	{{event_properties.${line_items}[0].title}}
Fornecedor do item	{{event_properties.${line_items}[0].vendor}}
Propriedades do item	{{event_properties.${line_items}[0].properties}}
Preço do item	{{event_properties.${line_items}[0].price}}
Título do frete	{{event_properties.${shipping}[0].title}}
Preço do frete	{{event_properties.${shipping}[0].price}}
ID da variante	{{event_properties.${line_items}[0].variant_id}}
Título da variante	{{event_properties.${line_items}[0].variant_title}}

Evento: ecommerce.order_cancelled
Tipo: Evento recomendado
Disparado: Quando o pedido de um usuário é cancelado
Fonte de dados: REST API da Braze
Caso de uso: (Transacional) Confirmação de cancelamento de pedido

Variável	Modelo Liquid
ID do pedido	{{event_properties.${order_id}}}
Preço total	{{event_properties.${total_price}}}
Descontos totais	{{event_properties.${total_discounts}}}
Confirmado	{{event_properties.${confirmed}}}
URL de status do pedido	{{event_properties.${order_status_url}}}
Número do pedido	{{event_properties.${order_number}}}
Timestamp de cancelamento	{{event_properties.${cancelled_at}}}
Tags	{{event_properties.${tags}}}
Códigos de desconto	{{event_properties.${discount_codes}}}
Status de processamento	{{event_properties.${fulfillment_status}}}
Processamentos	{{event_properties.${fulfillments}}}
ID do item	{{event_properties.${line_items}[0].product_id}}
Quantidade do item	{{event_properties.${line_items}[0].quantity}}
SKU do item	{{event_properties.${line_items}[0].sku}}
Título do item	{{event_properties.${line_items}[0].title}}
Fornecedor do item	{{event_properties.${line_items}[0].vendor}}
Nome do item	{{event_properties.${line_items}[0].name}}
Propriedades do item	{{event_properties.${line_items}[0].properties}}
Status de processamento	{{event_properties.${line_items}[0].fulfillment_status}}
Título do frete	{{event_properties.${shipping}[0].title}}
Preço do frete	{{event_properties.${shipping}[0].price}}
ID da variante	{{event_properties.${line_items}[0].variant_id}}
Título da variante	{{event_properties.${line_items}[0].variant_title}}

Evento: ecommerce.order_refunded
Tipo: Evento recomendado
Disparado: Quando o pedido de um usuário é reembolsado
Fonte de dados: REST API da Braze
Caso de uso: (Transacional) Confirmação de reembolso

Variável	Modelo Liquid
ID do pedido	{{event_properties.${order_id}}}
Nota do pedido	{event_properties.${note}}}
ID do item	{{event_properties.${line_items}[0].product_id}}
Quantidade do item	{{event_properties.${line_items}[0].quantity}}
SKU do item	{{event_properties.${line_items}[0].sku}}
Título do item	{{event_properties.${line_items}[0].title}}
Fornecedor do item	{{event_properties.${line_items}[0].vendor}}
Nome do item	{{event_properties.${line_items}[0].name}}
Propriedades do item	{{event_properties.${line_items}[0].properties}}
Preço do item	{{event_properties.${line_items}[0].price}}
ID da variante	{{event_properties.${line_items}[0].variant_id}}
Título da variante	{{event_properties.${line_items}[0].variant_title}}

Evento: shopify_account_login
Tipo: Evento personalizado
Disparado: Quando um usuário faz login na sua conta
Fonte de dados: REST API da Braze
Caso de uso: Série de boas-vindas

Variável	Modelo Liquid
source	{{event_properties.${source}}}

Nota

A integração com Shopify atualmente não oferece suporte ao preenchimento do evento de compra da Braze. Sendo assim, filtros de compra, Liquid tags, disparos baseados em ação e dados de análise devem usar o evento ecommerce.order_placed.

Atributos personalizados do Shopify compatíveis

Nota

Todos os atributos são originados da REST API da Braze.

• carga útil de exemplo
• atributos personalizados do shopify

• tags do shopify

1
2
3
4
5
6
7
8
9
10
11
12
13

{
  "attributes": [
    {
      "shopify_tags": "VIP_customer",
      "shopify_total_spent": "60.00",
      "shopify_order_count": "3",
      "shopify_last_order_id": "1234567",
      "shopify_last_order_name": "test_order",
      "shopify_zipcode": "10001",
      "shopify_province": "null"
    }
  ]
}

Nome do atributo	Descrição
shopify_total_spent	O valor total que o cliente gastou ao longo de todo o histórico de pedidos.
shopify_order_count	O número de pedidos associados a esse cliente. Pedidos de teste e arquivados não são contabilizados.
shopify_last_order_id	O ID do último pedido do cliente.
shopify_last_order_name	O nome do último pedido do cliente. Esse valor está diretamente relacionado ao campo name no recurso de pedido.
shopify_zipcode	O CEP do cliente a partir do endereço padrão.
shopify_province	O estado/província do cliente a partir do endereço padrão.

Importante

Existe um problema conhecido na versão atual da API do Shopify que impede o preenchimento correto do atributo de usuário shopify_last_order_name. O impacto para os usuários é o seguinte:

• Usuários existentes: Para qualquer usuário que já possua um valor em shopify_last_order_name, esse valor é mantido, mas não é atualizado por pedidos subsequentes.
• Novos usuários: Para novos usuários, o campo não é preenchido e permanece vazio ou nulo.

Esta página será atualizada após o Shopify resolver esse problema.

Personalização com Liquid

Para adicionar personalização com Liquid aos seus atributos personalizados do Shopify, selecione + Personalization. Em seguida, selecione Custom Attributes como seu tipo de personalização.

Após selecionar seu atributo personalizado, insira um valor padrão e copie o snippet Liquid na sua mensagem.

Atributos padrão do Shopify compatíveis

Nota

Todos os atributos são originados da REST API da Braze.

• E-mail
• Nome
• Sobrenome
• Telefone
• Cidade
• País

Nota

A Braze só atualizará os atributos personalizados do Shopify compatíveis e os atributos padrão da Braze se houver uma diferença nos dados em relação ao perfil de usuário existente. Por exemplo, se os dados recebidos do Shopify contiverem o nome Bob e Bob já existir como nome no perfil de usuário da Braze, a Braze não disparará uma atualização e não será cobrado um ponto de dados.

Coleta de dados do SDK

Para saber mais sobre quais dados são coletados pelos SDKs da Braze, consulte Coleta de dados do SDK.

Preenchimento de dados históricos

Os dados históricos do Shopify são importados antes de você conectar a Braze — eventos de pedidos dos últimos 90 dias e dados de clientes do último ano. Ambos os períodos são contados a partir da data em que você concluiu sua integração.

Por meio da configuração de integração padrão do Shopify ou da configuração de integração personalizada do Shopify, você pode ativar o preenchimento de dados históricos para incluir clientes e pedidos anteriores em segmentos, Campaigns e Canvas. Isso importa seus pedidos do Shopify (eventos relacionados a pedidos) dos últimos 90 dias e perfis de usuários do último ano. Ambos os períodos são contados a partir da data em que você concluiu sua integração.

Quando a Braze importa seus clientes do Shopify, ela atribui o tipo de external_id que você escolheu nas configurações.

Nota

Se você já é cliente da Braze com Campaigns ou Canvas ativos, revise como os clientes importados e os eventos de pedidos afetam seus Segments e jornadas antes de ativar o preenchimento de dados históricos. O preenchimento de dados históricos não atualiza retroativamente usuários que já estão em Campaigns ou Canvas ativos.

Se você planeja integrar com um ID externo personalizado (seja para a integração padrão ou para a integração personalizada), será necessário adicionar seu ID externo personalizado como um metacampo de cliente da Shopify a todos os perfis de clientes existentes da Shopify e, em seguida, realizar o backfill histórico.

Como a Braze seleciona dados históricos

A Braze usa estes campos de data do Shopify quando a carga inicial é executada:

Se você migrar pedidos históricos para o Shopify e mantiver as datas de criação originais, a Braze importará apenas os pedidos criados nos últimos 90 dias.

Configurando o preenchimento de dados históricos do Shopify

1. Ative o preenchimento de dados históricos na etapa Track Shopify data.

2. Após concluir a configuração da integração, a Braze iniciará a sincronização inicial de dados. Você pode acompanhar o progresso na guia Shopify Data das configurações da integração.

Velocidade e tempo de sincronização do preenchimento

O preenchimento de dados históricos é realizado pela integração da Braze com o Shopify — não pelo SDK da Braze — e começa automaticamente quando você conclui a configuração da integração.

Após ativar o preenchimento de dados históricos, a Braze importa eventos de pedidos e perfis de clientes do Shopify em lotes. Eventos de pedidos e perfis de clientes são sincronizados em cronogramas separados, então um pode ser concluído antes do outro.

O tempo de sincronização depende do volume de dados históricos na sua loja. Lojas com alto volume de pedidos ou grandes bases de clientes podem levar mais tempo para concluir o preenchimento. Não é possível alterar a velocidade do preenchimento ou solicitar uma sincronização mais rápida.

Dados sincronizados

Para a sincronização inicial de dados, a Braze importa os eventos de pedidos e perfis de usuários descritos em Como a Braze seleciona dados históricos. Quando a Braze importa seus clientes do Shopify, ela atribui o tipo de external_id que você escolheu nas configurações.

A tabela a seguir resume os dados incluídos nessa carga inicial.