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.
Antes de iniciar esta configuración, compruebe que está utilizando lo siguiente:
También necesitará esto:
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.
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.
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.
En Adobe Campaign, acceda al menú de opciones en Administration > Platform > Options en la Explorer.
Seleccione la opción NmsPipeline_Config.
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.
},
]
}
]
}
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"
}
]
}
]
}
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.
Para configurar la opción Canalización, debe seguir estas recomendaciones:
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) |
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" ... "/>
Se requiere reiniciar para que los cambios surtan efecto:
nlserver restart pipelined@instance
Para validar la configuración de la canalización para el aprovisionamiento, siga los pasos a continuación: