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 rastreados

La integración de Shopify utiliza eventos recomendados de comercio electrónico para capturar comportamientos de compra clave. Para ver ejemplos de implementación y estrategias de marketing con estos eventos, consulta los casos de uso de comercio electrónico.

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.

• ejemplo de carga útil
• 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 obligatorias (como cart_id o cart_token) de los eventos de comercio electrónico. En casos excepcionales, problemas temporales en Shopify pueden hacer que falten estas propiedades, lo que puede provocar que se descarten los eventos afectados.

• 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
Desencadenado: Cuando un cliente ve la página de un producto
Origen de datos: SDK de Braze
Caso de uso: Abandono de navegación

Variable	Plantilla de 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}}} Añade el dominio de tu sitio de 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
Desencadenado: Cuando un cliente añade, elimina o actualiza productos de su carrito de compras
Origen de datos: SDK de Braze
Caso de uso: Abandono del carrito de compras

Para los Canvas de carrito abandonado, primero tienes que añadir la etiqueta de Liquid inicial del carrito de compras para obtener el contexto del carrito en tu mensaje.

1

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

Luego, puedes añadir las siguientes etiquetas de Liquid del carrito de compras a tu mensaje.

Variable	Plantilla de 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 añadir 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
Desencadenado: Cuando un usuario accede a la página de pago
Origen de datos: REST API de Braze
Caso de uso: Abandono del pago

Importante

Si un cliente utiliza Shop Pay como opción de pago acelerado, Shopify puede omitir ciertos eventos de pago estándar (como el webhook de inicio de pago de Shopify). Esto significa que es posible que Braze no reciba los datos necesarios para añadir el alias del token de pago, lo que puede afectar al seguimiento del abandono del pago y a la conciliación de perfiles de usuario.

Para los Canvas de pago abandonado, primero tienes que utilizar la siguiente etiqueta de Liquid:

1
2

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

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

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

Variable	Plantilla de 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 contiene URL de productos ni URL de imágenes. Por ello, tienes que utilizar la personalización de catálogos con Liquid, tal y como se indica en Personalización de productos del carrito abandonado para correos electrónicos.

Evento: shopify_fulfilled_order
Tipo: Evento personalizado
Desencadenado: Cuando el pedido de un usuario está preparado y listo para el envío
Origen de datos: REST API de Braze
Caso de uso: (Transaccional) Actualización de la preparación del pedido

Variable	Plantilla de Liquid
ID del pedido	{{event_properties.${order_id}}}
Precio total	{{event_properties.${total_price}}}
Descuentos totales	{{event_properties.${total_discounts}}}
Estado 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}}}
Marca de tiempo de cierre	{{event_properties.${closed_at}}}
ID del elemento	{{event_properties.${line_items}[0].product_id}}
Cantidad del elemento	{{event_properties.${line_items}[0].quantity}}
SKU del elemento	{{event_properties.${line_items}[0].sku}}
Título del elemento	{{event_properties.${line_items}[0].title}}
Proveedor del elemento	{{event_properties.${line_items}[0].vendor}}
Nombre del elemento	{{event_properties.${line_items}[0].name}}
Propiedades del elemento	{{event_properties.${line_items}[0].properties}}
Precio del elemento	{{event_properties.${line_items}[0].price}}
Título del envío	{{event_properties.${shipping}[0].title}}
Precio del envío	{{event_properties.${shipping}[0].price}}
Estado de preparación	{{event_properties.${fulfillment_status}}}
Estado del envío de la preparación	{{event_properties.${fulfillments}[0].shipment_status}}
Estado	{{event_properties.${fulfillments}[0].status}}
Empresa de seguimiento de la preparación	{{event_properties.${fulfillments}[0].Fulfillment tracking_company}}
Número de seguimiento de la preparación	{{event_properties.${fulfillments}[0].Fulfillment tracking_number}}
Números de seguimiento de la preparación	{{event_properties.${fulfillments}[0].Fulfillment tracking_numbers}}
URL de seguimiento de la preparación	{{event_properties.${fulfillments}[0].Fulfillment tracking_url}}
URL de seguimiento de la preparación (lista)	{{event_properties.${fulfillments}[0].Fulfillment tracking_urls}}
Estado de preparación	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
Nombre de la preparación	{{event_properties.${fulfillments}[0].line_items[0].name}}
Precio de la preparación	{{event_properties.${fulfillments}[0].line_items[0].price}}
ID del producto de la preparación	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Cantidad de la preparación	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Envío de la preparación	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
SKU de la preparación	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Título de la preparación	{{event_properties.${fulfillments}[0].line_items[0].title}}
Proveedor de la preparación	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
ID de la variante	{{event_properties.${line_items}[0].variant_id}}
Título de la variante	{{event_properties.${line_items}[0].variant_title}}

Evento: shopify_partially_fulfilled_order
Tipo: Evento personalizado
Desencadenado: Cuando parte del pedido de un usuario está preparada y lista para el envío
Origen de datos: REST API de Braze
Caso de uso: (Transaccional) Actualización de la preparación del pedido

