Descrizione di un evento event-description

Modello dati di messaggistica transazionale about-transactional-messaging-datamodel

La messaggistica transazionale si basa sul modello dati di Adobe Campaign e utilizza due tabelle separate aggiuntive. Queste tabelle, NmsRtEvent e NmsBatchEvent contengono gli stessi campi e consentono di gestire eventi in tempo reale da un lato e eventi batch dall'altro.

Metodi SOAP soap-methods

Questa sezione descrive i metodi SOAP associati agli schemi del modulo dei messaggi transazionali.

Due metodi SOAP PushEvent o PushEvents sono collegati ai due dataschemi nms:rtEvent e nms:BatchEvent. È il sistema informativo che determina se un evento è di tipo "batch" o "tempo reale".

Il percorso WSDL per l'accesso a entrambi i metodi è:

Per ulteriori informazioni sulla generazione di un file WSDL, vedere questa sezione.

Entrambi i metodi contengono un elemento <urn:sessiontoken> per l'accesso al modulo di messaggistica transazionale. È consigliabile utilizzare un metodo di identificazione tramite indirizzi IP attendibili. Per recuperare il token di sessione, esegui una chiamata SOAP di accesso, quindi un token GET seguito da una disconnessione. Utilizza lo stesso token per diverse chiamate RT. Gli esempi inclusi in questa sezione utilizzano il metodo del token di sessione consigliato.

Se utilizzi un server con bilanciamento del carico, puoi utilizzare l’autenticazione Utente/Password (a livello del messaggio RT). Esempio:

<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>

Il metodo PushEvent è costituito da un parametro <urn:domevent> che contiene l'evento.

Il metodo PushEvents è costituito da un parametro <urn:domeventcollection> contenente eventi.

Esempio di utilizzo di PushEvent:

<urn:PushEvent>

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

 <urn:domEvent>

   <rtEvent>

   ...

   </rtEvent>

 </urn:domEvent>

</urn:PushEvent>

Esempio di utilizzo di PushEvents:

<urn:PushEvents>

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

 <urn:domEventCollection>

   <Events>

     <rtEvent>... </rtEvent>

     <rtEvent>... </rtEvent>

     ...

   </Events>

 </urn:domEventCollection>

</urn:PushEvents>

Gli elementi <rtevent> e <batchevent> hanno un set di attributi e un elemento figlio obbligatorio: <ctx> per l'integrazione dei dati del messaggio.

Gli attributi obbligatori degli elementi <rtevent> e <batchevent> sono @type e @email. Il valore di @type deve essere uguale al valore dell’elenco dettagliato definito durante la configurazione dell’istanza di esecuzione. Questo valore ti consente di definire il modello da collegare al contenuto dell’evento durante la consegna.

<rtevent> configuration example:

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

In questo esempio, vengono forniti due canali: l’indirizzo e-mail e il numero di telefono cellulare. wwishChannel consente di selezionare il canale da utilizzare per trasformare l'evento in un messaggio. Il valore "0" corrisponde al canale e-mail, il valore "1" al canale mobile e così via.

Se desideri posticipare la consegna di un evento, aggiungi il campo scheduled seguito dalla data preferita. L’evento verrà trasformato in un messaggio in questa data.

È consigliabile compilare gli attributi @wishedChannel e @emailFormat con valori numerici. La tabella delle funzioni che collega i valori numerici e le etichette si trova nella descrizione dello schema di dati.

L'elemento <ctx> contiene i dati del messaggio. Il contenuto XML è aperto, il che significa che può essere configurato a seconda del contenuto da distribuire.

Esempio di dati:

   <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>

Informazioni restituite dalla chiamata SOAP information-returned-by-the-soap-call

Quando riceve un evento, Adobe Campaign genera un ID restituito univoco. Questo è l’ID della versione archiviata dell’evento.

Se il valore dell’identificatore restituito è rigorosamente maggiore di zero, significa che l’evento è stato archiviato correttamente in Adobe Campaign.

Tuttavia, se l'evento non viene elaborato, il metodo restituisce un messaggio di errore o un valore uguale a zero.