v7
Se aplica a Campaign Classic v7
v8
También se aplica a Campaign v8

Configuración de canalización configuring-pipeline

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 prerequisites

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 organización válido: para encontrar el ID de organización, consulte esta página
  • un acceso para desarrolladores para su organización
  • configuración de activadores en Adobe Analytics

Archivos de autenticación y configuración authentication-configuration

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 creating-adobe-io-project

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

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.

    code language-none
    {
    "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.

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

El parámetro de consumidor consumer-parameter

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 pipeline-option-recommendation

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

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(Legacy)
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 pipelined-process-autostart

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 pipelined-process-restart

Se requiere reiniciar para que los cambios surtan efecto:

nlserver restart pipelined@instance

Paso 4: Validación step-validation

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.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1