Variable	Plantilla de Liquid
ID del pedido	{{event_properties.${order_id}}}
Precio total	{{event_properties.${total_price}}}
Descuentos totales	{{event_properties.${total_discounts}}}
Estado 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}}}
Marca de tiempo de cierre	{{event_properties.${closed_at}}}
ID del elemento	{{event_properties.${line_items}[0].product_id}}
Cantidad del elemento	{{event_properties.${line_items}[0].quantity}}
SKU del elemento	{{event_properties.${line_items}[0].sku}}
Título del elemento	{{event_properties.${line_items}[0].title}}
Proveedor del elemento	{{event_properties.${line_items}[0].vendor}}
Nombre del elemento	{{event_properties.${line_items}[0].name}}
Propiedades del elemento	{{event_properties.${line_items}[0].properties}}
Precio del elemento	{{event_properties.${line_items}[0].price}}
Título del envío	{{event_properties.${shipping}[0].title}}
Precio del envío	{{event_properties.${shipping}[0].price}}
Estado de preparación	{{event_properties.${fulfillment_status}}}
Estado del envío de la preparación	{{event_properties.${fulfillments}[0].shipment_status}}
Estado de preparación	{{event_properties.${fulfillments}[0].status}}
Empresa de seguimiento de la preparación	{{event_properties.${fulfillments}[0].tracking_company}}
Número de seguimiento de la preparación	{{event_properties.${fulfillments}[0].tracking_number}}
Números de seguimiento de la preparación	{{event_properties.${fulfillments}[0].tracking_numbers}}
URL de seguimiento de la preparación	{{event_properties.${fulfillments}[0].tracking_url}}
URL de seguimiento de la preparación (lista)	{{event_properties.${fulfillments}[0].tracking_urls}}
Estado de preparación	{{event_properties.${fulfillments}[0].line_items[0].fulfillment_status}}
Nombre de la preparación	{{event_properties.${fulfillments}[0].line_items[0].name}}
Precio de la preparación	{{event_properties.${fulfillments}[0].line_items[0].price}}
ID del producto de la preparación	{{event_properties.${fulfillments}[0].line_items[0].product_id}}
Cantidad de la preparación	{{event_properties.${fulfillments}[0].line_items[0].quantity}}
Envío de la preparación	{{event_properties.${fulfillments}[0].line_items[0].requires_shipping}}
SKU de la preparación	{{event_properties.${fulfillments}[0].line_items[0].sku}}
Título de la preparación	{{event_properties.${fulfillments}[0].line_items[0].title}}
Proveedor de la preparación	{{event_properties.${fulfillments}[0].line_items[0].vendor}}
ID de la variante	{{event_properties.${line_items}[0].variant_id}}
Título de la variante	{{event_properties.${line_items}[0].variant_title}}

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

Variable	Plantilla de Liquid
ID del pedido	{{event_properties.${order_id}}}
Estado 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}}}
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 del elemento	{{event_properties.${line_items}[0].product_id}}
Cantidad del elemento	{{event_properties.${line_items}[0].quantity}}
SKU del elemento	{{event_properties.${line_items}[0].sku}}
Título del elemento	{{event_properties.${line_items}[0].title}}
Proveedor del elemento	{{event_properties.${line_items}[0].vendor}}
Propiedades del elemento	{{event_properties.${line_items}[0].properties}}
Precio del elemento	{{event_properties.${line_items}[0].price}}
Título del envío	{{event_properties.${shipping}[0].title}}
Precio del envío	{{event_properties.${shipping}[0].price}}
ID de la variante	{{event_properties.${line_items}[0].variant_id}}
Título de la variante	{{event_properties.${line_items}[0].variant_title}}

Evento: ecommerce.order_cancelled
Tipo: Evento recomendado
Desencadenado: Cuando se cancela el pedido de un usuario
Origen de datos: REST API de Braze
Caso de uso: (Transaccional) Confirmación de cancelación del pedido

Variable	Plantilla de Liquid
ID del 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 preparación	{{event_properties.${fulfillment_status}}}
Preparaciones	{{event_properties.${fulfillments}}}
ID del elemento	{{event_properties.${line_items}[0].product_id}}
Cantidad del elemento	{{event_properties.${line_items}[0].quantity}}
SKU del elemento	{{event_properties.${line_items}[0].sku}}
Título del elemento	{{event_properties.${line_items}[0].title}}
Proveedor del elemento	{{event_properties.${line_items}[0].vendor}}
Nombre del elemento	{{event_properties.${line_items}[0].name}}
Propiedades del elemento	{{event_properties.${line_items}[0].properties}}
Estado de preparación	{{event_properties.${line_items}[0].fulfillment_status}}
Título del envío	{{event_properties.${shipping}[0].title}}
Precio del envío	{{event_properties.${shipping}[0].price}}
ID de la variante	{{event_properties.${line_items}[0].variant_id}}
Título de la variante	{{event_properties.${line_items}[0].variant_title}}

Evento: ecommerce.order_refunded
Tipo: Evento recomendado
Desencadenado: Cuando se reembolsa el pedido de un usuario
Origen de datos: REST API de Braze
Caso de uso: (Transaccional) Confirmación del reembolso

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

