Recursos de dados da Shopify
Este artigo fornece uma visão geral de nossos recursos do Shopify, incluindo quais dados do Shopify são rastreados e exemplos de cargas úteis, backfill histórico e sincronizações de produtos.
Eventos do Shopify rastreados
A integração do Shopify usa eventos recomendados de comércio eletrônico para capturar os principais comportamentos de compras. Para obter exemplos de implementação e estratégias de marketing usando esses eventos, consulte os casos de uso de comércio eletrônico.
A integração Shopify suporta webhooks de criação e atualização de clientes Shopify, que estão localizados nas configurações de configuração 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 habilitado em 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
{
"name": "ecommerce.checkout_started",
"time": "2022-05-23T13:52:38-04:00",
"properties": {
"cart_id": "eeafa272cebfd4b22385bc4b645e762c",
"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",
"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
{
"name": "ecommerce.order_placed",
"time": "2022-05-23T13:52:38-04:00",
"properties": {
"order_id": "820982911946154508",
"cart_id": "eeafa272cebfd4b22385bc4b645e762c",
"total_value": 421.88,
"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
{
"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,
"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
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 de 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
Caso de uso: Abandono de carrinho
Para as telas de carrinho abandonado, primeiro você precisa adicionar a tag Liquid do carrinho de compras inicial para obter o contexto do carrinho de compras em sua mensagem.
1
{% shopping_cart {{context.${cart_id}}} %}
Em seguida, você pode adicionar as seguintes tags Liquid do carrinho de compras em 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 do 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
Caso de uso: Abandono do checkout
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 tags Liquid à sua mensagem para fazer referência aos 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 com êxito o processo de checkout e faz um pedido
Caso de uso: Confirmação de pedidos, redirecionamento pós-compra, upsells ou cross-sells
| Variável | Modelo Liquid |
| |————————- | —————————————————– |
| cart_id | {{event_properties.${cart_id}}} |
| moeda | {{event_properties.${currency}}} |
| descontos | {{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}} |
| quantidade | {{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 ou URLs de imagens. Como resultado, você precisa usar a personalização do Catalogs Liquid, 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 é atendido e está pronto para envio
Caso de uso: Atualização do cumprimento (transacional)
| 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}}} |
|
| Cancelamento de registro de data e hora | {{event_properties.${cancelled_at}}} |
|
| Fechado | Carimbo de data/hora | {{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 de remessa | {{event_properties.${shipping}[0].price}} |
|
| Status de cumprimento | {{event_properties.${fulfillment_status}}} |
|
| Status do envio do processamento | {{event_properties.${fulfillments}[0].shipment_status}} |
|
| Status | {{event_properties.${fulfillments}[0].status}} |
|
| Empresa de rastreamento de cumprimento | {{event_properties.${fulfillments}[0].Fulfillment tracking_company}} |
|
| Número de rastreamento do cumprimento | {{event_properties.${fulfillments}[0].Fulfillment tracking_number}} |
|
| Números de rastreamento de cumprimento | {{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 cumprimento | {{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 de atendimento | {{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 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 é atendida e está pronta para envio
Caso de uso: Atualização do cumprimento (transacional)
| 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}}} |
|
| Cancelamento de registro de data e hora | {{event_properties.${cancelled_at}}} |
|
| Fechado | Carimbo de data/hora | {{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 de remessa | {{event_properties.${shipping}[0].price}} |
|
| Status de cumprimento | {{event_properties.${fulfillment_status}}} |
|
| Status do envio do processamento | {{event_properties.${fulfillments}[0].shipment_status}} |
|
| Status de cumprimento | {{event_properties.${fulfillments}[0].status}} |
|
| Empresa de rastreamento de cumprimento | {{event_properties.${fulfillments}[0].tracking_company}} |
|
| Número de rastreamento do cumprimento | {{event_properties.${fulfillments}[0].tracking_number}} |
|
| Números de rastreamento de cumprimento | {{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 cumprimento | {{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 de atendimento | {{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 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
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}}} |
| Cancelamento de registro de data e hora | {{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 de remessa | {{event_properties.${shipping}[0].price}} |
| ID da variante | {{event_properties.${line_items}[0].variant_id}} |
| Título variante | {{event_properties.${line_items}[0].variant_title}} |
Evento: shopify_cancelled_order
Tipo: Evento personalizado
Disparado: Quando o pedido de um usuário é cancelado
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}}} |
| Cancelamento de registro de data e hora | {{event_properties.${cancelled_at}}} |
| Tags | {{event_properties.${tags}}} |
| Códigos de desconto | {{event_properties.${discount_codes}}} |
| Status de cumprimento | {{event_properties.${fulfillment_status}}} |
| Cumprimentos | {{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 cumprimento | {{event_properties.${line_items}[0].fulfillment_status}} |
| Título da remessa | {{event_properties.${shipping}[0].title}} |
| Preço de remessa | {{event_properties.${shipping}[0].price}} |
| ID da variante | {{event_properties.${line_items}[0].variant_id}} |
| Título variante | {{event_properties.${line_items}[0].variant_title}} |
Evento: shopify_order_refunded
Tipo: Evento personalizado
Disparado: Quando o pedido de um usuário é reembolsado
Caso de uso: (Transacional) Confirmação de reembolso
| Variável | Modelo Liquid |
|---|---|
| ID do pedido | {{event_properties.${order_id}}} |
| Nota de 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 variante | {{event_properties.${line_items}[0].variant_title}} |
Evento: shopify_account_login
Tipo: Evento personalizado
Disparado: Quando um usuário registra sua conta
Caso de uso: Série de boas-vindas
| Variável | Modelo Liquid |
|---|---|
source |
{{event_properties.${source}}} |
A integração com o Shopify atualmente não suporta o preenchimento do evento de compra do 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 com a 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 | Nome do atributo | Descrição |
|---|---|---|---|
shopify_total_spent O valor total que o cliente gastou no histórico de pedidos. |
|||
shopify_order_count |
O número de pedidos associados a esse cliente. Os pedidos de teste e arquivados não são considerados. | ||
shopify_last_order_id |
O ID do último pedido do cliente. | ||
shopify_last_order_name |
O nome do último pedido do cliente. Isso está diretamente relacionado ao campo name no recurso do pedido. |
||
shopify_zipcode |
O código postal do cliente do endereço padrão. | ||
shopify_province A província do cliente a partir de seu endereço padrão. |
Um problema conhecido com a versão atual da API do 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 a personalização Liquid aos seus atributos personalizados da Shopify, selecione + Personalização. Em seguida, selecione Atributos personalizados como seu tipo de personalização.
Depois de selecionar seu atributo personalizado, insira um valor padrão e cole o snippet do Liquid na sua mensagem.
Atribuições padrão compatíveis com o Shopify
- Nome
- Sobrenome
- Telefone
- Cidade
- País
A Braze só atualizará os atributos personalizados compatíveis da Shopify e os atributos padrão da Braze se houver uma diferença nos dados do perfil do usuário existente. Por exemplo, se os dados de entrada do Shopify contiverem um primeiro nome de Bob e Bob já existir como um primeiro nome no perfil de usuário do Braze, o 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 do Braze, consulte Coleta de dados do SDK.
Provisionamento de dados históricos
Durante a integração da sua loja Shopify, você pode iniciar uma sincronização inicial de dados por meio do backfill histórico para interagir imediatamente com seus clientes. Como parte desse backfill, o Braze executará uma sincronização inicial de dados de todos os clientes e pedidos feitos nos últimos 90 dias antes de sua conexão de integração com o Shopify. Quando o Braze importar seus clientes do Shopify, atribuiremos o tipo de external_id que você escolheu em suas definições de configuração.
Se você planeja integrar com um ID externo personalizado (para a integração padrão ou 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 preenchimento retroativo histórico.
Configuração do backfill histórico da Shopify
- Ative o backfill histórico na etapa Rastrear dados do Shopify.
- Depois de concluir a configuração da integração, o Braze iniciará a sincronização inicial dos dados. Você pode monitorar o progresso na guia Shopify Data de suas configurações de integração.
Dados sincronizados
Para a sincronização inicial de dados, o Braze importará os clientes e os pedidos feitos nos últimos 90 dias antes de sua conexão de integração com o Shopify. Quando o Braze importar seus clientes do Shopify, ele atribuirá o tipo de external_id que você escolheu em suas definições de configuração.
Editar esta página no GitHub