Características de los datos de Shopify

Este artículo ofrece un resumen de las características de Braze para Shopify, incluyendo qué datos de Shopify se rastrean, ejemplos de cargas útiles, backfill histórico y sincronización de productos.

Eventos de Shopify con seguimiento

La integración de Shopify utiliza eventos de eCommerce recomendados para capturar comportamientos de compra clave. Para ejemplos de implementación y estrategias de marketing que utilizan estos eventos, consulta ejemplos de eCommerce.

Importante

La integración con Shopify admite webhooks de creación y actualización de clientes de Shopify, que se encuentran en la configuración de datos. Cuando se crea o actualiza un perfil de usuario en Shopify, se creará o actualizará el perfil de usuario correspondiente en Braze.

Estas acciones no desencadenan eventos personalizados en Braze y se utilizan únicamente para sincronizar los datos de usuario de Shopify con Braze. Los datos sincronizados incluyen atributos personalizados, atributos estándar y, si están habilitados en tu configuración, estados de grupos de suscripción.

• carga útil de ejemplo
• eventos de 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

Braze depende de Shopify para proporcionar las propiedades de evento requeridas (como cart_id o cart_token) para los eventos de eCommerce. En casos excepcionales, problemas temporales con Shopify pueden provocar que estas propiedades no se reciban, lo que puede causar que los eventos afectados se descarten.

• 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
Se desencadena: Cuando un cliente visita la página de un producto
Origen de datos: SDK de Braze
Ejemplo: Abandono de navegación

Variable	Plantilla 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}}} Agrega el dominio de tu sitio Shopify antes de la 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
Se desencadena: Cuando un cliente agrega, elimina o actualiza su carrito de compras
Origen de datos: SDK de Braze
Ejemplo: Abandono del carrito de compras

Para los Canvas de carrito abandonado, primero debes agregar la etiqueta Liquid inicial del carrito de compras para obtener contexto del carrito en tu mensaje.

1

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

Luego puedes agregar las siguientes etiquetas Liquid del carrito de compras en tu mensaje.

Variable	Plantilla 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> }}

Consejo

Para obtener más información sobre cómo crear un bucle for de Liquid para agregar dinámicamente todos los productos a tu correo electrónico, consulta Personalización de productos del carrito abandonado para correos electrónicos.

Evento: ecommerce.checkout_started
Tipo: Evento recomendado
Se desencadena: Cuando un usuario navega a la página de pago
Origen de datos: REST API de Braze
Ejemplo: Abandono de pago

Importante

Si un cliente utiliza Shop Pay como opción de pago acelerado, Shopify puede omitir ciertos eventos estándar de pago (como el webhook de inicio de pago de Shopify). Esto significa que Braze puede no recibir los datos necesarios para agregar el alias del token de pago, lo que puede afectar el seguimiento de abandono de pago y la reconciliación del perfil de usuario.

Para los Canvas de abandono de pago, primero debes utilizar la siguiente etiqueta Liquid:

1
2

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

Luego puedes agregar las siguientes etiquetas Liquid en tu mensaje para hacer referencia a los productos en tu carrito en el momento del pago.

Variable	Plantilla 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
Se desencadena: Cuando un usuario completa correctamente el proceso de pago y realiza un pedido
Origen de datos: REST API de Braze
Ejemplo: Confirmación de pedido, reorientación posterior a la compra, ventas adicionales o ventas cruzadas

Variable	Plantilla 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}}

Consejo

El webhook de pago completado de Shopify no incluye URL de productos ni URL de imágenes. Como resultado, debes utilizar la personalización con Liquid de catálogos como se menciona en Personalización de productos del carrito abandonado para correos electrónicos.

Evento: shopify_fulfilled_order
Tipo: Evento personalizado
Se desencadena: Cuando el pedido de un usuario se cumple y está listo para el envío
Origen de datos: REST API de Braze
Ejemplo: (Transaccional) Actualización de cumplimiento

