Notificaciones de reposición de existencias

Aprende a configurar notificaciones de reposición de existencias utilizando tu catálogo y eventos personalizados, para que puedas suscribir automáticamente a los clientes para que reciban notificaciones cuando un artículo vuelva a estar disponible. Ten en cuenta que esto solo se aplica a los usuarios que ya han aceptado recibir notificaciones.

Cómo funciona

Puedes configurar un evento personalizado para usarlo como evento de suscripción, como un evento product_clicked. Este evento debe contener una propiedad del ID del artículo (IDs de artículos del catálogo). Te sugerimos incluir un nombre de catálogo, pero no es obligatorio. También proporcionarás el nombre de un campo de cantidad de inventario, que debe ser un tipo de datos numérico.

Ten en cuenta que el stock de un artículo del catálogo debe estar en cero para que un usuario pueda suscribirse a él correctamente. Cuando un artículo tiene una cantidad de inventario mayor que cero, Braze buscará a todos los usuarios suscritos a ese artículo y enviará un evento personalizado que puedes usar para desencadenar una Campaign o un Canvas.

Las propiedades del evento se envían junto con tu usuario, por lo que puedes usar plantillas para incluir los detalles del artículo en la Campaign o el Canvas que se envía.

Configuración de notificaciones de vuelta en existencia

Sigue estos pasos para configurar las notificaciones de vuelta en existencia en un catálogo específico.

1. Ve a tu catálogo y selecciona la pestaña Configuración.
2. Selecciona la opción Vuelta en existencia.
3. Si la configuración global de vuelta en existencia no se ha configurado, se te pedirá que configures los eventos personalizados y las propiedades que se utilizarán para desencadenar las notificaciones de vuelta en existencia:
   
   • Catálogo alternativa Es el catálogo que se utiliza para la suscripción de vuelta en existencia si no hay una propiedad catalog_name presente en el evento personalizado.
   • Evento personalizado para suscripciones es el evento personalizado de Braze que se utiliza para suscribir a un usuario a las notificaciones de vuelta en existencia. Cuando se produce este evento, el usuario que lo realizó queda suscrito.
   • Evento personalizado para cancelar la suscripción es el evento personalizado de Braze que se utilizará para cancelar la suscripción de un usuario a las notificaciones de vuelta en existencia. Este evento es opcional. Si el usuario no realiza este evento, se cancelará su suscripción después de 90 días o cuando se desencadene el evento de vuelta en existencia, lo que ocurra primero.

   • Propiedad del evento de ID del artículo es la propiedad del evento personalizado mencionado anteriormente en esta sección que se utiliza para determinar el artículo para una suscripción o cancelación de suscripción de vuelta en existencia. Esta propiedad del evento personalizado debe contener un ID de artículo (id) que esté presente en un catálogo. El ID del artículo debe enviarse como una cadena para que coincida con el tipo de datos id almacenado en el catálogo de destino. El evento personalizado también debe contener una propiedad catalog_name para especificar en qué catálogo se encuentra este artículo.

   • Un ejemplo de evento personalizado sería:

• rest api
• web sdk
• android sdk
• ios sdk

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

{
    "events": [
        {
            "external_id": "<external_id>",
            "name": "subscription",
            "time": "2024-04-15T19:22:28Z",
            "properties": {
                "id": "shirt-xl",
                "catalog_name": "on_sale_products",
                "type": ["back_in_stock"]
            }
        }
    ]
}

1
2
3
4
5

braze.logCustomEvent("subscription", {
  id: "shirt-xl",
  catalog_name: "on_sale_products",
  type: ["back_in_stock"]
});

1
2
3
4
5
6
7
8
9
10

// Kotlin
Braze.getInstance(context).logCustomEvent(
  "subscription",
  BrazeProperties(
    JSONObject()
      .put("id", "shirt-xl")
      .put("catalog_name", "on_sale_products")
      .put("type", JSONArray().put("back_in_stock"))
  )
)

1
2
3
4
5
6
7
8
9

// Java
Braze.getInstance(context).logCustomEvent(
  "subscription",
  new BrazeProperties(new JSONObject()
    .put("id", "shirt-xl")
    .put("catalog_name", "on_sale_products")
    .put("type", new JSONArray().put("back_in_stock"))
  )
);

1
2
3
4
5
6
7
8
9

// Swift
AppDelegate.braze?.logCustomEvent(
  name: "subscription",
  properties: [
    "id": "shirt-xl",
    "catalog_name": "on_sale_products",
    "type": ["back_in_stock"]
  ]
)

