Recursos de dados do Shopify
Este artigo fornece uma visão geral dos nossos recursos do Shopify, incluindo quais dados do Shopify são rastreados e exemplos de cargas úteis, preenchimento histórico e sincronizações de produtos.
Eventos rastreados do Shopify
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
Acionado: Quando um cliente visualiza uma página de produto
Caso de Uso: Abandono de navegação
| Variável | Modelagem 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
Acionado: Quando um cliente adiciona, remove ou atualiza seu carrinho de compras
Caso de Uso: Abandono de carrinho
Para Canvases de Carrinho Abandonado, você primeiro 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}}} %}
Então você pode adicionar as seguintes tags Liquid do carrinho de compras em sua mensagem.
| Variável | Modelagem 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> }} |
tip:
Para saber mais sobre como construir 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
Acionado: Quando um cliente adiciona, remove ou atualiza seu carrinho de compras
Caso de Uso: Abandono de checkout
Para Canvases de Checkout Abandonado, você primeiro precisa usar a seguinte tag Liquid:
1
2
{% shopping_cart {{context.${cart_id}}} :abort_if_not_abandoned false %}
{{context.${cart_id}}}
Então você pode adicionar as seguintes tags Liquid na sua mensagem para referenciar os produtos dentro do seu carrinho no momento do checkout.
| Variável | Modelagem 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
Acionado: Quando um usuário completa com sucesso o processo de checkout e faz um pedido
Caso de Uso: Confirmação de pedido, redirecionamento pós-compra, upsells ou cross-sells
| Variável | Modelagem 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}} |
tip:
O webhook de finalização de checkout do Shopify não contém URLs de produtos ou URLs de imagens. Como resultado, você precisa usar a personalização de Catálogos Liquid conforme mencionado em Personalização de produtos de carrinho abandonado para e-mails.
Evento: shopify_fulfilled_order
Tipo: Evento personalizado
Acionado: Quando o pedido de um usuário é atendido e está pronto para envio
Caso de Uso: (Transacional) Atualização de atendimento
| Variável | Modelagem 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
Acionado: Quando parte do pedido de um usuário é atendida e está pronta para envio
Caso de Uso: (Transacional) Atualização de atendimento
| Variável | Modelagem 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
Acionado: Quando o pedido de um usuário é marcado como pago dentro do Shopify
Caso de Uso: (Transacional) Confirmação de pagamento
| Variável | Modelagem 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
Acionado: Quando o pedido de um usuário é cancelado
Caso de Uso: (Transacional) Confirmação de cancelamento de pedido
| Variável | Modelagem 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
Acionado: Quando o pedido de um usuário é reembolsado
Caso de Uso: (Transacional) Confirmação de reembolso
| Variável | Modelagem 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
Acionado: Quando um usuário faz login em sua conta
Caso de Uso: Série de boas-vindas
| Variável | Modelagem Liquid |
|---|---|
source |
{{event_properties.${source}}} |
note:
A integração do Shopify atualmente não suporta a população do evento de compra do Braze. Como resultado, filtros de compra, tags Liquid, gatilhos baseados em ações e análise de dados devem usar o evento ecommerce.pedido_realizado.
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. |
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
note:
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, veja 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 através de preenchimento histórico para engajar imediatamente seus clientes. Como parte desse preenchimento, o Braze realizará uma sincronização inicial de todos os clientes e pedidos realizados nos últimos 90 dias antes da conexão da sua integração Shopify. Quando o Braze importa seus clientes do Shopify, nós iremos atribuir o tipo external_id que você escolheu nas configurações de configuração.
note:
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 metafield de cliente Shopify a todos os perfis de clientes Shopify existentes e, em seguida, realizar o preenchimento histórico.
Configurando o preenchimento histórico do Shopify
- Ative o preenchimento histórico na etapa Rastrear dados do Shopify.
- Após concluir a configuração da sua integração, o Braze começará a sincronização inicial de dados. Você pode monitorar o progresso na aba Dados do Shopify das configurações da sua integração.
Dados sincronizados
Para a sincronização inicial de dados, o Braze importará clientes e pedidos realizados nos últimos 90 dias antes da conexão da sua integração Shopify. Quando o Braze importa seus clientes do Shopify, ele irá atribuir o tipo external_id que você escolheu nas configurações de configuração.
Editar esta página no GitHub
QUÃO ÚTIL FOI ESTA PÁGINA?
New Stuff!