Variable	Plantilla Liquid
ID de pedido	{{event_properties.${order_id}}}
Precio total	{{event_properties.${total_price}}}
Descuentos totales	{{event_properties.${total_discounts}}}
Estado de confirmación	{{event_properties.${confirmed}}}
URL del estado del pedido	{{event_properties.${order_status_url}}}
Número de pedido	{{event_properties.${order_number}}}
Marca de tiempo de cancelación	{{event_properties.${cancelled_at}}}
Marca de tiempo de cierre	{{event_properties.${closed_at}}}
ID de artículo	{{event_properties.${line_items}[0].product_id}}
Cantidad de artículo	{{event_properties.${line_items}[0].quantity}}
SKU de artículo	{{event_properties.${line_items}[0].sku}}
Título de artículo	{{event_properties.${line_items}[0].title}}
Proveedor de artículo	{{event_properties.${line_items}[0].vendor}}
Nombre de artículo	{{event_properties.${line_items}[0].name}}
Propiedades de artículo	{{event_properties.${line_items}[0].properties}}
Precio de artículo	{{event_properties.${line_items}[0].price}}
Título de envío	{{event_properties.${shipping}[0].title}}
Precio de envío	{{event_properties.${shipping}[0].price}}
Estado de cumplimiento	{{event_properties.${fulfillment_status}}}
Estado de envío de cumplimiento	{{event_properties.${fulfillments}[0].shipment_status}}
Estado	{{event_properties.${fulfillments}[0].status}}
Empresa de seguimiento de cumplimiento	{{event_properties.${fulfillments}[0].Fulfillment tracking_company}}
Número de seguimiento de cumplimiento	{{event_properties.${fulfillments}[0].Fulfillment tracking_number}}
Números de seguimiento de cumplimiento	{{event_properties.${fulfillments}[0].Fulfillment tracking_numbers}}
URL de seguimiento de cumplimiento	{{event_properties.${fulfillments}[0].Fulfillment tracking_url}}
URL de seguimiento de cumplimiento	{{event_properties.${fulfillments}[0].Fulfillment tracking_urls}}
Estado de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
Nombre de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].name}}
Precio de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].price}}
ID de producto de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Cantidad de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Envío de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
SKU de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Título de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].title}}
Proveedor de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
ID de variante	{{event_properties.${line_items}[0].variant_id}}
Título de variante	{{event_properties.${line_items}[0].variant_title}}

Evento: shopify_partially_fulfilled_order
Tipo: Evento personalizado
Se desencadena: Cuando parte del pedido de un usuario se cumple y está listo para el envío
Origen de datos: REST API de Braze
Ejemplo: (Transaccional) Actualización de cumplimiento

Variable	Plantilla Liquid
ID de pedido	{{event_properties.${order_id}}}
Precio total	{{event_properties.${total_price}}}
Descuentos totales	{{event_properties.${total_discounts}}}
Estado de confirmación	{{event_properties.${confirmed}}}
URL del estado del pedido	{{event_properties.${order_status_url}}}
Número de pedido	{{event_properties.${order_number}}}
Marca de tiempo de cancelación	{{event_properties.${cancelled_at}}}
Marca de tiempo de cierre	{{event_properties.${closed_at}}}
ID de artículo	{{event_properties.${line_items}[0].product_id}}
Cantidad de artículo	{{event_properties.${line_items}[0].quantity}}
SKU de artículo	{{event_properties.${line_items}[0].sku}}
Título de artículo	{{event_properties.${line_items}[0].title}}
Proveedor de artículo	{{event_properties.${line_items}[0].vendor}}
Nombre de artículo	{{event_properties.${line_items}[0].name}}
Propiedades de artículo	{{event_properties.${line_items}[0].properties}}
Precio de artículo	{{event_properties.${line_items}[0].price}}
Título de envío	{{event_properties.${shipping}[0].title}}
Precio de envío	{{event_properties.${shipping}[0].price}}
Estado de cumplimiento	{{event_properties.${fulfillment_status}}}
Estado de envío de cumplimiento	{{event_properties.${fulfillments}[0].shipment_status}}
Estado de cumplimiento	{{event_properties.${fulfillments}[0].status}}
Empresa de seguimiento de cumplimiento	{{event_properties.${fulfillments}[0].tracking_company}}
Número de seguimiento de cumplimiento	{{event_properties.${fulfillments}[0].tracking_number}}
Números de seguimiento de cumplimiento	{{event_properties.${fulfillments}[0].tracking_numbers}}
URL de seguimiento de cumplimiento	{{event_properties.${fulfillments}[0].tracking_url}}
URL de seguimiento de cumplimiento	{{event_properties.${fulfillments}[0].tracking_urls}}
Estado de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
Nombre de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].name}}
Precio de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].price}}
ID de producto de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Cantidad de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Envío de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
SKU de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Título de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].title}}
Proveedor de cumplimiento	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
ID de variante	{{event_properties.${line_items}[0].variant_id}}
Título de variante	{{event_properties.${line_items}[0].variant_title}}

Evento: shopify_paid_order
Tipo: Evento personalizado
Se desencadena: Cuando el pedido de un usuario se marca como pagado en Shopify
Origen de datos: REST API de Braze
Ejemplo: (Transaccional) Confirmación de pago

Variable	Plantilla Liquid
ID de pedido	{{event_properties.${order_id}}}
Estado de confirmación	{{event_properties.${confirmed}}}
URL del estado del pedido	{{event_properties.${order_status_url}}}
Número de pedido	{{event_properties.${order_number}}}
Marca de tiempo de cancelación	{{event_properties.${cancelled_at}}}
Descuentos totales	{{event_properties.${total_discounts}}}
Precio total	{{event_properties.${total_price}}}
Etiquetas	{{event_properties.${tags}}}
Códigos de descuento	{{event_properties.${discount_codes}}}
ID de artículo	{{event_properties.${line_items}[0].product_id}}
Cantidad de artículo	{{event_properties.${line_items}[0].quantity}}
SKU de artículo	{{event_properties.${line_items}[0].sku}}
Título de artículo	{{event_properties.${line_items}[0].title}}
Proveedor de artículo	{{event_properties.${line_items}[0].vendor}}
Propiedades de artículo	{{event_properties.${line_items}[0].properties}}
Precio de artículo	{{event_properties.${line_items}[0].price}}
Título de envío	{{event_properties.${shipping}[0].title}}
Precio de envío	{{event_properties.${shipping}[0].price}}
ID de variante	{{event_properties.${line_items}[0].variant_id}}
Título de variante	{{event_properties.${line_items}[0].variant_title}}

Evento: ecommerce.order_cancelled
Tipo: Evento recomendado
Se desencadena: Cuando se cancela el pedido de un usuario
Origen de datos: REST API de Braze
Ejemplo: (Transaccional) Confirmación de cancelación de pedido

Variable	Plantilla Liquid
ID de pedido	{{event_properties.${order_id}}}
Precio total	{{event_properties.${total_price}}}
Descuentos totales	{{event_properties.${total_discounts}}}
Confirmado	{{event_properties.${confirmed}}}
URL del estado del pedido	{{event_properties.${order_status_url}}}
Número de pedido	{{event_properties.${order_number}}}
Marca de tiempo de cancelación	{{event_properties.${cancelled_at}}}
Etiquetas	{{event_properties.${tags}}}
Códigos de descuento	{{event_properties.${discount_codes}}}
Estado de cumplimiento	{{event_properties.${fulfillment_status}}}
Cumplimientos	{{event_properties.${fulfillments}}}
ID de artículo	{{event_properties.${line_items}[0].product_id}}
Cantidad de artículo	{{event_properties.${line_items}[0].quantity}}
SKU de artículo	{{event_properties.${line_items}[0].sku}}
Título de artículo	{{event_properties.${line_items}[0].title}}
Proveedor de artículo	{{event_properties.${line_items}[0].vendor}}
Nombre de artículo	{{event_properties.${line_items}[0].name}}
Propiedades de artículo	{{event_properties.${line_items}[0].properties}}
Estado de cumplimiento	{{event_properties.${line_items}[0].fulfillment_status}}
Título de envío	{{event_properties.${shipping}[0].title}}
Precio de envío	{{event_properties.${shipping}[0].price}}
ID de variante	{{event_properties.${line_items}[0].variant_id}}
Título de variante	{{event_properties.${line_items}[0].variant_title}}

Evento: ecommerce.order_refunded
Tipo: Evento recomendado
Se desencadena: Cuando se reembolsa el pedido de un usuario
Origen de datos: REST API de Braze
Ejemplo: (Transaccional) Confirmación de reembolso

Variable	Plantilla Liquid
ID de pedido	{{event_properties.${order_id}}}
Nota del pedido	{event_properties.${note}}}
ID de artículo	{{event_properties.${line_items}[0].product_id}}
Cantidad de artículo	{{event_properties.${line_items}[0].quantity}}
SKU de artículo	{{event_properties.${line_items}[0].sku}}
Título de artículo	{{event_properties.${line_items}[0].title}}
Proveedor de artículo	{{event_properties.${line_items}[0].vendor}}
Nombre de artículo	{{event_properties.${line_items}[0].name}}
Propiedades de artículo	{{event_properties.${line_items}[0].properties}}
Precio de artículo	{{event_properties.${line_items}[0].price}}
ID de variante	{{event_properties.${line_items}[0].variant_id}}
Título de variante	{{event_properties.${line_items}[0].variant_title}}

Evento: shopify_account_login
Tipo: Evento personalizado
Se desencadena: Cuando un usuario inicia sesión en su cuenta
Origen de datos: REST API de Braze
Ejemplo: Serie de bienvenida

Variable	Plantilla Liquid
source	{{event_properties.${source}}}

Nota

La integración de Shopify actualmente no admite la generación del evento de compra de Braze. Como resultado, los filtros de compra, las etiquetas Liquid, los desencadenadores basados en acciones y los análisis deben utilizar el evento ecommerce.order_placed.

Atributos personalizados de Shopify compatibles

Nota

Todos los atributos provienen de la REST API de Braze.

• example payload
• shopify custom attributes

• shopify tags

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"
    }
  ]
}

Nombre del atributo	Descripción
shopify_total_spent	La cantidad total de dinero que el cliente ha gastado en todo su historial de pedidos.
shopify_order_count	El número de pedidos asociados a este cliente. Los pedidos de prueba y archivados no se cuentan.
shopify_last_order_id	El ID del último pedido del cliente.
shopify_last_order_name	El nombre del último pedido del cliente. Está directamente relacionado con el campo name en el recurso de pedido.
shopify_zipcode	El código postal del cliente desde su dirección predeterminada.
shopify_province	La provincia del cliente desde su dirección predeterminada.

Importante

Un problema conocido con la versión actual de la API de Shopify impide que el atributo de usuario shopify_last_order_name se complete correctamente. El impacto en los usuarios es el siguiente:

• Usuarios existentes: Para cualquier usuario que ya tenga un valor para shopify_last_order_name, ese valor persiste pero no se actualiza con pedidos posteriores.
• Usuarios nuevos: Para cualquier usuario nuevo, el campo no se completa y permanece vacío o nulo.

Esta página se actualizará después de que Shopify resuelva este problema.

Personalización con Liquid

Para añadir personalización con Liquid para tus atributos personalizados de Shopify, selecciona + Personalización. Luego selecciona Atributos personalizados como tu tipo de personalización.

