subscribeRulesetItems
Creado para:
- Desarrollador
El comando subscribeRulesetItems
le permite suscribirse a propuestas que son el resultado de conjuntos de reglas satisfechos. Para ello, especifique por qué superficies y esquemas filtrar y proporcione una función de llamada de retorno.
Cada vez que se evalúan los conjuntos de reglas, la función de devolución de llamada recibe un objeto result
con una matriz de propuestas.
subscribeRulesetItems
es la única manera de obtener propuestas que provienen de conjuntos de reglas, ya que no se devuelven junto con sendEvent
resultados.Opciones de comando
Este comando toma un objeto options
con las siguientes propiedades:
Propiedad | Tipo | Descripción |
---|---|---|
surfaces | Matriz de cadenas | Una lista de superficies. La función de llamada de retorno solo recibirá las propuestas que coincidan con una de las superficies proporcionadas aquí. |
schemas | Matriz de cadenas | Una lista de esquemas. La función de llamada de retorno solo recibirá las propuestas que coincidan con uno de los esquemas proporcionados aquí. |
callback | Función | Una función de llamada de retorno que se invocará cuando las propuestas sean el resultado de conjuntos de reglas satisfechos. La función de devolución de llamada recibe dos parámetros cuando se invoca: result y collectEvent . Consulte parámetros de devolución de llamada para obtener detalles. |
Parámetros de devolución de llamada
La función de llamada de retorno recibe los dos parámetros descritos en la tabla siguiente cuando se invoca.
Parámetro | Tipo | Descripción |
---|---|---|
result | Objeto | Este objeto contiene una matriz propositions . Estas propuestas son el resultado directo de conjuntos de reglas satisfechos. El objeto result tiene la misma estructura que el objeto result devuelto por sendEvent mediante una cláusula then . |
collectEvent | Función | Una función de conveniencia que puede utilizar para enviar eventos de Edge Network para rastrear interacciones, visualizaciones y otros eventos. |
Función collectEvent
La función collectEvent
es una función de conveniencia que puede utilizar para enviar eventos de Edge Network con el fin de realizar un seguimiento de interacciones, visualizaciones y otros eventos. Acepta los dos parámetros descritos en la tabla siguiente.
Parámetro | Tipo | Descripción |
---|---|---|
Tipo de evento | Cadena | Cadena que indica qué tipo de evento de propuesta se va a emitir. Los tipos de eventos admitidos son display , interact o dismiss . |
propositions | Matriz | Una matriz de propuestas correspondientes al evento. |
Suscripción a tarjetas de contenido mediante la extensión de etiqueta del SDK web
Siga los pasos a continuación para suscribirse a las tarjetas de contenido a través de la interfaz de usuario de etiquetas.
- Inicie sesión en experience.adobe.com con sus credenciales de Adobe ID.
- Vaya a Recopilación de datos > Etiquetas.
- Seleccione la propiedad de etiquetas que desee.
- Vaya a Reglas y luego seleccione la regla que desee.
- En Eventos, seleccione un evento existente o cree uno nuevo.
- Establezca el campo desplegable Extensión en SDK web de Adobe Experience Platform y establezca el Tipo de evento en Suscribir elementos de conjunto de reglas.
- Seleccione los esquemas y las superficies para los que desea suscribirse a las tarjetas de contenido, en el lado derecho de la pantalla.
- Seleccione Conservar cambios y, a continuación, ejecute el flujo de trabajo de publicación.
Suscripción a tarjetas de contenido mediante la biblioteca JavaScript del SDK web
El siguiente código de ejemplo se suscribe a la superficie web://mywebsite.com/#welcome
para las tarjetas de contenido y utiliza el método de conveniencia collectEvent
para emitir eventos display
para todas las propuestas.
alloy("subscribeRulesetItems", {
surfaces: ["web://mywebsite.com/#welcome"],
schemas: ["https://ns.adobe.com/personalization/message/content-card"],
callback: (result, collectEvent) => {
const { propositions = [] } = result;
renderMyPropositions(propositions);
collectEvent("display", propositions);
},
});