Descripción del evento event-description

Modelo de datos de mensajería transaccional about-transactional-messaging-datamodel

La mensajería transaccional se basa en el modelo de datos de Adobe Campaign y utiliza dos tablas independientes adicionales. Estas tablas, NmsRtEvent y NmsBatchEvent, contienen los mismos campos y permiten administrar eventos en tiempo real por un lado y eventos por lotes por otro.

Métodos SOAP soap-methods

Esta sección detalla los métodos SOAP asociados a los esquemas de módulos de mensajes transaccionales.

Dos métodos SOAP PushEvent o PushEvents están vinculados a los dos esquemas de datos nms:rtEvent y nms:BatchEvent. Es el sistema de información el que determina si un evento es de tipo “por lotes” o en “tiempo real”.

La ruta WSDL para acceder a ambos métodos es:

Para obtener más información sobre la generación de un archivo WSDL, consulte esta sección.

Ambos métodos contienen un elemento <urn:sessiontoken> para iniciar sesión en el módulo de mensajes transaccionales. Se recomienda utilizar un método de identificación a través de direcciones IP de confianza. Para recuperar el símbolo de sesión, realice una llamada SOAP de inicio de sesión y obtenga el autentificador seguido de un cierre de sesión. Utilice el mismo símbolo para varias llamadas de RT. Los ejemplos incluidos en esta sección utilizan el método de símbolo de sesión, que es el recomendado.

Si utiliza un servidor balanceador de carga, puede utilizar la autenticación Usuario/Contraseña (en el nivel del mensaje RT). Ejemplo:

<PushEvent xmlns="urn:nms:rtEvent">
<sessiontoken>mc/PASSWORD</sessiontoken>
<domEvent>
<rtEvent wishedChannel="41" type="rt_MobileJourney_iOS_Push" registrationToken="c3ddc8aaecc24822df25d0f49865cca61ea3f86c61bfa53ae4d37294e37f4a1c" hashlpId="27EE7571EC14DBA23B9B5CC0EF79BB782DAECF4C03C88E5D92CC9B9DAC4E5DDA" correlationId="415b7593-4f6f-e911-811f-00505691247c" xmlns="">
<mobileApp uuid="236B24DC-C073-412F-8BCB-AC7207096258" _operation="none"/>
<ctx>...</ctx>
</rtEvent>
</domEvent>
</PushEvent>

El método PushEvent está formado por un parámetro <urn:domevent> que contiene el evento.

El método PushEvents está formado por un parámetro <urn:domeventcollection> que contiene eventos.

Ejemplo con PushEvent:

<urn:PushEvent>

 <sessiontoken>___921f9b38-72ac-49ad-b481-ab32973efc50</sessiontoken>

 <urn:domEvent>

   <rtEvent>

   ...

   </rtEvent>

 </urn:domEvent>

</urn:PushEvent>

Ejemplo con PushEvents:

<urn:PushEvents>

 <sessiontoken>___921f9b38-72ac-49ad-b481-ab32973efc50</sessiontoken>

 <urn:domEventCollection>

   <Events>

     <rtEvent>... </rtEvent>

     <rtEvent>... </rtEvent>

     ...

   </Events>

 </urn:domEventCollection>

</urn:PushEvents>

Los elementos <rtevent> y <batchevent> tienen un conjunto de atributos así como un elemento secundario obligatorio: <ctx> para integrar datos de mensajes.

Los atributos obligatorios de los elementos <rtevent> y <batchevent> son @type y @email. El valor de @type debe ser el mismo que el valor de la lista desglosada definido al configurar la instancia de ejecución. Este valor permite definir la plantilla que se va a vincular al contenido del evento durante la entrega.

<rtevent> configuration example:

<rtEvent type="order_confirmation" email="john.doe@domain.com" origin="eCommerce" wishedChannel="0" externalId="1242" mobilePhone="+33620202020">

En este ejemplo se ofrecen dos canales: la dirección de correo electrónico y el número de teléfono móvil. wishedChannel permite seleccionar el canal que se desea utilizar al transformar el evento en un mensaje. El valor “0” corresponde al canal de correo electrónico, el valor “1” al canal móvil, etc.

Si desea posponer una entrega de eventos, añada el campo scheduled seguido de la fecha preferida. El evento se transforma en un mensaje en esta fecha.

Se recomienda rellenar los atributos @wishedChannel y @emailFormat con valores numéricos. La tabla de funciones que vincula los valores numéricos y las etiquetas se encuentra en la descripción del esquema de datos.

El elemento <ctx> contiene los datos del mensaje. Su contenido XML está abierto, lo que significa que se puede configurar según el contenido que se va a enviar.

Ejemplo de datos:

   <ctx>
               <client>
                        <firstname>John</firstname>
                        <lastname>Doe</lastname>
               </client>
               <action>
                         <type>Order confirmation</type>
                          <number>CN23453</number>
               </action>
               <orderdetails>
                          <article num="1">
                                   <name>Generic USB key</name>
                                   <price>20</price>
                           </article>
               </orderdetails>
    </ctx>

Información devuelta por la llamada SOAP information-returned-by-the-soap-call

Cuando recibe un evento, Adobe Campaign genera un ID de retorno único. Este es el ID de la versión archivada del evento.

Si el valor del identificador devuelto es estrictamente mayor que cero, significa que el evento se ha archivado correctamente en Adobe Campaign.

Sin embargo, si no se puede procesar el evento, el método devuelve un mensaje de error o un valor igual a cero.