Show Menu
TEMAS×

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. Está en formato JSON. El activador se procesa inmediatamente con el código Javascript. Se guarda en una tabla de base de datos sin ningún otro procesamiento en tiempo real. 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

El uso Experience Cloud Triggers en Campaign requiere lo siguiente:
  • Versión de Adobe Campaign 6.11 compilación 8705 o posterior.
  • Adobe Analytics Ultimate, Premium, Foundation, OD, Select, Prime, Mobile Apps, Select, o Standard.
Las configuraciones de requisitos previos son:
  • Creación de un archivo con clave privada y luego la creación de la aplicación oAuth registrada con esa clave.
  • Configuración de los activadores en Adobe Analytics.
La configuración de Adobe Analytics está fuera del ámbito de este documento.
Adobe Campaign requiere la siguiente información de Adobe Analytics:
  • Nombre de la aplicación oAuth.
  • El valor de IMSOrgId, identificador del cliente Experience Cloud.
  • Nombres de los activadores configurados en Analytics.
  • Nombre y formato de los campos de datos que se van a conciliar con la base de datos de marketing.
Parte de esta configuración tiene un desarrollo personalizado y requiere lo siguiente:
  • Conocimientos prácticos sobre análisis de JSON, XML y Javascript en Adobe Campaign.
  • Conocimientos prácticos de las API QueryDef y Writer.
  • Nociones de trabajo de cifrado y autenticación mediante claves privadas.
Como la edición del código JS requiere habilidades técnicas, no lo intente sin tener la comprensión adecuada.
Los activadores se guardan en una tabla de la base de datos. Por lo tanto, los operadores de marketing pueden utilizar los datos de activación de forma segura en flujos de trabajo de segmentación.

Archivos de autenticación y configuración

Se requiere la autenticación ya que la canalización está alojada en Adobe Experience Cloud. Si el servidor de marketing está alojado On-Premise, cuando inicia sesión en la canalización, debe autenticarse para tener una conexión segura. 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.

IMSOrgId

IMSOrgId es el identificador del cliente en Adobe Experience Cloud. Configúrelo en el archivo serverConf.xml de instancia, bajo el atributo IMSOrgId. Ejemplo:
<redirection IMSOrgId="C5E715(…)98A4@AdobeOrg" (…)

Generación de claves

La clave es un par de archivos. Está en formato RSA y tiene una longitud de 4096 bytes. Se puede generar con una herramienta de código abierto como OpenSSL. Cada vez que se ejecuta la herramienta, se genera una nueva clave de forma aleatoria. Para mayor comodidad, los pasos se enumeran a continuación:
  • openssl genrsa -out <private_key.pem> 4096
  • openssl rsa -pubout -in <private_key.pem> -out <public_key.pem>
Ejemplo de archivo private_key.pem:
----BEGIN RSA PRIVATE KEY----
MIIEowIBAAKCAQEAtqcYzt5WGGABxUJSfe1Xy8sAALrfVuDYURpdgbBEmS3bQMDb
(…)
64+YQDOSNFTKLNbDd+bdAA+JoYwUCkhFyvrILlgvlSBvwAByQ2Lx
----END RSA PRIVATE KEY----

Ejemplo de archivo public_key.pem:
----BEGIN PUBLIC KEY----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtqcYzt5WGGABxUJSfe1X
(…)
EwIDAQAB
----END PUBLIC KEY----

Las claves no deben generarse con PuttyGen, OpenSSL es la mejor opción.

Creación automática de clientes en Adobe Experience Cloud

Es necesario crear una aplicación de tipo JWT iniciando sesión en Adobe Analytics en la cuenta de organización correcta en Admin > User Management > Legacy Oath application .
Siga estos pasos:
  1. Seleccione el Service Account (JWT Assertion) .
  2. Escriba Application Name .
  3. Registre el Public key .
  4. Seleccione el activador Scopes .
  5. Haga clic en Create y compruebe el Application ID y Application Secret creado.

Registro del nombre de la aplicación en Adobe Campaign Classic

El ID de aplicación del cliente oAuth creado debe configurarse en Adobe Campaign. Puede hacerlo editando el archivo de configuración de instancia en el pipelined elemento, específicamente el atributo appName.
Ejemplo:
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Cifrado clave

Para que la utilice pipelined, la clave privada debe cifrarse. La codificación se realiza mediante la función cryptString Javascript y debe realizarse en la misma instancia que pipelined.
En esta página hay disponible un ejemplo de cifrado de clave privada con JavaScript.
La clave privada cifrada debe estar registrada en Adobe Campaign. Puede hacerlo editando el archivo de configuración de instancia en el pipelined elemento, específicamente el atributo authPrivateKey.
Ejemplo:
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Inicio automático de proceso de canalización

El pipelined proceso debe iniciarse automáticamente. Para ello, establezca el elemento en el archivo de configuración en autostart="true":
<pipelined autoStart="true" appName="applicationID" authPrivateKey="@qQf146pexBksGvo0esVIDO(…)"/>

Reinicio del proceso de canalización

También se puede iniciar manualmente con la línea de comandos:
nlserver start pipelined@instance

Se requiere reiniciar para que los cambios surtan efecto:
nlserver restart pipelined@instance

En caso de errores, búsquelos en la salida estándar (si ha empezado manualmente) o en el pipelined archivo de registro. Consulte la sección Resolución de problemas de este documento para obtener más información sobre la resolución de problemas.

Opciones de configuración de canalización

Opción
Descripción
appName
ID de la aplicación OAuth (ID de aplicación) registrada en Adobe Analytics (donde se cargó la clave pública): Administración > User Management > Aplicación de Oath heredado. Consulte esta sección .
authGatewayEndpoint
URL para obtener "tokens de puerta de enlace".
Valor predeterminado: https://api.omniture.com
authPrivateKey
Clave privada (parte pública cargada en Adobe Analytics (consulte esta sección). AES cifrado con la opción XtkSecretKey: xtk.session.EncryptPassword("PRIVATE_KEY");
disableAuth
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 descubrir el extremo de los servicios de canalización que se va a usar para este inquilino. Valor predeterminado: https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec
El período entre 2 volcados del estado interno del proceso en var/INSTANCE/pipelined.json estado interno también está disponible bajo demanda en http://INSTANCE/pipelined/status (puerto 7781).
forcedPipelineEndpoint
Deshabilite el descubrimiento de PipelineServicesEndpoint y fuércelo
monitorServerPort
El proceso pipelined escucha en este puerto para proporcionar el estado interno del proceso en http://INSTANCE/pipelined/status (puerto 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)