Parámetros de plantilla de elementos de campaña

Formato de los parámetros de plantilla de elementos de campaña

El formato de un parámetro de plantilla de elementos de campaña depende de dónde proceden los datos. Hay dos opciones:

1. Los datos provienen de la interfaz de usuario.
   Si los datos que el mandato de tarea necesita son datos que un usuario de negocio ha especificado al configurar el desencadenante, destino o acción, el formato es similar al siguiente:

   <Argument name="paramName" value="MARKETING_paramName" />

   Todos los valores de parámetros que provienen de la interfaz de usuario empiezan con este prefijo: MARKETING_. A continuación se proporciona un ejemplo; en este caso, se trata de un destino que evalúa el nivel de soporte por el que ha pagado un cliente como Oro, Plata o Bronce.

   <Argument name="supportLevel" value="MARKETING_supportLevel" />

   Cuando un usuario de negocio entra datos sobre un desencadenante, destino o acción utilizado en una actividad de marketing, los pares nombre-valor para cada parámetro de plantilla de elementos de campaña se guardan en la tabla DMELEMENTNVP. El siguiente es un ejemplo de una fila de la tabla para un destino con un DMELEMENT_ID de 1000:

   Ejemplo de contenido de la tabla DMELEMENTNVP

   DMELEMENT_ID	NAME	VALUE
   1000	"supportLevel"	"Gold"

   Cuando se activa la actividad de marketing:

   • Los servicios de marketing buscan el paramName en la tabla DMELEMENTNVP y sustituyen el valor MARKETING_paramName en la definición de implementación por el valor correspondiente.
   • Si el paramName no se encuentra en la tabla DMELEMENTNVP, el valor se establecerá en cualquier serie vacía y se hará caso omiso de ese parámetro.
2. Los datos se especifican directamente en la definición de plantilla.

   Para ciertos desencadenantes, destinos y acciones, el mandato de tarea necesita datos que un usuario de empresa no especifica. En este caso, el parámetro value no tiene el prefijo MARKETING_.

   Por ejemplo, si un mandato de tarea debe comprobar el comportamiento del usuario en la página actual, el siguiente parámetro puede pasar los datos de la página actual al mandato de tarea:

   <Argument name="matchLocations" value="request" />

Parámetros para listas capturadas en objetos de cuadrícula

Para algunos elementos de campaña, los usuarios de empresa pueden especificar listas de cosas como categorías, entradas de catálogo o segmentos de clientes. Por ejemplo, un usuario de negocio puede especificar más de una categoría para la acción Recomendar categoría. En la vista de propiedades del elemento de campaña, las listas se capturan utilizando un objeto de cuadrícula. Cuando la lista se mantiene en la tabla DMELEMENTNVP, cada fila de la cuadrícula corresponde a una fila de la tabla DMELEMENTNVP, y cada fila hace referencia al mismo nombre de propiedad. Por ejemplo:

Cuando este tipo de parámetro se incluye en una definición de plantilla de elemento de campaña, el parámetro necesita especificar un solo elemento. Por ejemplo, el parámetro para el ejemplo anterior es parecido al siguiente:

<Argument name="categoryIdList" value="MARKETING_categoryIdList"/>

Para obtener la lista de la interfaz de usuario, el mandato de tarea de elemento de campaña correspondiente debe llamar al método getElementParameters. El método devuelve una lista separada por comas de todos los valores de la tabla DMELEMENTNVP. En el ejemplo anterior, el código getElementParameters().get("categoryIdList") devuelve 10101,10102,10103 . Para proporcionar los valores de un objeto List, utilice el método MarketingUtil.parseList. Para el ejemplo anterio, la línea de código es parecida a la siguiente:

List categoryIdList = MarketingUtil.parseList(getElementParameters().get("categoryIdList"));

Parámetros comunes utilizados en elementos de campaña

Los desencadenantes, destinos y acciones facilitados con el Centro de gestión tienen muchos parámetros definidos. Si va a crear un nuevo desencadenante, destino o acción, puede utilizar los parámetros definidos aquí para enviar datos de la interfaz de usuario al mandato de tarea, o puede crear sus propios argumentos.