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.

PRECAUCIÓN

En caso de implementación híbrida, asegúrese de que la canalización está configurada en una instancia media.

Requisitos previos

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

  • Versión mínima de Adobe Campaign 20.3
  • Versión de Adobe Analytics Standard

También necesitará:

  • Autenticación de proyectos de E/S de Adobe
  • un IMSOrgID válido, el identificador del cliente Experience Cloud con Adobe Analytics agregado
  • acceso de desarrollador a la organización IMS
  • se ha realizado la 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 el Marketing Cloud mediante el proyecto de E/S de Adobe.

Paso 1: Creación/actualización de un proyecto de E/S de Adobe

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

For On Premise customers, refer to the Configuring Adobe I/O for Adobe Experience Cloud Triggers page. Note that you need to select Adobe Analytics while adding API to the Adobe I/O credential.

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:

Opción Descripción
appName(Heredado) AppID de la aplicación OAuth registrada en la aplicación heredada de Oath donde se cargó la clave pública. Para obtener más información, consulte esta página
authGatewayEndpoint(Legacy) URL para obtener los tokens de la puerta de enlace. Predeterminado: https://api.omniture.com
authPrivateKey(Legacy) La clave privada, la parte pública cargada en la aplicación heredada de Oath, AES cifrada con la opción XtkKey: cryptString("PRIVATE_KEY")
disableAuth(Legacy) Deshabilite la autenticación, la conexión sin tokens de puerta de enlace solo la aceptan algunos extremos de canalización de desarrollo.
discoverPipelineEndpoint URL para encontrar el extremo de los servicios de canalización que se va a usar para este inquilino. Predeterminado: https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec También se puede acceder a petición al período entre dos volcados del proceso de estado interno en var/INSTANCE/pipelined.json.
aquí: http://INSTANCE:7781/pipelined/status
forcedPipelineEndpoint Deshabilite la detección de PipelineServicesEndpoint para forzarla
monitorServerPort El proceso de canalización escuchará en este puerto para proporcionar el proceso de estado interno aquí: http://INSTANCE:PORT/pipelined/status.
El valor predeterminado es 7781
pointerFlushMessageCount Cuando se procesa este número de mensajes, los desplazamientos se guardan en la base de datos.
El valor predeterminado es 1000
pointerFlushPeriodSec Después de este período, los desplazamientos se guardan en la base de datos.
El valor predeterminado es 5 (segundos)
processingJSThreads Número de mensajes de procesamiento de los subprocesos dedicados con conectores JS personalizados.
El valor predeterminado es 4
processingThreads Número de mensajes de procesamiento de los subprocesos dedicados con código integrado.
El valor predeterminado es 4
retryPeriodSec Retraso entre reintentos si hay errores de procesamiento.
El valor predeterminado es 30 (segundos)
retryValiditySec Descarte el mensaje si no se procesa correctamente después de este período (demasiados reintentos).
El valor predeterminado es 300 (segundos)

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.

En esta página