Después de seleccionar tu atributo personalizado, introduce un valor predeterminado y copia el fragmento de código Liquid en tu mensaje.

Atributos estándar de Shopify compatibles

Nota

Todos los atributos provienen de la REST API de Braze.

• Correo electrónico
• Nombre
• Apellido
• Teléfono
• Ciudad
• País

Nota

Braze solo actualizará los atributos personalizados de Shopify compatibles y los atributos estándar de Braze si hay una diferencia en los datos con respecto al perfil de usuario existente. Por ejemplo, si los datos entrantes de Shopify contienen un nombre de Bob y Bob ya existe como nombre en el perfil de usuario de Braze, Braze no activará una actualización y no se te cobrará un punto de datos.

Recopilación de datos del SDK

Para obtener más información sobre los datos que recopilan los SDK de Braze, consulta Recopilación de datos del SDK.

Rellenado histórico

Los datos históricos de Shopify se importan antes de conectar Braze: eventos de pedidos de los últimos 90 días y datos de clientes del último año. Ambos plazos se cuentan a partir de la fecha en que completas tu integración.

A través de la configuración de integración estándar de Shopify o la configuración de integración personalizada de Shopify, puedes activar el rellenado histórico para incluir clientes y pedidos anteriores en Segments, Campaigns y Canvas. Esto importa tus pedidos de Shopify (eventos relacionados con pedidos) de los últimos 90 días y perfiles de usuario del último año. Ambos plazos se cuentan a partir de la fecha en que completas tu integración.

Cuando Braze importa tus clientes de Shopify, asigna el tipo de external_id que elegiste en tu configuración.

Nota

Si ya eres cliente de Braze con Campaigns o Canvas activos, revisa cómo los clientes importados y los eventos de pedidos afectan tus Segments y recorridos antes de habilitar el rellenado histórico. El rellenado histórico no actualiza retroactivamente a los usuarios que ya están en Campaigns o Canvas activos.

Si planeas integrar con un ID externo personalizado (ya sea para la integración estándar o la integración personalizada), deberás añadir tu ID externo personalizado como metacampo de cliente de Shopify a todos los perfiles de clientes de Shopify existentes y, a continuación, realizar el backfill histórico.

Cómo selecciona Braze los datos históricos

Braze utiliza estos campos de fecha de Shopify cuando se ejecuta la carga inicial:

Si migras pedidos históricos a Shopify y conservas sus fechas de creación originales, Braze solo importa los pedidos creados en los últimos 90 días.

Configurar el rellenado histórico de Shopify

1. Activa el rellenado histórico en el paso Track Shopify data.

2. Después de completar la configuración de tu integración, Braze comenzará la sincronización inicial de datos. Puedes monitorear el progreso en la pestaña Shopify Data de la configuración de tu integración.

Velocidad y tiempos de sincronización del rellenado

El rellenado histórico lo realiza la integración de Shopify de Braze, no el SDK de Braze, y comienza automáticamente cuando completas la configuración de la integración.

Después de habilitar el rellenado histórico, Braze importa eventos de pedidos y perfiles de clientes desde Shopify en lotes. Los eventos de pedidos y los perfiles de clientes se sincronizan en líneas de tiempo separadas, por lo que uno puede finalizar antes que el otro.

El tiempo de sincronización depende de la cantidad de datos históricos en tu tienda. Las tiendas con un alto volumen de pedidos o grandes bases de clientes pueden tardar más en completar el rellenado. No puedes cambiar la velocidad del rellenado ni solicitar una sincronización más rápida.

Datos sincronizados

Para la sincronización inicial de datos, Braze importa los eventos de pedidos y perfiles de usuario descritos en Cómo selecciona Braze los datos históricos. Cuando Braze importa tus clientes de Shopify, asigna el tipo de external_id que elegiste en tu configuración.

La siguiente tabla resume los datos incluidos en esa carga inicial.