Configuración de canalización

Los parámetros de autenticación como el ID de cliente, la clave privada y el extremo de autenticación se configuran en los archivos de configuración de instancia.
La lista de activadores que se van a procesar se configura en una opción en formato JSON.
Los activadores se utilizan para la segmentación mediante un flujo de trabajo de campaña que envía correos electrónicos. La campaña se configura de modo que un cliente que tenga ambos eventos desencadenadores reciba un correo electrónico.

Requisitos previos

Antes de iniciar esta configuración, compruebe que está utilizando lo siguiente:

• Como mínimo, una de las siguientes compilaciones de Adobe Campaign:
  • 19.1.8.9039
  • 19.1.4.9032 - Gold Standard 11
  • 20.2.4.9187
  • 20.3.1
• Versión Adobe Analytics Standard

También necesitará esto:

• Autenticación de proyectos de Adobe I/O
• un ID de la organización de IMS válido, el identificador del cliente de Experience Cloud con Adobe Analytics añadido
• acceso de desarrollador a la organización de IMS
• configuración de activadores en Adobe Analytics

Archivos de autenticación y configuración

Se requiere la autenticación ya que la canalización está alojada en Adobe Experience Cloud.
Utiliza un par de claves públicas y privadas. Este proceso tiene la misma función que un usuario/contraseña, solo que es más seguro.
La autenticación es compatible con Marketing Cloud mediante el proyecto de Adobe I/O.

Paso 1: Creación/actualización de un proyecto de Adobe I/O

Para los clientes alojados, puede crear un ticket de servicio de atención al cliente para permitir a su organización utilizar los token de cuenta técnica de Adobe I/O para la integración de activadores.

Para los clientes locales, consulte la página Configuración de Adobe I/O para los activadores de Adobe Experience Cloud. Tenga en cuenta que debe seleccionar Adobe Analytics al agregar la API a la credencial de Adobe I/O.

Paso 2: Configuración de la opción de canalización NmsPipeline_Config

Una vez configurada la autenticación, la canalización recuperará los eventos. Solo procesará los activadores configurados en Adobe Campaign. El activador debe haberse generado desde Adobe Analytics y se debe haber insertado en la canalización, que solo procesará los activadores configurados en Adobe Campaign.
La opción también se puede configurar con un comodín para capturar todos los activadores independientemente del nombre.

1. En Adobe Campaign, acceda al menú de opciones en Administration > Platform > Options en la Explorer.

2. Seleccione la opción NmsPipeline_Config.

3. En el campo Value (long text), puede pegar el siguiente código JSON, que especifica dos activadores. Debe asegurarse de eliminar los comentarios.

   {
   "topics": [ // list of "topics" that the pipelined is listening to.
      {
           "name": "triggers", // Name of the first topic: triggers.
           "consumer": "customer_dev", // Name of the instance that listens.  This value can be found on the monitoring page of Adobe Campaign.
           "triggers": [ // Array of triggers.
               {
                   "name": "3e8a2ba7-fccc-49bb-bdac-33ee33cf02bf", // TriggerType ID from Analytics 
                   "jsConnector": "cus:triggers.js" // Javascript library holding the processing function.
               }, {
                   "name": "2da3fdff-13af-4c51-8ed0-05802a572e94", // Second TriggerType ID 
                   "jsConnector": "cus:triggers.js" // Can use the same JS for all.
               },
           ]
       }
   ]
   }
   

4. También puede pegar el siguiente código JSON que captura todos los activadores.

   {
   "topics": [
     {
       "name": "triggers",
       "consumer":  "customer_dev",
       "triggers": [
         {
           "name": "*",
           "jsConnector": "cus:pipeline.js"
         }
       ]
     }
   ]
   }
   

El parámetro de consumidor

La canalización funciona como un modelo de proveedor y consumidor. Los mensajes se consumen únicamente para un consumidor individual: cada consumidor obtiene su propia copia de los mensajes.

El parámetro Consumidor identifica la instancia como uno de estos consumidores. La identidad de la instancia llamará a la canalización. Puede rellenarla con el nombre de instancia que se encuentra en la página de monitorización de la consola de cliente.

El servicio de canalización realiza un seguimiento de los mensajes recuperados por cada consumidor. El uso de diferentes consumidores para diferentes instancias permite asegurarse de que todos los mensajes se envíen a cada instancia.

Recomendaciones de opciones de canalización

Para configurar la opción Canalización, debe seguir estas recomendaciones:

• Añada o edite los activadores en Triggers; no debe editar el resto.
• Asegúrese de que el JSON sea válido. Puede utilizar un validador JSON, por ejemplo, consulte este sitio web .
• “name” corresponde al ID del desencadenador. El comodín "*" capturará todos los activadores.
• “Consumidor” corresponde al nombre de la instancia o aplicación que realiza la llamada.
• La canalización también admite el tema “alias”.
• Siempre debe reiniciar la canalización después de realizar cambios.

Paso 3: Configuración opcional

Puede cambiar algunos parámetros internos según sus requisitos de carga, pero asegúrese de probarlos antes de ponerlos en producción.

La lista de parámetros opcionales se encuentra a continuación:

Inicio automático de proceso de canalización

El proceso de canalización debe iniciarse automáticamente.

Para ello, establezca el elemento < pipelined > en el archivo de configuración en autostart="true":

 <pipelined autoStart="true" ... "/>

Reinicio del proceso de canalización

Se requiere reiniciar para que los cambios surtan efecto:

nlserver restart pipelined@instance

Paso 4: Validación

Para validar la configuración de la canalización para el aprovisionamiento, siga los pasos a continuación:

• Asegúrese de que el proceso de pipelined se esté ejecutando.
• Compruebe los registros de conexión de canalización en pipelned.log.
• Compruebe la conexión y si se reciben los pings. Los clientes alojados pueden utilizar la Monitorización desde la consola de cliente.