Recursos de dados da Shopify
Este artigo fornece uma visão geral dos nossos recursos da Shopify, incluindo quais dados da Shopify são rastreados e exemplos de cargas úteis, backfill histórico e sincronizações de produtos.
Eventos da Shopify rastreados
A integração da Shopify usa eventos recomendados de eCommerce para capturar os principais comportamentos de compra. Para ver exemplos de implementação e estratégias de marketing usando esses eventos, consulte Casos de uso de eCommerce.
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.
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"
}
}
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 da 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 você precisa adicionar a Liquid tag inicial do carrinho de compras para obter o contexto do carrinho na sua mensagem.
1
{% shopping_cart {{context.${cart_id}}} %}
Em seguida, você pode adicionar as seguintes Liquid tags do carrinho de compras na 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> }} |
Para saber mais sobre como criar um loop Liquid for para adicionar dinamicamente todos os produtos ao 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
Se um cliente usar o Shop Pay como opção de checkout acelerado, a Shopify pode ignorar determinados eventos padrão de checkout (como o webhook de checkout iniciado da 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 você precisa usar a seguinte Liquid tag:
1
2
{% shopping_cart {{context.${cart_id}}} :abort_if_not_abandoned false %}
{{context.${cart_id}}}
Em seguida, você pode adicionar as seguintes Liquid tags na sua mensagem para referenciar os produtos do 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 o processo de checkout e faz 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}} |
O webhook de checkout concluído da Shopify não contém URLs de produtos nem URLs de imagens. Por isso, você precisa usar a personalização Liquid de Catálogos, conforme mencionado 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 confirmado | {{event_properties.${confirmed}}} |
| URL de status do pedido | {{event_properties.${order_status_url}}} |
| Número do pedido | {{event_properties.${order_number}}} |
| Carimbo de data/hora de cancelamento | {{event_properties.${cancelled_at}}} |
| Carimbo de data/hora 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 da remessa | {{event_properties.${shipping}[0].title}} |
| Preço da remessa | {{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}} |
| Empresa de rastreamento 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 do 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 confirmado | {{event_properties.${confirmed}}} |
| URL de status do pedido | {{event_properties.${order_status_url}}} |
| Número do pedido | {{event_properties.${order_number}}} |
| Carimbo de data/hora de cancelamento | {{event_properties.${cancelled_at}}} |
| Carimbo de data/hora 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 da remessa | {{event_properties.${shipping}[0].title}} |
| Preço da remessa | {{event_properties.${shipping}[0].price}} |
| Status de processamento | {{event_properties.${fulfillment_status}}} |
| Status de envio do processamento | {{event_properties.${fulfillments}[0].shipment_status}} |
| Status de processamento | {{event_properties.${fulfillments}[0].status}} |
| Empresa de rastreamento 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 do 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 na 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 confirmado | {{event_properties.${confirmed}}} |
| URL de status do pedido | {{event_properties.${order_status_url}}} |
| Número do pedido | {{event_properties.${order_number}}} |
| Carimbo de data/hora 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 da remessa | {{event_properties.${shipping}[0].title}} |
| Preço da remessa | {{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: shopify_cancelled_order
Tipo: Evento personalizado
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}}} |
| Carimbo de data/hora 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 da remessa | {{event_properties.${shipping}[0].title}} |
| Preço da remessa | {{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: shopify_order_refunded
Tipo: Evento personalizado
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}}} |
A integração da Shopify atualmente não oferece suporte ao preenchimento do evento de compra da Braze. Como resultado, os filtros de compra, as Liquid tags, os disparos baseados em ação e a análise de dados devem usar o evento ecommerce.order_placed.
Atributos personalizados compatíveis da Shopify
Todos os atributos são originados da REST API da Braze.
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 em todo o seu 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. Está diretamente relacionado ao campo name no recurso do 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. |
Um problema conhecido na versão atual da API da Shopify impede que o atributo de usuário shopify_last_order_name seja preenchido corretamente. O impacto sobre os usuários é o seguinte:
- Usuários existentes: Para qualquer usuário que já tenha um valor para
shopify_last_order_name, esse valor persiste, mas não é atualizado pelos pedidos subsequentes. - Novos usuários: Para todos os novos usuários, o campo não é preenchido e permanece vazio ou nulo.
Esta página será atualizada depois que a Shopify resolver esse problema.
Personalização Liquid
Para adicionar personalização Liquid aos seus atributos personalizados da Shopify, selecione + Personalization. Em seguida, selecione Custom Attributes como tipo de personalização.
Depois de selecionar seu atributo personalizado, insira um valor padrão e copie o snippet Liquid na sua mensagem.
Atributos padrão compatíveis da Shopify
Todos os atributos são originados da REST API da Braze.
- Nome
- Sobrenome
- Telefone
- Cidade
- País
A Braze só atualiza os atributos personalizados compatíveis da Shopify e os atributos padrão da Braze quando há uma diferença nos dados em relação ao perfil de usuário existente. Por exemplo, se os dados recebidos da Shopify contiverem o nome “Bob” e “Bob” já existir como nome no perfil de usuário da Braze, a Braze não dispara uma atualização e você não é cobrado por 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.
Backfill histórico
Os dados históricos da Shopify são importados de 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 a integração.
Por meio da configuração de integração padrão da Shopify ou da configuração de integração personalizada da Shopify, você pode ativar o backfill histórico para direcionar clientes anteriores. Isso importa seus pedidos da Shopify (eventos relacionados a pedidos) dos últimos 90 dias e perfis de usuário do último ano. Ambos os períodos são contados a partir da data em que você concluiu a integração.
Quando a Braze importa seus clientes da Shopify, ela atribui o tipo de external_id que você escolheu nas suas configurações.
Se você já é cliente da Braze com Campaigns ou Canvas ativos, revise como os clientes importados e os eventos de pedidos afetam seus segmentos e jornadas antes de ativar o backfill histórico.
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.
Configuração do backfill histórico da Shopify
- Ative o backfill histórico na etapa Track Shopify data.
- Depois de concluir a configuração da integração, a Braze iniciará a sincronização inicial dos dados. Você pode monitorar o progresso na guia Shopify Data das suas configurações de integração.
Dados sincronizados
Na sincronização inicial de dados, a Braze importa eventos de pedidos dos últimos 90 dias e perfis de usuário do último ano, cada um contado a partir da data em que você concluiu a integração. Quando a Braze importa seus clientes da Shopify, ela atribui o tipo de external_id que você escolheu nas suas configurações.
A tabela a seguir resume os dados incluídos nessa carga inicial.
| Eventos recomendados da Braze | Eventos personalizados da Shopify | Atributos padrão da Braze | Status de inscrição da Braze |
|---|---|---|---|
|
|
|
|