Características de los datos de Shopify
Este artículo ofrece un resumen de nuestras características de 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 recomendados de eCommerce para capturar comportamientos de compra clave. Para ver ejemplos de implementación y estrategias de marketing con estos eventos, consulta ejemplos de eCommerce.
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.
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"
}
}
Braze depende de Shopify para proporcionar las propiedades del evento requeridas (como cart_id o cart_token) para los eventos de eCommerce. En casos poco frecuentes, problemas temporales con Shopify pueden hacer que estas propiedades no se reciban, lo que puede provocar que los eventos afectados se descarten.
Evento: ecommerce.product_viewed
Tipo: Evento recomendado
Se desencadena: Cuando un cliente ve la página de un producto
Origen de datos: SDK de Braze
Ejemplo: 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 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 añade, 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 necesitas añadir la etiqueta de Liquid del carrito de compras inicial 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 en 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> }} |
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 de 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
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 añadir 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 necesitas 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 en tu mensaje para hacer referencia a los productos en 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
Se desencadena: Cuando un usuario completa con éxito 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 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}} |
El webhook de pago completado de Shopify no incluye URL de productos ni URL de imágenes. Como resultado, necesitas utilizar la personalización de Liquid de catálogos, como se menciona en Personalización de productos de carrito abandonado para correos electrónicos.
Evento: shopify_fulfilled_order
Tipo: Evento personalizado
Se desencadena: Cuando el pedido de un usuario se completa y está listo para el envío
Origen de datos: REST API de Braze
Ejemplo: (Transaccional) Actualización de cumplimiento
| Variable | Plantilla de Liquid |
|---|---|
| ID del 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 de 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 artículo | {{event_properties.${line_items}[0].product_id}} |
| Cantidad del artículo | {{event_properties.${line_items}[0].quantity}} |
| SKU del artículo | {{event_properties.${line_items}[0].sku}} |
| Título del artículo | {{event_properties.${line_items}[0].title}} |
| Proveedor del artículo | {{event_properties.${line_items}[0].vendor}} |
| Nombre del artículo | {{event_properties.${line_items}[0].name}} |
| Propiedades del artículo | {{event_properties.${line_items}[0].properties}} |
| Precio del 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}} |
| URLs 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 completa y está lista para el envío
Origen de datos: REST API de Braze
Ejemplo: (Transaccional) Actualización de cumplimiento
| Variable | Plantilla de Liquid |
|---|---|
| ID del 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 de 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 artículo | {{event_properties.${line_items}[0].product_id}} |
| Cantidad del artículo | {{event_properties.${line_items}[0].quantity}} |
| SKU del artículo | {{event_properties.${line_items}[0].sku}} |
| Título del artículo | {{event_properties.${line_items}[0].title}} |
| Proveedor del artículo | {{event_properties.${line_items}[0].vendor}} |
| Nombre del artículo | {{event_properties.${line_items}[0].name}} |
| Propiedades del artículo | {{event_properties.${line_items}[0].properties}} |
| Precio del 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}} |
| URLs 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 de Liquid |
|---|---|
| ID del pedido | {{event_properties.${order_id}}} |
| Estado de confirmación | {{event_properties.${confirmed}}} |
| URL de 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 artículo | {{event_properties.${line_items}[0].product_id}} |
| Cantidad del artículo | {{event_properties.${line_items}[0].quantity}} |
| SKU del artículo | {{event_properties.${line_items}[0].sku}} |
| Título del artículo | {{event_properties.${line_items}[0].title}} |
| Proveedor del artículo | {{event_properties.${line_items}[0].vendor}} |
| Propiedades del artículo | {{event_properties.${line_items}[0].properties}} |
| Precio del 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 el pedido de un usuario se cancela
Origen de datos: REST API de Braze
Ejemplo: (Transaccional) Confirmación de cancelación de 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 de 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 del artículo | {{event_properties.${line_items}[0].product_id}} |
| Cantidad del artículo | {{event_properties.${line_items}[0].quantity}} |
| SKU del artículo | {{event_properties.${line_items}[0].sku}} |
| Título del artículo | {{event_properties.${line_items}[0].title}} |
| Proveedor del artículo | {{event_properties.${line_items}[0].vendor}} |
| Nombre del artículo | {{event_properties.${line_items}[0].name}} |
| Propiedades del 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 el pedido de un usuario se reembolsa
Origen de datos: REST API de Braze
Ejemplo: (Transaccional) Confirmación de reembolso
| Variable | Plantilla de Liquid |
|---|---|
| ID del pedido | {{event_properties.${order_id}}} |
| Nota del pedido | {event_properties.${note}}} |
| ID del artículo | {{event_properties.${line_items}[0].product_id}} |
| Cantidad del artículo | {{event_properties.${line_items}[0].quantity}} |
| SKU del artículo | {{event_properties.${line_items}[0].sku}} |
| Título del artículo | {{event_properties.${line_items}[0].title}} |
| Proveedor del artículo | {{event_properties.${line_items}[0].vendor}} |
| Nombre del artículo | {{event_properties.${line_items}[0].name}} |
| Propiedades del artículo | {{event_properties.${line_items}[0].properties}} |
| Precio del 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 de Liquid |
|---|---|
source |
{{event_properties.${source}}} |
La integración de Shopify actualmente no admite el llenado del evento de compra de Braze. Como resultado, los filtros de compra, las etiquetas de Liquid, los desencadenadores basados en acciones y los análisis deben usar el evento ecommerce.order_placed.
Atributos personalizados de Shopify compatibles
Todos los atributos provienen de la REST API de Braze.
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"attributes": [
{
"shopify_tags": "VIP_customer",
"shopify_total_spent": "60.00",
"shopify_order_count": "3",
"shopify_last_order_id": "1234567",
"shopify_last_order_name": "test_order",
"shopify_zipcode": "10001",
"shopify_province": "null"
}
]
}
| 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 contabilizan. |
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 de su dirección predeterminada. |
shopify_province |
La provincia del cliente de su dirección predeterminada. |
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 los pedidos posteriores. - Nuevos usuarios: Para cualquier nuevo usuario, 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 agregar 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, ingresa un valor predeterminado y copia el fragmento de Liquid en tu mensaje.
Atributos estándar de Shopify compatibles
Todos los atributos provienen de la REST API de Braze.
- Correo electrónico
- Nombre
- Apellido
- Teléfono
- Ciudad
- País
Braze solo actualizará los atributos personalizados de Shopify compatibles y los atributos estándar de Braze si hay una diferencia en los datos 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.
Reabastecimiento histórico
Los datos históricos de Shopify se importan antes de que conectes Braze: eventos de pedidos de los últimos 90 días y datos de clientes del último año. Ambos periodos se cuentan 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 la configuración de la integración personalizada de Shopify, puedes activar el reabastecimiento histórico para segmentar a clientes anteriores. 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 periodos se cuentan hacia atrás desde 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.
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 reabastecimiento histórico.
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.
Configurar el reabastecimiento histórico de Shopify
- Activa el reabastecimiento histórico en el paso Track Shopify data.
- 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.
Datos sincronizados
Para la sincronización inicial de datos, Braze importa eventos de pedidos de los últimos 90 días y perfiles de usuario del último año, cada uno contado hacia atrás desde 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.
La siguiente tabla resume los datos incluidos en esa carga inicial.
| Eventos recomendados de Braze | Eventos personalizados de Shopify | Atributos estándar de Braze | Estados de suscripción de Braze |
|---|---|---|---|
|
|
|
|