1
2
3
4
5
6
7

// Objective-C
[AppDelegate.braze logCustomEvent:@"subscription"
                       properties:@{
  @"id": @"shirt-xl",
  @"catalog_name": @"on_sale_products",
  @"type": @[@"back_in_stock"]
}];

Nota

Los desencadenantes de vuelta en existencia y de bajada de precio utilizan el mismo evento para suscribir al usuario a la notificación, por lo que puedes usar la propiedad type para configurar tanto las notificaciones de bajada de precio como las de vuelta en existencia en el mismo evento. Ten en cuenta que la propiedad type debe ser un array.

4. Selecciona Guardar y continúa a la página de Configuración del catálogo.
5. Configura tu regla de notificación. Hay dos opciones:
   • Notificar a todos los usuarios suscritos notifica a todos los clientes que están esperando cuando el artículo vuelva a estar en existencia.
   • Establecer límites de notificación notifica a un número específico de clientes cada 10 minutos. Braze notificará al número especificado de clientes en incrementos hasta que no queden más clientes por notificar o hasta que el artículo se agote. Tu tasa de notificación no puede superar la notificación a 10 000 usuarios por minuto.
6. Configura el Campo de inventario en el catálogo. Este campo del catálogo se utilizará para determinar si el artículo está agotado. El campo debe ser de tipo numérico.
7. Selecciona Guardar configuración.

Importante

Las reglas de notificación en esta configuración no reemplazan la configuración de notificaciones de Canvas, como las horas tranquilas.

Uso de notificaciones de vuelta en existencia en un Canvas

Después de configurar la característica de vuelta en existencia en un catálogo, sigue estos pasos para usarla con Canvas.

1. Configura un Canvas basado en acciones.
2. Selecciona Vuelta en existencia como desencadenante.
3. Selecciona el nombre del catálogo con las notificaciones de vuelta en existencia.
4. Continúa configurando tu Canvas como lo harías normalmente.

Ahora, tus clientes pueden recibir una notificación cuando un artículo vuelva a estar en existencia.

Uso de Liquid

Para incluir detalles del artículo del catálogo que volvió a estar en existencia mediante plantillas, puedes usar la etiqueta de Liquid context para acceder al item_id.

Usar {{context.${catalog_update}.item_id}} devolverá el ID del artículo que volvió a estar en existencia. {{context.${catalog_update}.previous_value}} devolverá el valor de inventario del artículo antes de la actualización, y {{context.${catalog_update}.new_value}} devolverá el nuevo valor de inventario después de la actualización.

Usa la etiqueta de Liquid {% catalog_items <name_of_your_catalog> {{context.${catalog_update}.item_id}} %} en la parte superior de tu mensaje, y luego usa {{ items[0].<field_name> }} para acceder a los datos de ese artículo a lo largo del mensaje.

Importante

La terminología y el espacio de nombres de Liquid que ves dependen de las características disponibles en tu espacio de trabajo:

• Si el panel muestra Variables de contexto, haz referencia a las propiedades de entrada con context, como {{context.${property_name}}}. También puedes crear o actualizar variables con un paso de contexto.
• Si el panel muestra Propiedades de entrada de Canvas, haz referencia a ellas con canvas_entry_properties, como {{canvas_entry_properties.${property_name}}}. El paso de contexto y el filtro Variable de contexto no están disponibles.
  
  Para más información, consulta Contexto y Propiedades de contexto y de evento. Si necesitas acceso al contexto de Canvas, ponte en contacto con tu administrador de éxito de cliente.

Consejo

Para importar imágenes para los elementos desencadenantes del catálogo, este debe incluir un campo denominado image_url. A continuación, puedes hacer referencia a él utilizando {{ items[0].image_url }}.

Consideraciones

• Los usuarios solo están suscritos durante 90 días. Si el artículo no vuelve a estar en existencia en 90 días, se cancela la suscripción del usuario.
• Cuando se utiliza la regla de notificación Notificar a todos los usuarios suscritos, Braze notificará a 100.000 usuarios en 10 minutos.
• Braze admite hasta 50.000 artículos actualizados diariamente que son elegibles para desencadenar notificaciones de vuelta en existencia. Puedes tener hasta 100 millones de suscripciones activas en un momento dado, donde cada suscripción representa un perfil de usuario suscrito para supervisar un artículo del catálogo.
• Cuando exportas usuarios suscritos desde la configuración de tu catálogo, el archivo CSV incluye hasta 10.000 suscripciones, incluso si el catálogo tiene más suscripciones activas.