Evento: shopify_account_login
Tipo: Evento personalizado
Desencadenado: Cuando un usuario inicia sesión en su cuenta
Origen de datos: REST API de Braze
Caso de uso: Serie de bienvenida

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

Nota

Actualmente, la integración de Shopify no admite el registro del evento de compra de Braze. Por ello, los filtros de compra, las etiquetas de Liquid, los desencadenantes 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.

• ejemplo de carga útil
• atributos personalizados de shopify

• etiquetas de shopify

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

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

Nombre del atributo	Descripción	Origen de datos
shopify_total_spent	El importe total que el cliente ha gastado en todo su historial de pedidos.	Webhook customers/purchasing_summary de Shopify
shopify_orders_count	El número de pedidos asociados a este cliente. No se cuentan los pedidos de prueba ni los archivados.	Webhook customers/purchasing_summary de Shopify
shopify_last_order_id	El ID del último pedido del cliente.	Webhook customers/purchasing_summary de Shopify
shopify_zipcode	El código postal del cliente, tomado de su dirección predeterminada.	Webhooks customers/create y customers/update de Shopify
shopify_province	La provincia del cliente, tomada de su dirección predeterminada.	Webhooks customers/create y customers/update de Shopify
shopify_locale	La configuración regional del cliente (por ejemplo, en o fr-CA), establecida a partir del idioma del navegador recopilado por el píxel web de Braze hasta que realiza un pedido, y luego actualizada con la configuración regional de su último pago.	Píxel web de Braze, webhooks orders/* de Shopify, reposición histórica de clientes

Nota

Shopify ya no proporciona el nombre del último pedido de un cliente, por lo que Braze no establece un atributo shopify_last_order_name. Los perfiles que ya tienen un valor lo conservan, pero no se actualiza.

Personalización con Liquid

Para añadir personalización con Liquid a tus atributos personalizados de Shopify, selecciona + Personalización. Después, selecciona Atributos personalizados como tipo de personalización.

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

Atributos estándar de Shopify admitidos

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 admitidos 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 el nombre Bob y Bob ya existe como nombre en el perfil de usuario de Braze, Braze no desencadenará una actualización y no se te cobrará ningún 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.

Relleno histórico

Los datos históricos de Shopify se importan desde antes de que conectes Braze. Durante la configuración, eliges hasta qué fecha anterior quieres importar los eventos de pedidos y los perfiles de clientes. Cada intervalo de tiempo se cuenta hacia atrás desde la fecha en que completas tu integración.

A través de la configuración de la integración estándar de Shopify o de la configuración de la integración personalizada de Shopify, puedes activar el relleno histórico para incluir clientes y pedidos anteriores en Segments, Campaigns y Canvas. Cuando lo actives, selecciona:

• Un intervalo de fechas para los pedidos: Últimos 90 días, Último año o Últimos 2 años (el valor predeterminado es Últimos 90 días)
• Un intervalo de fechas para los perfiles de clientes: Último año, Últimos 2 años o Todo el tiempo (el valor predeterminado es Todo el tiempo)

Braze muestra un recuento estimado de registros y un tiempo de procesamiento para cada opción antes de que termines la configuración. Cuando se completa el relleno, los intervalos que seleccionaste aparecen como fechas concretas en la página del partner de Shopify. Estas selecciones no se pueden cambiar una vez completada la configuración.

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

Nota

Si ya eres cliente de Braze y tienes Campaigns o Canvas activos, revisa cómo afectan los clientes y eventos de pedidos importados a tus Segments y recorridos antes de habilitar el relleno histórico. El relleno 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 cuyas fechas de creación estén dentro del intervalo de pedidos que seleccionaste.

Configurar el relleno histórico de Shopify

1. Selecciona Activar relleno histórico en el paso Seguimiento de datos de Shopify.
2. Elige un intervalo de fechas para los pedidos y otro para los perfiles de clientes. Revisa los recuentos estimados y el tiempo de procesamiento de tus selecciones.
3. Cuando completes la configuración de tu integración, Braze comenzará la sincronización inicial de datos. Puedes supervisar el progreso en la pestaña Datos de Shopify de la configuración de tu integración.

Velocidad y tiempo de sincronización del relleno

El relleno 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 relleno histórico, Braze importa los eventos de pedidos y los perfiles de clientes de Shopify por lotes. Los eventos de pedidos y los perfiles de clientes se sincronizan en plazos distintos, así que uno puede terminar antes que el otro. Los rellenos grandes se dividen en intervalos de fechas paralelos para que puedan ejecutarse al mismo tiempo.

El tiempo de sincronización depende de la cantidad de datos históricos de tu tienda y de los intervalos que seleccionaste. Las tiendas con un gran volumen de pedidos o una base de clientes amplia pueden tardar más en completar el relleno. No puedes cambiar la velocidad del relleno 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 los perfiles de usuario descritos en Cómo selecciona Braze los datos históricos. Cuando Braze importa tus clientes de Shopify, les asigna el tipo de external_id que elegiste en tu configuración.

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