Guía del administrador y de inicio - Location

IBM eMessage
Versión 9 Release 1
13 de febrero de 2015
Guía del administrador y de inicio
Nota
Antes de utilizar esta información y el producto al que da soporte, lea la información incluida en “Avisos” en la página 127.
Esta edición se aplica a la versión 9, release 1, modificación 0 de IBM eMessage y a todos los releases y
modificaciones subsiguientes mientras no se indique lo contrario en nuevas ediciones.
© Copyright IBM Corporation 1999, 2015.
Contenido
Capítulo 1. Mensajería alojada utilizando
IBM Campaign e IBM eMessage . . . . 1
Cómo definir una cuenta de correo electrónico
alojada con IBM . . . . . . . . . . .
Descripción general del proceso de inicio . .
Antes de empezar a trabajar con eMessage . .
.
.
.
. 1
. 1
. 3
Capítulo 2. Configuración del entorno
local de IBM EMM para eMessage . . . 5
Habilitación de funciones de eMessage en Campaign
Confirmación de registro de eMessage . . . . .
Visualizar las opciones de menú de eMessage . . .
Especificación de las características de las tablas de
sistema de eMessage. . . . . . . . . . . .
Configurar el acceso a las tablas del sistema de
eMessage . . . . . . . . . . . . . . .
Configuración del acceso a las tablas del sistema
local de eMessage . . . . . . . . . . .
Correlación necesaria para tablas del sistema de
eMessage en Campaign . . . . . . . . . . .
Reinicio necesario del servidor de aplicaciones web
para Campaign . . . . . . . . . . . . .
5
5
6
7
8
8
9
9
Capítulo 3. Conexión a servicios de
correo electrónico alojados . . . . . . 11
Requisitos para configurar la conexión con IBM
EMM Hosted Services . . . . . . . . . . .
Requisitos para cargar datos a IBM EMM Hosted
Services . . . . . . . . . . . . . . .
Requisitos de conexión y puertos . . . . . .
Conexión de carga predeterminada mediante FTP
explícito . . . . . . . . . . . . . .
Carga de datos con FTP implícito . . . . . .
Conexión mediante un proxy HTTP . . . . .
Valor de puerto y frecuencia de descarga de datos
Requisito de usuario del sistema para acceder a IBM
EMM Hosted Services . . . . . . . . . . .
Configuración del usuario del sistema que accede
a IBM EMM Hosted Services . . . . . . .
Configuración de las direcciones que se utilizan
para conectarse a IBM EMM Hosted Services . . .
Configuración de direcciones para conectarse a
IBM EMM Hosted Services . . . . . . . .
Configuración de la comunicación segura para el
correo electrónico alojado. . . . . . . . . .
Generar un almacén de claves de confianza . .
Configuración de SSL al utilizar WebLogic . . .
Cómo configurar SSL para utilizar IBM
WebSphere . . . . . . . . . . . . .
11
12
12
13
14
17
23
23
24
25
25
26
27
28
31
Capítulo 4. Operación del rastreador de
respuestas y contactos . . . . . . . 35
Inicio manual del RCT.
.
.
© Copyright IBM Corp. 1999, 2015
.
.
.
.
.
.
.
. 35
Operación manual del Rastreador de respuestas y
contactos . . . . . . . . . . . . . .
Detención del Rastreador de respuestas y
contactos . . . . . . . . . . . . . .
Cómo iniciar automáticamente el RCT como servicio
Adición del Rastreador de respuestas y contactos
(RCT) como servicio . . . . . . . . . .
Eliminación del servicio Rastreador de respuestas
y contactos . . . . . . . . . . . . .
36
36
36
37
38
Capítulo 5. Verificación del inicio . . . 39
Confirmación de las configuraciones del sistema . .
Probar la carga a IBM EMM Hosted Services . . .
Probar la descarga desde IBM EMM Hosted Services
Probar la conexión a la interfaz de mensajería
alojada . . . . . . . . . . . . . . . .
39
41
41
41
Capítulo 6. Configuraciones para IBM
eMessage . . . . . . . . . . . . . 43
Lo que puede configurar en eMessage . . . .
Qué se debe reiniciar después de hacer cambios en
la configuración . . . . . . . . . . . .
Configuración del acceso a historial adicional de
ejecución de envíos de correos . . . . . . .
Soporte de la integración de ofertas de Campaign
Configuración del soporte para tablas de
dimensiones . . . . . . . . . . . . .
Configuración del acceso a las tablas del sistema
local de eMessage . . . . . . . . . . .
Propiedades de configuración de eMessage . . .
Campaign | particiones | partición[n] |
eMessage . . . . . . . . . . . . .
Campaign | partitions | partition[n] | server |
internal . . . . . . . . . . . . . .
Campaign | particiones | partición[n] |
eMessage | contactAndResponseHistTracking .
eMessage | serverComponentsAndLocations |
hostedServices . . . . . . . . . . .
eMessage | particiones | partición[n] |
hostedAccountInfo . . . . . . . . . .
eMessage | particiones | partición[n] |
dataSources | systemTables . . . . . . .
eMessage | particiones | partición[n] |
recipientListUploader . . . . . . . . .
eMessage | particiones | partición[n] |
responseContactTracker . . . . . . . .
. 44
. 45
. 46
47
. 47
. 48
. 48
. 49
. 50
. 53
. 55
. 56
. 57
. 60
. 60
Capítulo 7. Configuraciones para
implementar notificaciones de envío a
móvil de IBM . . . . . . . . . . . . 63
Visión general de cómo integrar las aplicaciones
móviles con los sistemas de mensajería de IBM .
Integración de Google Cloud Messaging con IBM
eMessage . . . . . . . . . . . . . .
. 63
. 64
iii
Requisitos previos para la integración de
aplicaciones de Google Android con
notificaciones de envío de IBM . . . . . . .
Implementación de IBM Push Notification SDK
for Android dentro de su aplicación . . . . .
Suministro de una bandeja de entrada de
aplicación para aplicaciones Android . . . . .
Suministro de notificaciones desencadenadas por
ubicación para aplicaciones Android . . . . .
Suministro de notificaciones de intención de la
acción . . . . . . . . . . . . . . .
Configuración del soporte para eventos y
notificaciones . . . . . . . . . . . . .
Personalización de notificaciones . . . . . .
Integración de ID de usuario de aplicación de
dispositivo móvil (XID) para Android . . . .
Integración del servicio de notificación de envío de
Apple con IBM eMessage. . . . . . . . . .
Requisitos previos para la integración de
aplicaciones de Apple iOS con notificaciones de
envío de IBM . . . . . . . . . . . . .
Implementación de iOS en la aplicación . . . .
Suministro de una bandeja de entrada de
aplicación para aplicaciones iOS . . . . . .
Suministro de acciones en notificaciones . . . .
Notificaciones desencadenadas por ubicación
para las aplicaciones iOS . . . . . . . . .
Configuración del SDK para notificaciones
activadas por ubicación . . . . . . . . .
Configuración del comportamiento personalizado
de identificadores . . . . . . . . . . .
Creación de una notificación de envío para la
aplicación de ejemplo de Apple iOS . . . . .
Borrado de todas las notificaciones desde el
dispositivo móvil . . . . . . . . . . .
Recepción de notificación de registro de
aplicación . . . . . . . . . . . . . .
Integración del ID de usuario de aplicación de
dispositivo móvil (XID) para iOS . . . . . .
Habilitación de la cuenta de mensajería alojada para
la mensajería móvil . . . . . . . . . . . .
Registro de una aplicación de dispositivo móvil en
IBM eMessage . . . . . . . . . . . . .
Requisito para identificar usuarios de la aplicación
en la base de datos de marketing . . . . . . .
Prueba de la integración de la aplicación de
dispositivo móvil en un dispositivo móvil . . . .
Configuración de ubicaciones para entrega
desencadenada por ubicación . . . . . . . .
Edición de las propiedades de ubicación. . . .
Supresión de ubicaciones disponibles para la
entrega desencadenada por ubicación. . . . .
Configuración de valores predeterminados para la
mensajería móvil . . . . . . . . . . . .
Enviar datos de seguimiento de notificación de IBM
64
65
67
68
Capítulo 9. Acerca de la resolución de
problemas en eMessage. . . . . . . 105
70
Archivos de registro de eMessage
Utilización de log4j con eMessage
70
73
75
75
76
77
79
83
86
87
87
88
88
88
89
90
90
92
iv
.
.
.
.
.
.
.
.
.
.
.
.
IBM eMessage: Guía del administrador y de inicio
.
.
.
.
.
.
.
.
.
.
. 105
. 105
Capítulo 10. Gestión del acceso de
usuario a las funciones de mensajería 107
Asignación de roles y políticas para el acceso a
envío de correos . . . . . . . . . . .
Roles y permisos en Marketing Platform y
Campaign . . . . . . . . . . . .
Acerca de las políticas de seguridad . . . .
Permisos de mensajería en Campaign . . . .
Realización de roles y permisos disponibles .
¿Cómo evalúa Campaign los permisos?. . .
Definición de estados de permiso. . . . .
Permisos de envíos de correos en Campaign .
Permisos para la categoría Activos digitales .
Permisos para la categoría Documentos. . .
Permisos para la categoría Administración de
correo electrónico . . . . . . . . . .
Permisos de mensajería para eMessage . . . .
Asignación de roles de eMessage . . . . .
Control de dominios de correo electrónico y
dominios de enlace corto . . . . . . . .
Mantenimiento de dominios de correo
electrónico alojado. . . . . . . . . .
Configuración de la dirección y del nombre de
visualización de remitente predeterminados . .
Cómo controlar el acceso a la lista de mensajes
enviados . . . . . . . . . . . . . .
Cómo otorgar el acceso a la lista de mensajes
enviados . . . . . . . . . . . . .
Cómo denegar el acceso a la lista de mensajes
enviados . . . . . . . . . . . . .
Cómo habilitar la restricción a la lista de
mensajes enviados. . . . . . . . . .
Permisos para informes de eMessage . . . .
. 107
.
.
.
.
.
.
.
.
.
108
108
110
111
112
112
113
113
114
. 115
. 116
. 116
. 117
. 118
. 119
. 120
. 121
. 121
. 122
. 123
92
93
94
94
95
95
Capítulo 8. Programas de utilidad para
eMessage . . . . . . . . . . . . . 97
El script RLU .
Script de seguimiento de respuestas y contactos
(RCT) de eMessage . . . . . . . . . . . . 98
Script MKService_rct de eMessage . . . . . . . 99
configTool . . . . . . . . . . . . . . 100
Para hacer copia de seguridad de los valores de
configuración . . . . . . . . . . . . 104
. 97
Antes de ponerse en contacto con el
soporte técnico de IBM . . . . . . . 125
Avisos . . . . . . . . . . . . . . 127
Marcas registradas. . . . . . . . . . . . 129
Consideraciones sobre la política de privacidad y
los términos de uso . . . . . . . . . . . 129
Capítulo 1. Mensajería alojada utilizando IBM Campaign e IBM
eMessage
Cuando IBM® Campaign se integra con IBM eMessage, puede utilizar eMessage
para realizar campañas de marketing por correo electrónico altamente
personalizadas.
eMessage proporciona acceso a recursos alojados por IBM de forma que puede
diseñar, enviar y supervisar mensajes personalizados individualmente en función
de la información almacenada en su despensa de datos de clientes.
v En Campaign, utilice diagramas de flujo para crear listas de destinatarios de
correo electrónico y seleccione datos de personalización para cada destinatario.
v En eMessage, utilice recursos de capacidad de entrega, transmisión y diseño de
correo electrónico alojados por IBM para realizar campañas de marketing por
correo electrónico.
Cómo definir una cuenta de correo electrónico alojada con IBM
Cuando usted adquiere una suscripción a eMessage, IBM crea una cuenta de
correo electrónico alojada en su nombre y le envía las credenciales de cuenta que
necesitará para utilizar las características de eMessage. Aplicará estas credenciales
cuando configure las aplicaciones locales de IBM EMM para acceder al entorno de
correo electrónico alojado sobre conexiones seguras.
Debe tener una cuenta válida para acceder a los recursos de correo electrónico que
IBM proporciona como servicio de software. Si su instalación de IBM EMM incluye
diversas particiones y tiene previsto utilizar eMessage en más de una partición,
necesita una cuenta de correo electrónico alojada para cada partición. No puede
compartir cuentas de correo electrónico entre distintas instalaciones o particiones.
El hecho de definir una cuenta de correo electrónico alojada es el inicio del proceso
de inicio, que dura aproximadamente 90 días. Para una descripción general del
proceso, consulte “Descripción general del proceso de inicio”.
Descripción general del proceso de inicio
Puede activar las características de correo electrónico en IBM Campaign, para
dirigir campañas de marketing por correo electrónico altamente dirigidas y
rastreables. Campaign utiliza funciones de correo electrónico proporcionadas por
IBM eMessage a través de recursos alojados en centros de datos en Estados Unidos
y Reino Unido. Se incluye una cuenta para acceder a estos recursos en la
suscripción de eMessage.
IBM comienza el proceso de inicio después de crear la cuenta de correo electrónico
alojada. IBM ayuda a familizarizarse con eMessage, a conectarse con recursos de
correo electrónico alojados y a crearse una reputación como comercial por correo
electrónico legítimo entre los principales proveedores de servicios de Internet (ISP).
El proceso continúa en tres fases. Los equipos de los servicios profesionales y de
los servicios para cuentas de correo electrónico de IBM le guían en el proceso.
© Copyright IBM Corp. 1999, 2015
1
El consultor de los Servicios profesionales es el principal punto de contacto con
IBM durante el proceso de inicio. Una vez completado el proceso de inicio de la
cuenta, el consultor de los Servicios profesionales transfiere la responsabilidad de
soporte técnico principal al equipo de soporte técnico de productos de IBM .
A partir de entonces, dispone de un consultor de Servicios de cuenta de correo
electrónico (EAS, Email Account Services) en exclusiva que le proporciona
asistencia especial para problemas relacionados con el correo electrónico. Crearse
una reputación favorable en correo electrónico entre los principales proveedores de
servicios de Internet (ISP, Internet Service Providers) es esencial para asegurarse de
que sus campañas de marketing por correo electrónico llegan siempre a los
destinatarios objetivo. Cuando empieza a realizar envíos de correos, el consultor de
EAS revisa el rendimiento en la capacidad de entrega de los envíos de correos y le
sugiere formas para construirse gradualmente una reputación en correo electrónico.
Actividades e hitos del proceso de inicio
Planificación
Lo que ocurre
Quién es el responsable
Enviar las credenciales de cuenta de correo electrónico y el
Kit de bienvenida, incluyendo la hoja de trabajo para iniciar
el correo electrónico.
Servicios de cuenta de
correo electrónico de IBM
Planificar una teleconferencia para presentar a todas las
partes implicadas, revisar la planificación para el inicio y
comprender los objetivos del marketing por correo
electrónico.
Servicios profesionales de
IBM
Completar la Hoja de trabajo para iniciar el correo electrónico Su organización
especificando los requisitos del dominio de correo electrónico
y las previsiones de envío de correos.
Crear su reputación en correo electrónico
2
Lo que ocurre
Quién es el responsable
Suministrar la cuenta de correo electrónico utilizando la
información proporcionada durante la teleconferencia y en la
Hoja de trabajo para iniciar el correo electrónico.
Operaciones de correo
electrónico de IBM
IBM eMessage: Guía del administrador y de inicio
Lo que ocurre
Quién es el responsable
Iniciar envíos de correos de prueba para seleccionar cuentas
de prueba con los principales ISP. Para completar esta fase se
necesitan aproximadamente 30 días.
Operaciones de correo
electrónico de IBM
Activar eMessage en IBM Campaign.
Su organización (con el
soporte técnico de IBM)
Configurar el acceso a los recursos de correo electrónico
alojados. Consulte al asesor de EAS el centro de datos que
debe especificar.
Su organización (con el
soporte técnico de IBM)
Iniciar el envío de correos. Para crearse una reputación
favorable en correo electrónico, realice primero envíos de
correos pequeños, seguidos en el tiempo de envíos más
grandes y más frecuentes. Los ISP a menudo intentan limitar
el correo no deseado bloqueando los envíos de correos muy
grandes o frecuentes que no reconozcan como legítimos.
Su organización (con el
soporte técnico de IBM)
Proporcionar resultados de capacidad de entrega y ayuda
para establecer una reputación a medida que aumentan los
volúmenes y la frecuencia de los envíos de correos.
Servicios de cuenta de
correo electrónico de IBM
Producción
Lo que ocurre
Quién es el responsable
Enviar correos de un volumen y frecuencia normales.
Su organización
Transferir la responsabilidad principal de contacto al equipo
de soporte técnico de IBM.
Servicios profesionales de
IBM
Mantener el compromiso de consultar sobre cuestiones de
Servicios de cuenta de
correo electrónico. Establecer contacto de forma regular para
correo electrónico de IBM
mantener el soporte de cuentas de correo electrónico de forma
continuada.
Antes de empezar a trabajar con eMessage
Antes de empezar el proceso de inicio de correo electrónico alojado, tenga en
cuenta las cuestiones siguientes.
v Algunas configuraciones requieren reiniciar el servidor de aplicaciones web.
Planifique la actividad de configuración de eMessage de forma que no interfiera
con la ejecución de grandes diagramas de flujo ni con otras actividades de
Campaign.
v IBM le pide que nombre un individuo que sirva como principal punto de
contacto durante el proceso de inicio.
v Solicite credenciales de cuenta de correo electrónico alojada antes de iniciar el
proceso de inicio. Utilizará estas credenciales para configurar los sistemas para
que accedan a la cuenta.
v Consulte al personal de administración de la red. eMessage requiere unos rangos
de puerto específicos para establecer comunicación con IBM EMM Hosted
Services.
v Confirme que tiene los permisos de red apropiados para realizar cambios de
configuración.
Capítulo 1. Mensajería alojada utilizando IBM Campaign e IBM eMessage
3
4
IBM eMessage: Guía del administrador y de inicio
Capítulo 2. Configuración del entorno local de IBM EMM para
eMessage
Para utilizar eMessage para utilizar mensajes de correo electrónico alojado es
necesario hacer cambios en la instalación local de IBM EMM. Complete los pasos
que se describen en las secciones siguientes.
v “Habilitación de funciones de eMessage en Campaign”
v “Registro de eMessage manualmente” en la página 6
v “Especificación de las características de las tablas de sistema de eMessage” en la
página 7
v “Correlación necesaria para tablas del sistema de eMessage en Campaign” en la
página 9
v “Configuración del acceso a las tablas del sistema local de eMessage” en la
página 8
v “Reinicio necesario del servidor de aplicaciones web para Campaign” en la
página 9
Si el entorno contiene diversas particiones, repita estos pasos para cada partición
de Campaign en la que utilice IBM eMessage. Para obtener más información sobre
cómo crear y trabajar con diversas particiones, consulte la publicación IBM
Campaign, Guía de instalación.
Habilitación de funciones de eMessage en Campaign
Cuando se instala Campaign, el instalador instala también eMessage en la partición
predeterminada, pero no lo habilita. Las funciones de eMessage no están
disponibles hasta que se habilita eMessage.
Antes de empezar
Confirme que eMessage se ha registrado correctamente con IBM Marketing
Platform.
Registrar eMessage con Marketing Platform forma parte del proceso de instalación
de IBM Campaign.
Procedimiento
1.
En IBM Marketing Platform, edite Campaign > partitions > partition[n] >
server > internal > eMessageInstalled.
2. Para habilitar eMessage, debe cambiar el valor a yes.
Tareas relacionadas:
“Confirmación de registro de eMessage”
Confirmación de registro de eMessage
IBM eMessage debe estar registrado en IBM Marketing Platform. Para confirmar
que eMessage se ha registrado correctamente, debe examinar la configuración de
Marketing Platform.
© Copyright IBM Corp. 1999, 2015
5
Procedimiento
1. Inicie sesión en IBM EMM.
2. Vaya a Valores > Configuración.
3. Busque la categoría de configuración eMessage.
IBM eMessage está registrado en Marketing Platform si la categoría eMessage
aparece en jerarquía de propiedades de configuración.
Qué hacer a continuación
Si la categoría eMessage no aparece en la jerarquía de propiedades, consulte la IBM
Campaign, Guía de instalación para obtener información sobre cómo registrar
eMessage manualmente.
Si la categoría de eMessage está disponible, debe habilitar funciones de eMessage
en Campaign.
Tareas relacionadas:
“Habilitación de funciones de eMessage en Campaign” en la página 5
Registro de eMessage manualmente
Si el instalador de eMessage no puede acceder a las tablas de sistema de Marketing
Platform durante el proceso de instalación, debe ejecutar la utilidad configTool
para registrarlo manualmente.
Acerca de esta tarea
De forma predeterminada, el instalador de Campaign registra automáticamente
eMessage con las tablas de sistema de Marketing Platform sin habilitar eMessage.
En algunas situaciones, el instalador de Campaign no establece conexión con las
tablas de sistema de Marketing Platform para que registren automáticamente
eMessage.
Si el instalador no registra eMessage automáticamente, debe registrar eMessage
manualmente con la utilidad configTool que se proporciona con la instalación de
IBM EMM.
Procedimiento
1. En la instalación de Marketing Platform, navegue al directorio tools\bin.
La utilidad configTool se encuentra en el directorio tools\bin. El directorio de
instalación de eMessage es un subdirectorio del directorio de instalación de
Campaign.
2. Ejecute el mandato, configTool -r eMessage -f
"ruta_completa_al_directorio_de_instalación_de_eMessage\conf\
emessage_configuration.xml"
Visualizar las opciones de menú de eMessage
Para utilizar IBM eMessage, debe actualizar la configuración del sistema de modo
que las opciones de menú para eMessage se visualicen en la interfaz de IBM
Marketing Platform. Para visualizar las opciones obligatorias, utilice el programa
de utilidad configTool que se suministra con la instalación de IBM EMM.
6
IBM eMessage: Guía del administrador y de inicio
Debe ejecutar configTool con parámetros específicos para cada opción de menú de
eMessage. Al ejecutar configTool se actualizan los valores de configuración del
sistema. Debe reiniciar el servidor de aplicaciones web para aplicar los cambios.
Aunque eMessage se instala con Campaign, las opciones de menú de eMessage no
aparecen hasta que se ejecuta configTool y se reinicia el servidor de aplicaciones
web. En el directorio tools de la instalación de Marketing Platform, encontrará el
programa de utilidad configTool en la carpeta bin.
Nota: Debe especificar una ruta al directorio de instalación de eMessage como
parámetro de configTool. El directorio de instalación de eMessage es un
subdirectorio del directorio de instalación de Campaign.
v Para visualizar los Valores de eMessage en el menú Valores.
configTool.bat -v -i -p "Affinium|suite|uiNavigation|settingsMenu" -f
"ruta_completa_al_directorio_de_instalación_de_eMessage\conf\
emessage_op_odsettings_navigation.xml"
v Para visualizar los Envíos de correos de eMessage en el menú Campaña.
configTool.bat -v -i -p "Affinium|suite|uiNavigation|mainMenu|Campaign"
-f "ruta_completa_al_directorio_de_instalación_de_eMessage\conf\
emessage_op_mailings_navigation.xml"
v Para visualizar los Documentos de eMessage en el menú Campaña.
configTool.bat -v -i -p "Affinium|suite|uiNavigation|mainMenu|Campaign"
-f "ruta_completa_al_directorio_de_instalación_de_eMessage\conf\
emessage_op_documents_navigation.xml"
v Para visualizar las Herramientas de análisis de eMessage en el menú
Herramientas de análisis.
configTool.bat -v -i -p "Affinium|suite|uiNavigation|mainMenu|Analytics"
-f "ruta_completa_al_directorio_de_instalación_de_eMessage\conf\
emessage_op_analytics_navigation.xml"
Para verificar que ha añadido satisfactoriamente las opciones de menú, tras
reiniciar el servidor de aplicaciones web, inicie sesión en IBM EMM y abra los
menús Valores, Campaña, y Herramientas de análisis y compruebe que aparecen
las opciones correspondientes a eMessage.
Especificación de las características de las tablas de sistema de
eMessage
IBM eMessage requiere información que describa el tipo, esquema y JDBC de
conexión de las tablas de sistema de eMessage en su instalación. Las tablas de
sistema de eMessage se crean en el esquema de Campaign como parte del proceso
de instalación de Campaign.
Procedimiento
Proporcione la información necesaria en las siguientes propiedades de
configuración. Consulte la ayuda en línea de Marketing Platform para cada
propiedad para obtener más información sobre cómo establecer las propiedades de
configuración.
v eMessage > partitions > partition [n] < dataSources > systemTables > type
v eMessage > partitions > partition [n] < dataSources > systemTables >
schemaName
v eMessage > partitions > partition [n] < dataSources > systemTables >
jdbcBatchSize
Capítulo 2. Configuración del entorno local de IBM EMM para eMessage
7
v eMessage > partitions > partition [n] < dataSources > systemTables >
jdbcClassName
v eMessage > partitions > partition [n] < dataSources > systemTables >
jdbcURI
Qué hacer a continuación
Para obtener información adicional sobre las propiedades de configuración y la
configuración de eMessage, consulte Capítulo 6, “Configuraciones para IBM
eMessage”, en la página 43.
Configurar el acceso a las tablas del sistema de eMessage
Los componentes de eMessage deben poder acceder a las tablas del sistema de
forma automática, sin ninguna entrada manual del usuario. Para permitir a los
componentes de eMessage acceder a las tablas del sistema del esquema de
Campaign sin solicitar un inicio de sesión manual a la base de datos, debe definir
un usuario de sistema en IBM Marketing Platform. Debe configurar este usuario de
sistema para proporcionar las credenciales de acceso a la base de datos que
contiene el esquema de Campaign.
Los usuarios de sistema y los orígenes de datos se configuran en IBM Marketing
Platform. Para obtener más información sobre cómo crear usuarios del sistema y
orígenes de datos, consulte la publicación IBM Marketing Platform, Guía del
administrador.
Configuración del acceso a las tablas del sistema local de
eMessage
IBM eMessage necesita poder acceder a las tablas de sistema de eMessage que se
encuentran en el esquema de Campaign. Para permitir que los componentes de
eMessage accedan a tablas del sistema en el esquema de Campaign sin solicitar un
inicio de sesión de base de datos manual, debe especificar un usuario del sistema
de eMessage para proporcionar las credenciales de acceso de base de datos
necesarias.
Acerca de esta tarea
El usuario del sistema que accede a la base de datos está asociado a un origen de
datos de IBM Marketing Platform que contiene las credenciales de inicio de sesión
de la base de datos que aloja el esquema de Campaign.
Para obtener más información sobre las propiedades de configuración de la tabla
del sistema, consulte “eMessage | particiones | partición[n] | dataSources |
systemTables” en la página 57.
Procedimiento
1. Especifique el usuario del sistema que ha definido en IBM Marketing Platform.
Edite la siguiente propiedad de configuración.
eMessage > partitions > partition [n] < dataSources > systemTables >
asmUserForDBCredentials
2. Especifique las credenciales de inicio de sesión de la base de datos que contiene
el esquema de Campaign y las tablas del sistema de eMessage. Edite la
siguiente propiedad de configuración.
8
IBM eMessage: Guía del administrador y de inicio
eMessage > partitions > partition [n] < dataSources > systemTables >
amDataSourceForDBCredentials
Correlación necesaria para tablas del sistema de eMessage en
Campaign
Debe correlacionar las tabla de sistema de eMessage del esquema de Campaign
con las correspondientes tablas de base de datos de eMessage. Las tablas de
sistema de eMessage tienen eMessage en el nombre de tabla.
En Campaign, correlacione las siguientes tablas de sistema de eMessage.
v eMessageTabla de lista de salida
v Tabla de correlación de campos de audiencia de lista de salida de eMessage
v Tabla de envío de correos de eMessage
v Tabla de instancia de envío de correos de eMessage
v Tabla de correlación de columnas de tablas de datos de eMessage
v Tabla de correlación de campos de personalización de eMessage
v Tabla de uso de campos de personalización de tabla de eMessage
Para obtener información sobre la correlación de tablas, consulte la publicación
IBM Campaign, Guía del administrador.
Reinicio necesario del servidor de aplicaciones web para Campaign
Tras realizar cambios en las configuraciones de Campaign y eMessage, debe
reiniciar el servidor de aplicaciones web que aloja a Campaign.
Consulte la documentación de su servidor de aplicaciones web para obtener
instrucciones sobre cómo reiniciar.
Capítulo 2. Configuración del entorno local de IBM EMM para eMessage
9
10
IBM eMessage: Guía del administrador y de inicio
Capítulo 3. Conexión a servicios de correo electrónico
alojados
Para acceder a servicios de correo electrónico alojado proporcionados por IBM,
debe configurar una conexión entre la instalación local de IBM EMM y IBM EMM
Hosted Services.
Los usuarios de marketing acceden a las características de eMessage a través de la
interfaz de Campaign. Para trabajar con eMessage es necesario que establezca una
conexión a Internet automática y segura que Campaign pueda utilizar para cargar
listas de destinatarios de correo electrónico en IBM EMM Hosted Services. Los
componentes de eMessage instalados con Campaign también utilizan esta conexión
para descargar datos de contacto y respuesta en las tablas de sistema de eMessage
en el esquema de Campaign.
Nota: Cada instancia de Campaign requiere una conexión exclusivo a IBM EMM
Hosted Services. Si la instalación de Campaign incluye diversas particiones, cada
partición requiere una cuenta de correo electrónico alojada distinta. Las cuentas
pueden compartir la conexión IP a IBM EMM Hosted Services.
Todas las comunicaciones entre IBM EMM y IBM EMM Hosted Services se llevan a
cabo sobre SSL. Cada comunicación de IBM EMM Hosted Services es una
respuesta a una solicitud del entorno local. IBM EMM Hosted Services nunca
intenta iniciar una conexión con la red corporativa. Todas las comunicaciones con
IBM EMM Hosted Services se originan desde detrás del cortafuegos de la empresa.
Requisitos para configurar la conexión con IBM EMM Hosted Services
Para configurar una conexión con IBM EMM Hosted Services se requieren
permisos de administración, así como información sobre la cuenta de correo
electrónico alojada establecida para la organización.
Para configurar una conexión correo electrónico alojada, se necesita lo siguiente.
v Nombre de usuario y contraseña proporcionada por IBM para la cuenta de
correo electrónico alojada
v Permisos para crear y modificar usuarios del sistema en IBM Marketing Platform
v Acceso administrativo a las propiedades de configuración que se mantienen en
la instalación local de IBM Marketing Platform
v Acceso administrativo al servidor de aplicaciones web donde están desplegados
IBM Marketing Platform y Campaign
Debe saber, o poder de consultar a las personas que lo saben, los requisitos
corporativos de seguridad de datos. Antes de empezar, revise estos procedimientos
para entender cómo crear la necesaria conexión en conformidad con las
restricciones corporativas de cortafuegos.
Debe estar familiarizado con cómo configurar conexiones de confianza en su
servidor de aplicaciones web, ya sea IBM WebSphere u Oracle WebLogic.
© Copyright IBM Corp. 1999, 2015
11
Requisitos para cargar datos a IBM EMM Hosted Services
Hay un componente de eMessage, denominado el Cargador de Listas de
Destinatarios (RLU -Recipient List Uploader) que forma parte de su instalación de
IBM Campaign. El RLU utiliza el FTP en modo pasivo para gestionar la carga de
listas de envío de correos y los metadatos asociados en IBM EMM Hosted Services.
eMessage utiliza FTP pasivo para cargar datos. Al utilizar FTP pasivo, el RLU
inicia todas las solicitudes de conexión de subida como el cliente local. IBM EMM
Hosted Services nunca inicia una solicitud de conexión a la red.
eMessage admite dos tipos de métodos de FTP pasivo, el FTP explícito y el FTP
implícito. El FTP explícito es el método predeterminado utilizado para cargar listas
de destinatarios. Para utilizar FTP implícito que se deben hacer cambios en las
propiedades de configuración de eMessage.
Para obtener más información sobre FTP en modo pasiva y sobre cómo utilizar
FTP sobre SSL, consulte RFC959 y RFC2228.
Conceptos relacionados:
“Conexión de carga predeterminada mediante FTP explícito” en la página 13
“Carga de datos con FTP implícito” en la página 14
Requisitos de conexión y puertos
Para establecer comunicación con IBM EMM Hosted Services, debe disponer de
una conexión a Internet. IBM EMM Hosted Services utiliza puertos específicos.
La instalación local de IBM EMM y IBM EMM Hosted Services utiliza los
siguientes puertos para comunicarse.
HTTPS: puerto 443
Puertos de comandos FTP
v FTP explícito: puerto 21
v FTP implícito: puerto 990
Puertos de carga de datos FTP
v Centro de datos de EE.UU.
FTP explícito: puertos del 15393 al 15424
FTP implícito: puertos del 15600 al 15701
v Centro de datos del Reino Unido
FTP explícito: puertos del 15393 al 15443
FTP implícito: puertos del 15600 al 15650
IBM EMM Hosted Services nunca inicia una conexión con la red local. Únicamente
responde a las solicitudes de conexión iniciadas desde detrás de su cortafuegos.
12
IBM eMessage: Guía del administrador y de inicio
Conexión de carga predeterminada mediante FTP explícito
De forma predeterminada, el Cargador de listas de destinatarios (RLU) utiliza el
FTP explícito cuando el sistema carga una lista de destinatarios de correo
electrónico. La lista de destinatarios también se denomina Tabla de lista de salida
(OLT)
El RLU establece una conexión con IBM EMM Hosted Services utilizando el puerto
de comandos FTP predeterminado (puerto 21). Emite un comando para solicitar
que la sesión se cifre sobre SSL. Mediante la conexión segura, el RLU negocia con
el servidor FTP para establecer un enlace SSL aparte sobre un puerto seleccionado
aleatoriamente por el RLU. Para obtener más información sobre el FTP explícito,
consulte el RFC 2228.
En el diagrama siguiente se ilustra el método predeterminado para cargar datos de
destinatarios de Campaign a IBM EMM Hosted Services.
En la tabla siguiente se describe la secuencia de conexión.
Paso
Acción
Descripción
1
Solicitud de conexión FTP inicial Desde detrás del cortafuegos corporativo, el
del cliente
RLU inicia una sesión de carga de datos
utilizando FTP sobre SSL explícito. El RLU
envía la solicitud de conexión SSL a la
dirección de IBM EMM Hosted Services.
Debe configurar previamente esta dirección.
Para iniciar la sesión, el RLU abre un
puerto seleccionado al azar en el lado del
cliente y como puerto de comandos FTP.
IBM EMM Hosted Services acepta
conexiones de comandos FTP cifrados en el
puerto 21.
Capítulo 3. Conexión a servicios de correo electrónico alojados
13
Paso
Acción
Descripción
2
Respuesta del servidor FTP
remoto
Como respuesta a la solicitud del RLU de
establecer una sesión SSL segura, el
servidor FTP designa el puerto de datos
FTP sobre el que aceptará la carga de listas
de destinatarios.
3
Carga de listas de destinatarios
El RLU inicia la carga de la lista en el
puerto de datos especificado. Cuando
finaliza la carga, el RLU libera la conexión
FTP.
Para ver el rango de puertos de datos que puede especificar el servidor FTP,
consulte “Requisitos de conexión y puertos” en la página 12.
Conceptos relacionados:
“Requisitos para cargar datos a IBM EMM Hosted Services” en la página 12
Tareas relacionadas:
“Configuración de direcciones para conectarse a IBM EMM Hosted Services” en la
página 25
“Configuración del usuario del sistema que accede a IBM EMM Hosted Services”
en la página 24
Configuración de la conexión FTP explícita
No es necesaria ninguna configuración adicional. De forma predeterminada, el
RLU utiliza la FTP explícita.
Carga de datos con FTP implícito
Puede configurar el RLU para que utilice FTP implícito para cargar listas de
destinatarios de correo electrónico. El FTP implícito utiliza el puerto 990 para
establecer una conexión con IBM EMM Hosted Services.
Al habilitar el RLU para FTP implícito, toda la sesión se cifra desde el inicio. El
FTP implícito es diferente de la conexión mediante FTP explícito, donde el RLU
solicita explícitamente un enlace seguro.
Para utilizar FTP implícito para subir las listas de destinatarios, debe descubrir y
configurar una propiedad de configuración del sistema en las propiedades de
configuración de eMessage.
El siguiente diagrama ilustra cómo el RLU carga datos de destinatarios en IBM
EMM Hosted Services cuando el sistema está configurado para utilizar FTP
implícito.
14
IBM eMessage: Guía del administrador y de inicio
En la tabla siguiente se describe la secuencia de conexión.
Paso
Acción
Descripción
1
Solicitud de conexión FTP inicial Desde detrás del cortafuegos corporativo, el
del cliente
RLU inicia una sesión de carga de datos
utilizando FTP sobre SSL. El RLU envía la
solicitud de conexión SSL a la dirección de
IBM EMM Hosted Services. Debe configurar
previamente esta dirección.
Para iniciar la sesión, el RLU abre el puerto
990. IBM EMM Hosted Services únicamente
acepta conexiones de comandos FTP
cifrados en el puerto 990.
2
Respuesta del servidor FTP
remoto
Si IBM EMM Hosted Services reconoce la
solicitud como una solicitud de FTP
implícito válida, el servidor FTP acepta la
solicitud de conexión. Designa el puerto de
datos FTP para utilizar para la carga de
lista de destinatarios.
Consulte “Requisitos de conexión y
puertos” en la página 12 para saber el
rango de puertos de datos que el servidor
FTP puede especificar.
3
Carga de listas de destinatarios
El RLU inicia la carga de la lista en el
puerto de datos especificado. Cuando
finaliza la carga, el RLU libera la conexión
FTP.
Conceptos relacionados:
“Requisitos para cargar datos a IBM EMM Hosted Services” en la página 12
Capítulo 3. Conexión a servicios de correo electrónico alojados
15
Acceso a los parámetros de configuración para carga de FTP
implícito
Para configurar el sistema para utilizar FTP implícito para cargar datos, debe editar
las propiedades de configuración que están ocultas de forma predeterminada.
Puede ejecutar un script para que se muestren las propiedades.
Acerca de esta tarea
Para configurar el sistema para utilizar FTP implícito para cargar datos, debe hacer
visibles las siguientes propiedades de configuración. De forma predeterminada,
estas propiedades están ocultas.
v eMessage > serverComponentsAndLocations > hostedServices > ftpPort
v eMessage > serverComponentsAndLocations > hostedServices >
useFTPImplicitSSL
Este procedimiento muestra las propiedades de configuración, pero no las
configura. Para habilitar el FTP implícito, debe acceder a estas propiedades de la
configuración de eMessage y configurarlas. Para obtener información sobre cómo
configurar estas propiedades, consulte “Habilitación de la carga de FTP implícito”.
Procedimiento
Para mostrar ftpPort y useFTPImplicitSSL, en el directorio Tools de su instalación
de eMessage, ejecute el script switch_config_visibility desde el script de línea de
comandos, como se detalla a continuación.
Windows
\switch_config_visibility.bat -p
"Affinium|eMessage|serverComponentsAndLocations|hostedServices|ftpPort" -v
true
\switch_config_visibility.bat -p
"Affinium|eMessage|serverComponentsAndLocations|hostedServices|
useFTPImplicitSSL" -v true
UNIX
/switch_config_visibility.sh
"Affinium|eMessage|serverComponentsAndLocations|hostedServices|ftpPort" -v
true
/switch_config_visibility.sh
"Affinium|eMessage|serverComponentsAndLocations|hostedServices|
useFTPImplicitSSL" -v true
Qué hacer a continuación
Debe reiniciar el servidor de aplicaciones web para hacer estas propiedades
visibles en la configuración de eMessage.
Tareas relacionadas:
“Configuración del acceso a historial adicional de ejecución de envíos de correos”
en la página 46
Habilitación de la carga de FTP implícito
Para habilitar el FTP implícito, debe actualizar la configuración de eMessage.
16
IBM eMessage: Guía del administrador y de inicio
Antes de empezar
Para completar esta tarea, debe revelar dos propiedades de configuración. Para
obtener más información, consulte “Acceso a los parámetros de configuración para
carga de FTP implícito” en la página 16.
Procedimiento
1. Vaya a Valores > Configuración > eMessage > serverComponentsAndLocations
> hostedServices.
2. Pulse en Editar configuración.
v Confirme que useFTPImplicitSSL está establecido en true.
v Establezca ftpPort en 990.
3. Guarde los cambios que ha realizado.
Qué hacer a continuación
Los cambios no entrarán en vigor hasta que reinicie el servidor de aplicaciones
web y el escucha de Campaign. Puede hacer esto ahora o esperar hasta completar
todos los pasos de la configuración de inicio.
Conexión mediante un proxy HTTP
Si las reglas del cortafuegos corporativo prohíben la comunicación directa con
Internet público, puede conectar a IBM EMM Hosted Services mediante un
servidor proxy HTTP. eMessage da soporte a la conexión mediante un servidor
proxy SOCKS que permite tráfico HTTPS y FTPS.
eMessage da soporte al protocolo SOCKS versión 5.
Nota: Para conectar a IBM EMM Hosted Services mediante un servidor proxy,
debe instalar Campaign versión 8.5.0.1 o superior.
El diagrama siguiente muestra la comunicación entre el entorno local y el entorno
hospedado cuando se utiliza un proxy SOCKS.
Capítulo 3. Conexión a servicios de correo electrónico alojados
17
Puede configurar un servidor de proxy SOCKS en el entorno local in situ. Antes de
empezar a configurar el servidor proxy, confirme que cumple los requisitos
siguientes.
v El servidor proxy debe ser un servidor proxy SOCKS.
v El servidor proxy debe poder acceder al entorno de eMessage OD. El servidor
debe permitir tráfico a/de los puertos configurados para el centro de datos que
utiliza la cuenta de correo electrónico hospedado. IBM mantiene los centros de
datos en EE.UU. y en el Reino Unido.
v El entorno de eMessage OP debe poder acceder al servidor proxy SOCKS.
Configuración del direccionamiento para tráfico FTPS y HTTPS
mediante proxy SOCKS
Para utilizar un proxy SOCKS para acceder a los recursos de correo electrónico
hospedados, debe actualizar el servidor de aplicaciones web donde ha desplegado
IBM Campaign. También debe modificar los scripts de inicio para el RCT y RLU
de eMessage.
Procedimiento
v Para tráfico FTPS, aplique las siguientes configuraciones al RLU y al servidor de
aplicaciones web.
Configuración
Descripción
-Dibm.unica.emessage.ftps.proxy.host = <host_socks>
Nombre de host o IP del
proxy SOCKS.
-Dibm.unica.emessage.ftps.proxy.port = <puerto_socks>
Puerto en el que se ejecuta
el proxy SOCKS.
18
IBM eMessage: Guía del administrador y de inicio
Configuración
Descripción
-Dibm.unica.emessage.ftps.proxy.match.hosts=
<lista separada por comas de nombres de host y direcciones IP>
Nombres de host y
direcciones IP que se
utilizan al direccionar tráfico
mediante el proxy SOCKS.
Proporcione valores
específicos al centro de
datos utilizado por la
cuenta.
Cuando el entorno locales y el entorno hospedado establecen una conexión de
datos, la dirección IP que se especifica para
-Dibm.unica.emessage.ftps.proxy.match.hosts es la dirección IP que el servidor
FTP remoto envía al cliente FTP local.
Establezca -Dibm.unica.emessage.ftps.proxy.match.hosts en uno de los valores
siguientes. El valor que especifique dependerá del centro de datos que utilice la
cuenta de correo electrónico hospedada.
Nombre de host y direcciones IP del centro de datos de EE.UU.:
-Dibm.unica.emessage.ftps.proxy.match.hosts=
ftpem.unicaondemand.com,192.86.44.132,192.86.44.133,192.86.44.134,192.86.45.132,192.86.45.133,192.86.45.134
Nombre de host y direcciones IP del centro de datos del Reino Unido:
-Dibm.unica.emessage.ftps.proxy.match.hosts=
ftp-emeu.unicaondemand.com,192.86.45.132,192.86.45.133,192.86.45.134,192.86.44.132,192.86.44.133,192.86.44.134
v Para tráfico HTTPS, aplique las siguientes configuraciones al RCT y al servidor
de aplicaciones web.
Configuración
Descripción
-Dibm.unica.emessage.https.proxy.host=<socksHost>
Nombre de host o IP del
proxy SOCKS
-Dibm.unica.emessage.https.proxy.port=<puerto_socks>
Puerto en el que se ejecuta
el proxy SOCKS
-Dibm.unica.emessage.https.proxy.type=SOCKS
Tipo de servidor proxy.
Debe utilizar un servidor
proxy SOCKS.
Configuración de la autenticación para acceder a un proxy
SOCKS
Si el proxy SOCKS requiere autenticación, debe configurar el servidor de
aplicaciones web, el RLU y el RCT para proporcionar las credenciales de acceso.
Procedimiento
Configure lo siguiente para el servidor de aplicaciones web, el RLU y el RCT. Los
valores de nombre_usuario y contraseña deben ser las credenciales necesarias para
la autenticación en el proxy.
-Dibm.unica.emessage.proxy.auth.user = <nombre_usuario>
-Dibm.unica.emessage.proxy.auth.password = <contraseña>
Capítulo 3. Conexión a servicios de correo electrónico alojados
19
Configuración del RCT para utilizar un proxy SOCKS
Debe modificar el RCT para la comunicación mediante un servidor proxy SOCKS.
Los valores necesarios dependen del sistema operativo.
Procedimiento
v Para el RCT en entornos Windows, añada los siguientes argumentos de proxy a
common.bat. El archivo common.bat se encuentra en el directorio //eMessage/bin
de su instalación local de eMessage.
set RCT_PROXY_ARGS=
-Dibm.unica.emessage.https.proxy.host=<PROXY_HOST>
-Dibm.unica.emessage.https.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.https.proxy.type=SOCKS
-Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER>
-Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD>
set RCT_JAVA_ARGS=%BASE_VM_ARGS% %RCT_MEM_ARGS%
%RCT_EXTRA_VM_ARGS% %RCT_PROXY_ARGS%
v Para el RCT en entornos UNIX, añada los siguientes argumentos de proxy a
common.sh. El archivo common.sh se encuentra en el directorio \\eMessage\bin de
su instalación local de eMessage.
Nota: No modifique directamente rlu.sh, rct.sh o setenv.sh. El sistema anula
temporalmente los cambios.
RCT_PROXY_ARGS="
-Dibm.unica.emessage.https.proxy.host=<PROXY_HOST>
-Dibm.unica.emessage.https.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.https.proxy.type=SOCKS
-Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER>
-Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD>"
RCT_JAVA_ARGS="${BASE_VM_ARGS} ${RCT_MEM_ARGS} ${RCT_EXTRA_VM_ARGS}
${RCT_PROXY_ARGS}"
Configuración del RLU para utilizar un proxy SOCKS
Debe modificar el RLU para la comunicación mediante un servidor proxy SOCKS.
Los valores necesarios dependen del sistema operativo.
Procedimiento
v Para el RLU en entornos Windows, añada los siguientes argumentos de proxy a
common.bat. El archivo common.bat se encuentra en el directorio //eMessage/bin
de su instalación local de eMessage.
20
IBM eMessage: Guía del administrador y de inicio
set RLU_PROXY_ARGS=
-Dibm.unica.emessage.ftps.proxy.host=<PROXY_HOST>
-Dibm.unica.emessage.ftps.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.ftps.proxy.match.hosts=<lista separada por comas de nombres
de host y direcciones IP>
-Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER>
-Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD>
set RLU_JAVA_ARGS=%BASE_VM_ARGS% %RLU_MEM_ARGS% %RLU_EXTRA_VM_ARGS%
%RLU_PROXY_ARGS%
v Para el RLU en entornos UNIX, añada los siguientes argumentos de proxy a
common.sh. El archivo common.sh se encuentra en el directorio \\eMessage\bin de
su instalación local de eMessage.
Nota: No modifique directamente rlu.sh, rct.sh o setenv.sh. El sistema anula
temporalmente los cambios.
RLU_PROXY_ARGS="
-Dibm.unica.emessage.ftps.proxy.host=<PROXY_HOST>
-Dibm.unica.emessage.ftps.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.ftps.proxy.match.hosts=<lista separada por comas de nombres
de host y direcciones IP>
-Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER>
-Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD>"
RLU_JAVA_ARGS="${BASE_JAVA_ARGS} ${RLU_MEM_ARGS} ${RLU_EXTRA_VM_ARGS}
${RLU_PROXY_ARGS}"
Configuración del servidor de aplicaciones web para utilizar un
proxy SOCKS
Para conectar a IBM EMM Hosted Services mediante un proxy SOCKS, debe
modificar la configuración del servidor de aplicaciones web. Para servidores IBM
WebSphere, puede modificar los argumentos JVM genéricos. Para servidores Oracle
Weblogic, puede modificar el script SetDomainEnv.
Procedimiento
v Si el servidor de aplicaciones web es IBM WebSphere, añada lo siguiente a los
argumentos JVM genéricos de WebSphere.
Capítulo 3. Conexión a servicios de correo electrónico alojados
21
-Dibm.unica.emessage.https.proxy.host=<PROXY_HOST>
-Dibm.unica.emessage.https.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.https.proxy.type=SOCKS
-Dibm.unica.emessage.ftps.proxy.host=<PROXY_HOST>
-Dibm.unica.emessage.ftps.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.ftps.proxy.match.hosts=<lista separada por comas de nombres
de host y direcciones IP>
-Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER>
-Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD>
v Si el servidor de aplicaciones web es Oracle Weblogic, modifique el script
setDomainEnv. Los valores necesarios dependen del sistema operativo.
En entornos Windows, realice los cambios siguientes:
JAVA_OPTIONS =%{JAVA_OPTIONS}
-Dibm.unica.emessage.https.proxy.host=<PROXY_HOST>
-Dibm.unica.emessage.https.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.https.proxy.type=SOCKS
-Dibm.unica.emessage.ftps.proxy.host=<PROXY_HOST>
-Dibm.unica.emessage.ftps.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.ftps.proxy.match.hosts=<lista separada por comas de nombres
de host y direcciones IP>
-Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER>
-Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD>
En entornos UNIX, realice los cambios siguientes:
JAVA_OPTIONS ='${JAVA_OPTIONS}
-Dibm.unica.emessage.https.proxy.host=<PROXY_HOST>
-Dibm.unica.emessage.https.proxy.port=<PROXY_PORT>
-Dibm.unica.emessage.https.proxy.type=SOCKS
-Dibm.unica.emessage.ftps.proxy.host=<PROXY_HOST>
-Dibm.unica.emessage.ftps.proxy.port=<POXY_PORT>
-Dibm.unica.emessage.ftps.proxy.match.hosts=<lista separada por comas de nombres
de host y direcciones IP>
-Dibm.unica.emessage.proxy.auth.user=<PROXY_AUTH_USER>
-Dibm.unica.emessage.proxy.auth.password=<PROXY_AUTH_PASSWORD>'
22
IBM eMessage: Guía del administrador y de inicio
Valor de puerto y frecuencia de descarga de datos
Como parte de la instalación de IBM Campaign, se instala un componente de
eMessage denominado Rastreador de respuestas y contactos (RCT). El RCT solicita
regularmente datos de respuestas y contactos de correo electrónico a IBM EMM
Hosted Services. De forma predeterminada, el RCT emite una solicitud de datos
cada 5 segundos.
El RCT emite las solicitudes de datos sobre HTTPS (HTTP sobre SSL). IBM EMM
Hosted Services acepta las solicitudes de conexión HTTPS en el puerto 443, y
únicamente de aquellos hosts que haya especificado durante el proceso de inicio de
cuenta de correo electrónico alojada.
Conceptos relacionados:
Capítulo 4, “Operación del rastreador de respuestas y contactos”, en la página 35
Requisito de usuario del sistema para acceder a IBM EMM Hosted
Services
Los componentes de eMessage tienen que poder acceder IBM EMM Hosted
Services sin necesidad de introducir manualmente ninguna credencial de inicio de
sesión. Para establecer el inicio de sesión automático, defina un usuario del sistema
en Marketing Platform que pueda proporcionar las credenciales de acceso
necesarias.
Para simplificar la administración de usuario y la resolución de problemas, puede
modificar un usuario del sistema existente para que acceda a los servicios alojados
y las tablas del sistema local. Puede configurar un único usuario del sistema que
suministre las credenciales a diversos sistemas. Por ejemplo, modificando la
configuración del usuario del sistema de Campaign se crea un único usuario que
puede acceder automáticamente a las tablas del sistema de IBM EMM Hosted
Services y de eMessage del esquema Campaign.
La credencial necesaria para acceder a IBM EMM Hosted Services son el nombre
de usuario y la contraseña que IBM proporciona para la cuenta de mensajería
alojada. Las credenciales que utilice dependerán de si se conecta al centro de datos
que IBM mantiene en los EE.UU. o al centro de datos del Reino Unido. Consulte
con IBM para conocer el centro de datos que debe utilizar.
Para obtener información específica sobre cómo configurar un usuario del sistema
para comunicarse con IBM EMM Hosted Services, consulte la publicación IBM
eMessage Guía de inicio y del administrador and Administrator's Guide.
Para obtener información general sobre cómo crear usuarios del sistema y orígenes
de datos, consulte la publicación IBM Marketing Platform Guía del administrador.
Requisito de acceso a la partición de IBM EMM Hosted Services
Se debe permitir que los componentes de IBM eMessage en la partición
proporcionen automáticamente credenciales de inicio de sesión válidas al intentar
comunicarse con IBM EMM Hosted Services. Para ello, debe añadir las credenciales
de inicio de sesión de IBM EMM Hosted Services a un usuario de Marketing
Platform. Este usuario se convierte en el usuario de sistema de eMessage.
Capítulo 3. Conexión a servicios de correo electrónico alojados
23
Puede añadir el origen de datos de la plataforma que contiene las credenciales de
IBM EMM Hosted Services al usuario del sistema de eMessage. Este usuario puede
ser el mismo usuario del sistema que accede a las tablas del sistema de Campaign
en la partición.
Los pasos para configurar usuarios del sistema para una partición son los mismos
que los que se siguen durante la instalación inicial de eMessage, que crearon la
primera partición. Para obtener detalles sobre cómo añadir credenciales de inicio
de sesión a un usuario del sistema de IBM EMM Hosted Services, consulte la
publicación IBM eMessage Guía del administrador y de inicio.
Las credenciales necesarias para acceder a IBM EMM Hosted Services son el
nombre de usuario y contraseña que IBM le proporcionó durante el proceso de
inicio.
Importante: Para cada partición adicional, debe solicitar un nombre de usuario y
contraseña distintos a IBM.
Configuración del usuario del sistema que accede a IBM EMM
Hosted Services
Los componentes de eMessage en Campaign deben poder acceder a IBM EMM
Hosted Services automáticamente, sin que se le solicite un inicio de sesión. Los
usuarios del sistema configurados en IBM Marketing Platform pueden hacer
referencia a un origen de datos que proporcione el nombre de usuario y contraseña
necesarios. Puede añadir el origen de datos a un usuario del sistema nuevo o a
cualquier usuario del sistema existente. Para simplificar la administración de
usuarios, puede actualizar un usuario del sistema que ya esté configurado para
acceder al esquema de Campaign para que pueda acceder también a IBM EMM
Hosted Services.
Antes de empezar
Para completar esta tarea, debe conocer el nombre de usuario y la contraseña de
IBM EMM Hosted Services que IBM ha asignado a su cuenta de correo electrónico
alojada. La recepción del nombre de usuario y la contraseña forma parte del
proceso de inicio de la cuenta..
Debe tener los permisos de acceso adecuados y saber cómo crear usuarios del
sistema y orígenes de datos en IBM Marketing Platform.
Acerca de esta tarea
Nota: Si su instalación contiene diversas particiones, debe llevar a cabo esta tarea
para cada una de las particiones. No se pueden compartir usuarios de sistema
entre distintas particiones.
Procedimiento
1. Cree un origen de datos de plataforma que contenga el nombre de usuario y la
contraseña necesarios para acceder a IBM EMM Hosted Services. Para obtener
los mejores resultados y facilitar el mantenimiento, ponga a este origen de
datos el nombre UNICA_HOSTED_SERVICES. Configure este origen de datos
como se indica a continuación.
En Inicio de sesión en origen de datos, escriba el nombre de usuario que ha
recibido de IBM durante el proceso de inicio de la cuenta.
24
IBM eMessage: Guía del administrador y de inicio
En Contraseña en origen de datos, escriba la contraseña que ha recibido de
IBM durante el proceso de inicio de la cuenta.
2. Especifique el origen de datos en la configuración de eMessage. Utilice la
propiedad de configuración amDataSourceForAcctCredentials.
Esta propiedad de configuración se encuentra en eMessage > partitions >
partition[n] > hostedAccountInfo > amDataSourceForAcctCredentials.
De forma predeterminada, el origen de datos especificado es
UNICA_HOSTED_SERVICES.
3. Especifique un usuario del sistema para acceder a IBM EMM Hosted Services.
Puede especificar un usuario existente o crear un usuario. En la configuración
de eMessage, utilice la propiedad de configuración amUserForAcctCredentials.
Esta propiedad de configuración se encuentra en eMessage > partitions >
partition[n] > hostedAccountInfo > amUserForAcctCredentials.
De forma predeterminada, el usuario predeterminado es asm_admin.
4. Añada el origen de datos configurado en el Paso 1 al usuario del sistema
especificado en el Paso 3.
Qué hacer a continuación
Debe reiniciar el servidor de aplicaciones web para que los cambios tengan efecto.
Conceptos relacionados:
“Conexión de carga predeterminada mediante FTP explícito” en la página 13
“Confirmación de las configuraciones del sistema” en la página 39
Configuración de las direcciones que se utilizan para conectarse a
IBM EMM Hosted Services
Para garantizar la correcta conexión con IBM EMM Hosted Services, debe
especificar las direcciones como valores de las propiedades de configuración en la
configuración de eMessage. Las direcciones de conexión que especifique
dependerán de si se conecta al centro de datos de IBM de Estados Unidos o al
centro de datos de IBM del Reino Unido.
Consulte IBM para confirmar el centro de datos que utiliza su cuenta de correo
electrónico alojada.
Para obtener más información sobre cómo configurar la información de conexión,
consulte “Configuración de direcciones para conectarse a IBM EMM Hosted
Services”.
Configuración de direcciones para conectarse a IBM EMM
Hosted Services
Para garantizar la correcta conexión con IBM EMM Hosted Services, debe
especificar las direcciones como valores de las propiedades de configuración en la
configuración de eMessage. Las direcciones de conexión que especifique
dependerán de si se conecta al centro de datos de IBM de Estados Unidos o al
centro de datos de IBM del Reino Unido.
Capítulo 3. Conexión a servicios de correo electrónico alojados
25
Antes de empezar
Consulte IBM para confirmar el centro de datos que utiliza su cuenta de correo
electrónico alojada.
Procedimiento
En IBM Marketing Platform, vaya a Valores > Configuración. En la configuración
de eMessage, vaya a las siguientes propiedades de configuración eMessage y
confirme o actualice los valores de conexión, según el centro de datos que utilice
su cuenta.
Si su cuenta se conecta al centro de datos de EE.UU. utilice los valores
predeterminados.
v eMessage > serverComponentsAndLocations > hostedServices> uiHostName
El valor predeterminado es em.unicaondemand.com.
Para conectar con el centro de datos de IBM del Reino Unido, cambie este valor
a
em-eu.unicaondemand.com.
v eMessage > serverComponentsAndLocations > hostedServices> dataHostName
El valor predeterminado es em.unicaondemand.com.
Para conectar con el centro de datos de IBM del Reino Unido, cambie este valor
a
em-eu.unicaondemand.com.
v eMessage > serverComponentsAndLocations > hostedServices> ftpHostName
El valor predeterminado es ftp-em.unicaondemand.com.
Para conectar con el centro de datos de IBM del Reino Unido, cambie este valor
a
ftp-em-eu.unicaondemand.com.
Qué hacer a continuación
Si cambia una propiedad de configuración, reinicie el servidor de aplicaciones web
para aplicar los cambios.
Conceptos relacionados:
“Conexión de carga predeterminada mediante FTP explícito” en la página 13
Configuración de la comunicación segura para el correo electrónico
alojado
Las comunicaciones entre el usuario de marketing de correo electrónico y IBM
EMM Hosted Services se producen sobre SSL (Secure Sockets Layer). Debe cambiar
la configuración del servidor de aplicaciones web para que utilice SSL. Para hacer
los cambios necesarios es necesario utilizar el programa de utilidad keytool de
Java™.
Para configurar la comunicación segura se requieren las siguientes acciones.
v Generar un almacén de claves de confianza.
v Obtener un certificado digital de IBM EMM Hosted Services.
v Añadir el almacén de claves de confianza al servidor de aplicaciones web.
26
IBM eMessage: Guía del administrador y de inicio
v Importar el certificado digital de IBM EMM Hosted Services en el almacén de
claves de confianza.
Los pasos exactos y la secuencia necesarios para configurar SSL dependen del tipo
y la versión del servidor de aplicaciones web (WebSphere o WebLogic) en el que
haya desplegado IBM Marketing Platform y IBM Campaign.
Para WebLogic, consulte “Configuración de SSL al utilizar WebLogic” en la página
28.
Para WebSphere, consulte “Cómo configurar SSL para utilizar IBM WebSphere” en
la página 31.
Generar un almacén de claves de confianza
Siga este procedimiento para crear un almacén de claves de identidades y un
almacén de claves confianza para configurar IBM eMessage para comunicarse con
IBM EMM Hosted Services por SSL. Los almacenes de claves se añaden al servidor
de aplicaciones web al configurar SSL.
Acerca de esta tarea
IBM utiliza los siguientes valores de muestra en los procedimientos de este
apartado.
Almacén de claves de identidades: IBMUnicaClientIdentity.jks
Alias del almacén de claves de identidades: IBMUnicaClientIdentity
Contraseña (-storepass) del almacén de claves de identidades: clientPwd
Clave de seguridad (-keypass) del almacén de claves de identidades: clientPwd
Certificado basado en el almacén de claves de identidades:
ClientCertificate.cer
v Almacén de claves de confianza: IBMUnicaTrust.jks
v Contraseña (-storepass) del almacén de claves de confianza: trustPwd
v
v
v
v
v
Los valores reales que especifique debe ser específicos de la instalación.
Para completar los pasos de este procedimiento, ejecute el programa de utilidad
keytool de Java desde la línea de comandos.
Procedimiento
1. Genere un almacén de claves de identidades. Utilice el comando genkey, como
se muestra en el siguiente ejemplo.
En este ejemplo se crea un almacén de claves de identidades denominado
IBMUnicaClientIdentity.jks. Puede utilizar un nombre distinto para el
almacén de claves de identidades que cree usted.
keytool -genkey -alias IBMUnicaClientIdentity -keyalg RSA -keystore
<IBMUnicaClientIdentity.jks> -keypass <clientPwd> -validity 1000 -dname
"CN=hostName, O=myCompany" -storepass <clientPwd>
Tenga en cuenta lo siguiente.
v Utilizará los valores de alias, keystore, keypass, y storepass más adelante
en este procedimiento y cuando configure SSL en el servidor de aplicaciones
web.
v Para WebSphere 6.0, la contraseña del almacén de claves (-storepass) y la
contraseña de clave (-keypass) deben ser la misma.
Capítulo 3. Conexión a servicios de correo electrónico alojados
27
v En el nombre distinguido (-dname) el nombre común (CN) es el mismo que el
nombre de host utilizado para acceder a IBM EMM. Por ejemplo, si el URL
de IBM EMM es https://hostName.example.com:7002/unica/jsp, el CN es
hostName.example.com. La parte de CN del nombre distinguido es la única
parte obligatoria; la organización (O) y la unidad organizativa (OU) no son
obligatorias.
2. Genere un certificado basado en el almacén de claves de identidades. Utilice el
comando export, como se muestra en el siguiente ejemplo.
En este ejemplo se genera un certificado denominado ClientCertificate.cer.
Puede utilizar un nombre distinto para el certificado que cree usted.
Los valores de keystore, storepass, y alias deben coincidir con los valores que
haya especificado en el almacén de claves de identidades.
keytool -export -keystore <IBMUnicaClientIdentity.jks> -storepass
<clientPwd> -alias IBMUnicaClientIdentity -file <ClientCertificate.cer>
3. Genere el almacén de claves de confianza. Utilice el comando import, como se
muestra en el siguiente ejemplo.
En este ejemplo se genera un almacén de claves de confianza denominado
IBMUnicaTrust.jks. Puede utilizar un nombre distinto para el almacén de
claves de confianza que cree usted.
keytool –import -alias IBMUnicaClientIdentity -file
<ClientCertificate.cer> -keystore <IBMUnicaTrust.jks> -storepass
<trustPwd>
Escriba Y cuando se le solicite si desea confiar en el certificado.
Qué hacer a continuación
Anote los valores que ha definido para las siguientes variables. Sus valores pueden
ser diferentes de los valores que aparecen en el ejemplo.
v alias (en el ejemplo: IBMUnicaClientIdentity)
v identity keystore (en el ejemplo: IBMUnicaClientIdentity.jks)
v storepass (en el ejemplo: trustPwd) El valor de storepass del almacén de claves
de confianza puede ser distinto del valor de storepass del almacén de claves de
identidades y del certificado.
v keystore (en el ejemplo: IBMUnicaTrust.jks) Según su servidor de aplicaciones
web, deberá especificar también el almacén de claves de identidades.
Estos valores específicos de la instalación se especifican al configurar SSL en el
servidor de aplicaciones web de la instalación de IBM EMM.
Configuración de SSL al utilizar WebLogic
En esta sección se describen los pasos necesarios para configurar SSL al desplegar
componentes de IBM EMM en Oracle WebLogic. Este cambio es necesario para
permitir que los componentes de eMessage que operan dentro de Campaign
puedan comunicarse con IBM EMM Hosted Services sobre SSL.
Acerca de esta tarea
Para obtener instrucciones específicas sobre cómo navegar y trabajar con la interfaz
de usuario de Oracle WebLogic, consulte la documentación para la versión
específica de Oracle WebLogic que está utilizando.
28
IBM eMessage: Guía del administrador y de inicio
Procedimiento
Realice las siguientes tareas.
v Modificar el script de inicio de WebLogic
v Modificar la configuración de WebLogic
v Obtenga un certificado digital de IBM EMM Hosted Services
v Cree un almacén de claves de confianza e importe el certificado digital de IBM
Modificación del script de inicio WebLogic
Si ha desplegado Campaign en WebLogic, debe modificar el script de inicio de
WebLogic y la configuración de WebLogic para SSL de forma que WebLogic
reconozca y acepte la comunicación segura entre los componentes de eMessage
instalados localmente y IBM EMM Hosted Services.
Procedimiento
Añada el argumento siguiente a las JAVA_OPTIONS en el script de inicio de
WebLogic.
v -Dweblogic.security.SSL.allowSmallRSAExponent=true
v WebLogic version 12c or higher:
-Dweblogic.security.SSL.protocolVersion=TLS1
Todas las versiones anteriores: -Dweblogic.security.SSL.nojce=true
Modificar la configuración de WebLogic
Debe modificar la configuración de SSL en WebLogic.
Procedimiento
Puede utilizar la consola de WebLogic para realizar el siguiente cambio en la
configuración de SSL de su dominio.
Cambie el valor de Verificación del nombre de host a Ninguna.
Obtener un certificado de IBM EMM Hosted Services
Para configurar la comunicación por SSL, debe descargar un certificado digital de
IBM EMM Hosted Services. Los detalles del certificado se guardan en un archivo
con extensión .cer que puede importar en el almacén de claves del servidor de
aplicaciones web.
Acerca de esta tarea
Cuando el certificado SSL existente caduque, perderá el acceso a IBM EMM Hosted
Services. Puede utilizar este procedimiento para descargar un nuevo certificado.
Procedimiento
1. En Internet Explorer, inicie sesión en la dirección de IBM EMM Hosted Services
que se haya configurado para su cuenta de correo electrónico alojada.
v Para el centro de datos de Estados Unidos, vaya a https://
em.unicaondemand.com
v Para el centro de datos del Reino Unido, vaya a https://emeu.unicaondemand.com
El intento de inicio falla, pero le permite utilizar el navegador para enviar la
solicitud de certificado.
2. Pulse en el icono de bloqueo y seleccione Ver certificado.
Capítulo 3. Conexión a servicios de correo electrónico alojados
29
3. Seleccione la pestaña Detalles y después seleccione Copiar a un archivo.
Guarde el archivo con extensión .cer en una ubicación que sea accesible para
el servidor de aplicaciones web. El archivo que ha creado es el certificado
digital que insertará en el almacén de claves del servidor de aplicaciones web.
Por ejemplo, guarde el certificado con el nombre IBMHosted.cer.
Crear un almacén de claves de confianza de WebLogic e
importar el certificado digital de IBM
Para Weblogic, debe crear un almacén de claves de confianza que acepte el
certificado de IBM.
Antes de empezar
Antes de empezar, utilice un navegador web para descargar el certificado digital
de IBM EMM Hosted Services y guárdelo como un archivo .cer. Por ejemplo, el
certificado puede denominarse IBMHosted.cer (su nombre de archivo puede ser
diferente). Para obtener información detallada adicional, consulte “Obtener un
certificado de IBM EMM Hosted Services” en la página 29.
Acerca de esta tarea
IBM utiliza los siguientes valores de muestra en los procedimientos de este
apartado.
v
v
v
v
v
Almacén de claves de identidades: IBMUnicaClientIdentity.jks
Contraseña del almacén de claves de identidades: clientPwd
Almacén de claves de confianza: IBMUnicaTrust.jks
Alias del almacén de claves de confianza: IBMUnicaHostedIdentity
Contraseña (-storepass) del almacén de claves de confianza: trustPwd
v Certificado digital (-file) de IBM: IBMHosted.cer
Los valores reales que especifique debe ser específicos de la instalación.
Para completar los pasos de este procedimiento, ejecute el programa de utilidad
keytool de Java desde la línea de comandos.
Procedimiento
1. Generar un almacén de claves de confianza para WebLogic. Para obtener
información detallada, consulte “Generar un almacén de claves de confianza”
en la página 27.
Debe especificar el almacén de claves de identidad y el almacén de claves de
confianza en la configuración de WebLogic.
2. Utilice el comando importación en el programa de utilidad keytool para añadir
el certificado de IBM EMM Hosted Services al almacén de claves de confianza
creado en el Paso 1, como se muestra en el siguiente ejemplo. Utilice el
certificado digital que ha descargado de IBM.
En este procedimiento, también se define un alias para el almacén de claves de
confianza. keytool -import -alias IBMUnicaHostedIdentity -file
<IBMHosted.cer> -keystore <IBMUnicaTrust.jks> -storepass <trustPwd>
Escriba Y cuando se le solicite si desea confiar en el certificado.
3. En la consola de administración de WebLogic, configure los almacenes de
claves para el servidor.
30
IBM eMessage: Guía del administrador y de inicio
Para especificar las reglas de configuración, seleccione la opción
correspondiente a almacenes de claves de identidades y de confianza
personalizados entre de las opciones disponibles. En Identidad personalizada,
debe especificar el almacén de claves de identidades. En Confianza
personalizada, debe especificar el almacén de claves de confianza.
Por ejemplo, en la consola de administración, especifique lo siguiente
(utilizando los valores del ejemplo del almacén de claves de confianza que ha
creado en el paso 1).
v En Identidad: especifique el almacén de claves de identidades y la
contraseña asociada.
Por ejemplo, IBMUnicaClientIdentity.jks y clientPwd.
v En Confianza: especifique el almacén de claves de confianza y la contraseña
asociada.
Por ejemplo, IBMUnicaTrust.jks y trustPwd.
Especifique la ruta completa a ambos almacenes de claves.
4. Reinicie WebLogic. WebLogic no implementa los cambios de configuración
hasta que se reinicia el servidor de aplicaciones web.
5. Para probar la conexión SSL, inicie una sesión en IBM Campaign y acceda a
diversos menús de características de mensajería. Confirme que puede crear
correo electrónico, páginas de destino y envíos de correos.
Cómo configurar SSL para utilizar IBM WebSphere
En esta sección se describen los pasos necesarios para configurar SSL cuando se
han desplegado componentes de IBM EMM en IBM WebSphere. Este cambio es
necesario para permitir que los componentes de eMessage que operan dentro de
Campaign puedan comunicarse con IBM EMM Hosted Services sobre SSL.
Antes de empezar
Antes de empezar, deberá saber el valor de la propiedad de configuración
uiHostName. El valor de uiHostName es el URL de IBM EMM Hosted Services. Para
obtener información detallada, consulte “Configuración de las direcciones que se
utilizan para conectarse a IBM EMM Hosted Services” en la página 25.
Acerca de esta tarea
Debe acceder a la consola de seguridad de WebSphere para modificar los valores
para el certificado SSL y la gestión de claves. Esta tarea requiere reiniciar el
servidor de aplicaciones web de Campaign para implementar los cambios.
Si ha desplegado Campaign en WebSphere versión 6.1 o superior, debe modificar
la configuración de seguridad de WebSphere para recuperar el certificado de
firmante de IBM EMM Hosted Services y añadirlo al almacén de confianza de
WebSphere. Si recibe un mensaje de error indicando que el certificado de firmante
actual ha caducado, suprima el certificado actual y añada uno nuevo.
Para obtener instrucciones específicas sobre cómo navegar y trabajar con la interfaz
de usuario de WebSphere, consulte la documentación para la versión específica de
IBM WebSphere que está utilizando.
Nota: Antes de empezar, confirme que el fixpack 7.0.0.17 se ha instalado en el
servidor de WebSphere. Para obtener más información, consulte “IBM WebSphere
Application Server V7.0 requiere el fixpack 7.0.0.17 o superior” en la página 32.
Capítulo 3. Conexión a servicios de correo electrónico alojados
31
Procedimiento
1. Generar un almacén de claves de confianza.
Para obtener información detallada adicional, consulte “Generar un almacén de
claves de confianza” en la página 27.
Para configurar SSL, debe especificar los valores que haya definido para las
siguientes variables. Los valores que se muestran son solamente a modo de
ejemplo. Puede que sus valores sean diferentes.
v alias: UnicaClientIdentity (ejemplo)
v keystore: IBMUnicaTrust.jks (ejemplo)
v storepass: trustPwd (ejemplo)
2. Seleccione el nuevo almacén de claves en la consola de seguridad de
WebSphere.
Por ejemplo, si ha seguido el ejemplo del paso 1, seleccione IBMUnicaTrust.jks.
3. Obtenga un certificado de seguridad de IBM EMM Hosted Services e impórtelo
en WebSphere, como se describe en los siguientes pasos.
a. En la consola de seguridad de WebSphere, vaya a Certificado SSL y gestión
de claves > Almacenes de claves y certificados > NodeDefaultTrustStore >
Certificados de firmante. Selecciona la opción para Recuperar del puerto.
b. Configure WebSphere para establecer una conexión de prueba para
recuperar el certificado de firmante de IBM EMM Hosted Services. Escriba
los siguientes valores para el certificado de firmante de IBM EMM Hosted
Services.
v Host El valor que se haya definido en eMessage
>serverComponentsAndLocations > hostedServices >uiHostName
v Puerto 443
v Configuración SSL para conexiones de salida NodeDefaultSSLSettings
v Alias El valor que haya especificado en Host
Cuando haya terminado, WebSphere se comunica con IBM EMM Hosted
Services para recuperar la información necesaria para crear un certificado de
firmante para IBM EMM Hosted Services.
4. Cuando WebSphere termine de crear el certificado de firmante, seleccione el
nuevo certificado en la consola de seguridad.
El servidor de aplicaciones web utiliza el nuevo certificado al establecer
conexiones con IBM EMM Hosted Services.
5. Reinicie WebSphere
WebSphere no implementa los cambios de configuración hasta que reinicie el
servidor de aplicaciones web.
IBM WebSphere Application Server V7.0 requiere el fixpack
7.0.0.17 o superior
Si tiene previsto utilizar IBM WebSphere Application Server V7.0, para desplegar
productos de IBM EMM, debe aplicar el Fixpack 17 (también conocido como
Versión 7.0.0.17) o posterior, para tratar un problema de seguridad. Esto se aplica a
todos los paquetes de WebSphere Application Server 7.0, incluyendo la versión que
va que con algunos productos de IBM EMM.
Puede obtener el fixpack 17 o superior aquí:
http://www-01.ibm.com/support/docview.wss?rs=180&uid=swg27013594.
32
IBM eMessage: Guía del administrador y de inicio
Tenga en cuenta que, en esta página, debe seleccionar el fixpack correcto antes de
descargarlo.
Para obtener información adicional acerca de las versiones de WebSphere
soportadas para desplegar productos de IBM EMM, consulte el documento
Entornos de software recomendados y Requisitos mínimos del sistema de cada producto.
Capítulo 3. Conexión a servicios de correo electrónico alojados
33
34
IBM eMessage: Guía del administrador y de inicio
Capítulo 4. Operación del rastreador de respuestas y
contactos
La Rastreador de respuestas y contactos (RCT) está instalado en el entorno local y
se comunica con IBM EMM Hosted Services para recuperar y procesar datos de
contactos de correo electrónico, entrega de correos electrónicos y respuestas de
destinatario, como pulsaciones y aperturas de enlaces. El RCT debe estar en
ejecución a fin de recuperar los datos de rastreo de enlaces y notificación de
entrega de correos electrónicos de IBM EMM Hosted Services.
La Rastreador de respuestas y contactos (RCT) está instalado en el entorno local y
se comunica con IBM EMM Hosted Services para recuperar y procesar datos de
contactos de correo electrónico, entrega de correos electrónicos y respuestas de
destinatario, como pulsaciones y aperturas de enlaces. El RCT debe estar en
ejecución a fin de recuperar los datos de rastreo de enlaces y notificación de
entrega de correos electrónicos de IBM EMM Hosted Services.
Puede iniciar el RCT de cualquiera de las siguientes maneras.
v Iniciar el RCT manualmente.
v Iniciar el RCT como servicio
Importante: Debe iniciar el RCT manualmente la primera vez que utiliza
eMessage, incluso si se ha registrado el RCT como un servicio.
Debe reiniciar el RCT cuando se realizan cambios en las propiedades de
configuración para eMessage. Puede reiniciar el RCT en cualquier momento,
aunque lo haya configurado para que se ejecute como servicio. IBM EMM Hosted
Services continúa almacenando datos de rastreo aunque el RCT esté cerrado o
reiniciándose. Cuando se reanuda, el RCT descarga la información de la cola.
Conceptos relacionados:
“Valor de puerto y frecuencia de descarga de datos” en la página 23
“Inicio manual del RCT”
“Cómo iniciar automáticamente el RCT como servicio” en la página 36
Inicio manual del RCT
Ejecute el script rct para iniciar y detener el Rastreador de respuestas y contactos
(RCT). Para iniciar manualmente el RCT, ejecute el script rct en el directorio bin
de su instalación de eMessage.
Para obtener más información sobre este script, consulte “Script de seguimiento de
respuestas y contactos (RCT) de eMessage” en la página 98.
Conceptos relacionados:
Capítulo 4, “Operación del rastreador de respuestas y contactos”
© Copyright IBM Corp. 1999, 2015
35
Operación manual del Rastreador de respuestas y contactos
Para operar manualmente el Rastreador de respuestas y contactos (RCT), ejecute el
script rct en el directorio bin de la instalación de eMessage.
Procedimiento
v Para iniciar el RTC, ejecute el script rct en el directorio bin de la instalación de
eMessage, de la forma siguiente.
rct start
v Para detener el RCT, ejecute el script rct de la forma siguiente.
rct stop
Qué hacer a continuación
Para obtener más información sobre este script, consulte “Script de seguimiento de
respuestas y contactos (RCT) de eMessage” en la página 98.
Detención del Rastreador de respuestas y contactos
Detener el Rastreador de respuestas y contactos (RCT) mediante la ejecución del
script rct.
Procedimiento
Vaya al directorio bin de la instalación de eMessage y ejecute el script rct como se
indica a continuación.
rct stop
Qué hacer a continuación
IBM EMM Hosted Services continúa almacenando los datos de rastreo y respuesta
hasta que reinicia el RCT.
Para obtener más información acerca de este script, consulte “Script de
seguimiento de respuestas y contactos (RCT) de eMessage” en la página 98
Cómo iniciar automáticamente el RCT como servicio
Puede configurar el Rastreador de respuestas y contactos (RCT) para que se inicie
automáticamente añadiéndolo como servicio.
Registre el servicio RCT ejecutando el script MKService_rct que se proporciona con
el software de eMessage.
Cuando ejecute el script MKService_rct para registrar el servicio, debe utilizar el
script rct para iniciar manualmente el RCT la primera vez. Después de eso, el RCT
se reiniciará automáticamente cada vez que rearranque el sistema operativo de la
máquina donde se ha instalado el RCT.
Una vez configurado el servicio RCT, puede impedir que el RCT se ejecute
automáticamente ejecutando el script MKService_rct con la opción -remove.
Conceptos relacionados:
Capítulo 4, “Operación del rastreador de respuestas y contactos”, en la página 35
Tareas relacionadas:
36
IBM eMessage: Guía del administrador y de inicio
“Adición del Rastreador de respuestas y contactos (RCT) como servicio”
“Eliminación del servicio Rastreador de respuestas y contactos” en la página 38
Referencia relacionada:
“Script MKService_rct de eMessage” en la página 99
Adición del Rastreador de respuestas y contactos (RCT) como
servicio
Puede configurar el Rastreador de respuestas y contactos (RCT) para que se inicie
automáticamente añadiéndolo como servicio.
Acerca de esta tarea
Registre el servicio RCT ejecutando el script MKService_rct que se proporciona con
el software de eMessage.
Para añadir el Rastreador de respuestas y contactos (RCT) como servicio, ejecute el
script MKService_rct -install desde el directorio bin de la instalación de
eMessage.
El directorio de bin se crea como un subdirectorio en el directorio de instalación de
Campaign al instalar o actualizar a la versión más reciente de IBM Campaign.
Procedimiento
Para añadir el Rastreador de respuestas y contactos (RCT) como servicio, ejecute el
script MKService_rct -install desde el directorio bin de la instalación de
eMessage.
En UNIX o Linux, ejecute este script con un usuario que tenga permisos de usuario
raíz o permisos para crear procesos de daemon.
En Windows, el nombre de servicio es Rastreador de respuestas y contactos.
Qué hacer a continuación
Una vez haya ejecutado el script MKService_rct inicie el RCT manualmente con el
script rct. El RCT se debe reiniciar manualmente sólo una vez. Tras iniciar el RCT
manualmente la primera vez, el RCT se reiniciará automáticamente cada vez que
se reinicie el sistema operativo del sistema donde esté instalado.
Una vez configurado el servicio RCT, puede impedir que el RCT se ejecute
automáticamente ejecutando el script MKService_rct con la opción -remove.
Conceptos relacionados:
“Cómo iniciar automáticamente el RCT como servicio” en la página 36
Referencia relacionada:
“Script MKService_rct de eMessage” en la página 99
“Script de seguimiento de respuestas y contactos (RCT) de eMessage” en la página
98
Capítulo 4. Operación del rastreador de respuestas y contactos
37
Eliminación del servicio Rastreador de respuestas y contactos
Si ha instalado el Rastreador de respuestas y contactos (RCT) como servicio, el
RCT se reinicia cada vez que se reinicia el sistema donde ha instalado el RCT. Para
evitar que el RCT se reinicie automáticamente, debe eliminar el servicio Rastreador
de respuestas y contactos (RCT).
Procedimiento
Para eliminar el RCT como servicio, ejecute el script MKService_rct con la opción
-remove.
Desde una línea de comandos de Windows, en el directorio de inicio de IBM
EMM, ejecute eMessage\bin\MKService_rct.bat -remove.
En UNIX o Linux, en el directorio de inicio de IBM EMM, ejecute
eMessage/bin/MKService_rct.sh -remove.
Qué hacer a continuación
Para obtener más información acerca de este script, consulte “Script MKService_rct
de eMessage” en la página 99
Conceptos relacionados:
“Cómo iniciar automáticamente el RCT como servicio” en la página 36
38
IBM eMessage: Guía del administrador y de inicio
Capítulo 5. Verificación del inicio
Para garantizar el acceso a todas las características de correo electrónico alojado,
pruebe las configuraciones y conexiones de sus instalaciones de Campaign y
eMessage después de habilitar eMessage, ampliar su instalación de eMessage o
actualizar la instalación de Campaign.
Verifique las configuraciones y conexiones después de realizar cualquiera de las
acciones siguientes.
v Habilitar eMessage por primera vez
v Actualizar la instalación actual de IBM Campaign
v Añadir una nueva partición a la configuración de eMessage que se conserva en
IBM Marketing Platform
Confirmación de las configuraciones del sistema
Para asegurarse de que han finalizado los preparativos de inicio, confirme que las
siguientes propiedades de configuración se han establecido y que los valores
cumplan los requisitos de sus instalaciones de eMessage y Campaign.
Propiedad de configuración
Configuración
Campaign | partitions |
partition[n] | eMessage |
eMessagePluginJarFile
Ruta completa de la ubicación del archivo de plug-in que funciona como
Cargador de listas de destinatarios (RLU). Especifique la ruta completa del
directorio local en el sistema que aloja el servidor de aplicaciones web de
Campaign.
El instalador de IBM cumplimenta automáticamente esta configuración para la
partición predeterminada cuando ejecuta el instalador. Si tiene particiones
adicionales, configure esta propiedad manualmente.
Campaign | partitions |
Indica que eMessage está instalado.
partition[n] | server | internal
Establezca esta propiedad en Yes en cada partición donde desee habilitar
| eMessageInstalled
eMessage, incluida la partición predeterminada. Al establecer esta propiedad en
Yes, las características de eMessage pasan a estar disponibles en la interfaz de
Campaign.
eMessage |
serverComponentsAndLocations |
hostedServices | uiHostName
Dirigirse a IBM EMM Hosted Services para todas las comunicaciones excepto
para cargar listas.
El valor predeterminado es em.unicaondemand.com para el centro de datos de
EE.UU.
Si se conecta al centro de datos de Reino Unido, cambie este valor a
em-eu.unicaondemand.com.
eMessage |
serverComponentsAndLocations |
hostedServices | dataHostName
La dirección para la conexión que utiliza eMessage para cargar los metadatos
relacionados con las listas de destinatarios en IBM EMM Hosted Services.
El valor predeterminado es em.unicaondemand.com para el centro de datos de
EE.UU.
Si se conecta al centro de datos de Reino Unido, cambie este valor a
em-eu.unicaondemand.com.
© Copyright IBM Corp. 1999, 2015
39
Propiedad de configuración
Configuración
eMessage |
serverComponentsAndLocations |
hostedServices | ftpHostName
La dirección para la conexión que eMessage utiliza para cargar los datos de las
listas de destinatarios (excepto los metadatos) en IBM EMM Hosted Services.
El valor predeterminado es ftp-em.unicaondemand.com para el centro de datos
de EE.UU.
Si se conecta al centro de datos de Reino Unido, cambie este valor a
ftp-em-eu.unicaondemand.com.
eMessage | partitions |
El usuario de IBM EMM que hace referencia al origen de datos que contiene
partition[n] | hostedAccountInfo las credenciales de acceso de IBM EMM Hosted Services.
| amUserForAcctCredentials
Puede configurar este valor al crear un usuario del sistema para acceder a los
recursos de correo electrónico que aloja IBM.
eMessage | partitions |
El origen de datos de Marketing Platform que contiene las credenciales de
partition[n] | hostedAccountInfo inicio de sesión de IBM EMM Hosted Services .
| amDataSourceForAcctCredentials
Puede configurar este valor al crear un usuario del sistema para acceder a los
recursos de correo electrónico que aloja IBM.
eMessage | partitions |
partition [n] < dataSources |
systemTables | type
Tipo de la base de datos que aloja las tablas de sistema.
eMessage | partitions |
partition [n] < dataSources |
systemTables | schemaName
Nombre del esquema de base de datos de las tablas de sistema.
eMessage | partitions |
partition [n] < dataSources |
systemTables | jdbcClassName
Controlador JDBC para las tablas de sistema.
eMessage | partitions |
partition [n] < dataSources |
systemTables | jdbcURI
URI de conexión JDBC para las tablas de sistema.
Proporcione el valor correcto para la base de datos.
Se establece en el nombre de esquema apropiado para su base de datos.
Proporcione el valor correcto para su entorno.
Proporcione el valor correcto para su entorno.
Especifique el tipo de base de datos, el controlador de base de datos, el host, el
puerto y el nombre de la base de datos. Por
ejemplo:jdbc:oracle:thin:@yourdb.example.com:1234:DBname
Consulte la documentación de la base de datos para obtener instrucciones
específicas sobre cómo construir el URL de JDBC.
El valor que especifique debe coincidir exactamente con el valor definido en el
servidor web de Campaign.
eMessage | partitions |
partition [n] < dataSources |
systemTables |
asmUserForDBCredentials
El usuario de IBM EMM que hace referencia al origen de datos que contiene
las credenciales de inicio de sesión de las tablas de sistema.
eMessage | partitions |
partition [n] < dataSources |
systemTables |
asmDataSourceForDBCredentials
El origen de datos de Marketing Platform que contiene las credenciales de
inicio de sesión a la base de datos que contiene las tablas de sistema.
Puede crear este usuario al configurar acceso a las tablas del sistema eMessage
local.
Puede crear este origen de datos al crear un usuario para acceder a las tablas
del sistema de eMessage.
Conceptos relacionados:
Capítulo 6, “Configuraciones para IBM eMessage”, en la página 43
Tareas relacionadas:
“Configuración del usuario del sistema que accede a IBM EMM Hosted Services”
en la página 24
40
IBM eMessage: Guía del administrador y de inicio
“Configuración del acceso a las tablas del sistema local de eMessage” en la página
48
Probar la carga a IBM EMM Hosted Services
Para probar la capacidad de cargar datos a IBM EMM Hosted Services desde su
entorno local, ejecute el script rlu en modo de comprobación.
Procedimiento
En el directorio bin de la instalación de eMessage, ejecute el script rlu de una de
las siguientes formas.
v rlu -c
v rlu --check
Referencia relacionada:
“El script RLU” en la página 97
Probar la descarga desde IBM EMM Hosted Services
Para probar la capacidad para descargar información desde IBM EMM Hosted
Services, ejecute el script rct en modalidad de comprobación.
Procedimiento
Vaya al directorio bin de la instalación de eMessage y ejecute el script rct como se
indica a continuación.
rct check
Referencia relacionada:
“Script de seguimiento de respuestas y contactos (RCT) de eMessage” en la página
98
Probar la conexión a la interfaz de mensajería alojada
IBM aloja la interfaz de mensajería en sus centros de datos en EE.UU. y el Reino
Unido. Pruebe la conexión con la interfaz de envío de correos alojada intentando
acceder a una característica de eMessage.
Procedimiento
Inicie una sesión en IBM EMM y seleccione Envíos de correos de eMessage en el
menú Campaña.
Si la conexión con la interfaz de usuario de eMessage se ha establecido
correctamente, se abrirá la página de envíos de correos de eMessage y se
visualizará una lista de correo electrónicos y características de envíos de correos
relacionadas.
Si la conexión con la interfaz de usuario no se establece correctamente, verá un
error.
Capítulo 5. Verificación del inicio
41
42
IBM eMessage: Guía del administrador y de inicio
Capítulo 6. Configuraciones para IBM eMessage
IBMMarketing Platform proporciona diversas propiedades de configuración para
modificar el comportamiento y el aspecto de IBMeMessage. Algunas propiedades
de configuración se establecen durante la instalación. Puede cambiar las
propiedades de configuración en cualquier momento.
Tras actualizar las configuraciones de Campaign o eMessage, debe reiniciar el RCT
(Rastreador de respuestas y contactos) y el servidor de aplicaciones web que aloja
a Campaign.
Característica o función
Propiedad de configuración (incluida ruta)
Habilitar o inhabilitar eMessage en la partición Campaign | partitions | partition[n] | server | internal
de Campaign.
Consulte “Campaign | partitions | partition[n]
| server | internal” en la página 50.
Características de las listas de destinatarios de
correo electrónico.
Campaign | partitions | partition[n] | eMessage
Consulte “Campaign | particiones |
partición[n] | eMessage” en la página 49.
URL necesarias para establecer conexión con
IBM EMM Hosted Services.
eMessage | serverComponentsAndLocations | hostedServices
Consulte “eMessage |
serverComponentsAndLocations |
hostedServices” en la página 55.
Credenciales de acceso a bases de datos y a
cuentas para conectar con IBM EMM Hosted
Services.
eMessage | partitions | partition[n] | hostedAccountInfo
Consulte “eMessage | particiones |
partición[n] | hostedAccountInfo” en la página
56
Valores de acceso a base de datos y de
esquema para las tablas de sistema de
eMessage.
eMessage | partitions | partition[n] | dataSources |
systemTables
Consulte “eMessage | particiones |
partición[n] | dataSources | systemTables” en
la página 57
Ubicación de un script que se ejecuta en
respuesta a las acciones o al estado del
Cargador de listas de destinatarios. (opcional).
eMessage | partitions | partition[n] | recipientListUploader
Consulte “eMessage | particiones |
partición[n] | recipientListUploader” en la
página 60
© Copyright IBM Corp. 1999, 2015
43
Característica o función
Propiedad de configuración (incluida ruta)
Valores relacionados con la descarga de datos,
procesados por el Rastreador de respuestas y
contactos (RCT).
eMessage | partitions | partition[n] | responseContactTracker
Consulte “eMessage | particiones |
partición[n] | responseContactTracker” en la
página 60
Soporte para presentar listas de datos
personalizadas en eMessage en base a las
tablas de dimensiones de Campaign.
Campaign | partitions | partition[n]| eMessage |
oltDimTableSupport
Consulte Configuración del soporte para tablas
de dimensiones.
Soporte para el seguimiento del historial de
ejecución de envíos de correos. Consulte
“eMessage | particiones | partición[n] |
responseContactTracker” en la página 60
eMessage | partitions | partition[n] | responseContactTracker
Consulte el parámetro enableExecutionHistoryDataTracking.
Para obtener más información sobre cómo trabajar con propiedades de
configuración, consulte la publicación IBM Marketing Platform Administrator's Guide.
Conceptos relacionados:
“Confirmación de las configuraciones del sistema” en la página 39
Lo que puede configurar en eMessage
Puede configurar los siguientes aspectos de la instalación local de IBM eMessage.
Característica o función
Propiedad de configuración (incluida ruta)
Habilitar o inhabilitar eMessage en la partición Campaign | partitions | partition[n] | server | internal
de Campaign.
Consulte “Campaign | partitions | partition[n]
| server | internal” en la página 50.
Características de las listas de destinatarios de
correo electrónico.
Campaign | partitions | partition[n] | eMessage
Consulte “Campaign | particiones |
partición[n] | eMessage” en la página 49.
URL necesarias para establecer conexión con
IBM EMM Hosted Services.
eMessage | serverComponentsAndLocations | hostedServices
Consulte “eMessage |
serverComponentsAndLocations |
hostedServices” en la página 55.
Credenciales de acceso a bases de datos y a
cuentas para conectar con IBM EMM Hosted
Services.
eMessage | partitions | partition[n] | hostedAccountInfo
Consulte “eMessage | particiones |
partición[n] | hostedAccountInfo” en la página
56
44
IBM eMessage: Guía del administrador y de inicio
Característica o función
Propiedad de configuración (incluida ruta)
Valores de acceso a base de datos y de
esquema para las tablas de sistema de
eMessage.
eMessage | partitions | partition[n] | dataSources |
systemTables
Consulte “eMessage | particiones |
partición[n] | dataSources | systemTables” en
la página 57
Ubicación de un script que se ejecuta en
respuesta a las acciones o al estado del
Cargador de listas de destinatarios. (opcional).
eMessage | partitions | partition[n] | recipientListUploader
Consulte “eMessage | particiones |
partición[n] | recipientListUploader” en la
página 60
Valores relacionados con la descarga de datos,
procesados por el Rastreador de respuestas y
contactos (RCT).
eMessage | partitions | partition[n] | responseContactTracker
Consulte “eMessage | particiones |
partición[n] | responseContactTracker” en la
página 60
Soporte para presentar listas de datos
personalizadas en eMessage en base a las
tablas de dimensiones de Campaign.
Campaign | partitions | partition[n] | eMessage |
oltDimTableSupport
Consulte “Configuración del soporte para
tablas de dimensiones” en la página 47.
Soporte para la integración de ofertas
Campaign con correo electrónico
personalizado.
Campaign | partitions | partition[n] | eMessage |
contactAndResponseHistTracking
Consulte “Campaign | particiones |
partición[n] | eMessage |
contactAndResponseHistTracking” en la
página 53
Soporte para el seguimiento del historial de
ejecución de envíos de correos. Consulte
“eMessage | particiones | partición[n] |
responseContactTracker” en la página 60
eMessage | partitions | partition[n] | responseContactTracker
Consulte el parámetro enableExecutionHistoryDataTracking.
Qué se debe reiniciar después de hacer cambios en la configuración
Tras realizar cambios en las configuraciones de Campaign y eMessage, debe
reiniciar el RCT (Rastreador de respuestas y contactos) y el servidor de
aplicaciones web que aloja a Campaign.
Para obtener información sobre cómo reiniciar el RCT, consulte “Script de
seguimiento de respuestas y contactos (RCT) de eMessage” en la página 98.
Para obtener información sobre cómo reiniciar el servidor de aplicaciones web,
consulte la documentación de su servidor de aplicaciones web.
Capítulo 6. Configuraciones para IBM eMessage
45
Configuración del acceso a historial adicional de ejecución de envíos
de correos
Puede solicitar que IBM proporcione datos adicionales para historial de ejecución
de envíos de correos. El acceso a historial adicional de ejecución de envíos de
correos está disponible en IBM si se solicita y actualizando la configuración de
eMessage. Los datos del historial de ejecución de envíos de correos se registran en
las tablas locales del sistema de eMessage en la tabla UACE_ExecHistory para
describir las ejecuciones de envíos de correos completadas.
Antes de empezar
Para descargar datos adicionales de ejecución de envíos de correos, debe actualizar
la propiedad de configuración enableExecutionHistoryDataTracking. De forma
predeterminada, enableExecutionHistoryDataTracking ahora se expone en las
propiedades de configuración de eMessage.
Puede visualizar esta propiedad de configuración en su instalación local de
eMessage ejecutando el script switch_config_visibility.bat, que se encuentra en
el directorio emessage\tools.
Acerca de esta tarea
Están disponibles los tipos de registro siguientes si instala o actualiza Campaign
versión 8.6.0.4 o versión 9.1.0 o superior. Esta información no está disponible para
la versión 9.0.0.
v Línea de asunto del mensaje
v Dirección de origen
v Usuario que ha actualizado el envío de correos
v Descripción del documento
v Fecha en que se ha guardado el envío de correos
Procedimiento
1. Solicite acceso a datos de historial adicional de ejecución de envíos de correos.
Para solicitar el acceso, póngase en contacto con su representante de IBM en
[email protected].
2. Actualice la configuración de eMessage. Configure la siguiente propiedad de
configuración.
Affinium|eMessage|partitions|partition1|responseContactTracker|
enableExecutionHistoryDataTracking
Establezca enableExecutionHistoryDataTracking en True.
Qué hacer a continuación
Puede consultar las tablas del sistema de eMessage para recuperar información de
ejecución de envíos de correos de la tabla UACE_ExecHistory.
Para obtener más información sobre las tablas del sistema de eMessage, consulte la
publicación IBM EMM System Tables and Data Dictionary.
Tareas relacionadas:
46
IBM eMessage: Guía del administrador y de inicio
“Acceso a los parámetros de configuración para carga de FTP implícito” en la
página 16
Soporte de la integración de ofertas de Campaign
IBM eMessage admite añadir ofertas configuradas en Campaign a correo
electrónico personalizado creado en eMessage .
Las ofertas se basan en plantillas de oferta que se han configurado en IBM
Campaign. Para dar soporte a la integración de ofertas de Campaign en un correo
electrónico personalizado, debe actualizar la propiedad
contactAndResponseHistTracking en la configuración de Campaign y realizar otras
configuraciones en Campaign.
Para obtener más información sobre cómo configurar el soporte para la integración
de ofertas, consulte los temas sobre la integración de ofertas de eMessage en la
publicación IBM Campaign Administrator's Guide.
Referencia relacionada:
“Campaign | particiones | partición[n] | eMessage |
contactAndResponseHistTracking” en la página 53
Configuración del soporte para tablas de dimensiones
Para dar soporte a ciertas características que se proporcionan mediante scripts
avanzados para correo electrónico, la propiedad de configuración
oltDimTableSupport se debe establecer en True. Al actualizar a Campaign 8.5.0 o
posterior, debe modificar manualmente el valor de este parámetro de
configuración.
Acerca de esta tarea
eMessage proporciona scripts avanzados para crear mensajes de correo electrónico
con listas de información personalizada. Estas listas requieren asociar tablas de
dimensiones creadas en Campaign con una Tabla de lista de salida (OLT -Output
List Table) que define la lista de destinatario de correo electrónico. Las Tablas de
listas de salida se crean en el esquema de eMessage.
La propiedad de configuración oltDimTableSupport controla el soporte para crear
tablas de dimensiones en el esquema de eMessage. Cuando el valor de esta
propiedad está establecido en True, una OLT puede utilizar la información de una
tabla de dimensiones.Antes de Campaign 8.5.0, el valor predeterminado de
oltDimTableSupport era False, no True.
Realice los pasos siguientes para actualizar la propiedad oltDimTableSupport.
Para obtener más información sobre cómo los usuarios de marketing pueden
utilizar los scripts avanzados para crear tablas de datos, consulte la publicación
IBM eMessage Guía del usuario.
Capítulo 6. Configuraciones para IBM eMessage
47
Procedimiento
1. Vaya a Valores > Configuración > Campaña > Particiones > partición[n] >
eMessage
2. Pulse Editar valores y establezca el valor de la Propiedad oltDimTableSupport
en True.
Configuración del acceso a las tablas del sistema local de eMessage
Los componentes de eMessage tienen que poder acceder a las tablas de sistema de
eMessage en el esquema de Campaign. Debe crear y configurar un usuario del
sistema que pueda acceder automáticamente a las tablas del sistema. El usuario del
sistema que se ha configurado durante la instalación de Campaign, ya tiene el
acceso necesario al esquema de Campaign.
Acerca de esta tarea
Nota: Si su instalación contiene diversas particiones, debe llevar a cabo esta tarea
para cada una de las particiones. No se pueden compartir usuarios de sistema
entre distintas particiones.
Si desea utilizar un usuario del sistema diferente para acceder a las tablas del
sistema de eMessage, debe crear un usuario del sistema nuevo en Marketing
Platform y crear un nuevo origen de datos de plataforma con acceso al esquema de
Campaign.
Procedimiento
1. En la configuración de eMessage, especifique un usuario del sistema que
acceda a la base de datos que aloja el esquema de Campaign.
Puede crear un nuevo usuario o especificar un usuario existente. El usuario del
sistema que ha configurado para Campaign ya tiene acceso al esquema de
Campaign.
Utilice la propiedad de configuración eMessage > partitions > partition [n]
< dataSources > systemTables > asmUserForDBCredentials.
De forma predeterminada, el usuario predeterminado es asm_admin.
2. En la configuración de eMessage, especifique el origen de datos configurado
para contener el nombre de usuario y la contraseña necesarios para acceder a la
base de datos que aloja el esquema de Campaign.
Puede utilizar el origen de datos que se ha creado para acceder al esquema de
Campaign al instalar Campaign.
Utilice la propiedad de configuración eMessage > partitions > partition [n]
< dataSources > systemTables > amDataSourceForDBCredentials.
Conceptos relacionados:
“Confirmación de las configuraciones del sistema” en la página 39
Propiedades de configuración de eMessage
Puede acceder a las propiedades de configuración de eMessage desde el menú
Valores en Marketing Platform. Las propiedades para la configuración de eMessage
se encuentran en las categorías de configuración de Campaign y eMessage.
48
IBM eMessage: Guía del administrador y de inicio
Para acceder a las propiedades de configuración, vaya a Valores >
Configuraciones. La página Configuraciones enumera todas las propiedades de
configuración disponibles para su instalación de IBM EMM.
Campaign | particiones | partición[n] | eMessage
Defina las propiedades de esta categoría para definir las características de las listas
de destinatarios y especificar la ubicación de los recursos que cargan las listas en
IBM EMM Hosted Services.
eMessagePluginJarFile
Descripción
Ruta completa a la ubicación del archivo que funciona como Cargador de
listas de destinatarios (RLU). Este plugin a Campaign carga datos de OLT
y los metadatos asociados a los servicios remotos que aloja IBM. La
ubicación que especifique debe ser la ruta completa del directorio local en
el sistema de archivos de la máquina que aloja el servidor de aplicaciones
web Campaign.
El instalador de IBM completa esta configuración automáticamente para la
partición predeterminada cuando ejecuta el instalador. Para otras
particiones, debe configurar manualmente esta propiedad. Debido a que
únicamente existe un RLU para cada instalación de eMessage, todas las
particiones deben especificar la misma ubicación para el RLU.
No cambie esta configuración a menos que IBM le indique que lo haga.
Valor predeterminado
No hay valor predeterminado definido.
Valores válidos
Ruta completa al directorio local donde ha instalado el servidor web de
Campaign.
defaultSeedInterval
Descripción
El número de mensajes entre los mensajes de claves si defaultSeedType es
Distribute list.
Valor predeterminado
1000
defaultSeedType
Descripción
El método predeterminado que utiliza eMessage para insertar direcciones
de inicio en una lista de destinatarios.
Valor predeterminado
Distribute IDS
Valores válidos
v Distribute IDS: distribuye los ID de manera uniforme e inserta
direcciones de inicio a intervalos equivalentes a lo largo de la lista
completa de destinatarios, de acuerdo con el tamaño de la lista de
destinatarios y el número de direcciones de inicio disponibles.
Capítulo 6. Configuraciones para IBM eMessage
49
v Distribute list: inserta la dirección de claves para cada ID de
defaultSeedInterval en la lista principal. Inserta la lista completa de
direcciones de inicio disponibles en intervalos especificados a lo largo de
la lista de destinatarios de producción. Debe especificar el intervalo entre
los puntos de inserción.
oltTableNamePrefix
Descripción
Se usa en el esquema generado para la tabla de lista de salida (OLT). Debe
definir este parámetro.
Valor predeterminado
OLT
Valores válidos
El prefijo puede contener hasta 8 caracteres alfanuméricos o de subrayado,
y debe comenzar con una letra.
oltDimTableSupport
Descripción
Este parámetro de configuración controla la capacidad de añadir las tablas
de dimensiones a las tablas de lista de salida (OLT) creadas en el esquema
de eMessage. Las tablas de dimensiones son necesarias para utilizar la
programación para correo electrónico a fin de crear tablas de datos en los
mensajes de correo electrónico.
El valor predeterminado es False. Debe establecer esta propiedad en True
para que los usuarios de marketing puedan crear tablas de dimensiones
cuando utilicen el proceso de eMessage para definir una lista de
destinatarios. Para obtener más información sobre la creación de tablas de
datos y la utilización de los scripts avanzados para correo electrónico,
consulte la Guía del usuario de IBM eMessage.
Valor predeterminado
False
Valores válidos
True | False
Campaign | partitions | partition[n] | server | internal
Las propiedades de esta categoría especifican valores de integración y los límites
del ID interno de la partición de Campaign seleccionada. Si su instalación de
Campaign tiene varias particiones, establezca estas propiedades para cada partición
que desee que se vea afectada.
internalIdLowerLimit
Descripción
Las propiedades internalIdUpperLimit y internalIdLowerLimit restringen
los ID internos de Campaign dentro del rango especificado. Tenga en
cuenta que los valores son inclusivos: es decir, Campaign puede utilizar
tanto el límite inferior como el superior.
Valor predeterminado
50
IBM eMessage: Guía del administrador y de inicio
0 (cero)
internalIdUpperLimit
Descripción
Las propiedades internalIdUpperLimit y internalIdLowerLimit restringen
los ID internos de Campaign dentro del rango especificado. Los valores
son inclusivos: es decir, Campaign puede utilizar tanto el límite inferior
como el superior. Si está instalado Distributed Marketing, establezca el
valor en 2147483647.
Valor predeterminado
4294967295
eMessageInstalled
Descripción
Indica que eMessage está instalado. Si selecciona Yes, las características de
eMessage están disponibles en la interfaz de Campaign.
El instalador de IBM define esta propiedad en Yes para la partición
predeterminada de la instalación de eMessage. Si tiene particiones
adicionales donde haya instalado eMessage, debe configurar esta
propiedad manualmente.
Valor predeterminado
No
Valores válidos
Yes | No
interactInstalled
Descripción
Tras instalar el entorno de diseño de Interact, esta propiedad de
configuración se debe establecer en Yes para habilitar el entorno de diseño
de Interact en Campaign.
Si Interact no se ha instalado, establézcalo en No. Si se establece esta
propiedad en No no se eliminan los menús y las opciones de Interact de la
interfaz de usuario. Para eliminar los menús y las opciones, debe anular
manualmente el registro de Interact utilizando el programa de utilidad
configTool.
Valor predeterminado
No
Valores válidos
Yes | No
Disponibilidad
Esta propiedad sólo es aplicable si tiene instalado Interact.
MO_UC_integration
Descripción
Capítulo 6. Configuraciones para IBM eMessage
51
Habilita la integración con Marketing Operations para esta partición, si la
integración está habilitada en los valores de configuración de Plataforma.
Si desea más información, consulte IBM Marketing Operations y Campaign
Integration Guide.
Valor predeterminado
No
Valores válidos
Yes | No
MO_UC_BottomUpTargetCells
Descripción
Para esta partición, admite celdas de modo ascendente para hojas de
cálculo de celdas objetivo, si MO_UC_integration está habilitado. Si se
establece en Yes, están visibles tanto las celdas objetivo de modo
descendente como las de modo ascendente, pero las celdas objetivo de
modo ascendente son de sólo lectura. Si desea más información, consulte
IBM Marketing Operations y Campaign Integration Guide.
Valor predeterminado
No
Valores válidos
Yes | No
Legacy_campaigns
Descripción
Para esta partición, habilita el acceso a campañas creadas antes de la
integración de Marketing Operations y Campaign. Sólo se aplica si
MO_UC_integration está establecido en Yes. Las campañas heredadas
incluyen también campañas creadas en Campaign 7.x y enlazadas a
proyectos de Plan 7.x. Si desea más información, consulte IBM Marketing
Operations y Campaign Integration Guide.
Valor predeterminado
No
Valores válidos
Yes | No
IBM Marketing Operations - Integración de ofertas
Descripción
Habilita la posibilidad de utilizar Marketing Operations para realizar tareas
de gestión del ciclo de vida de las ofertas en esta partición, si
MO_UC_integration está habilitado para esta partición. La integración de
ofertas debe estar habilitada en los valores de configuración de su
Plataforma. Si desea más información, consulte IBM Marketing Operations y
Campaign Integration Guide.
Valor predeterminado
No
52
IBM eMessage: Guía del administrador y de inicio
Valores válidos
Yes | No
UC_CM_integration
Descripción
Permite la integración de segmentos en línea de Digital Analytics para una
partición de Campaign. Cuando esta opción se establece en Yes, el cuadro
del proceso Selección de un diagrama de flujo proporciona la opción para
seleccionar Segmentos de Digital Analytics como entrada. Para configurar
la integración de Digital Analytics para cada partición, seleccione Valores >
Configuración > Campaign | particiones | partición[n] | Coremetrics.
Valor predeterminado
No
Valores válidos
Yes | No
Campaign | particiones | partición[n] | eMessage |
contactAndResponseHistTracking
Utilice las propiedades de esta categoría para configurar la integración de ofertas
de eMessage con IBM Campaign para la partición existente.
etlEnabled
Descripción
Campaign utiliza su propio proceso ETL para la extracción, transformación
y carga de los datos de la respuesta de la oferta de las tablas de
seguimiento del historial de respuestas de eMessage en las tablas de
historial de respuesta y contacto de Campaign.
El proceso de ETL coordina la información de las tablas necesarias,
incluyendo UA_UsrResponseType (tipos de respuesta de Campaign) y
UA_RespTypeMapping (correlación de tipos de respuesta entre Campaign y
eMessage).
Al establecer el valor como Yes se garantiza que la información sobre el
historial de respuesta y contacto de la oferta de eMessage sea coordinada
entre Campaign y eMessage. Por ejemplo, los datos de respuesta de correo
electrónico se incluirán en informes de Campaign.
Nota: También debe establecer Campaign | particiones | partición[n] |
servidor | interno | eMessageInstalled en Yes para esta partición o el
proceso de ETL no se ejecutará.
Valor predeterminado
No
Valores válidos
Yes | No
runOnceADay
Descripción
Indica si el proceso de ETL debe ejecutarse solo una vez al día.
Capítulo 6. Configuraciones para IBM eMessage
53
Si el valor es Yes: debe especificar startTime; el trabajo de ETL se ejecuta
hasta que todos los registros se han procesado y sleepIntervalInMinutes se
ignora.
Si el valor es No: el trabajo de ETL se inicia en cuanto se inicia el servidor
web de Campaign. El trabajo de ETL se detiene después de que todos los
registros se procesen y, a continuación, espera durante el tiempo
especificado por sleepIntervalInMinutes.
Valor predeterminado
No
Valores válidos
Yes | No
batchSize
Descripción
El proceso ETL utiliza este parámetro para captar registros descargados por
RCT a la tabla del sistema local eMessage. Puesto que los valores grandes
pueden afectar al rendimiento, la lista de valores disponibles se restringe a
los valores válidos que se muestran a continuación. Si prevé un gran
volumen de registro, ajuste batchSize además de sleepIntervalInMinutes
para procesar los registros a intervalos regulares.
Valor predeterminado
100
Valores válidos
100 | 200 | 500 | 1000
sleepIntervalInMinutes
Descripción
Especifica el intervalo en minutos entre trabajos de ETL. Esta opción
determina el tiempo de espera después de la finalización de un trabajo. El
proceso de ETL espera este tiempo antes de iniciar el siguiente trabajo. Se
pueden ejecutar varios trabajos de forma síncrona y puede haber varios
trabajos de ETL por partición.
Si runOnceADay es Sí, no puede establecer un intervalo de suspensión.
Valor predeterminado
60
Valores válidos
Números enteros positivos
startTime
Descripción
Especifique una hora a la que iniciar el trabajo ETL. Debe utilizar el
formato del entorno local inglés para especificar la hora de inicio.
Valor predeterminado
12:00:00 a.m.
54
IBM eMessage: Guía del administrador y de inicio
Valores válidos
Cualquier hora válida en el formato hh:mm:ss AM/PM
notificationScript
Descripción
Un ejecutable o archivo de script opcional que se ejecuta después de
finalizar cada trabajo de ETL. Por ejemplo, puede que desee ser notificado
del éxito o error de cada trabajo de ETL, para la supervisión. El script de
notificación se ejecuta cada vez que el trabajo ETL de una partición
determinada finaliza la ejecución.
Los parámetros pasados a este script son fijos y no se pueden cambiar. El
script puede utilizar los parámetros siguientes:
v etlStart: la hora de inicio de ETL en número de milisegundos.
v etlEnd: la hora de finalización de ETL en número de milisegundos.
v totalCHRecords: número total de registros de contactos procesados.
v totalRHRecords: número total de registros del historial de respuestas
procesados.
v executionStatus: estado de ejecución de ETL con el valor 1 (error) o 0
(éxito).
Valor predeterminado
No hay valor predeterminado definido.
Valores válidos
Cualquier ruta válida a la que pueda acceder el servidor de Campaign con
permisos de Lectura y Ejecución. Por ejemplo: D:\misscripts\
nombrescript.exe
Conceptos relacionados:
“Soporte de la integración de ofertas de Campaign” en la página 47
eMessage | serverComponentsAndLocations | hostedServices
Defina propiedades para especificar los URL para conectarse a IBM EMM Hosted
Services. eMessage utiliza conexiones independientes para cargar listas de
destinatarios, metadatos que describen las listas de destinatarios y para la
comunicación general que se envía al entorno alojado.
Debe cambiar los valores predeterminados si va a conectarse con IBM EMM
Hosted Services a través del centro de establecido por IBM en el Reino Unido.
Consulte a IBM para determinar a qué centro de datos está conectado.
uiHostName
Descripción
La dirección que eMessage utiliza para toda la comunicación con IBM
EMM Hosted Services, excepto la cargar las listas de destinatarios y
metadatos relacionados.
Valor predeterminado
em.unicaondemand.com
Capítulo 6. Configuraciones para IBM eMessage
55
Si se va a conectar al centro de datos del Reino Unido, cambie este valor a
em-eu.unicaondemand.com.
dataHostName
Descripción
La dirección que utiliza eMessage para cargar metadatos relacionados con
las listas de destinatarios en IBM EMM Hosted Services.
Valor predeterminado
em.unicaondemand.com
Si se va a conectar al centro de datos del Reino Unido, cambie este valor a
em-eu.unicaondemand.com.
ftpHostName
Descripción
La dirección que eMessage utiliza para cargar los datos de las listas de
destinatarios (excepto los metadatos de listas) en IBM EMM Hosted
Services.
Valor predeterminado
ftp-em.unicaondemand.com
Si se va a conectar al centro de datos del Reino Unido, cambie este valor a
ftp-em-eu.unicaondemand.com.
eMessage | particiones | partición[n] | hostedAccountInfo
Defina propiedades de esta categoría para definir las credenciales de usuario para
la base de datos que contiene información de cuenta necesaria para acceder a IBM
EMM Hosted Services. Los valores que especifique aquí deben estar definidos
como valores de usuario en Marketing Platform.
amUserForAcctCredentials
Descripción
Utilice esta propiedad para especificar el usuario de la Marketing Platform
que contiene un origen de datos de la Marketing Platform que especifica
las credenciales de acceso a la cuenta requeridas para acceder a IBM EMM
Hosted Services.
Valor predeterminado
asm_admin
Valores válidos
Cualquier usuario de Marketing Platform.
amDataSourceForAcctCredentials
Descripción
Utilice esta propiedad para especificar el origen de datos de Marketing
Platform que define las credenciales de inicio de sesión de IBM EMM
Hosted Services.
Valor predeterminado
56
IBM eMessage: Guía del administrador y de inicio
UNICA_HOSTED_SERVICES
Valores válidos
Un origen de datos asociado con el usuario que especifique en
amUserForAcctCredentials
eMessage | particiones | partición[n] | dataSources |
systemTables
Esta categoría contiene propiedades de configuración que definen el esquema, los
valores de conexión y las credenciales de inicio de sesión para la base de datos que
contiene las tablas del sistema de eMessage en el entorno de red.
type
Descripción
Tipo de la base de datos que aloja las tablas del sistema de eMessage.
Valor predeterminado
No hay valor predeterminado definido. Es necesario definir esta
propiedad.
Valores válidos
v SQLSERVER
v ORACLE9
v ORACLE10 (también se utiliza para indicar bases de datos Oracle 11)
v DB2
schemaName
Descripción
Nombre del esquema de base de datos para las tablas del sistema de
eMessage. Es el mismo que el nombre de esquema para las tablas del
sistema de Campaign.
Debe incluir este nombre de esquema al hacer referencia a tablas del
sistema en los scripts.
Valor predeterminado
dbo
jdbcBatchSize
Descripción
El número de solicitudes de ejecución que JDBC ejecuta a la vez en la base
de datos.
Valor predeterminado
10
Valores válidos
Un número entero mayor que 0.
jdbcClassName
Descripción
Capítulo 6. Configuraciones para IBM eMessage
57
Controlador JDBC para las tablas del sistema según se define en su
servidor web de Campaign.
Valor predeterminado
No hay valor predeterminado definido. Es necesario definir esta
propiedad.
jdbcURI
Descripción
URI de conexión JDBC para tablas del sistema según se define en el
servidor web de Campaign.
Valor predeterminado
No hay valor predeterminado definido. Es necesario definir esta
propiedad.
asmUserForDBCredentials
Descripción
Utilice esta propiedad para especifica un usuario de IBM EMM que tendrá
permitido el acceso a las tablas del sistema de eMessage.
Valor predeterminado
No hay valor predeterminado definido. Es necesario definir esta
propiedad.
Valores válidos
Cualquier usuario definido en la Marketing Platform. Normalmente, debe
ser el nombre del usuario del sistema de Campaign
amDataSourceForDBCredentials
Descripción
Utilice esta propiedad para especificar el origen de datos que define las
credenciales de inicio de sesión para la base de datos que contiene las
tablas del sistema de eMessage. Puede ser el mismo que el origen de datos
para las tablas del sistema de Campaign.
Valor predeterminado
UA_SYSTEM_TABLES
Valores válidos
Un origen de datos de Marketing Platform asociado al usuario de IBM
EMM que especifique en asmUserForDBCredentials
El origen de datos especifica un usuario y credenciales de base de datos
utilizados para acceder a las tablas del sistema de eMessage. Si el esquema
predeterminado para el usuario de base de datos no es el esquema que
contiene las tablas del sistema, debe especificar el esquema de tablas del
sistema en la conexión JDBC utilizada para acceder a las tablas del sistema.
poolAcquireIncrement
Descripción
58
IBM eMessage: Guía del administrador y de inicio
Es el número de conexiones nuevas que crea eMessage para las tablas del
sistema cuando la agrupación de conexión de base de datos se queda sin
conexiones. eMessage crea nuevas conexiones hasta llegar al número
especificado en poolMaxSize.
Valor predeterminado
1
Valores válidos
Un número entero mayor que 0.
poolIdleTestPeriod
Descripción
El número de segundos que espera eMessage entre pruebas de conexiones
desocupadas con las tablas del sistema de eMessage para la actividad.
Valor predeterminado
100
Valores válidos
Un número entero mayor que 0.
poolMaxSize
Descripción
El número máximo de conexiones que establece eMessage con las tablas
del sistema. Un valor de cero (0) indica que no hay número máximo.
Valor predeterminado
100
Valores válidos
Un número entero mayor o igual a 0.
poolMinSize
Descripción
El número mínimo de conexiones que establece eMessage con las tablas del
sistema.
Valor predeterminado
10
Valores válidos
Un número entero mayor o igual a 0.
poolMaxStatements
Descripción
El número máximo de sentencias que almacena eMessage en la memoria
caché PrepareStatement por cada conexión con las tablas del sistema. Si
poolMaxStatements se establece en cero (0), se inhabilita la memoria caché
de sentencias.
Valor predeterminado
Capítulo 6. Configuraciones para IBM eMessage
59
0
Valores válidos
Un número entero igual o mayor que 0.
timeout
Descripción
El número de segundos que eMessage mantiene una conexión de base de
datos desocupada antes de descartar la conexión.
Si poolIdleTestPeriod es mayor que 0, eMessage prueba todas las
conexiones desocupadas, agrupadas pero sin verificar, cada timeout
segundos.
Si poolIdleTestPeriod es mayor que timeout, se descartan las conexiones
desocupadas.
Valor predeterminado
100
Valores válidos
Un número entero igual o mayor que 0.
eMessage | particiones | partición[n] | recipientListUploader
Esta categoría de configuración contiene una propiedad opcional para la ubicación
de un script definido por el usuario que se ejecuta en respuesta a las acciones o el
estado del Cargador de listas de destinatarios.
pathToTriggerScript
Descripción
Puede crear script que desencadena una acción en respuesta a la carga de
una lista de destinatarios en IBM EMM Hosted Services. Por ejemplo,
puede crear un script para enviar una alerta por correo electrónico al
diseñador de listas una vez que la carga de la lista se haya realizado
correctamente.
Si define un valor para esta propiedad, eMessage pasará información de
estado sobre el Cargador de listas de destinatarios a la ubicación
especificada. eMessage no hace nada si deja esta propiedad en blanco.
Valor predeterminado
No hay valor predeterminado definido.
Valores válidos
Cualquier ruta de red válida.
eMessage | particiones | partición[n] | responseContactTracker
Las propiedades en esta categoría especifican el comportamiento del Rastreador de
respuestas y contactos (RCT). El RCT recupera y procesa los datos de los contactos
de correo electrónico, la entrega de correos electrónicos y las respuestas de los
destinatarios, tales como pulsaciones y aperturas de enlaces.
pauseCustomerPremisesTracking
Descripción
60
IBM eMessage: Guía del administrador y de inicio
eMessage almacena datos de contactos y respuestas en una cola de IBM
EMM Hosted Services. Esta propiedad le permite ordenar a RCT que
detenga temporalmente la recuperación de datos de IBM EMM Hosted
Services. Cuando reanuda el rastreo, el RCT descarga los datos
acumulados.
Valor predeterminado
False
Valores válidos
True | False
waitTimeToCheckForDataAvailability
Descripción
El RCT verifica periódicamente los nuevos datos sobre las respuestas de
los destinatarios o los contactos de correo electrónico. Esta propiedad le
permite especificar la frecuencia, en segundos, con la que el RCT verifica si
existen datos nuevos en IBM EMM Hosted Services. El valor
predeterminado es de 300 segundos, o cada 5 minutos.
Valor predeterminado
300
Valores válidos
Cualquier número entero mayor que 1.
perfLogInterval
Descripción
Esta propiedad le permite especificar la frecuencia con la que RCT registra
las estadísticas de rendimiento en un archivo de registro. El valor que
ingresa determina el número de lotes entre las entradas del registro.
Valor predeterminado
10
Valores válidos
Un número entero mayor que 0.
enableSeparatePartialResponseDataTracking
Descripción
Esta propiedad determina si eMessage reenvía los datos de respuesta del
correo electrónico parcial a las tablas de seguimiento en su instalación local
de eMessage.
eMessage necesita el ID de instancia de envío de correos y el Número de
secuencia de mensaje para atribuir correctamente las respuestas de correo
electrónico. Cuando habilita el rastreo de datos de respuesta parcial aparte,
eMessage pone las respuestas incompletas en tablas de rastreo locales
aparte donde puede revisarlos o llevar a cabo un procesamiento adicional
de los mismos.
Valor predeterminado
True
Capítulo 6. Configuraciones para IBM eMessage
61
Valores válidos
True | False
enableExecutionHistoryDataTracking
Descripción
Esta propiedad controla si puede descargar datos del historial de ejecución
de envíos de correos de IBM EMM Hosted Services.
De forma predeterminada, esta propiedad está establecida en False, para
impedir la descarga de datos adicionales. Cuando se establece esta
propiedad en True, puede descargar datos sobre ejecuciones de envíos de
correos que no se especifican normalmente en las tablas del sistema de
eMessage. Puede utilizar esta información complementaria como ayuda
para automatizar la gestión de bases de datos y envío de correos.
De forma predeterminada esta propiedad está oculta. Puede visualizar esta
propiedad de configuración en la instalación local de eMessage ejecutando
el script switch_config_visibility.bat, que se encuentra en el directorio
emessage\tools.
El acceso a los datos del historial de envíos de correos está disponible en
IBM si se solicita. Para solicitar acceso a datos adicionales del historial de
ejecución de envío de correos, póngase en contacto con su representante de
IBM en [email protected].
Valor predeterminado
False
Valores válidos
True | False
62
IBM eMessage: Guía del administrador y de inicio
Capítulo 7. Configuraciones para implementar notificaciones
de envío a móvil de IBM
Los usuarios de marketing utilizan IBM eMessage para enviar notificaciones de
envío a aplicaciones de dispositivo móvil. Para dar soporte a esta actividad, los
administradores del sistema deben configurar eMessage para que se comunique
con las aplicaciones de dispositivo móvil y con dispositivos móviles para los cuales
los usuarios de marketing envían notificaciones. Los administradores deben
mantener también la lista de ubicaciones utilizadas para la entrega de
notificaciones desencadenada por ubicación y configurar valores predeterminados
que los usuarios de marketing utilizan para configurar las notificaciones de envío.
Los desarrolladores de aplicaciones de dispositivo móvil modifican las aplicaciones
de dispositivo móvil para integrarlas con los sistemas de mensajería de IBM y
eMessage.
Para configurar eMessage para dar soporte a notificaciones de envío a móvil, debe
tener instalado IBM Campaign 9.1.0.2 Fixpack o superior.
Visión general de cómo integrar las aplicaciones móviles con los
sistemas de mensajería de IBM
La integración de una aplicación móvil con los sistemas de mensajería de IBM
conlleva una serie de acciones y actividades de diseño que están relacionadas con
distintos sistemas y organizaciones. Los pasos incluyen comunicarse con los
servicios de cuenta de IBM, configurar IBM eMessage y modificar la aplicación
móvil con un SDK proporcionado por IBM.
Antes de comenzar el proceso, debe completar las preparaciones necesarias de
Apple y Google para las aplicaciones que se integran con sus respectivos sistemas
operativo móvil y de notificación.
La tabla enumera la serie de acciones necesarias para integrar una aplicación móvil
con los servicios de mensajería de IBM.
Sec.
1
Actividad
Información
Registre la aplicación con Google Cloud
Messaging o con Apple Push
Notification Service.
“Requisitos previos para la integración
de aplicaciones de Google Android con
notificaciones de envío de IBM” en la
página 64
“Requisitos previos para la integración
de aplicaciones de Apple iOS con
notificaciones de envío de IBM” en la
página 76
2
Solicite que IBM habilite la cuenta de
mensajería alojada para la mensajería
móvil.
3
Registre la aplicación con IBM eMessage. “Registro de una aplicación de
dispositivo móvil en IBM eMessage” en
la página 90
© Copyright IBM Corp. 1999, 2015
“Habilitación de la cuenta de mensajería
alojada para la mensajería móvil” en la
página 90
63
Sec.
4
Actividad
Información
Modifique la aplicación para utilizar las
notificaciones de envío de IBM.
“Implementación de IBM Push
Notification SDK for Android dentro de
su aplicación” en la página 65
“Implementación de iOS en la
aplicación” en la página 77
5
Configure las ubicaciones para la entrega “Configuración de ubicaciones para
de notificaciones desencadenada por
entrega desencadenada por ubicación”
ubicación.
en la página 93
6
Solicite que IBM habilite el intercambio
“Enviar datos de seguimiento de
automático de resultados de seguimiento notificación de IBM” en la página 95
de notificación.
Integración de Google Cloud Messaging con IBM eMessage
IBM eMessage proporciona un modo simple para integrar las notificaciones de
envío de mensajería Google Cloud (GCM) en las aplicacoines de su Android 2.2 y
superior.
Para integrar GCM con los servicios de mensajería de IBM, debe descargar e
integrar el SDK Push Notification de IBM para Android.
Conceptos relacionados:
“Requisitos previos para la integración de aplicaciones de Google Android con
notificaciones de envío de IBM”
Tareas relacionadas:
“Registro de una aplicación de dispositivo móvil en IBM eMessage” en la página
90
Requisitos previos para la integración de aplicaciones de
Google Android con notificaciones de envío de IBM
Antes de comenzar a integrar una aplicación móvil de Google Android con los
servicios de IBM para notificaciones de envío, debe registrar y proporcionar la
mensajería de Google Cloud (GCM) a su aplicación móvil de Android 2.2 y
superior. Durante el registro, cree un proyecto GCM. Cada proyecto tiene un
nombre de paquete y un número de proyecto de API de Google. El nombre de
paquete y el número de proyecto de API son entradas necesarias para registrar la
aplicación de dispositivo móvil con los servicios de mensajería de IBM.
Cree proyectos independientes para los entornos de desarrollo y de producción. Al
registrar la aplicación con los servicios de mensajería de IBM, registre los proyectos
de desarrollo y de producción de forma independiente.
El suministro y el registro de su aplicación de dispositivo móvil en GCM incluye
las actividades siguientes.
v Crear una cuenta de mensajería de Google.
v Configurar Google Play Services
v Crear un proyecto de API de Google.
64
IBM eMessage: Guía del administrador y de inicio
v Compilar su aplicación en Eclipse o en la línea de mandatos.
v Registrar la aplicación con Google Cloud Messaging.
v Anotar el número de proyecto de API de Google y la clave de API de Google.
Estos valores son necesarios para integrar la aplicación con los sistemas de
mensajería de IBM y eMessage.
Consulte el sitio web de Google ( http://developer.android.com/google/gcm/
index.html ) para obtener instrucciones específicas sobre la creación de proyectos
de desarrollo y producción en GCM.
Nota: Asegúrese de registrar el número de proyecto de API de Google y la clave
de API de Google de cada proyecto GCM que cree. Debe proporcionar estos
valores al registrar la aplicación con IBM.
Conceptos relacionados:
“Integración de Google Cloud Messaging con IBM eMessage” en la página 64
Tareas relacionadas:
“Registro de una aplicación de dispositivo móvil en IBM eMessage” en la página
90
Implementación de IBM Push Notification SDK for Android
dentro de su aplicación
Para integrar Google Cloud Messaging (GCM) con los servicios de mensajería de
IBM, debe descargar IBM Push Notification SDK for Android y añadirlo a la
aplicación móvil. Modifique el SDK y la aplicación de dispositivo móvil para
proporcionar las características de notificación que admite IBM eMessage.
Antes de empezar
Antes de empezar a modificar la aplicación para que funcione con los sistemas de
mensajería eMessage y IBM debe hacer lo siguiente.
v Registre su aplicación con Google Cloud Messaging. Debe registrar el número de
proyecto de la API de Google y la clave de la API de Google. Estos valores son
necesarios para implementar el SDK.
v Registre la aplicación con eMessage. El proceso de registro genera una clave de
aplicación. La clave de aplicación es necesaria para implementar el SDK.
Acerca de esta tarea
Nota: Para obtener instrucciones adicionales relacionadas con la implementación
de notificaciones de envío de IBM en su de aplicación de dispositivo móvil,
examine la aplicación de ejemplo que se incluye con el paquete IBM Push
Notification SDK for Android.
1. Descargue IBM Push Notification SDK for Android versión 2.x de IBM
developerWorks en https://www.ibmdw.net/push/docs/ibm-mobile-pushnotification/google-cloud-messaging/download-ibm-push-notification-sdkandroid/.
2. Añada IBM Push Notification SDK for Android a la ruta del proyecto.
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
65
a. Cree una nueva carpeta en su proyecto que se denomine libs y mueva el
archivo JAR de IBM Push Notification SDK for Android a dicha carpeta.
Busque el archivo JAR de SDK en el directorio raíz después de extraer el
paquete del SDK.
b. Seleccione el proyecto.
c. Pulse Propiedades con el botón derecho del ratón.
d. Seleccione Ruta de construcción de java.
e. Seleccione la pestaña Bibliotecas.
f. Seleccione Añadir JAR y vaya al archivo JAR de IBM Push Notification SDK
for Android en la carpeta libs.
3. Modifique el archivo AndroidManifest.xml.
a. Versión de Android: establezca la versión mínima de Android SDK en '8'
(Android 2.2) o superior. IBM Push Notification SDK for Android no
funciona con versiones anteriores.
<uses-sdk android:minSdkVersion="8" />
b. Permisos: se necesitan los permisos siguientes para que el SDK funcione
correctamente. Estos permisos se sitúan como un hijo del nodo <manifest>.
Sustituya las dos apariciones de YOUR_APP_PACKAGE_NAME por el nombre de
paquete de su aplicación.
<permission android:name="YOUR_APP_PACKAGE_NAME.permission.C2D_MESSAGE"
android:protectionLevel="signature" />
<uses-permission android:name="YOUR_APP_PACKAGE_NAME.permission.C2D_MESSAGE" />
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
Si desea utilizar la Acción de marcación opcional en la página de detalles de
notificación, añada la información siguiente:
<uses-permission android:name="android.permission.CALL_PHONE" />
c. Componentes de aplicación: añada el XML siguiente al nodo <application>.
Sustituya la aparición de YOUR_APP_PACKAGE_NAME por el nombre de paquete
de su aplicación.
<provider
android:name="com.xtify.sdk.db.Provider"
android:authorities="YOUR_APP_PACKAGE_NAME.XTIFY_PROVIDER"
android:exported="false" />
<receiver android:name="com.xtify.sdk.c2dm.C2DMBroadcastReceiver" >
<intent-filter android:permission="com.google.android.c2dm.permission.SEND" >
<action android:name="com.google.android.c2dm.intent.RECEIVE" />
<category android:name="YOUR_APP_PACKAGE_NAME" />
</intent-filter>
<intent-filter android:permission="com.google.android.c2dm.permission.SEND" >
<action android:name="com.google.android.c2dm.intent.REGISTRATION" />
<category android:name="YOUR_APP_PACKAGE_NAME" />
</intent-filter>
</receiver>
<receiver android:name="com.xtify.sdk.NotifActionReceiver" />
<receiver android:name="com.xtify.sdk.wi.AlarmReceiver" >
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.TIMEZONE_CHANGED" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.PACKAGE_REPLACED" />
66
IBM eMessage: Guía del administrador y de inicio
<data android:scheme="package" />
</intent-filter>
</receiver>
<service
<service
<service
<service
<service
<service
android:name="com.xtify.sdk.location.LocationUpdateService" />
android:name="com.xtify.sdk.c2dm.C2DMIntentService" />
android:name="com.xtify.sdk.alarm.MetricsIntentService" />
android:name="com.xtify.sdk.alarm.TagIntentService" />
android:name="com.xtify.sdk.alarm.RegistrationIntentService" />
android:name="com.xtify.sdk.alarm.LocationIntentService" />
4. Edite su actividad Main: en su actividad main (la actividad que se inicia
cuando se abre la aplicación por primera vez), necesita hacer lo siguiente.
a. Añada la importación siguiente:
import com.xtify.sdk.api.XtifySDK;
b. A continuación, llame a XtifySDK.start en el método onStart de la
actividad:
final String XTIFY_APP_KEY = "YOUR_XTIFY_APP_KEY";
final String PROJECT_NUM = "YOUR_PROJECT_NUM"; // Este es el número de proyecto de Google
XtifySDK.start(getApplicationContext(), XTIFY_APP_KEY, PROJECT_NUM);
Cambie "YOUR_XTIFY_APP_KEY" por su clave de aplicación de
notificación de envío de dispositivo móvil de IBM y
"YOUR_PROJECT_NUM" por su número de proyecto de la API de Google.
XtifySDK.start() inicia el proceso de registro con la notificación de envío de
dispositivo móvil de IBM y GCM y, a continuación, se asegura de que el
componente IBM Push Notification SDK for Android esté en ejecución.
public class MainActivity extends Activity {
private static final String XTIFY_APP_KEY = "1234567-abcd-efgh-ijkl-25d2389b0178";
private static final String PROJECT_NUM = "1234567890123";
@Override
protected void onStart() {
super.onStart();
XtifySDK.start(getApplicationContext(), XTIFY_APP_KEY, PROJECT_NUM);
}
}
No permita que su aplicación se pueda instalar en tarjetas de almacenamiento
externas. Para obtener más información, consulte el sitio del desarrollador de
Google en http://developer.android.com/guide/topics/data/installlocation.html#ShouldNot. Establezca que sea necesario instalar la aplicación en la
memoria interna.
Suministro de una bandeja de entrada de aplicación para
aplicaciones Android
Para dar soporte al envío de notificaciones de bandeja de entrada a una aplicación
de dispositivo móvil Android, debe crear una bandeja de entrada en la aplicación
de dispositivo móvil para recibirlas.
Acerca de esta tarea
En el SDK de la serie Android 2.x, la gestión de notificaciones de bandeja de
entrada se retira del SDK, por lo que puede personalizar la vista para su
aplicación. En ocasiones, se hace referencia a las notificaciones de bandeja de
entrada como notificaciones enriquecidas.
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
67
Procedimiento
1. Añada el paquete de notificaciones de bandeja de entrada a su aplicación.
a. Cree un paquete de clases con el nombre: com.xtify.rn
b. Desde el paquete IBM Push Notification SDK for Android, copie el código
fuente de Rich Notification/src/com/xtify/rn en el nuevo paquete que
haya creado.
c. Desde el paquete IBM Push Notification SDK for Android, copie el
contenido de la carpeta Rich Notification/res/ a la carpeta /res de su
proyecto.
2. Añada lo siguiente al nodo de aplicación en el manifiesto.
<activity android:configChanges="orientation"
android:name="com.xtify.rn.RichNotifInboxActivity"></activity>
<activity android:configChanges="orientation"
android:name="com.xtify.rn.RichNotifActivity"></activity>
3. En la subclase "XtifyBroadcastReceiver" (XtifyNotifier en la aplicación de
ejemplo), añada la llamada de método siguiente en "onMessage".
import com.xtify.rn.RichNotificationManger;
public class XtifyNotifier extends XtifyBroadcastReceiver {
...
@Override
public void onMessage(Context context, Bundle msgExtras) {
RichNotificationManger.processNotifExtras(context, msgExtras);
...
}
...
}
4. Para mostrar la bandeja de entrada de notificaciones, inicie
RichNotifInboxActivity colocando el código siguiente en la función onClick de
su MenuItem o Button.
Intent intent = new Intent(this, RichNotifInboxActivity.class);
context.startActivity(intent);
Donde context es el contexto de actividad. Puede obtenerlo haciendo uso de
this en la actividad.
Suministro de notificaciones desencadenadas por ubicación
para aplicaciones Android
Al integrar el paquete IBM Push Notification SDK for Android en la aplicación de
dispositivo móvil, la aplicación puede escuchar actualizaciones de ubicación de
dispositivo de dispositivos móviles y enviarlas a los servicios de mensajería de
IBM. Si un dispositivo móvil se mueve dentro de un radio especificado de una
ubicación predefinida, el sistema envía automáticamente una notificación al
usuario del dispositivo móvil.
Acerca de esta tarea
El paquete IBM Push Notification SDK for Android utiliza datos de ubicación de
red a través del servicio NETWORK_PROVIDER para minimizar el impacto en el
rendimiento de la batería. Este proveedor determina la ubicación que se basa sólo
68
IBM eMessage: Guía del administrador y de inicio
en puntos de acceso WiFi y la disponibilidad de la torre de comunicaciones. Los
resultados se recuperan utilizando únicamente una búsqueda de red y no mediante
GPS.
Cuando habilita las actualizaciones y el seguimiento permanentes, la ubicación del
dispositivo se envía a IBM cada 15 minutos, incluso aunque la aplicación esté en
segundo plano.
Procedimiento
1. Habilite las actualizaciones y el seguimiento de ubicación permanentes.
El contexto es el contexto de la aplicación. Obtenga el contexto llamando a
"Activity.getApplicationContext()" o "Context.getApplicationContext()".
a. Importe la clase "XtifyLocation".
import com.xtify.sdk.api.XtifyLocation;
b. Llame al método estático siguiente en su aplicación.
XtifyLocation.enableRepetitiveLocUpdate(context);
Para inhabilitarlo:
XtifyLocation.disableRepetitiveLocUpdate(context);
2. Actualice el manifiesto para que incluya el permiso siguiente. Este se posiciona
como un hijo del nodo <manifest>.
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
Tareas relacionadas:
“Configuración de ubicaciones para entrega desencadenada por ubicación” en la
página 93
Configuración para que estén disponibles las actualizaciones de
ubicación al solicitarlas
Puede configurar la aplicación móvil para proporcionar actualizaciones de
ubicación en un determinado punto de la aplicación o al solicitarlas el usuario. Por
ejemplo, configure una actualización de ubicación al suceder una acción de
usuario, como cuando el usuario se registra en la aplicación.
Procedimiento
Utilice el método siguiente de la clase XtifyLocation.
updateLocation(int timeOut, LocationUpdateListener locationUpdateListener);
Este método está a la escucha de la actualización de ubicaciones hasta que se
recibe la ubicación o se alcanza el tiempo de espera. El método no garantiza la
entrega de ubicación a IBM. Se llama al método LocationUpdateListener
suministrado solo cuando se recibe la ubicación. Es posible que tenga que crear la
lógica para intentar volver a conectar como respuesta a condiciones de error, como
un tiempo de espera excedido.
Configuración de actualizaciones de ubicación personalizadas
Puede implementar su propia lógica para determinar la ubicación de un
dispositivo móvil y enviar la notificación a IBM.
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
69
Procedimiento
Utilice el método siguiente de la clase XtifyLocation.
updateLocation(int timeOut, LocationUpdateListener locationUpdateListener);
Este método no garantiza la entrega de ubicación a IBM. Se llama al método
LocationUpdateListener suministrado solo cuando se recibe la ubicación. Es
posible que tenga que crear la lógica para intentar volver a conectar como
respuesta a condiciones de error, como un tiempo de espera excedido.
Ejemplo
El ejemplo siguiente ilustra un diseño posible para actualizaciones de ubicación
personalizadas.
import com.xtify.sdk.api.XtifyLocation;
import com.xtify.sdk.api.XtifyLocation.LocationUpdateListener;
...
int timeOut = 2 * 60 * 1000; // un min.
XtifyLocation xtifyLocation = new XtifyLocation(getApplicationContext());
xtifyLocation.updateLocation(timeOut, new LocationUpdateListener() {
@Override
public void onUpdateComplete(boolean result, Location location) {
}
});
...
Suministro de notificaciones de intención de la acción
Para abrir una actividad mediante la acción de notificación Intención de la
acción, debe actualizar el nodo de actividad en el archivo AndroidManifest.xml.
Procedimiento
1. Añada lo siguiente al nodo de actividad en el archivo AndroidManifest.xml.
<intent-filter>
<action android:name="com.yoursite.YOUR_ACTION_NAME" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
2. Sustituya com.yoursite.YOUR_ACTION_NAME por el nombre de la acción. Cuando
envía una notificación a través de la consola, puede establecer la "Intención de
la acción" en el nombre de la acción.
Configuración del soporte para eventos y notificaciones
Utilice el IBM Push Notification SDK para responder a eventos y a datos de
notificaciones de envío entrantes.
Acerca de esta tarea
1. Añada lo siguiente al nodo de aplicación en el manifiesto:
<receiver android:name=".XtifyNotifier" >
<intent-filter>
<action android:name="com.xtify.sdk.NOTIFIER" />
</intent-filter>
</receiver>
70
IBM eMessage: Guía del administrador y de inicio
2. Cree una clase, denomínela XtifyNotifier en su paquete principal y utilice el
código siguiente como contenido de este nuevo archivo de clase:
import android.content.Context;
import android.os.Bundle;
import com.xtify.sdk.api.XtifyBroadcastReceiver;
public class XtifyNotifier extends XtifyBroadcastReceiver {
@Override
protected void onMessage(Context context, Bundle msgExtras){
}
@Override
protected void onRegistered(Context context) {
}
@Override
protected void onC2dmError(Context context, String errorId) {
}
}
La llamada a los métodos de XtifyNotifier se lleva a cabo incluso aunque su
aplicación no esté en ejecución (consulte las notas de XtifyNotifier). A continuación
se muestra una descripción de qué va a recibir en cada uno de los métodos y
cuándo se va a recibir.
1. onMessage: los elementos adicionales del mensaje se reciben en onMessage en
el parámetro bundle. Puede obtener los elementos adicionales en el ejemplo
anterior obteniendo las cadenas por clave:
msgExtras.getString(key);
La clave puede ser una de las siguientes:
a. Una clave definida por notificaciones de envío de IBM .
Tabla 1. Tabla de claves.
Clave
Descripción
com.xtify.sdk.NOTIFICATION_TITLE
Título de notificación simple.
com.xtify.sdk.NOTIFICATION_CONTENT
Contenido de notificación simple.
com.xtify.sdk.NOTIF_ACTION_TYPE
Tipo de la acción cuya ejecución se estableció en la
notificación de envío de IBM para el SDK (por ejemplo,
com.xtify.sdk.OPEN_URL)
com.xtify.sdk.NOTIF_ACTION_DATA
Datos relacionados con el tipo de acción (por ejemplo,
para un URL de apertura, los datos son el URL del sitio
web)
b. Una clave personalizada que puede definir en la carga útil (por ejemplo,
puede establecer el campo de carga útil en la API de envío o en la
aplicación de la consola web, como se indica a continuación).
Puede obtener el valor en onMessage llamando:
En este caso, el valor devuelto es "myValue".
Nota: Para claves personalizadas (que no sean claves de notificación de
envío de IBM ), la clave tiene el prefijo data.
2. onC2dmError: si se produce un error durante el registro, se llama a
onC2dmError con errorId:
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
71
Tabla 2. Tabla de códigos de error
Código de error
Descripción
SERVICE_NOT_AVAILABLE
Se ha producido un 500/503 desde el servidor. El SDK
vuelve a intentar el registro.
ACCOUNT_MISSING
No existe ninguna cuenta de Google en el teléfono. La
aplicación debe solicitar al usuario que abra el
administrador de cuentas y añada una cuenta de Google.
Se soluciona en el lado del dispositivo.
AUTHENTICATION_FAILED
Contraseña incorrecta. La aplicación debe solicitar al
usuario que especifique su contraseña, y permitirle que
vuelva a intentarlo manualmente más adelante. Se
soluciona en el lado del dispositivo.
TOO_MANY_REGISTRATIONS
El usuario tiene demasiadas aplicaciones registradas. La
aplicación debe indicar al usuario que desinstale alguna
de las demás aplicaciones, permitiéndole volver a
intentarlo más adelante. Se soluciona en el lado del
dispositivo.
INVALID_SENDER
No se reconoce la cuenta del remitente.
PHONE_REGISTRATION_ERROR
Registro de teléfono incorrecto con Google. Este teléfono
no tiene soporte para GCM actualmente.
3. onRegister: este método se llama cuando se registra IBM Push Notification SDK
for Android con IBM y con GCM, y está listo para recibir notificaciones. Si
desea recuperar el XID del usuario y mantenerlo en su propia tabla de
usuarios, es aquí donde debe hacerlo.
Qué hacer a continuación
XtifyNotifier amplía XtifyBroadcastReceiver, que es una subclase de
android.content.BroadcastReceiver. Los métodos abstractos de XtifyNotifier se
llaman desde BroadcastReceiver.onReceive. Tienen el mismo ciclo de vida que
cualquier BroadcastReceiver. Para obtener más información, consulte
http://developer.android.com/reference/android/content/
BroadcastReceiver.html#ReceiverLifecycle.
La biblioteca difunde un intento con una simple pulsación
"com.xtify.sdk.EVENT_NCK". Puede configurar un receptor en su proyecto y
ejecutar lógica personalizada sobre acciones, como el envío de la pulsación al SDK
de Google Analytics. A continuación se indica cómo configurarlo.
1. Cree una clase con el nombre "XtifyEventReceiver", añada el código siguiente y
sustituya CUSTOM_CODE por el código que se ejecuta tras una pulsación:
public class XtifyEventReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
if(intent.getAction() == "com.xtify.sdk.EVENT_NCK"){
Log.i(XtifyEventReceiver.class.getName(), "Notification clicked.");
CUSTOM_CODE
}
}
}
2. Añada lo siguiente a su archivo de manifiesto y sustituya
YOUR_PACKAGE_NAME por el nombre del paquete que contiene la clase
XtifyEventReceiver:
72
IBM eMessage: Guía del administrador y de inicio
<receiver android:name="YOUR_PACKAGE_NAME.XtifyEventReceiver" >
<intent-filter>
<action android:name="com.xtify.sdk.EVENT_NCK" />
</intent-filter>
</receiver>
Nota: Es posible que desee registrar una métrica de apertura de aplicación, si es
necesario para su caso de uso. Por ejemplo, si va a gestionar grandes caídas en su
aplicación a través de una acción personalizada, podría registrar una estadística de
apertura de aplicación llamando:
XtifyMetricsManager.addMetric(context, MetricAction.APP_OPENED,
"<Insert ISO8601 time string>");
Personalización de notificaciones
Puede personalizar el comportamiento de las notificaciones predeterminadas
usando la clase com.xtify.sdk.api.NotificationsPreference en el SDK Push
Notification de IBM para Android.
Habilitación y cambio de las notificaciones sonoras
Para reproducir un sonido para notificaciones de la aplicación móvil, debe
modificar la clase NotificationsPreference.
Procedimiento
1. Para habilitar el sonido para notificaciones, invoque el método estático
siguiente desde la clase NotificationsPreference:
NotificationsPreference.setSoundEnabled(context, true);
2. Para cambiar el sonido de las notificaciones, añada primero su archivo de
sonido a la carpeta /res/raw/ de su proyecto y luego invoque el método
estático NotificationsPreference.setSound(context,soundResourceID). Por
ejemplo,
NotificationsPreference.setSound(context, R.raw.notification_sound);
Nota: Si ha habilitado el sonido pero no ha establecido un sonido
personalizado, se utiliza el sonido predeterminado del sistema.
Habilitación y cambio de notificaciones por vibración
Para habilitar o cambiar las vibraciones de sus notificaciones de aplicación móvil,
debe modificar AndroidManifest.xml y la clase NotificationsPreference.
Procedimiento
1. Para habilitar la vibración para notificaciones, añada el permiso siguiente a su
archivo AndroidManifest.xml:
<uses-permission android:name="android.permission.VIBRATE"/>
2. A continuación, llame al método estático siguiente desde la clase
NotificationsPreference:
NotificationsPreference.setVibrateEnabled(context, true);
3. Para cambiar el patrón de vibración notificaciones, invoque el método estático
NotificationsPreference.setVibrationPattern(context,vibrationPattern). Por
ejemplo,
long [] vibrate = {0,100,200,300};
NotificationsPreference.setVibrationPattern(context,vibrate);
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
73
Nota: Si ha habilitado la vibración pero no ha establecido un patrón de
vibración personalizado, se utiliza el patrón de vibración predeterminado del
sistema.
Habilitación y modificación de las notificaciones por iconos
Para habilitar o cambiar las notificaciones por icono para las notificaciones de su
aplicación móvil, debe modificar la clase NotificationsPreference.
Procedimiento
Para cambiar el icono de notificaciones, invoque el método estático
NotificationsPreference.setIcon(context,iconResourceID). Por ejemplo,
NotificationsPreference.setIcon(context, R.drawable.notification_icon);
Nota: El icono de notificaciones predeterminado es
android.R.drawable.sym_def_app_icon.
Habilitación y modificación de las notificaciones luminosas
Para habilitar o cambiar las notificaciones por luz para las notificaciones de su
aplicación móvil, debe modificar la clase NotificationsPreference.
Procedimiento
1. Para habilitar las luces de notificación, llame al método estático siguiente desde
la clase NotificationsPreference.
NotificationsPreference.setLightsEnabled(context, true);
2. Para cambiar las preferencias de las luces de notificaciones, invoque el método
estático NotificationsPreference.setLights(getApplicationContext(), new int[] {
ledARGB , ledOnMS , ledOffMS });. Por ejemplo:
int ledARGB = 0x00a2ff;
int ledOnMS = 300;
int ledOffMS = 1000:
NotificationsPreference.setLights(getApplicationContext(), new int[] { ledARGB, ledOnMS, ledOffMS });
Nota: Si pasa un valor nulo a cualquiera de los métodos de establecimiento en
NotificationsPreference, se restablece la preferencia y se aplicará el valor
predeterminado a las notificaciones nuevas.
Habilitación y cambio de notificaciones por indicativos
Para habilitar o cambiar las notificaciones mediante indicadores para las
notificaciones de su aplicación móvil, debe modificar la clase
NotificationsPreference.
Procedimiento
Para agregar distintivos de notificación para las notificaciones, invoque el método
estático NotificationsPreference.addFlags(context, NOTIFICATION_FLAG_1 |
NOTIFICATION_FLAG_2);. Por ejemplo:
NotificationsPreference.addFlags(context, Intent.FLAG_ACTIVITY_SINGLE_TOP);
Nota: Los distintivos de notificaciones predeterminados son
FLAG_ACTIVITY_NEW_TASK y FLAG_ACTIVITY_CLEAR_TOP.
Todos los distintivos se combinan con FLAG_ACTIVITY_NEW_TASK
Para obtener más información sobre distintivos, consulte http://
developer.android.com/reference/android/content/
Intent.html#FLAG_ACTIVITY_NEW_TASK.
74
IBM eMessage: Guía del administrador y de inicio
Integración de ID de usuario de aplicación de dispositivo
móvil (XID) para Android
El ID de usuario de aplicación de dispositivo móvil es un identificador exclusivo
que el sistema asigna a cada usuario de aplicación de dispositivo móvil cuando
este descarga e instala su aplicación de dispositivo móvil. El ID de usuario de
aplicación se denomina también XID. Los sistemas de mensajería de IBM envían el
ID de usuario de aplicación de dispositivo móvil al dispositivo móvil. Debe
configurar su aplicación de dispositivo móvil Android para que recupere el ID y lo
establezca como disponible en la base de datos de marketing para que se utilice al
seleccionar destinatarios de notificaciones de envío.
Utilizando Java, puede recuperar el ID de usuario de aplicación de dispositivo
móvil tal como se indica a continuación.
String xid = XtifySDK.getXidKey(getApplicationContext());
El ID de usuario de aplicación de dispositivo móvil no está disponible hasta que el
usuario instale la aplicación en un dispositivo móvil. Para enviar el ID de usuario
de aplicación de dispositivo móvil al servidor que da soporte a su base de datos de
marketing, utilice el método onRegistered de XtifyNotifier. Examine la aplicación
de ejemplo incluida en el SDK de notificación de envío de IBM para ver un
ejemplo de cómo recuperar el ID de usuario de aplicación de dispositivo móvil.
El ID de usuario de aplicación de dispositivo móvil puede cambiar en los
escenarios siguientes.
v Un nuevo registro del dispositivo (se registra de nuevo, después de tener ya un
ID de usuario de aplicación de dispositivo móvil). Esto ocurre si el usuario
móvil vuelve a instalar la aplicación. La actualización de la aplicación no afecta
al ID de usuario de aplicación de dispositivo móvil.
v El ID de instalación cambia. Esto es poco probable, pero podría ocurrir si cambia
alguna característica física del dispositivo.
Conceptos relacionados:
“Requisito para identificar usuarios de la aplicación en la base de datos de
marketing” en la página 92
Integración del servicio de notificación de envío de Apple con IBM
eMessage
IBM eMessage proporciona una forma sencilla de integrar el Servicio de
notificación de envío de Apple (APNS) con sus aplicaciones iOS (iPhone e iPad) 3.2
y posteriores.
Para integrar APNS con los servicios de mensajería de IBM, debe descargar e
integrar el SDK Push Notification de IBM para iOS de Apple.
Conceptos relacionados:
“Requisitos previos para la integración de aplicaciones de Apple iOS con
notificaciones de envío de IBM” en la página 76
Tareas relacionadas:
“Registro de una aplicación de dispositivo móvil en IBM eMessage” en la página
90
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
75
Requisitos previos para la integración de aplicaciones de
Apple iOS con notificaciones de envío de IBM
Antes de comenzar a integrar una aplicación de Apple iOS con los servicios de
IBM para notificaciones de envío, debe registrar y suministrar a su aplicación de
iOS (iPhone & iPad) 3.2 y superior el Apple Push Notification Service (APNS).
Durante el registro, configure un certificado SSL y una contraseña necesarios para
conectarse al APNS. El certificado y la contraseña son también entradas necesarias
para registrar la aplicación de dispositivo móvil con los servicios de mensajería de
IBM.
Al registrar y suministrar su aplicación móvil con Apple, puede crear un perfil de
desarrollo y un perfil de producción. Cada perfil requiere un certificado SSL y
contraseña independiente y debe registrarlos de forma independiente con APNS.
Proporcione los mismos certificados y contraseñas de desarrollo y de producción
de forma independiente en IBM al registrar la aplicación iOS con IBM.
El registro y suministro de su aplicación de dispositivo móvil con Apple incluye
los pasos siguientes:
v Crear una cuenta de desarrollador de Apple y descargar Xcode.
v Compilar su aplicación en Xcode.
v Crear un bundleID.
v Crear un AppID explícito. No crear un ID de aplicación comodín.
v Registrar la aplicación con Apple Push Notification Service. Crear perfiles de
suministro para desarrollo y producción. Cada perfil incluye un certificado SSL y
una contraseña.
v La aplicación y el ID de aplicación deben aparecer como habilitados para las
notificaciones de envío en APNS.
Consulte el sitio web de Apple (https://developer.apple.com/library/mac/
documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/
Chapters/ProvisioningDevelopment.html#//apple_ref/doc/uid/TP40008194CH104-SW1) para obtener instrucciones específicas sobre el registro y el suministro
de su aplicación de dispositivo móvil con Apple.
Nota: Asegúrese de registrar el nombre de certificado y la contraseña para cada
perfil de suministro que cree. Debe proporcionar estos valores al registrar la
aplicación con IBM. Asegúrese de que el tipo de certificado coincide con el tipo de
perfil de suministro. Los perfiles de distribución requieren un certificado de
distribución. Los perfiles de desarrollo requieren un certificado de desarrollo.
Conceptos relacionados:
“Integración del servicio de notificación de envío de Apple con IBM eMessage” en
la página 75
Tareas relacionadas:
“Registro de una aplicación de dispositivo móvil en IBM eMessage” en la página
90
76
IBM eMessage: Guía del administrador y de inicio
Implementación de iOS en la aplicación
Para integrar las aplicaciones iOS con los servicios de mensajería de IBM, debe
descargar IBM Push Notification SDK for Apple iOS y añadirlo a la aplicación
móvil. Modifique el SDK y la aplicación de dispositivo móvil para proporcionar las
características de notificación a las que da soporte IBM eMessage
Antes de empezar
Antes de empezar a modificar la aplicación para que funcione con los sistemas de
mensajería eMessage y IBM debe hacer lo siguiente.
v Registre la aplicación con Apple Push Notification Service. Debe registrar el
certificado SSL y la contraseña que desea crear. Estos valores son necesarios para
implementar el SDK.
v Registre la aplicación con eMessage. El proceso de registro genera una clave de
aplicación. La clave de aplicación es necesaria para implementar el SDK.
Acerca de esta tarea
Para utilizar Push Notification SDK for Apple iOS, se deben incluir los archivos de
origen de la carpeta del SDK en el proyecto de aplicación.
Procedimiento
1. Descargue el paquete IBM Push Notification SDK for Apple iOS de IBM
developerWorks en https://www.ibmdw.net/push/docs/ibm-mobile-pushnotification/apple-push-notification-service/download-ibm-push-notificationsdk-apple-ios/.
2. En el portal Apple Provisioning, abra el proyecto Xcode para su aplicación
móvil.
3. Abra el paquete IBM Push Notification SDK for Apple iOS. Arrastre la carpeta
XtifyLib desde la carpeta local (por ejemplo, /XtifyRich vN.n/XtifyLib) al
proyecto Xcode de aplicación. Asegúrese de que está seleccionado Copy items
into destination group’s folder (if needed) (Copiar elementos en la carpeta del
grupo de destino (si es necesario)).
4. Actualice XtifyGlobal.h.
a. Sustituya la xAppKey por su clave de aplicación.
#define xAppKey @"REPLACE_WITH_YOUR_APP_KEY"
//Obtener la clave de aplicación creada al registrar la aplicación con APNS
5. Añada las infraestructuras siguientes en el archivo de proyecto.
v Foundation.framework
v UIKit.framework
v
v
v
v
v
v
v
CoreGraphics.framework
SystemConfiguration.framework
MapKit.framework
CoreData.framework
MessageUI.framework
CoreLocation.framework
CFNetwork.framework
v libxml2.2.dylib
v libz.1.1.3.dylib
v MobileCoreServices.framework
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
77
v CoreTelephony.framework
6. En el archivo de cabecera de delegado de aplicación (AppDelegate.h):
a. Añada @class XLappMgr;.
#import <UIKit/UIKit.h>
@class XLappMgr; // Xtify Application Manager-include it in your app
b. En el archivo de implementación de aplicación (AppDelegate.m), añada
#import "XLappMgr.h" e incorpore las funciones de miembro marcadas
como //Añadir o incorporar esta función en el archivo de delegado de
aplicación.
#import "SampleTabsAppDelegate.h"
#import "XLappMgr.h" // Xtify Application Manager-- include this in your app
@implementation SampleTabsAppDelegate
// Añadir o incorporar las funciones siguientes en el archivo de delegado de aplicación
- init
{
if (self == [super init]) {
XLXtifyOptions *anXtifyOptions=[XLXtifyOptions getXtifyOptions];
[[XLappMgr get ]initilizeXoptions:anXtifyOptions];
}
return self;
}
// Añadir o incorporar esta función en el archivo de delegado de aplicación
- (void)application:(UIApplication *)app
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)devToken
{
NSLog(@"Succeeded registering for push notifications. Device token: %@", devToken);
[[XLappMgr get] registerWithXtify:devToken ];
}
// Añadir o incorporar esta función en el archivo de delegado de aplicación
- (void)applicationDidEnterBackground:(UIApplication *)application
{
NSLog(@"Application is about to Enter Background");
[[XLappMgr get] appEnterBackground];
}
// Añadir o incorporar esta función en el archivo de delegado de aplicación
- (void)applicationDidBecomeActive:(UIApplication *)application {
NSLog(@"Application moved from inactive to Active state");
[[XLappMgr get] appEnterActive];
}
// Añadir o incorporar esta función en el archivo de delegado de aplicación
- (void)applicationWillEnterForeground:(UIApplication *)application {
NSLog(@"Application moved to Foreground");
[[XLappMgr get] appEnterForeground];
}
// Añadir o incorporar esta función en el archivo de delegado de aplicación
- (void)application:(UIApplication *)application
didReceiveRemoteNotification:(NSDictionary *)launchOptions
{
NSLog(@"Receiving notification, app is running");
NSDictionary * aPush=[[NSDictionary alloc] initWithDictionary:launchOptions];
[self handleAnyNotification:aPush];
[aPush release];
}
// Añadir o incorporar esta función en el archivo de delegado de aplicación
- (BOOL)application:(UIApplication *)application
78
IBM eMessage: Guía del administrador y de inicio
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
....Setup main window etc.
//Comprobar si se inicia la aplicación debido a la notificación de envío
if ([launchOptions
objectForKey:UIApplicationLaunchOptionsRemoteNotificationKey]!=nil)
{
NSDictionary * aPush =[launchOptions
objectForKey:UIApplicationLaunchOptionsRemoteNotificationKey];
[self handleAnyNotification:aPush];
}
return YES;
}
// Añadir o incorporar esta función en el archivo de delegado de aplicación
- (void)handleAnyNotification:(NSDictionary *)aPush
{
// Actualizar métricas de pulsación de notificación
[[XLappMgr get]insertNotificationClick:aPush];
}
// Añadir o incorporar esta función en el archivo de delegado de aplicación
-(void)applicationWillTerminate:(UIApplication *)application
{
NSLog(@"applicationWillTerminate");
[[XLappMgr get] applicationWillTerminate];
}
- (void)dealloc
{
[super dealloc];
}
//Añadir o incorporar la función que se va a mostrar para el soporte de simulador
- (void)application:(UIApplication *)application
didFailToRegisterForRemoteNotificationsWithError:(NSError *) error
{
NSLog(@"Failed to register with error: %@", error);
[[XLappMgr get] registerWithXtify:nil ];
}
@end
7. En el Navegador de Xcode, seleccione el proyecto y seguidamente seleccione
Notificación de envío en la pestaña izquierda y Crear valores en la pestaña
derecha. Busque Otros distintivos de enlazador y añada -ObjC.
8. Compile y ejecute.
La aplicación se debería registrar correctamente y debería funcionar
normalmente. Si recibe el error de tiempo de ejecución Selector no
reconocido, significa que el distintivo de enlazador no se ha configurado
correctamente.
Suministro de una bandeja de entrada de aplicación para
aplicaciones iOS
Para dar soporte al envío de notificaciones de bandeja de entrada a una aplicación
de dispositivo móvil Apple iOS, debe crear una bandeja de entrada en la aplicación
de dispositivo móvil para recibirlas. Las notificaciones de bandeja de entrada
también se conocen como notificaciones enriquecidas.
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
79
Acerca de esta tarea
Nota: Para obtener instrucciones adicionales relacionadas con la implementación
de notificaciones de envío de IBM en su de aplicación de dispositivo móvil,
examine la aplicación de ejemplo que se incluye con el paquete IBM Push
Notification SDK for Android.
1. La carpeta XtifyLib incluye ahora código de ejemplo para crear la Bandeja de
entrada personalizada. Se incluyen clases en el archivo de proyecto de ejemplo
en XtifyLib > Bandeja de entrada personalizada > AppInclude.
2. Utilice las clases que se proporcionan en AppInclude como punto de partida.
3. Visión general de las clases:
a. CompanyCustomInbox: un derivador alrededor de las llamadas de
recuperación de notificaciones de envío de la bandeja de entrada de
notificaciones de envío de dispositivos móviles de IBM . Recibe una
notificación de envío de bandeja de entrada e inicia las notificaciones de
envío de bandeja de entrada pendientes. Modifique estos métodos si
prefiere un comportamiento distinto.
1) - (void) handleRichPush:(NSString *)msgId;
2) - (void) getPending:(id)notifyObject;
b. AppDelegate
1) Añada el código siguiente a su método inicial:
[[CompanyCustomInboxget] setCallbackSelectors:@selector(successfullyGotRichMessage:)
failSelector:@selector(failedToGetRichMessage:) andDelegate:self];
2) Implemente los métodos siguientes en su AppDelegate:
- (void) successfullyGotRichMessage:(XLRichJsonMessage *)inputMsg // Get notified on success
- (void) failedToGetRichMessage:(CiErrorType )errorType - // Obtener notificación en caso de error
c. XRInboxDbInterface: clase interna de notificación de envío de dispositivo
móvil de IBM para gestionar las funciones siguientes: acceso a la carga útil
de notificación de envío de dispositivo móvil de IBM , mensajes no leídos y
acceso de almacenamiento de datos. Algunos de los métodos
proporcionados por la clase XRInboxDbInterface son:
1) - (void) updateParentVCandDB:(id)delegatedInboxVC (void) readLocalStore;
2) - (void) addRichMessageToDb:(XLRichJsonMessage
*)inputMsg ;
3) - (int) getUnreadMessageCount;
4) - (int) getMessageCount ;
5) - (int) decrementMessageReadCount ;
d. XRInboxUiDbDelegate: protocolo que controla la interfaz de usuario y los
eventos de almacenamiento de datos. Utilice este protocolo para crear su
propio controlador de vista e implemente los métodos siguientes:
1) getInboxDbName: nombre de archivo del almacén de datos.
2) getInboxEntityName: nombre de la entidad de notificación de bandeja
de entrada.
3) getDbModelName: archivo del modelo de datos Xcode (extensión
.xcdatamodel) que corresponde a la estructura de datos de notificación
de bandeja de entrada.
4) getInboxTableView: en la mayoría de los casos, es el miembro tableView
del controlador de vista.
5) didGetPendingResult: notifica al controlador de vista de bandeja de
entrada cuando finaliza la llamada getPending.
80
IBM eMessage: Guía del administrador y de inicio
e. CompanyInboxVC: vista de notificación de bandeja de entrada - en la
mayoría de los casos, es la subclase de ViewController e implementa
XRInboxUiDbDelegate (: UITableViewController <XRInboxUiDbDelegate>)
f. CompanyInboxViewCell: una vista de celda para cada celda.
(CompanyInboxViewCell: UITableViewCell)
g. CompanyDetailsVC: página de visualización de notificaciones de bandeja de
entrada (CompanyDetailsVC: UIViewController
<UIWebViewDelegate,MFMailComposeViewControllerDelegate>
4. Para personalizar el listado de bandeja de entrada, modifique
CompanyInboxVC.xib y CompanyInboxViewCell.xib
5. Para personalizar la vista Detalles de notificación de bandeja de entrada,
modifique CompanyDetailsVC.xib
6. Ejemplo de uso:
a. Crear una instancia del controlador de vista de bandeja de entrada
personalizado y actualizar la interfaz con el controlador de vista:
CompanyInboxVC *inboxVC = [[CompanyInboxVC alloc] initWithNibName:@"CompanyInboxVC" bundle:nil];
Actualizar la interfaz de base de datos con la instancia del controlador de vista:
[[XRInboxDbInterface get] updateParentVCandDB:inboxVC];
b. Obtener los mensajes pendientes (por ejemplo, si utiliza el Controlador de
navegación):
NSArray *childViewControllers =inboxNavController.childViewControllers;
CompanyInboxVC *customVC=childViewControllers[0];
if (customVC && [customVC respondsToSelector:@selector(getPendingCustom)]) {
[customVC getPendingCustom];
}
El método getPendingCustom de su controlador de vista obtiene una
notificación cuando finaliza la recuperación del servidor. Mostrar la vista
Detalles de notificación de bandeja de entrada cuando un usuario selecciona
una fila de una lista:
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
CompanyDetailsVC *detailsViewController=[[CompanyDetailsVC alloc] initWithNibName:@"CompanyDetailsVC"
bundle:nil];
RichDbMessage *aDbMessage = [[XRInboxDbInterface get] cellForRowAtIndexPath:indexPath];
[detailsViewController setDetailsFromDbMessage:aDbMessage];
[self.navigationController pushViewController:detailsViewController animated:YES];
}
c. Gestionar la notificación de bandeja de entrada cuando se recibe la
notificación de envío mientras la aplicación se ejecuta en primer plano:
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)pushMessage
{
NSDictionary * aPush=[[NSDictionary alloc] initWithDictionary:pushMessage];
[self handleAnyNotification:aPush];
[aPush release];
}
1) Gestionar la notificación de bandeja de entrada cuando la aplicación no
se ejecuta en primer plano y el usuario selecciona abrir la notificación de
envío nativa:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:
(NSDictionary *)launchOptions
{
// La aplicación se inicia debido a la notificación de envío
if ([launchOptions objectForKey:UIApplicationLaunchOptionsRemoteNotificationKey]!=nil)
{
NSDictionary * aPush =[launchOptions objectForKey:UIApplicationLaunchOptionsRemoteNotificationKey];
[self handleAnyNotification:aPush];
}
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
81
// La aplicación se inicia debido a un cambio de ubicación significativo
if ([launchOptions objectForKey:UIApplicationLaunchOptionsLocationKey] != nil )
{
[[XLappMgr get] handleSignificantLocation:application andOptions:launchOptions];
}
return YES;
}
2) Handle notification for all types (Inbox, App, Custom):
- (void)handleAnyNotification:(NSDictionary *)aPush
{
// Actualizar métricas de pulsación de notificación
[[XLappMgr get]insertNotificationClick:aPush];
BOOL withAlert=YES;
#if __IPHONE_OS_VERSION_MAX_ALLOWED >= 40000
// la obtención de estado -applicationState sólo se admite en 4.0 y superior
if (![[UIApplication sharedApplication] respondsToSelector:@selector(applicationState)])
{
withAlert = YES;
}
else
{
UIApplicationState state = [[UIApplication sharedApplication] applicationState];
if (state == UIApplicationStateActive) {
withAlert=YES; // display an alert
}
else {
withAlert =NO; // no mostrar ninguna otra alerta
}
}
#endif
// Gestionar la notificación de bandeja de entrada utilizando una bandeja de entrada personalizada
if (aPush !=nil && [aPush objectForKey:@"RN"]!=[NSNull null] &&
[[aPush objectForKey:@"RN"] length] > 0 )
{
[[CompanyCustomInbox get] handleRichPush:aPush withAlert:withAlert];
}
// Fin de la bandeja personalizada
// Gestionar la notificación Abrir URL
if (aPush !=nil && [aPush objectForKey:@"URL"] !=[NSNull null] &&
[[aPush objectForKey:@"URL"] length] > 0 ) {
NSLog(@"About to Open Safari");
NSString *urlLink=[[[NSString alloc]initWithString:[aPush objectForKey:@"URL"]]autorelease];
NSURL *url = [NSURL URLWithString:urlLink];
if (![[UIApplication sharedApplication] openURL:url]) {
NSLog(@"Failed to open url:%@",[url description]);
}
}
// Gestionar otra notificación (el ejemplo siguiente describe una notificación personalizada para mostrar la aplicación de mapas)
if (aPush !=nil && [aPush objectForKey:@"MAP"] !=[NSNull null] &&
[[aPush objectForKey:@"MAP"] length] > 0 ) {
NSString *urlLink=[NSString stringWithFormat:
@"http://maps.apple.com/?%@",[aPush objectForKey:@"MAP"]];
NSURL *url = [NSURL URLWithString:urlLink];
if (![[UIApplication sharedApplication] openURL:url]) {
NSLog(@"Failed to open Maps:%@",[url description]);
}
}
}
82
IBM eMessage: Guía del administrador y de inicio
Suministro de acciones en notificaciones
Se pueden producir cuatro acciones posibles si se envía una notificación de envío a
través de IBM eMessage: Abrir aplicación, Abrir URL, Abrir bandeja de entrada y
Acción personalizada.
En esta sección se definen los escenarios que necesita configurar en su aplicación
para gestionar acciones simples y cómo gestionar acciones a partir de mensajes
enriquecidos.
v Abrir aplicación: la acción predeterminada cuando un usuario toca la
notificación simple. No hay nada que hacer aquí.
v Abrir URL: necesita gestionar URL enviados al dispositivo cuando la aplicación
se ejecuta en primer plano o en segundo plano. Añada el código siguiente en el
delegado de aplicación.
- (void)application:(UIApplication *)application
didReceiveRemoteNotification:(NSDictionary *)pushMessage
{
NSDictionary * aPush=[[NSDictionary alloc] initWithDictionary:pushMessage];
// Actualizar métricas de pulsación de notificación
[[XLappMgr get]insertNotificationClick:aPush];
// Gestionar el mensaje Abrir URL
if (aPush !=nil && [aPush objectForKey:@"URL"] !=[NSNull null] &&
[[aPush objectForKey:@"URL"] length] > 0 ) {
NSString *urlLink=[[[NSString alloc]initWithString:
[aPush objectForKey:@"URL"]]autorelease];
NSURL *url = [NSURL URLWithString:urlLink];
if (![[UIApplication sharedApplication] openURL:url]) {
NSLog(@"Failed to open url:%@",[url description]);
}
}
[aPush release];
}
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
// Comprobar si la aplicación se ha iniciado como resultado de un envío
if ([launchOptions objectForKey:UIApplicationLaunchOptionsRemoteNotificationKey]!=nil) {
NSDictionary * aPush=[[NSDictionary alloc] initWithDictionary:launchOptions];
// Actualizar métricas de pulsación de notificación
[[XLappMgr get]insertNotificationClick:aPush];
// Gestionar el mensaje Abrir URL
if (aPush !=nil && [aPush objectForKey:@"URL"] !=[NSNull null] &&
[[aPush objectForKey:@"URL"] length] > 0 ) {
NSString *urlLink=[[[NSString alloc]initWithString:
[aPush objectForKey:@"URL"]]autorelease];
NSURL *url = [NSURL URLWithString:urlLink];
if (![[UIApplication sharedApplication] openURL:url]) {
NSLog(@"Failed to open url:%@",[url description]);
}
}
}
// La aplicación se inicia debido a un cambio de ubicación significativo
if ([launchOptions objectForKey:UIApplicationLaunchOptionsLocationKey] != nil ) {
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
83
[[XLappMgr get]handleSignificantLocation:application andOptions:launchOptions ];
}
return YES;
}
v Abrir Mensaje de bandeja de entrada: consulte la sección sobre el suministro de
una bandeja de entrada de aplicación.
v Acciones de notificación simple personalizadas: si desea que su aplicación realice
una acción personalizada, distinta a Abrir URL o a gestionar una notificación
enriquecida, puede crear su propia Acción personalizada. Una vez que la
aplicación reciba la notificación, actuará en función del valor de la carga útil.
Puede cambiar de forma dinámica el valor de la carga útil y la aplicación
actuará en consecuencia. Por ejemplo, la aplicación puede iniciarse en una
página distinta de la aplicación, en función del valor de carga útil, o puede
iniciar una aplicación externa y que se pase el valor de carga útil a la aplicación.
El ejemplo siguiente describe cómo enviar una acción personalizada con carga
útil y gestionarla en su aplicación. En este ejemplo, después de que la aplicación
reciba la notificación personalizada, inicia la aplicación Apple Maps y marca una
dirección de origen a destino, ya que esta información se pasa a través de la
carga útil.
Desde la consola de IBM Mobile Push Notification, en Acción de botón,
seleccione Datos personalizados. En Datos personalizados, especifique el origen
y el destino. Por ejemplo, {MAP:'daddr=Trenton,+NJ&saddr=NYC'}. Puede hacer lo
mismo desde la API de envío.
{
"apiKey":"su_clave_api",
"appKey":"su_clave_aplicación",
"sendAll": false,
"xids": ["su_xid"],
"content": {
"message": "Obtener la dirección de su casa al juego de pelota",
"action": {
"type": "CUSTOM",
"data": "{MAP:’daddr=Trenton,+NJ&saddr=NYC’}", "label":"Direction"
}
}
}
En su aplicación, en AppDelegate.m:
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)pushMessage
{
NSDictionary * aPush=[[NSDictionary alloc] initWithDictionary:pushMessage];
// Actualizar métricas de pulsación de notificación
[[XLappMgr get]insertNotificationClick:aPush];
// Acción personalizada
if (aPush !=nil && [aPush objectForKey:@"MAP"] !=[NSNull null] &&
[[aPush objectForKey:@"MAP"] length] > 0 ) {
NSString *urlLink=[NSString stringWithFormat:@"http://maps.apple.com/?%@",
[aPush objectForKey:@"MAP"]];
NSURL *url = [NSURL URLWithString:urlLink];
if (![[UIApplication sharedApplication] openURL:url]) {
NSLog(@"Failed to open Maps app:%@",[url description]);
}
}
[aPush release];
}
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
84
IBM eMessage: Guía del administrador y de inicio
// Comprobar si la aplicación se ha iniciado como resultado de un envío
if ([launchOptions objectForKey:UIApplicationLaunchOptionsRemoteNotificationKey]!=nil) {
NSDictionary * aPush=[[NSDictionary alloc] initWithDictionary:launchOptions];
// Actualizar métricas de pulsación de notificación
[[XLappMgr get]insertNotificationClick:aPush];
// Acción personalizada
if (aPush !=nil && [aPush objectForKey:@"MAP"] !=[NSNull null] &&
[[aPush objectForKey:@"MAP"] length] > 0 ) {
NSString *urlLink=[NSString stringWithFormat:@"http://maps.apple.com/?%@",
[aPush objectForKey:@"MAP"]];
NSURL *url = [NSURL URLWithString:urlLink];
if (![[UIApplication sharedApplication] openURL:url]) {
NSLog(@"Failed to open Maps app:%@",[url description]);
}
}
}
// La aplicación se inicia debido a un cambio de ubicación significativo
if ([launchOptions objectForKey:UIApplicationLaunchOptionsLocationKey] != nil ) {
[[XLappMgr get]handleSignificantLocation:application andOptions:launchOptions ];
}
return YES;
}
Después de que el usuario seleccione la notificación, se inicia la aplicación de
mapas y direcciona la ruta de NYC a Trenton NJ.
v Acciones de notificación enriquecida personalizadas: la consola de notificaciones
de envío de IBM , junto con el SDK, proporciona una característica para añadir
una acción a la barra de herramientas de mensaje. La acción está disponible en
la página de detalles de notificación que forma parte de la barra de
herramientas. Las acciones incorporadas disponibles son abrir un marcador, abrir
un navegador y acción personalizada. Para enviar una acción personalizada al
dispositivo, cree una notificación dentro de la consola y defina una "acción
primaria". En esta sección se describen los cambios que necesita realizar el
desarrollador para que las acciones personalizadas funcionen correctamente.
En una de sus clases, indique al SDK la función de devolución de llamada que
va a gestionar la acción predeterminada. Por ejemplo, en la clase AppDelegate,
puede definir un método developerCustomActionMethod y hacer que se
notifique a dicho método cuando el usuario seleccione la acción personalizada
en la barra de herramientas de notificación. A continuación se muestra un
ejemplo.
...
[[XLappMgr get] setDeveloperCustomActionSelector:@selector(developerCustomActionMethod:)];
...
Implemente el método de acción en su clase. A continuación se muestra un
ejemplo de implementación de developerCustomActionMethod:
- (void)developerCustomActionMethod:(NSString *)actionData
{
NSString *address = [actionData stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
NSString *url = [NSString stringWithFormat:@"http://maps.google.com/maps?q=%@", address];
[[UIApplication sharedApplication] openURL:[NSURL URLWithString:url]];
}
En el ejemplo anterior, después de que el usuario seleccione la acción en la barra
de herramientas de notificación, la aplicación abre la aplicación Google Maps en
la dirección proporcionada en actionData. De forma similar, puede definir una
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
85
acción personalizada para abrir otras aplicaciones de iOS, que están definidas en
los esquemas de URL de Apple en , o una que cree usted mismo.
Notificaciones desencadenadas por ubicación para las
aplicaciones iOS
La entrega de notificaciones desencadenadas por ubicación depende de la
recepción de actualizaciones de ubicación enviadas desde la aplicación. De forma
predeterminada, las notificaciones de envío no utilizan la radio GPS para servicios
de ubicación. En su lugar, las notificaciones de envío utilizan la opción de bajo
consumo recomendada por Apple para recibir actualizaciones de ubicación.
Mientras está en primer plano, el proceso de ubicación solicita al sistema operativo
la ubicación más reciente, y la pasa a la API de ubicación, para el análisis de
delimitación geográfica. Mientras la aplicación se encuentra en segundo plano, la
biblioteca sólo tiene permiso para utilizar el servicio de cambio significativo de
ubicación y recomendado por Apple para estos tipos de casos de uso. Si está
probando el envío de delimitación geográfica de su aplicación, si el dispositivo no
se mueve, es probable que no reciba un envío desencadenado por ubicación. Puede
obligar a detener la aplicación y volver a iniciarla para forzar una actualización de
ubicación. También puede enviar directamente a la API para simular un suceso de
ubicación.
Cuando en su aplicación está habilitada la ubicación en segundo plano, XtifyLib
registra una devolución de llamada que se ejecuta cuando el propio iOS detecta un
cambio significativo en la ubicación del usuario (según la información del
repetidor de zona, la WiFi de carácter múltiple o si el usuario utiliza el GPS por sí
mismo).
Existe una percepción equivocada común en relación al icono de ubicación
(púrpura o gris) y su relación con el receptor de GPS. El icono no significa
necesariamente que una aplicación esté usando el GPS. El icono de color púrpura
aparece si una aplicación ha utilizado su ubicación (también indica al usuario cuál,
en Valores > Privacidad > Servicios de ubicación). Si una aplicación ha utilizado
su ubicación en las últimas 24 horas, aparece un icono gris. En esta entrada de las
preguntas más frecuentes hay más detalles sobre el icono de color púrpura y las
opciones de ubicación en segundo plano.
Al igual que pasa en toda preocupación de percepción, la comunicación es clave.
Cuando se utiliza esta funcionalidad, es recomendable que incluya una copia del
producto en dos lugares que revele por qué está solicitando la ubicación. En
primer lugar, en una ventana emergente modal cuando se instale por primera vez
la aplicación; en segundo lugar, en la página Valores de aplicación. También debe
plantearse describir el uso de ubicación en las notas del release y la descripción de
la aplicación.
Si la aplicación proporciona un servicio valioso como resultado de la ubicación de
compartición de usuario y la marca describe esta utilización al usuario durante la
instalación de la aplicación, los usuarios aceptan mejor los servicios de ubicación.
Incluso si la aplicación recibe la ubicación una sola vez, o a través de la
comprobación iniciada por el usuario, la flecha aparece.
86
IBM eMessage: Guía del administrador y de inicio
Configuración del SDK para notificaciones activadas por
ubicación
Para crear mensajes desencadenados o activados por ubicación, debe cambiar los
valores por omisión en SDK de notificación push de IBM para iOS de Apple.
Acerca de esta tarea
En Xcode, vaya a la carpeta XtifyLib y edite las opciones siguientes.
1. #define xLocationRequired NO
v Al establecer esta opción para YES, los servicios de mensajería de IBM
atienden escuchar a las actualizaciones significativas de cambio de ubicación
y las emparejan con las ubicaciones definidas en los Valores de eMessage. El
usuario de aplicación móvil recibe una solicitud que le ofrece compartir la
ubicación cuando el usuario instala la aplicación.
2. #define xRunAlsoInBackground FALSE
v Si se establece en TRUE, los servicios de mensajería de IBM atienden a las
actualizaciones de ubicación mientras la aplicación se encuentra en segundo
plano. Si se establece en FALSE, los servicios de mensajería de IBM atienden a
las actualizaciones de ubicación sólo cuando la aplicación está en primer
plano.
Tareas relacionadas:
“Configuración de ubicaciones para entrega desencadenada por ubicación” en la
página 93
Configuración del comportamiento personalizado de
identificadores
De forma predeterminada, el SDK de notificación de envío de IBM para Apple iOS
gestiona el comportamiento del recuento de identificadores. Puede configurar el
comportamiento personalizado de los identificadores modificando el SDK.
Procedimiento
En Xcode, explore la carpeta XtifyLib y edite XtifyGlobal.h:#define
xBadgeManagerMethod
XLInboxManagedMethod
1. Para gestionar el recuento de identificadores en el cliente y el servidor
basándose en los mensajes con formato sin leer, establézcalo en
XLInboxManagedMethod
2. Para gestionar la actualización del identificador en el cliente y el servidor,
establézcalo en XLDeveloperManagedMethod. Debe crear su propio método en el
delegado de aplicación.
Ejemplo
El ejemplo siguiente está tomado de la aplicación de ejemplo incluida en el
paquete SDK.
// A continuación se detalla un ejemplo de cómo se gestionan los cambios de notificación de identificadores de bandeja de entrada.
- (void) doMyUpdate:(XLappMgr *)appM
{
NSInteger newBadge=[appM getInboxUnreadMessageCount];
NSLog(@"The new inbox badge unread message count is=%d",newBadge);
// Establecer una cuenta privada de notificaciones
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
87
NSInteger privateCounter=0 ;
[appM setSpringBoardBadgeCount:newBadge+privateCounter];
[appM setServerBadgeCount:newBadge];
}
Creación de una notificación de envío para la aplicación de
ejemplo de Apple iOS
El paquete SDK de notificación de envío de IBM para el iOS de Apple incluye la
aplicación de muestra de iOS, SampleRich.
Antes de empezar
Confirme que el Servicio de notificación de envío de Apple (APNS) está habilitado
para su ID de Apple (comprobar en el portal Apple Provisioning). Hace falta un ID
de Apple y contraseña.
Acerca de esta tarea
La aplicación de ejemplo de iOS ayuda a mostrar las funciones integrales de la
Notificación de envío móvil de IBM, incluidas las notificaciones de envío de la
App, las notificaciones de envío de la bandeja de entrada y las notificaciones de
envío de la App que estén combinadas con las notificaciones de la Bandeja de
entrada. No puede recibir notificaciones de envío en un emulador. Debe desplegar
un perfil de suministro en un dispositivo real de Apple.
Procedimiento
1. Cree una clave de aplicación de iPhone en IBM eMessage y suba el certificado
APNS.
2. En el menú archivo de Xcode, abra el proyecto SampleRich.
3. Actualice XtifyGlobal.h y sustituya xAppKey por su clave de aplicación.
4. Actualice el archivo SampleRich-Info.plist y sustituya el identificador de
paquete por su ID de aplicación (obtenido al registrar la aplicación en el APNS)
5. Actualice el archivo del proyecto con el archivo de suministro.
6. Cree contenido en Editor de comunicaciones y asegúrese de obtener una
notificación enriquecida para su aplicación SampleRich. Para obtener más
información sobre la creación de notificaciones, consulte la IBM eMessage.
Borrado de todas las notificaciones desde el dispositivo móvil
Puede modificar el SDK para proporcionar una forma de borrar todas las
notificaciones recibidas por la aplicación en el dispositivo móvil.
Acerca de esta tarea
Invocar el método siguiente, de la siguiente manera:
[[XLAppMgr get] removeAllNotifications];
Recepción de notificación de registro de aplicación
Para recibir notificación de que un usuario de aplicación móvil ha instalado y
registrado la aplicación, debe establecer el delegado y el método.
88
IBM eMessage: Guía del administrador y de inicio
Procedimiento
Establezca el delegado y el método para que se notifiquen cuando se complete el
registro.
[[XLappMgr get] setInboxDelegate:self]; // El delegado se utiliza para todos los métodos de delegación de Xtify.
[[XLappMgr get] setDeveloperXidNotificationSelector:@selector(doUpdateDevServer:)];
Integración del ID de usuario de aplicación de dispositivo
móvil (XID) para iOS
El ID de usuario de aplicación de dispositivo móvil es un identificador exclusivo
que el sistema asigna a cada usuario de aplicación de dispositivo móvil cuando
este descarga e instala su aplicación de dispositivo móvil. El ID de usuario de
aplicación se denomina también XID.Los sistemas de mensajería de IBM envían el
ID de usuario de aplicación de dispositivo móvil al dispositivo móvil. Debe
configurar su aplicación de dispositivo móvil iOS para que recupere el ID y lo
establezca como disponible en la base de datos de marketing para que se utilice al
seleccionar destinatarios de notificaciones de envío.
Acerca de esta tarea
Al integrar las notificaciones de envío de IBM dentro de su aplicación, debe
mantener el ID de usuario de aplicación de dispositivo móvil en su base de datos
de marketing. El ID se utiliza para direccionar notificaciones de envío.
Puede obtener el ID de usuario de aplicación de dispositivo móvil en obj-c, tal
como se indica a continuación.
1. Método de devolución de llamada. Tras el registro con servicios de mensajería
de IBM , IBM ejecuta una devolución de llamada de su elección con el XID
asignado (a continuación se muestra un ejemplo en la aplicación de ejemplo):
// asegúrese de indicar a Xtify Lib qué devolución de llamada se va a utilizar, por ejemplo:
- init
{
if (self = [super init]) {
...
[[XLappMgr get] setDeveloperXidNotificationSelector:@selector(doUpdateXid:)];
...
}
return self;
}
- (void) doUpdateXid:(XLappMgr *)appM
{
NSLog(@"Got XID=%@",[appM getXid]);
}
2. Método de una sola vez. Ejecute lo siguiente para obtener el XID:
#import "AppDetailsMgr.h"
...
NSMutableDictionary *appDetailsDict = [[AppDetailsMgr get] getAppDetails];
NSString *xid = [appDetailsDict valueForKey:@"xid"];
El ID de usuario de aplicación de dispositivo móvil puede cambiar en los
escenarios siguientes.
v Un nuevo registro del dispositivo (se registra de nuevo, después de tener ya un
ID de usuario de aplicación de dispositivo móvil). Esto ocurre si el usuario
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
89
móvil vuelve a instalar la aplicación. La actualización de la aplicación no afecta
al ID de usuario de aplicación de dispositivo móvil.
v El ID de instalación cambia. Esto es poco probable, pero podría ocurrir si cambia
alguna característica física del dispositivo.
Conceptos relacionados:
“Requisito para identificar usuarios de la aplicación en la base de datos de
marketing” en la página 92
Habilitación de la cuenta de mensajería alojada para la mensajería
móvil
Desde márketing se puede utilizar eMessage para enviar notificaciones de envío
sólo si la cuenta de mensajería alojada está habilitada para mensajería móvil. Para
habilitar la cuenta de mensajería alojada para mensajería móvil, debe enviar una
solicitud a los Servicios de cuentas de correo electrónico de IBM, en
[email protected].
Acerca de esta tarea
El equipo de servicios de cuenta de correo electrónico asegurará que la cuenta de
mensajería alojada de IBM esté preparada para notificaciones de envío a móvil.
Qué hacer a continuación
Cuando el equipo de servicios de cuenta de correo electrónico completa dicho
proceso para la cuenta, puede registrar las aplicaciones móviles en la configuración
de eMessage.
Registro de una aplicación de dispositivo móvil en IBM eMessage
Para permitir que los usuarios de marketing utilicen eMessage para enviar
notificaciones a una aplicación móvil, debe registrar la aplicación en eMessage.
Debe registrar cada combinación de aplicación móvil y sistema operativo móvil
por separado en la configuración de eMessage.
Antes de empezar
El acceso para modificar la configuración de eMessage depende de los roles y
permisos de usuario. Revise los roles y permisos configurados para la instalación
de IBM Enterprise Marketing Management (EMM) bajo Roles y permisos de
usuario.
Nota: Para ver y gestionar las aplicaciones móviles en eMessage, el rol de usuario
debe tener el permiso Configurar aplicaciones móviles bajo la categoría
Administración de correo electrónico.
Acerca de esta tarea
Los servicios de mensajería de IBM y eMessage identifican una aplicación móvil
con una serie alfanumérica exclusiva llamada clave de la aplicación. El registro de
una aplicación móvil genera una clave de la aplicación que identifica la
90
IBM eMessage: Guía del administrador y de inicio
combinación de aplicación móvil y sistema operativo móvil. Al registrar la
aplicación se añade automáticamente la clave de la aplicación a la configuración de
eMessage.
Acceda a la configuración de eMessage desde la ventana Valores de eMessage.
Procedimiento
1. Acceda a Valores > Valores de eMessage.
2. Pulse Visualizar la lista de claves de aplicación móvil. Se abrirá la ventana
Claves de aplicación móvil.
.
3. Pulse Añadir una clave de aplicación móvil
4. Introduzca la información para identificar y describir la aplicación.
v Especifique un nombre para la aplicación. El nombre que especifique es el
nombre que los usuarios de marketing utilizarán para seleccionar la
aplicación al configurar un envío de notificaciones.
v Seleccione un tipo de clave de la aplicación.
Seleccione Producción o Realización de pruebas. El tipo que seleccione debe
coincidir con el tipo de perfil de suministro de Apple o de proyecto de
Google que se ha utilizado para registrar la aplicación.
v Seleccione un huso horario predeterminado.
eMessage utiliza el huso horario predeterminado cuando no puede
determinar la ubicación del dispositivo móvil receptor.
5. Seleccione el sistema operativo en el que se ejecuta la aplicación. Las opciones
relacionadas que se muestran son de acuerdo al sistema operativo seleccionado.
Especifique los valores que se definieron al registrar la aplicación con Apple o
Google.
v Para Android, proporcione la clave de API de Google configurada para la
aplicación.
v Para iOS, seleccione el archivo de certificado para la aplicación y escriba la
contraseña del certificado. Apple proporciona el certificado.
6. Especifique las políticas de seguridad que controlan a qué usuarios de
marketing se les permite ver y seleccionar la aplicación en las configuraciones
de envío de notificaciones. El rol de usuario de los usuarios de marketing que
deben seleccionar la aplicación en una configuración de envío requiere el
permiso Editar envíos de correos bajo la categoría Campañas.
7. Para añadir la aplicación a la configuración, pulse Guardar cambios.
Resultados
El sistema asignará automáticamente una clave de aplicación al guardar la
configuración de la clave de aplicación. La clave se muestra como un valor de sólo
lectura en el campo Clave de la aplicación en la ventana Claves de aplicación
móvil.
Conceptos relacionados:
“Integración de Google Cloud Messaging con IBM eMessage” en la página 64
“Integración del servicio de notificación de envío de Apple con IBM eMessage” en
la página 75
“Requisitos previos para la integración de aplicaciones de Google Android con
notificaciones de envío de IBM” en la página 64
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
91
“Requisitos previos para la integración de aplicaciones de Apple iOS con
notificaciones de envío de IBM” en la página 76
“Permisos de envíos de correos en Campaign” en la página 113
Requisito para identificar usuarios de la aplicación en la base de datos
de marketing
Para permitir que los usuarios de marketing puedan enviar notificaciones de envío
a aplicaciones móviles para dirigirse a las audiencias, los procesos de gestión de
datos locales deben añadir automáticamente nuevos ID de usuario de aplicación de
dispositivo móvil a las bases de datos de marketing en las que los usuarios de
marketing pueden utilizar IBM Campaign para seleccionarlos. Los procesos debe
poder recuperar automáticamente los ID de usuario de dispositivo móvil desde
cada uno de los dispositivos móviles en los que esté instalada la aplicación.
Cuando una persona instala la aplicación de dispositivo móvil en un dispositivo
móvil, el dispositivo se registra con IBM y proporciona la clave de aplicación para
identificar la aplicación. Los sistemas de mensajería de IBM responden mediante la
creación de un ID de usuario de aplicación de dispositivo móvil exclusivo para
identificar el dispositivo específico y la aplicación de dispositivo móvil. Los
sistemas de IBM reconocen el registro satisfactorio transmitiendo el ID de usuario
de aplicación de dispositivo móvil al dispositivo móvil. El ID de usuario de
aplicación se denomina también XID.
El ID de usuario de aplicación móvil sirve de dirección a la que eMessage envía las
notificaciones de envío. El ID debe estar disponible en la base de datos de
marketing local para su selección por parte de los usuarios de marketing. Para
enviar notificaciones de envío a los destinatarios seleccionados, los usuarios de
marketing definen un campo de personalización en IBM Campaign que se
correlaciona con los ID de usuario de aplicación de la base de datos de marketing.
Los sistemas de mensajería alojados de IBM no pueden acceder a las tablas locales
para insertar el nuevo ID de usuario de aplicación de dispositivo móvil. Los
administradores del sistema local deben diseñar y mantener procesos locales que
puedan recuperar el ID del dispositivo móvil en el que se ha guardado el valor.
Los procesos deben poder también registrar automáticamente el valor en las bases
de datos locales de marketing que se correlacionan con IBM Campaign.
Conceptos relacionados:
“Integración de ID de usuario de aplicación de dispositivo móvil (XID) para
Android” en la página 75
Tareas relacionadas:
“Integración del ID de usuario de aplicación de dispositivo móvil (XID) para iOS”
en la página 89
Prueba de la integración de la aplicación de dispositivo móvil en un
dispositivo móvil
Para probar la integración de la aplicación de dispositivo móvil con los sistemas de
mensajería de IBM, instale la aplicación en un dispositivo móvil y utilice eMessage
para redactar y enviar una notificación de envío de prueba al dispositivo.
92
IBM eMessage: Guía del administrador y de inicio
Acerca de esta tarea
La prueba de la integración requiere que envíe notificaciones de envío. Envíe
notificaciones únicamente a los destinatarios de prueba designados. Para obtener
más información sobre el envío de notificaciones de envío con IBM eMessage,
consulte la IBM eMessage User's Guide.
Procedimiento
1. Instale la aplicación de dispositivo móvil en un dispositivo móvil. La
instalación de la aplicación en un dispositivo móvil registra la combinación de
aplicación de dispositivo móvil y dispositivo móvil como un usuario de
aplicación exclusivo con IBM. Los servicios de mensajería de IBM crean y
devuelven automáticamente un ID de usuario de aplicación de dispositivo
móvil exclusivo, también conocido como XID.
2. Recupere el ID de usuario de aplicación de dispositivo móvil desde el
dispositivo de prueba. Debe especificar el valor del ID de usuario de aplicación
al configurar una notificación de envío de aplicación de dispositivo móvil. El
método utilizado para recuperar el ID de usuario de aplicación depende del
diseño de la aplicación.
3. Configure y ejecute un envío de prueba para enviar una notificación al
dispositivo de prueba. Cree una OLT que incluya un campo de personalización
que represente el ID de usuario de aplicación (XID) como valor de campo.
Ejecute el envío y confirme que la notificación se ha entregado en el dispositivo
móvil.
En función del tipo de notificaciones que desee enviar, realice la prueba con
una notificación de envío a la aplicación y una notificación de envío a bandeja
de entrada.
Configuración de ubicaciones para entrega desencadenada por
ubicación
Los usuarios de marketing pueden configurar notificaciones de envío para que se
envíen a dispositivos móviles que entren en ubicaciones geográficas especificadas,
por ejemplo, un suceso promocional o frente a un escaparate. Para dar soporte a
esta prestación, los administradores deben definir las ubicaciones disponibles en la
configuración de eMessage.
Acerca de esta tarea
Para definir una ubicación que los usuarios de marketing puedan utilizar para
habilitar la entrega desencadenada por ubicación, debe definir la dirección física
completa. También debe especificar un radio a partir de la dirección para definir el
área en la que deben entrar los destinatarios para que se desencadene la
notificación.
Procedimiento
1. Acceda a Valores > Valores de eMessage.
2. Pulse Visualizar la lista de ubicaciones disponibles. Se abrirá la ventana
Ubicaciones.
.
3. Pulse Añadir una ubicación
4. Especifique la dirección física completa de la ubicación que desea añadir. Pulse
Buscar para visualizar la ubicación en una correlación.
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
93
5. Especifique un nombre para identificar la ubicación.
6. Especifique un radio para definir el área alrededor de la ubicación que
desencadena una notificación a aplicación.
El sistema muestra el área con un círculo rojo. En función del radio que defina,
es posible que necesite expandir o contraer la correlación para tener la
resolución para ver el área resaltada de la correlación.
7. Pulse Guardar cambios. La nueva ubicación aparece en la lista de ubicaciones
disponibles.
Tareas relacionadas:
“Suministro de notificaciones desencadenadas por ubicación para aplicaciones
Android” en la página 68
“Configuración del SDK para notificaciones activadas por ubicación” en la página
87
Edición de las propiedades de ubicación
Puede cambiar los valores de una ubicación disponible para utilizarla para
habilitar la entrega desencadenada por ubicación de las notificaciones de envío
para las aplicaciones móviles.
Procedimiento
1. Acceda a Valores > Valores de eMessage.
2. Pulse Visualizar la lista de ubicaciones disponibles. Se abrirá la ventana
Ubicaciones.
3. Encuentre la ubicación que desea actualizar y pulse la lista. Se mostrará la
ventana Editar propiedades de ubicación.
4. Actualice los valores de ubicación.
v Ubicación seleccionada. Especifique la dirección física completa de la
ubicación y pulse Buscar.
v Nombre. Escriba el nombre que se muestra a los usuarios de marketing
cuando añaden la ubicación al envío de notificaciones.
v Radio. Especifique la distancia desde la dirección física que define el área de
desencadenante. Cuando los sistemas de mensajería de IBM detectan que un
dispositivo móvil pasa dentro del radio especificado, el sistema envía la
notificación que está configurada para el envío de notificaciones al
dispositivo móvil. El radio mínimo son 1000 metros, o equivalente.
v Descripción. Escriba una breve descripción que los usuarios de marketing
verán en la configuración del envío. Si define varias ubicaciones, la
descripción ayuda a los usuarios de marketing a distinguir entre las
diferentes ubicaciones disponibles.
5. Guarde los cambios.
Supresión de ubicaciones disponibles para la entrega
desencadenada por ubicación
Los administradores pueden eliminar una ubicación de la lista de ubicaciones
disponibles para la entrega desencadenada por ubicación.
Procedimiento
1. Acceda a Valores > Valores de eMessage.
94
IBM eMessage: Guía del administrador y de inicio
2. Pulse Visualizar la lista de ubicaciones disponibles. Se abrirá la ventana
Ubicaciones.
3. Seleccione las ubicaciones que desea y pulse Suprimir ubicaciones
seleccionadas
.
Configuración de valores predeterminados para la mensajería móvil
Para enviar notificaciones de envío a una lista de usuarios de aplicaciones móviles,
los usuarios de marketing especifican el ID de usuario de aplicación móvil para
cada dispositivo con un valor para un campo de personalización. El campo de
personalización se incluye en la tabla de lista de salida (OLT) que define la lista de
destinatarios de notificación de envío. Los administradores pueden configurar un
campo de personalización que se selecciona de forma predeterminada para
proporcionar el ID de usuario de aplicación móvil.
Acerca de esta tarea
La especificación de un campo de personalización predeterminado puede reducir el
tiempo que los usuarios de marketing necesitan para configurar un envío de
notificación a aplicación móvil. Sin embargo, los usuarios de marketing pueden
utilizar un campo de personalización distinto para proporcionar el valor de ID.
Procedimiento
1. Acceda a Valores > Valores de eMessage.
2. Pulse Visualizar valores predeterminados de mensajería móvil. Se abre la
ventana Valores predeterminados de mensajería móvil.
3. Especifique el nombre de visualización del campo de personalización que
proporciona el ID de aplicación móvil para los dispositivos móviles que reciben
notificaciones de aplicación móvil.
4. Pulse Guardar cambios. El nuevo campo de personalización predeterminado se
visualizará cuando los usuarios de marketing creen un nuevo envío de
notificación a aplicación. Las configuraciones de envío de notificación a
aplicación existentes no cambian.
Enviar datos de seguimiento de notificación de IBM
Los datos de seguimiento para las notificaciones de envío no están disponibles de
forma predeterminada. Debe solicitar que IBM envíe los datos de seguimiento de
notificación de envío a las tablas del sistema eMessage local.
Acerca de esta tarea
Debe solicitar el seguimiento de datos para cada combinación de aplicación y
sistema operativo por separado. Cada combinación está asociada a una AppKey
distinta. Por ejemplo, para recibir los datos de seguimiento de las notificaciones
que se envían a una aplicación móvil que se ejecuta en iOS y Android, debe hacer
dos solicitudes distintas.
Los sistemas de mensajería de IBM reenvían las respuestas a través del Rastreador
de respuestas y contactos (RCT) a las tablas de sistema de eMessage.
Capítulo 7. Configuraciones para implementar notificaciones de envío a móvil de IBM
95
Procedimiento
v Para solicitar datos de seguimiento de notificación, póngase en contacto con el
equipo de Servicios de cuentas de correo electrónico en [email protected].
v Para analizar las respuesta de notificación, consulte las tablas del sistema
eMessage. Para obtener más información sobre los datos que hay disponibles,
consulte IBM eMessage: tablas del sistema y diccionario de datos.
96
IBM eMessage: Guía del administrador y de inicio
Capítulo 8. Programas de utilidad para eMessage
eMessage proporciona varios scripts que se utilizan para administrar las funciones
de eMessage.
Puede utilizar los programas de utilidad que se describen en esta sección para
diversas funciones de inicio y administración. Además de los programas de
utilidad utilizados con IBM Marketing Platform, IBM eMessage utiliza también
programas de utilidad específicas para eMessage y se utilizan únicamente para
gestionar componentes de eMessage.
Para obtener más información sobre otros programas de utilidad disponibles para
su instalación de IBM EMM, consulte la publicación IBM Marketing Platform, Guía
del administrador.
El script RLU
Utilice el script RLU para comprobar el estado del Cargador de listas de
destinatarios (RLU).
Nota: No puede utilizar este script para iniciar ni detener el RLU. Utilice este
script solo para comprobar el estado de la conexión entre la RLU y IBM EMM
Hosted Services.
El script RLU es el directorio de inicio de IBM EMM en eMessage > bin. El
directorio de eMessage es un subdirectorio en el directorio de Campaign.
En entornos UNIX o Linux, ejecute el script como rlu.sh.
En Windows, ejecute el script desde la línea de comandos como rlu.bat.
Sintaxis
rlu -c | --check [-h]
Comandos
-c, --check
Compruebe que el RLU está correctamente configurado y que está conectado a
IBM EMM Hosted Services.
Opciones
-h, --help
Mostrar la sintaxis del script
Ejemplo
En un entorno Linux, determine si la RLU está conectada a IBM EMM Hosted
Services.
© Copyright IBM Corp. 1999, 2015
97
rlu.sh --check
En función del estado del sistema, la salida de este comando puede tener este
aspecto:
Configuring Data Source [systemTables]...
Testing configuration for partition partition1
Testing connectivity for partition partition1
Testing user accessibility for partition partition1
Succeeded. List uploader config and connectivity test
succeeded for partition partition1
Tareas relacionadas:
“Probar la carga a IBM EMM Hosted Services” en la página 41
Script de seguimiento de respuestas y contactos (RCT) de eMessage
Puede utilizar este script para ejecutar y comprobar el estado del seguimiento de
respuestas y contactos (RCT).
Este script se encuentra en el directorio bin de la instalación de eMessage.El
directorio eMessage es un subdirectorio del directorio Campaign.
En entornos UNIX o Linux, ejecute el script como rct.sh.
En Windows, ejecute el script desde la línea de comandos como
MKService_rct.bat.
Sintaxis
rct [ start | stop | check ]
Comandos
start
Iniciar el RCT
stop
Detener el RCT
Opciones
check
Comprobar el estado de la conexión entre el RCT y IBM EMM Hosted Services.
Ejemplos
v Para iniciar el RCT en Windows.
rct.bat start
v Para detener el RCT en Windows.
rct.bat stop
v En un entorno Linux, para determinar si el RCT está conectado a IBM EMM
Hosted Services.
98
IBM eMessage: Guía del administrador y de inicio
rct.sh check
En función del estado del sistema, la salida de este mandato puede tener este
aspecto:
C:\<INICIO_EMM>\Campaign\eMessage\bin>rct check
Probando configuración y conectividad para partición partition1
Satisfactorio | Partición: partition1 - ID de cuenta de servicios alojados:
asm_admin
Tareas relacionadas:
“Adición del Rastreador de respuestas y contactos (RCT) como servicio” en la
página 37
“Probar la descarga desde IBM EMM Hosted Services” en la página 41
Script MKService_rct de eMessage
El script MKService_rct añade o elimina el seguimiento de respuestas y contactos
(RCT) como servicio. Añadir el RCT como servicio reinicia el RCT cada vez que
reinicia el sistema donde haya instalado el RCT. Si se elimina el RCT como
servicio, se impide que se reinicie automáticamente.
Este script se encuentra en el directorio bin de la instalación de eMessage.
En entornos UNIX o Linux ejecute MKService_rct.sh. con un usuario que tenga
permisos de raíz o permisos para crear procesos de daemon.
En Windows, ejecute el script desde la línea de comandos con MKService_rct.bat.
Sintaxis
MKService_rct -install
MKService_rct -remove
Comandos
-install
Añadir el RCT como servicio
-remove
Eliminar el servicio RCT
Ejemplos
v Para añadir el RCT como servicio de Windows.
MKService_rct.bat -install
v Para eliminar el servicio RCT en UNIX o Linux.
MKService_rct.sh -remove
Conceptos relacionados:
“Cómo iniciar automáticamente el RCT como servicio” en la página 36
Tareas relacionadas:
Capítulo 8. Programas de utilidad para eMessage
99
“Adición del Rastreador de respuestas y contactos (RCT) como servicio” en la
página 37
configTool
Las propiedades y los valores de la página Configuración se almacenan en las
tablas del sistema. Puede utilizar la utilidad configTool para importar y exportar
valores de configuración a y desde las tablas del sistema.
Cuándo utilizar configTool
Puede utilizar configTool para los siguientes fines.
v Para importar plantillas de origen de datos y partición proporcionadas con
Campaign, que puede entonces modificar y duplicar utilizando la página
Configuración.
v Para registrar (importar las propiedades de configuración) productos de IBM
EMM, si el instalador del producto no puede añadir automáticamente las
propiedades a la base de datos.
v Para exportar una versión XML de los valores de configuración para la copia de
seguridad o para importarla en otra instalación de IBM EMM.
v Para suprimir categorías que no tengan el enlace Suprimir categoría. Puede
hacer esto utilizando configTool para exportar su configuración, y después
suprimiendo manualmente el XML que crea la categoría e utilizando configTool
para importar el XML editado.
Importante: Este programa de utilidad modifica las tablas usm_configuration y
usm_configuration_values en la base de datos de la tabla del sistema Marketing
Platform, que contienen las propiedades de configuración y sus valores. Para
obtener unos mejores resultados, cree una copia de seguridad de estas tablas, o
exporte sus configuraciones existentes utilizando configTool y realice una copia de
seguridad del archivo resultante de forma que pueda restaurar su configuración si
comete un error al importar con configTool.
Sintaxis
configTool -d -p "elementPath" [-o]
configTool -i -p "parent ElementPath" -f importFile [-o]
configTool -x -p "elementPath" -f exportFile
configTool -vp -p "elementPath" -f importFile [-d]
configTool -r productName -f registrationFile [-o] configTool -u
productName
Comandos
-d -p "elementPath" [o]
Suprimir las propiedades de configuración y sus valores, especificando una ruta en
la jerarquía de propiedades de configuración.
100
IBM eMessage: Guía del administrador y de inicio
La ruta del elemento debe utilizar los nombres internos de categorías y
propiedades. Puede obtenerlos en la página Configuración, seleccionando la
categoría o propiedad deseada y mirando la ruta que se muestra entre paréntesis
en el panel de la derecha. Delimite una ruta en la jerarquía de propiedades de
configuración utilizando el carácter | y coloque la ruta entre comillas dobles.
Tenga en cuenta lo siguiente.
v Con este comando únicamente se pueden suprimir las categorías y propiedades
de dentro de una aplicación, no aplicaciones completas. Utilice el comando -u
para anular el registro de una aplicación completa.
v Para suprimir categorías que no tengan el enlace Suprimir categoría en la
página Configuración, utilice la opción -o.
Cuando se utiliza -d con el comando -vp, el configTool suprime los nodos hijo en
la vía de acceso que especifique si estos nodos no se incluyen en el archivo XML
que especifique.
-i -p "parentElementPath" -f importFile [o]
Permite importar propiedades de configuración y sus valores desde un archivo
XML especificado.
Para importar, debe especificar una ruta hasta el elemento padre bajo la que desea
importar las categorías. El programa de utilidad configTool importa las
propiedades bajo la categoría que haya especificado en la ruta.
Puede añadir categorías a cualquier nivel por debajo del nivel superior, pero no
puede añadir una categoría al mismo nivel que la categoría superior.
La ruta del elemento padre debe utilizar nombres internos de categorías y
propiedades. Puede obtenerlos en la página Configuración, seleccionando la
categoría o propiedad deseada y mirando la ruta que se muestra entre paréntesis
en el panel de la derecha. Delimite una ruta en la jerarquía de propiedades de
configuración utilizando el carácter | y coloque la ruta entre comillas dobles.
Se puede especificar una ubicación para el archivo de importación relativa al
directorio tools/bin o especificar una ruta de directorio completa. Si especifica una
ruta relativa o no especifica ninguna ruta, configTool primero busca el archivo
relativo al directorio tools/bin.
De forma predeterminada, este comando no sobrescribe una categoría existente,
pero se puede utilizar la opción -o para forzar esta acción.
-x -p "elementPath" -f exportFile
Exportar propiedades de configuración y sus valores a un archivo XML con un
nombre especificado.
Puede exportar todas las propiedades de configuración o limitar la exportación a
una categoría específica especificando una ruta en la jerarquía de propiedades de
configuración.
La ruta del elemento debe utilizar los nombres internos de las categorías y las
propiedades, que puede obtener en la página Configuración, seleccionando la
categoría o propiedad deseada y mirando la ruta que se muestra entre paréntesis
Capítulo 8. Programas de utilidad para eMessage
101
en el panel de la derecha. Delimite una ruta en la jerarquía de propiedades de
configuración utilizando el carácter | y coloque la ruta entre comillas dobles.
Se puede especificar una ubicación para el archivo de exportación relativa al
directorio actual o especificar una ruta de directorio completa. Si la especificación
del archivo no contiene un separador (/ en UNIX, / o \ en Windows), configTool
graba el archivo en el directorio tools/bin en la instalación de Marketing Platform.
Si no proporciona la extensión xml, configTool la añade.
-vp -p "elementPath" -f importFile [-d]
Este comando se utiliza principalmente en las actualizaciones manuales, para
importar las propiedades de configuración. Si ha aplicado un paquete de arreglos
que contiene una propiedad de configuración nueva y actualiza a continuación, la
importación de un archivo de configuración como parte de un proceso de
actualización manual puede alterar temporalmente los valores establecidos cuando
se ha aplicado el paquete de arreglos. El comando -vp garantiza que la
importación no altere los valores de configuración establecida anteriormente.
Importante: Después de utilizar el programa de utilidad configTool con la opción
-vp, debe reiniciar el servidor de aplicaciones web en el que Marketing Platform
está desplegado, para que los cambios se apliquen.
Cuando se utiliza -d con el comando -vp, el configTool suprime los nodos hijo en
la vía de acceso que especifique si estos nodos no se incluyen en el archivo XML
que especifique.
-r productName -f registrationFile
Permite registrar la aplicación. La ubicación del archivo de registro puede ser
relativa al directorio tools/bin o puede ser una ruta completa. De forma
predeterminada, este comando no sobrescribe una configuración existente, pero se
puede utilizar la opción -o para forzar esta acción. El parámetro nombreProducto
debe ser uno de los nombres indicados arriba.
Tenga en cuenta lo siguiente.
v Cuando utiliza el comando -r, el archivo de registro debe tener <application>
como la primera etiqueta en el XML.
Es posible que se suministren otros archivos con el producto que pueda utilizar
para insertar propiedades de configuración en la base de datos de Marketing
Platform. Para estos archivos, utilice el comando -i. Sólo se puede utilizar con la
opción -r el archivo que tenga el código <application> en primer lugar.
v El archivo de registro de Marketing Platform se denomina Manager_config.xml,
y el primer código es <Suite>. Para registrar este archivo en una instalación
nueva, utilice el programa de utilidad populateDb, o vuelva a ejecutar el
instalador de Marketing Platform, tal como se describe en IBM Marketing
Platform Installation Guide.
v Después de la instalación inicial, para volver a registrar productos distintos de
Marketing Platform, utilice configTool con el comando -r y -o para alterar las
propiedades existentes.
El programa de utilidad configTool utiliza los nombres de producto como
parámetros en los comandos para registrar y anular el registro de los productos.
Con el release 8.5.0 de IBM EMM, han cambiado muchos nombres de productos.
No obstante, los nombres que configTool reconoce no han cambiado. A
102
IBM eMessage: Guía del administrador y de inicio
continuación se listan los nombres de producto válidos para utilizar con
configTool, junto con los nombres actuales de los productos.
Tabla 3. Nombres de producto para el registro y la anulación del registro de configTool
Nombre del producto
Nombre usado en configTool
Marketing Platform
Manager
Campaign
Campaign
Distributed Marketing
Collaborate
eMessage
emessage
Interact
interact
Contact Optimization
Optimize
Marketing Operations
Plan
CustomerInsight
Insight
Digital Analytics for On Premises
NetInsight
Opportunity Detect
Detect
Leads
Leads
Interaction History
InteractionHistory
Attribution Modeler
AttributionModeler
IBM SPSS Modeler Advantage Enterprise
Marketing Management Edition
SPSS
Digital Analytics
Coremetrics
-u productName
Anular el registro de una aplicación especificada por nombreProducto. No es
necesario incluir una ruta para la categoría de producto; es suficiente, y obligatorio,
con el nombre de producto. El proceso elimina todas las propiedades y los valores
de configuración del producto.
Opciones
-o
Cuando se utiliza con -i o -r, sobrescribe una categoría existente o registro de
producto (nodo).
Cuando se utiliza con -d, puede suprimir una categoría (nodo) que no tiene el
enlace Suprimir categoría en la página Configuración.
Ejemplos
v Importar valores de configuración de un archivo denominado
Product_config.xml que se encuentra en el directorio conf, bajo la instalación de
Marketing Platform.
configTool -i -p "Affinium" -f Product_config.xml
v Importar una de las plantillas de origen de datos de Campaign proporcionada,
en la partición predeterminada de Campaign, partition1. En el ejemplo se da por
supuesto que la plantilla de origen de datos de Oracle, OracleTemplate.xml, se
encuentra en el directorio tools/bin bajo la instalación de Marketing Platform.
Capítulo 8. Programas de utilidad para eMessage
103
configTool -i -p "Affinium|Campaign|partitions|partition1|dataSources" -f
OracleTemplate.xml
v Exportar todos los valores de configuración a un archivo denominado
myConfig.xml en el directorio D:\backups.
configTool -x -f D:\backups\myConfig.xml
v Exportar una partición de Campaign existente (completa con entradas de origen
de datos), guardarla en un archivo denominado partitionTemplate.xml, y
almacenarlo en el directorio predeterminado tools/bin, bajo la instalación de
Marketing Platform.
configTool -x -p "Affinium|Campaign|partitions|partition1" -f
partitionTemplate.xml
v Registrar manualmente una aplicación denominada nombreProducto utilizando
un archivo denominado app_config.xml ubicado en el directorio predeterminado
tools/bin bajo la instalación de Marketing Platform, y forzar que altere un
registro existente de esta aplicación.
configTool -r product Name -f app_config.xml -o
v Anular el registro de una aplicación denominada nombre_producto.
configTool -u productName
Para hacer copia de seguridad de los valores de
configuración
Para hacer una copia de seguridad de los valores de configuración de eMessage y
Campaign, utilice el programa de utilidad configTool para exportar una copia de
los valores de configuración actuales de IBM Marketing Platform a un archivo.
Acerca de esta tarea
Para obtener información detallada sobre cómo utilizar el programa de utilidad
configTool, incluyendo la explicación de la sintaxis y los parámetros, consulte
“configTool” en la página 100.
Al realizar la copia de seguridad con configTool se exportan todos los valores
actuales de las propiedades de la categoría emessage de la configuración. Cuando
lleve a cabo la copia de seguridad, especifique un nombre de archivo para el
archivo .xml exportado y anote la ubicación donde lo guarda.
Por ejemplo,
En Windows:
configTool.bat -x -p “emessage” -f emessageProperties.xml
En UNIX o Linux:
configTool.sh -x -p “emessage” -f emessageProperties.xml
De forma predeterminada, el archivo .xml se exporta al directorio
INICIO_ADMINISTRADOR/xml.
104
IBM eMessage: Guía del administrador y de inicio
Capítulo 9. Acerca de la resolución de problemas en
eMessage
IBM eMessage proporciona varias herramientas y técnicas que puede utilizar para
investigar problemas relacionados con sus instalaciones de Campaign y eMessage.
Archivos de registro de eMessage
IBM EMM proporciona varios archivos de registro que puede revisar para
supervisar la instalación de eMessage e investigar los problemas.
Archivo de registro de eMessage
Este registro contiene los siguientes tipos de información sobre la información
descargada desde IBM EMM Hosted Services.
v
v
v
v
información general de envío de correos
ID de instancia de envío de correos
datos de pulsaciones en enlaces
datos de correo electrónico rebotado
Ubicado en el directorio logs en la instalación de eMessage.
Archivos temporales de eMessage
Este directorio contiene los datos que se cargan.
Ubicado en el directorio temp de la instalación de eMessage.
Archivos de registro de Campaign
Puede revisar los archivos de registro de las siguientes ubicaciones para obtener
información relacionada con la actividad relacionada con el envío de correos en
Campaign.
v Campaign\partitions\<partitionN>\logs
Diversos archivos de registro relacionados con ejecuciones de diagramas de flujo,
incluyendo entradas de registro de cualquier proceso de eMessage contenido en
el diagrama de flujo.
v Campaign\logs
Este directorio contiene campaignweb.log, que contiene información sobre la
actividad de carga realizada por el Cargador de listas de destinatario.
Utilización de log4j con eMessage
eMessage utiliza el programa de utilidad log4j de Apache para registrar
información de configuración, depuración y errores relacionada con el RCT
(Rastreador de respuestas y contactos) y el RLU (Cargador de listas de
destinatarios).
Para obtener información sobre cómo cambiar la configuración del registro del
sistema, consulte:
© Copyright IBM Corp. 1999, 2015
105
v Comentarios en el archivo log4j.properties.
v Documentación de log4j en el sitio web de Apache: http://logging.apache.org/
log4j/1.2/manual.html
Utilizar log4j con el Cargador de listas de destinatarios
Cuando ejecuta el programa de utilidad RLU (Cargador de listas de destinatarios)
desde la línea de comandos, éste utiliza la configuración predeterminada del
registrador. Para cambiar esta configuración, modifique el archivo
emsg_rlu_log4j.properties. En el directorio conf del directorio de instalación de
eMessage, copie example_emsg_log4j.properties en emsg_rlu_log4j.properties.
Modifique emsg_rlu_log4j.properties como indican los comentarios que
encontrará dentro del archivo.
Cuando el RLU se invoca automáticamente desde un diagrama de flujo, utiliza el
registro de la aplicación web de Campaign, que está configurado en
campaign_log4j.properties, en el directorio de instalación de Campaign.
Utilizar log4j con el Rastreador de respuestas y contactos
Cuando ejecuta el programa de utilidad RCT (Rastreador de respuestas y
contactos), éste utiliza la configuración predeterminada del registrador. Para
cambiar esta configuración, modifique el archivo emsg_rct_log4j.properties. En el
directorio conf del directorio de instalación de eMessage, copie
example_emsg_log4j.properties en emsg_rct_log4j.properties. Modifique
emsg_rct_log4j.properties como indican los comentarios que encontrará dentro
del archivo.
106
IBM eMessage: Guía del administrador y de inicio
Capítulo 10. Gestión del acceso de usuario a las funciones de
mensajería
Campaign y eMessage utilizan roles y permisos proporcionados por IBM
Marketing Platform para controlar el acceso de los usuarios a funciones de
mensajería en eMessage y Campaign. Debe tener permisos en IBM Marketing
Platform y Campaign para realizar los cambios necesarios. También debe estar
familiarizado con la forma de configurar roles y permisos en Marketing Platform y
de cómo definir políticas de seguridad para Campaign.
Para llevar a cabo campañas de marketing de correo electrónico, los usuarios de
marketing de correo electrónico acceden a las características de envío de correos de
eMessage en IBM Campaign.
Para crear comunicaciones personalizadas y páginas de destino alojadas, los
usuarios de marketing trabajan con características y contenido en eMessage
Document Composer.
Para obtener información general sobre cómo configurar roles, permisos y políticas,
consulte los apartados de la publicación IBM Marketing Platform Administrator's
Guide que describen cómo gestionar la seguridad en IBM Marketing Platform y
IBM Campaign.
Conceptos relacionados:
“Asignación de roles y políticas para el acceso a envío de correos”
“Permisos de mensajería en Campaign” en la página 110
“Permisos de mensajería para eMessage” en la página 116
Asignación de roles y políticas para el acceso a envío de correos
Para iniciar la sesión en el sistema IBM EMM, los usuarios de marketing de correo
electrónico especifican un nombre de usuario y una contraseña del sistema. Los
permisos otorgados al usuario del sistema determinan cómo el usuario de
marketing puede acceder a características de envío de correos, comunicaciones
personalizadas y contenido en eMessage y Campaign.
Los permisos se asocian con roles que se han definido en IBM Marketing Platform.
Para controlar el acceso a las características de envío de correos en Campaign,
puede definir roles en una o más políticas de seguridad. Se debe asignar a todos
los usuarios del sistema que acceden a características de envío de correos,
comunicaciones y contenido un rol de eMessage en una política de seguridad de
Campaign. Mediante la política, puede aplicar de forma selectiva permisos para
características de envío de correos en Campaign y comunicaciones y contenido en
el Creador de documentos de eMessage.
También se debe asignar a los usuarios que acceden a las características de envío
de correos los roles de administrador y usuario de eMessage. Estos roles son
independientes de los roles de eMessage disponibles en las políticas de seguridad
de Campaign.
Conceptos relacionados:
© Copyright IBM Corp. 1999, 2015
107
Capítulo 10, “Gestión del acceso de usuario a las funciones de mensajería”, en la
página 107
“Roles y permisos en Marketing Platform y Campaign”
“Permisos de mensajería en Campaign” en la página 110
“Permisos de mensajería para eMessage” en la página 116
Roles y permisos en Marketing Platform y Campaign
Los roles en Marketing Platform y Campaign son una recopilación configurable de
permisos. Para cada rol en Marketing Platform y Campaign, puede especificar
permisos que controlan el acceso a la aplicación.
Puede utilizar los roles predeterminados o crear nuevos roles. El conjunto de
permisos disponibles está definido por el sistema. Usted no puede crear un nuevo
permiso.
Acerca de las asignaciones de roles
Generalmente, debe darle a los usuarios roles con permisos que reflejen las
funciones que los usuarios realizan en su organización cuando utilizan IBM EMM.
Puede asignar roles a un grupo o a un usuario individual. La ventaja de asignar
roles por grupo es que puede asignar una combinación de roles al grupo y si
después desea modificar esa combinación puede hacerlo en un lugar en vez de
tener que hacerlo varias veces para varios usuarios. Cuando asigna roles por
grupo, añade y elimina usuarios de sus grupos para controlar el acceso de los
usuarios.
Cómo evalúa los roles el sistema
Si un usuario tiene varios roles, el sistema evalúa los permisos de todos esos roles
juntos. Por lo tanto, la capacidad de realizar una función en un objeto determinado
se otorga o deniega en función de los permisos agregados de todos los roles. En el
caso de Campaign, la capacidad de realizar una función en un objeto determinado
se otorga o deniega en función de la política de seguridad del objeto.
Conceptos relacionados:
“Asignación de roles y políticas para el acceso a envío de correos” en la página 107
“Roles de eMessage en la política global” en la página 110
Acerca de las políticas de seguridad
Las políticas de seguridad son "libros de normas" que controlan la seguridad en
IBM Campaign; se las consulta siempre que un usuario realiza una acción en la
aplicación. Las políticas de seguridad se crean por partición. Las políticas de
seguridad no se comparten entre particiones. Cada partición en IBM Campaign
puede tener varias políticas de seguridad.
Una política de seguridad consta de los distintos roles que defina. Cada rol
contiene un conjunto de permisos que determinan las acciones que los usuarios
108
IBM eMessage: Guía del administrador y de inicio
pueden realizar y los objetos a los que pueden acceder. Puede asignar usuarios a
un rol directamente, o bien asignar grupos a un rol (los usuarios de esos grupos se
asignarían al rol).
Cuando crea un objeto como una campaña u oferta en la carpeta de nivel superior,
aplica una política de seguridad al objeto. Además, cuando crea una carpeta de
nivel superior, aplica una política de seguridad a la carpeta, y los objetos o
subcarpetas que cree dentro de dicha carpeta heredan la política de seguridad que
ha aplicado a la carpeta.
La aplicación de políticas de seguridad a objetos o carpetas le permite separar los
objetos en IBM Campaign para su uso por parte de distintos grupos de usuarios.
Por ejemplo, podría configurar sus políticas de seguridad de forma que los
usuarios que pertenezcan a una política no puedan acceder, ni siquiera ver, los
objetos asociados a otras políticas.
Puede crear sus propias políticas de seguridad o utilizar la política de seguridad
global predeterminada que se incluye en IBM Campaign.
La política de seguridad global
Campaign incluye una política de seguridad global predeterminada que puede
utilizar tal cual, o bien modificarla para que se ajuste a las necesidades de su
organización. Si elije no crear sus propias políticas de seguridad, se aplica de forma
predeterminada la política de seguridad global a los objetos que cree en Campaign.
Puede utilizar la política global además de sus propias políticas, o bien utilizar
únicamente sus políticas. No puede suprimir la política global, incluso si no la
utiliza.
Las políticas de seguridad que cree están bajo la política de seguridad global. En la
política global, puede crear una política de seguridad aparte para los empleados de
cada departamento de su organización.
La política de seguridad global contiene seis roles predefinidos; puede añadir roles
a la política global, si fuera necesario. No puede suprimir los roles predefinidos,
pero puede modificar sus permisos.
Los roles predefinidos son:
v Propietario de carpeta: todos los permisos habilitados
v Propietario: todos los permisos habilitados
v Admin: todos los permisos habilitados. El usuario predeterminado asm_admin
tiene asignado este rol
v Ejecutar: todos los permisos habilitados
v Diseño: permisos de lectura y escritura en la mayoría de objetos. No puede
planificar diagramas de flujo ni sesiones
v Revisar: permisos de sólo lectura
La política de seguridad global se aplica a todos los usuarios por medio de los
roles de Propietario y Propietario de carpeta, incluyendo los usuarios que no han
sido asignados a ningún otro rol específico en la política global. Como la política
global siempre se aplica, se puede utilizar, por ejemplo, para denegar permisos a
un rol de forma global.
Conceptos relacionados:
“Roles de eMessage en la política global” en la página 110
Capítulo 10. Gestión del acceso de usuario a las funciones de mensajería
109
Roles de eMessage en la política global
Además de los roles predefinidos de Campaign, la política global incluye varios
roles específicos de eMessage.
La política global incluye los siguientes roles de eMessage.
v eMsg_admin: puede acceder a todas las características de envío de correos, todo
el contenido y todos los documentos.
v eMsg_execute: puede acceder a todas las características de envío de correos,
todo el contenido y todos los documentos.
v eMsg_design: puede acceder a todo el contenido, todos los documentos y la
mayoría de las características de envío de correos. Sin embargo, no se otorga
explícitamente permiso para realizar envíos de correos de producción.
v eMsg_review: puede visualizar sólo contenido y documentos, y tiene permisos
limitados para trabajar con envíos de correos. No se otorga explícitamente
permiso para añadir, editar o suprimir envíos de correos. Se permite visualizar y
enviar envíos de correos de prueba y producción.
Nota: eMessage no da soporte a los roles de Propietario y Propietario de carpeta
que se crean de forma predeterminada para Campaign.
Conceptos relacionados:
“Roles y permisos en Marketing Platform y Campaign” en la página 108
“La política de seguridad global” en la página 109
“Permisos de envíos de correos en Campaign” en la página 113
“Permisos para la categoría Activos digitales” en la página 113
“Permisos para la categoría Documentos” en la página 114
Permisos de mensajería en Campaign
Campaign controla el acceso de los usuarios a las características de envío de
correos habilitando o inhabilitando permisos específicos definidos en los roles
asignados a un usuario o grupo. Estos roles están asociados a una o más políticas
de seguridad. Puede definir varias políticas de seguridad de Campaign y asignar
varios roles a cada política. Cada combinación de política y roles puede definir un
conjunto específico de permisos.
Para obtener más información sobre cómo gestionar permisos de seguridad,
incluyendo escenarios de seguridad de muestra, consulte la publicación IBM
Campaign Administrator’s Guide.
En Roles y permisos para IBM Marketing Platform, debe asignar permisos de
usuario para características de envío de correos y contenido en la sección
Campaign, de la forma siguiente.
1. Defina roles de usuario.
De forma predeterminada se crean roles de usuario definidos por el sistema
para eMessage en la política global.
También se pueden definir roles personalizarlos y añadirlos a la política global
o a otras políticas que defina.
2. Defina políticas de seguridad y añada roles de usuario a las políticas.
110
IBM eMessage: Guía del administrador y de inicio
La política global se define de forma predeterminada. Puede definir políticas
adicionales para Campaign.
3. Defina permisos específicos para cada rol en cada política.
Puede definir políticas adicionales y roles personalizados con varios conjuntos
de permisos para tener un mayor control sobre el acceso a correo características
de envío de correos en Campaign y eMessage Document Composer.
Los cambios en los permisos, roles y políticas se aplican cuando el usuario inicia la
sesión en IBM EMM. Después de asignar o cambiar permisos de envío de correos
para un usuario, el usuario debe cerrar la sesión para que se apliquen los cambios.
Conceptos relacionados:
Capítulo 10, “Gestión del acceso de usuario a las funciones de mensajería”, en la
página 107
“Asignación de roles y políticas para el acceso a envío de correos” en la página 107
Realización de roles y permisos disponibles
En función de su instalación de IBM Marketing Platform, es posible que los
controles administrativos necesarios para definir y aplicar roles y permisos no se
visualicen de forma inmediata. Puede hacer que los controles necesarios estén
disponibles accediendo al Creador de documentos de eMessage o a un envío de
correos en Campaign.
Acerca de esta tarea
Realice el procedimiento siguiente si no ve todos los permisos siguientes en la
política global de Campaign.
v Permisos para envíos de correos en la categoría Campañas
v Permisos para la biblioteca de contenido en la categoría Activos digitales
v Permisos para documentos de eMessage en la categoría Documentos
Procedimiento
1. Inicie sesión en IBM EMM.
Si tiene configurados varios usuarios, inicie sesión como usuario con los
permisos más limitados. Por ejemplo, inicie sesión como usuario que tiene sólo
permisos de visualización.
2. Vaya a Campaign > Documentos de eMessage para acceder al Creador de
documentos.
Espere a que el Creador de documentos acabe de cargarse.
3. Vaya a Configuración > Roles y permisos de usuario > Campaign > partición
[n] > Política global
Cuando se le solicite, confirme que desea salir del Creador de documentos
abandonando la página.
4. Pulse Añadir roles y asignar permisos. Se visualizan los siguientes roles de
eMessage.
v eMsg_admin
v eMsg_execute
v eMsg_design
v eMsg_review
Capítulo 10. Gestión del acceso de usuario a las funciones de mensajería
111
5. Pulse Guardar y editar permisos.
Los permisos de envío de correos se visualizan en las categorías Campañas,
Activos digitales y Documentos.
Para obtener más información sobre los permisos específicos disponibles,
consulte los temas siguientes.
Conceptos relacionados:
“Permisos de envíos de correos en Campaign” en la página 113
“Permisos para la categoría Activos digitales” en la página 113
“Permisos para la categoría Documentos” en la página 114
¿Cómo evalúa Campaign los permisos?
Cuando un usuario realiza una tarea o intenta acceder a un objeto, Campaign
realiza los pasos siguientes:
1. Identifica todos los grupos y roles a los que pertenece el usuario dentro de la
política de seguridad global. Un usuario puede pertenecer a uno, varios o
ningún rol. Un usuario pertenece al rol de Propietario si es el propietario de un
objeto; pertenecen al rol de Propietario de carpeta si son propietarios de la
carpeta en la que se encuentra el objeto. Un usuario pertenece a otros roles,
sólo si han sido específicamente asignados a dichos roles (ya sea directamente o
porque pertenecen a un grupo asignado al rol).
2. Identifica si el objeto al que se accede ha sido asignado a una política definida
personalizada, si existe alguna. Si así fuera, el sistema identificará todos los
grupos y roles a los que el usuario pertenece, dentro de esta política
personalizada.
3. Agrega los permisos para todos los roles a los que pertenece el usuario, en base
a los resultados de los pasos 1 y 2. Con el uso de este rol compuesto, el sistema
evalúa los permisos para la acción de la siguiente manera:
a. Si algún rol tiene el permiso Denegado para esta acción, el usuario no
podrá realizarla.
b. Si a ningún rol se le ha Denegado permiso para esta acción, entonces
verifica para determinar si algún rol tiene permiso Otorgado para esta
acción. Si así fuera, se permite al usuario realizar la acción.
c. Si ni a ni b se cumplen, se deniega el permiso al usuario.
Definición de estados de permiso
Para cada rol, puede especificar qué permisos se otorga, no se otorgar o se
deniegan. Establezca estos permisos en la página Valores > Roles de usuario &
Permisos.
Estos estados tienen los significados siguientes.
. Se otorga
v Otorgado - indicado con una marca de comprobación verde
explícitamente el permiso para realizar esta función determinada siempre y
cuando ninguno de los demás roles del usuario deniegue explícitamente el
permiso.
. Se deniega explícitamente el
v Denegado - indicado con una "X" roja
permiso para realizar esta función determinada, independientemente de otros
roles del usuario que puedan otorgar permiso.
112
IBM eMessage: Guía del administrador y de inicio
v No otorgado - indicado con una "X" gris sombreado
. No se otorga
explícitamente ni se deniega el permiso para realizar una función determinada.
Si este permiso no lo otorga explícitamente ninguno de los roles de un usuario,
este no puede realizar esta función.
Permisos de envíos de correos en Campaign
En Campaign, puede crear, configurar, ejecutar y supervisar envíos de correos de
eMessage con controles de las pestañas de envío de correos de eMessage. Puede
gestionar cada envío de correos en una pestaña individual.
Los siguientes permisos controlan el acceso de usuario a las pestañas de envío de
correos de eMessage. Se encuentran en la categoría Campañas.
Permiso
Descripción
Ver envíos de correos
Permite que un usuario visualice una pestaña de envío de correos
de eMessage en una campaña. El usuario no puede editar o
cambiar el envío de correos.
Editar envíos de
correos
Permite que un usuario configure o cambie una pestaña de envío
de correos de eMessage en una campaña.
Suprimir envíos de
correos
Permite que un usuario elimine un envío de correos de eMessage
de una campaña.
Añadir envíos de
correos
Permite que un usuario cree un envío de correos en una campaña.
Enviar envío de
Permite que un usuario inicie una ejecución de producción del
correos de producción envío de correos, habilite un envío de correos para correo
electrónico transaccional o planifique una ejecución de envío de
correos de producción.
Los envíos de correos de producción pueden incluir muchos
mensajes. Los mensajes de correo electrónico se envían a todas las
personas identificadas como destinatarios de producción en la lista
de destinatarios asociada al envío de correos.
Ejecutar ejecución de
prueba
Permite que un usuario inicie una ejecución de prueba del envío
de correos.
Los envíos de correos de prueba normalmente implican unos pocos
mensajes. Durante una ejecución de prueba se envía un mensaje de
correo electrónico a cada dirección identificada como destinatario
de prueba en la lista de destinatarios asociada al envío de correos.
Conceptos relacionados:
“Roles de eMessage en la política global” en la página 110
Tareas relacionadas:
“Registro de una aplicación de dispositivo móvil en IBM eMessage” en la página
90
“Realización de roles y permisos disponibles” en la página 111
Permisos para la categoría Activos digitales
Los permisos Activos digitales controlan el acceso de usuario a los elementos de
contenido de la Biblioteca de contenido de eMessage, así como a las carpetas y
subcarpetas en las que se almacenan.
Capítulo 10. Gestión del acceso de usuario a las funciones de mensajería
113
La Biblioteca de contenido es un repositorio para elementos de contenido (también
denominados activos digitales) que se utilizan en comunicaciones que crean los
usuarios en el Creador de Documentos de eMessage.
Permisos
Descripción
Ver activos digitales
de eMessage
Permite que un usuario abra elementos de contenido para
visualizar las propiedades y obtener una vista previa del contenido
que se puede añadir a una comunicación personalizada.
Crear nuevos activos
digitales en la
Biblioteca de
contenido de
eMessage
Permite que un usuario cree un elemento de contenido y lo añada
a la Biblioteca de contenido.
Editar activos
digitales existentes en
la Biblioteca de
contenido de
eMessage
Permite que un usuario abra y edite elementos de contenido
existentes.
Suprimir activos
digitales de la
Biblioteca de
contenido de
eMessage
Permite que un usuario elimine un elemento de contenido de la
Biblioteca de contenido.
Mover activos
digitales de una
carpeta a otra
Permite que un usuario mueva elementos de contenido en la
Biblioteca de contenido. Para mover un elemento de contenido es
necesario asignar este permiso a las carpetas de origen y destino.
Conceptos relacionados:
“Roles de eMessage en la política global” en la página 110
Tareas relacionadas:
“Realización de roles y permisos disponibles” en la página 111
Permisos para la categoría Documentos
Los permisos en la categoría Documentos controlan el acceso de usuario para
crear, editar y gestionar comunicaciones personalizadas en el Creador de
Documentos de eMessage.
Permisos
Descripción
Visualizar
documentos de
eMessage
Permite que un usuario visualice un documento utilizado para
crear un correo electrónico, una notificación de envío de bandeja
de entrada o una página de destino alojada.
Crear nuevos
documentos de
eMessage
Permite que un usuario cree una nueva comunicación
personalizada.
Editar documentos de Permite que un usuario cambie una comunicación personalizada
eMessage existentes
existente.
Suprimir documentos
de eMessage
114
Permite que un usuario elimine una comunicación personalizada.
IBM eMessage: Guía del administrador y de inicio
Permisos
Descripción
Publicar documento
de eMessage,
haciendo que el
contenido esté
disponible en Internet
publico
Permite que un usuario publique una comunicación personalizada.
Copiar documentos
de eMessage de una
carpeta a otra
Permite que un usuario copie una comunicación personalizada
entre carpetas de la biblioteca de contenido.
La publicación de una comunicación hace que el documento y todo
el contenido añadido esté disponible para su uso en un envío de
correos de eMessage.
Para copiar una comunicación es necesario asignar este permiso a
las carpetas de origen y de destino.
Mover documentos de Permite que un usuario mueva una comunicación personalizada de
eMessage de una
una carpeta a otra en la biblioteca de contenido.
carpeta a otra
Para mover una comunicación es necesario asignar este permiso a
las carpetas de origen y de destino.
Conceptos relacionados:
“Roles de eMessage en la política global” en la página 110
Tareas relacionadas:
“Realización de roles y permisos disponibles” en la página 111
Permisos para la categoría Administración de correo
electrónico
Los permisos de la categoría Administración de correo electrónico de la política
global de Campaign proporcionan a los administradores de eMessage acceso a los
valores que controlan el acceso de usuario a varios dominios y características de
mensajería.
Los administradores asignan acceso a los dominios y las características en la
sección Valores de política de la ventana Configuración de eMessage. Por ejemplo,
el administrador puede restringir la lista de dominios de correo electrónico que un
usuario puede seleccionar como un dominio De: en una comunicación por correo
electrónico creada en el editor de comunicaciones. La sección Valores de política no
se muestra a no ser que se conceda el permiso explícito adecuado al administrador
en la política global de Campaign.
Los administradores pueden controlar también el acceso a las interfaces
administrativas para registrar las aplicaciones móviles con eMessage y para
configurar las ubicaciones para utilizarlas con la entrega desencadenada por
ubicación. Los enlaces con las páginas administrativas aparecen en la sección
Valores de notificación móvil de la página Configuración de eMessage. La
mensajería móvil debe estar habilitada para que la cuenta de mensajería alojada
muestre la sección Valores de notificación móvil de la página Configuración de
eMessage.
Capítulo 10. Gestión del acceso de usuario a las funciones de mensajería
115
Permisos
Descripción
Configurar dominios
Controla el acceso a la sección Valores de política de la página
Configuración de eMessage. Si no se otorga permiso al rol de
administrador para configurar dominios de correo electrónico, el
administrador no podrá ver la sección Valores de política. Este
permiso es necesario también para administrar los dominios de
enlace corto.
Configurar
aplicaciones móviles
(Disponible solo si
está instalado el
fixpack de Campaign
9.1.0.2 o superior).
Controla el acceso a la ventana Claves de aplicación móvil de
Configuración de eMessage. Si no se concede permiso al rol de
administrador para configurar las aplicaciones móviles, no se
muestra el enlace con la página Claves de aplicación móvil en la
página Configuración de eMessage.
Configurar
ubicaciones
(Disponible solo si
está instalado el
fixpack de Campaign
9.1.0.2 o superior).
Controla el acceso a la ventana Ubicaciones de Configuración de
eMessage. Si no se concede permiso al rol de administrador para
configurar las ubicaciones, no se muestra el enlace con la página
Ubicaciones en la página Configuración de eMessage.
Permisos de mensajería para eMessage
IBM eMessage controla el acceso a características de envío de correos exteriores a
la pestaña de envío de correos en Campaign a través de los siguientes roles de
seguridad predefinidos.
v eMessage_admin
v eMessage_user
Los usuarios deben contar con ambos roles para poder acceder a las características
de envío de correos de eMessage.
Conceptos relacionados:
Capítulo 10, “Gestión del acceso de usuario a las funciones de mensajería”, en la
página 107
“Asignación de roles y políticas para el acceso a envío de correos” en la página 107
Tareas relacionadas:
“Asignación de roles de eMessage”
Asignación de roles de eMessage
Para ofrecer a usuario acceso total a las características de envío de correos de
eMessage, asigne los roles predefinidos de eMessage al usuario.
Procedimiento
1. En IBM Marketing Platform, acceda a Valores > Roles de usuario & Permisos
> eMessage > partición [n] > admin_eMessage.
2. Pulse Asignar usuarios.
3. Seleccione el usuario en la lista de usuarios disponibles. Pulse Añadir para
asignar el rol al usuario.
4. Repita los pasos 1-3 para el rol usuario_eMessage.
116
IBM eMessage: Guía del administrador y de inicio
5. Guarde los cambios.
Conceptos relacionados:
“Permisos de mensajería para eMessage” en la página 116
Control de dominios de correo electrónico y dominios de enlace corto
Si se solicita, IBM configura uno o más dominios de correo electrónico para su
cuenta de correo electrónico hospedada. IBM también puede asignar dominios que
los usuarios de marketing utilizan para crear enlaces abreviados en distintos tipos
de mensajes. Los administradores del sistema con los permisos adecuados
controlan los dominios de mensajería disponibles a los usuarios de marketing.
Acerca de esta tarea
En función de sus requisitos de negocio, podría ser recomendable restringir la lista
de los dominios de mensajería disponibles a usuarios de marketing específicos. Los
administradores de eMessage restringen la lista de dominios disponibles mediante
las políticas de seguridad que se aplican a las carpetas en el Creador de
Documentos. La capacidad de los usuarios de marketing de crear y editar
comunicaciones depende de la política de seguridad que se aplica a la carpeta que
contiene la comunicación.
Los administradores de eMessage con los permisos adecuados pueden controlar la
lista de dominios de correo electrónico que pueden utilizar los usuarios de
eMessage como dominio De: en las comunicaciones por correo electrónico. Los
administradores también pueden controlar la lista de dominios de enlace corto que
se presenta a los usuarios de marketing cuando configuran comunicaciones que
utilizan enlaces abreviados. Por ejemplo, puede especificar los dominios de enlace
corto que estarán disponibles cuando los usuarios de marketing añadan un enlace
de compartición social a los mensajes de marketing.
Los administradores de eMessage utilizan la página Valores de política para
otorgar permisos para utilizar dominios de mensajería específicos. El acceso a la
página Valores de política lo controlan los permisos Administración de correo
electrónico que se otorgan mediante la Política global de Campaign. Sólo los
administradores con los permisos adecuados pueden restringir el acceso a los
dominios de correo electrónico mediante la página Valores de política.
Procedimiento
1. En el menú Valores, seleccione Valores de eMessage. Si tiene los permisos de
administración adecuados, la sección Valores de política se visualiza en la
página Valores de eMessage.
2. Pulse Visualizar una lista de políticas y sus valores. Se visualiza una lista de
políticas de seguridad configuradas para su instalación de eMessage.
3. Pulse una política de seguridad asociada con el usuario del sistema cuyo acceso
a dominio de mensajería desea controlar.
La sección Dominios visualiza los dominios de correo electrónico configurados
para la cuenta de mensajería alojada.
La sección Dominios de enlace corto visualiza los dominios de enlace corto
configurados para la cuenta de mensajería alojada.
Capítulo 10. Gestión del acceso de usuario a las funciones de mensajería
117
v En una de las dos secciones, pulse Utilizar todos los dominios para permitir
que los usuarios asociados con la política utilicen cualquiera de los dominios
de correo electrónico que IBM ha configurado para la cuenta de correo
electrónico alojado.
Esta es la opción predeterminada.
v Pulse Utilizar dominios específicos para seleccionar dominios específicos.
Nota: Si selecciona Utilizar dominios específicos, debe actualizar los
permisos de dominio cuando registre un nuevo correo electrónico o dominio
de enlace corto para la cuenta de mensajería alojada. El sistema no asigna
automáticamente permisos para el nuevo dominio.
Resultados
Para los usuarios asociados con la política de seguridad, sólo los dominios de
correo electrónico seleccionados aparecen como una opción para la dirección De:
en las comunicaciones de correo electrónico. Para las comunicaciones que requieran
enlaces abreviados, los usuarios de marketing sólo podrán elegir entre los
dominios de enlace corto seleccionados.
Cuando se hayan guardado los nuevos valores, el Creador de Documentos
actualizará las opciones de dominio disponibles para los usuarios de marketing.
Para obtener más información sobre cómo los usuarios de marketing de eMessage
crean y gestionan comunicaciones, consulte la publicación IBM eMessage User’s
Guide.
Mantenimiento de dominios de correo electrónico alojado
Para enviar mensajes de correo electrónico, debe registrar al menos un dominio de
correo electrónico en IBM. Para mejorar la capacidad de entrega de los mensajes,
IBM trabaja con usted para establecer y mantener la reputación en correo
electrónico del dominio con los principales proveedores de servicios de Internet
(ISP) de todo el mundo. Puede establecer varios dominios de correo electrónico con
IBM.
Cuando configura la cabecera en una comunicación por correo electrónico, el
sistema completa la dirección De con el dominio de correo electrónico que ha
registrado en IBM. Si establece varios dominios de correo electrónico con IBM, los
dominios disponibles se visualizan en una lista desplegable. Los administradores
del sistema pueden controlar los dominios de correo electrónico que los usuarios
de marketing de correo electrónico pueden seleccionar o modificar.
Puede solicitar que IBM añada o suprima dominios de correo electrónico
establecidos para su cuenta de mensajería alojada. Después de que IBM complete
el cambio, el sistema actualiza la lista de dominios de correo electrónico
disponibles. El cambio se reflejará en la lista de dominios de correo electrónico
disponibles la próxima vez que se cree o edite una comunicación por correo
electrónico.
Nota: Los cambios de los dominios de correo electrónico de su cuenta no
actualizan las comunicaciones por correo electrónico que ha creado antes de la
solicitud de cambio. Para cambiar el dominio de correo electrónico de una
comunicación creada anteriormente, debe volver a abrir la comunicación por correo
electrónico y actualizar la selección de dominio de correo electrónico.
118
IBM eMessage: Guía del administrador y de inicio
Para obtener más información sobre cómo registrar un dominio de correo
electrónico en IBM, consulte la publicación IBM Enterprise Marketing Management
(EMM) Domain Name Options for Email.
Para solicitar cambios relacionados con los dominios de correo electrónico, póngase
en contacto con el equipo de servicios de cuenta de correo electrónico en
[email protected].
Configuración de la dirección y del nombre de visualización de
remitente predeterminados
Para cada dominio de correo electrónico que ha registrado en IBM, puede definir
una dirección de correo electrónico predeterminada y un nombre descriptivo
predeterminado. La combinación de dirección de correo electrónico o nombre
descriptivo y el dominio de correo electrónico aparece como la dirección De: en
todos los mensajes de correo electrónico que envía.
Acerca de esta tarea
Los administradores pueden configurar los nombres de visualización y remitente
predeterminados en la página Valores del dominio. Los valores de dominio forman
parte de la interfaz Valores de eMessage. El acceso a la página Valores del dominio
lo controlan los permisos Administración de correo electrónico que se otorgan
mediante la política global de Campaign. Sólo los administradores con los
permisos adecuados pueden restringir el acceso a los dominios de correo
electrónico mediante la página Valores de política.
Procedimiento
1. Acceda a Valores > Valores de eMessage. En la sección Valores del dominio,
pulse Visualizar la lista de valores del dominio.
La página Valores del dominio lista los nombres de visualización
predeterminados y las direcciones de correo electrónico asociados con los
dominios de correo electrónico registrados en la cuenta de correo electrónico
alojada. La lista incluye sólo los dominios que los permisos de usuario le
permiten modificar.
La columna Predeterminado indica la combinación de nombres de
visualización, dirección y dominio que aparece como la dirección De
predeterminada para las nuevas comunicaciones de correo electrónico.
. Se abre la ventana Editar valores del dominio.
2. Pulse Editar
La columna Nombre de dominio lista los dominios de correo electrónico
disponibles. Puede hacer lo siguiente para cualquiera de los dominios.
v En la columna Nombres de visualización De, especifique un nombre
descriptivo para que aparezca como el valor predeterminado para el dominio
de correo electrónico en la lista.
v En la columna Dirección De, especifique la parte local de la dirección de
correo electrónico para que aparezca como el valor predeterminado para un
dominio de correo electrónico en la lista.
3. Opcionalmente, en la columna Predeterminado, seleccione una combinación de
nombre de visualización, dirección y dominio para que aparezca como la
dirección De predeterminada para las nuevas comunicaciones de correo
electrónico.
Capítulo 10. Gestión del acceso de usuario a las funciones de mensajería
119
Si no selecciona un valor predeterminado, el sistema utiliza el primer dominio
de la lista para crear la dirección De predeterminada para las nuevas
comunicaciones de correo electrónico.
4. Guarde los cambios.
Resultados
Los nuevos valores de dirección se aplicarán a todas las nuevas comunicaciones
por correo electrónico que se creen. Los valores no cambian la información de
dirección para las comunicaciones por correo electrónico creadas anteriormente.
Para actualizar las comunicaciones por correo electrónico anteriores, debe reabrir y
modificar cada una de las comunicaciones.
Cómo controlar el acceso a la lista de mensajes enviados
eMessage proporciona una lista de mensajes que se han enviado desde el entorno
de eMessage. Debido a que la lista incluye enlaces a configuraciones de mensajería,
su planificación de seguridad puede requerir que se restrinja el acceso a la lista.
Acerca de esta tarea
La lista de mensajes se presenta en la página Envío de correos de eMessage. De
forma predeterminada, todos los usuarios del entorno de Campaign y eMessage,
pueden ver la lista de mensajes enviados. Sin embargo, cuando se habilita la
restricción de acceso, puede evitar que usuarios concretos puedan ver la opción de
menú para abrir la página que contiene la lista.
La restricción de acceso a la lista de mensajes enviados, afecta a todas las
particiones de la instalación de Campaign. Si la instalación de Campaign incluye
varias particiones, debe actualizar los permisos de usuario de forma separada en
cada partición, para otorgar o denegar explícitamente permiso para acceder a la
lista.
El control de quién puede acceder a la lista de mensajes enviados requiere una
serie de tareas para cambiar la configuración del sistema y los permisos de
usuario.
Tarea
Más información
Identificar usuarios que pueden acceder a la
lista de mensajes. Al principio, todos los
usuarios tienen el acceso otorgado.
“Cómo otorgar el acceso a la lista de
mensajes enviados” en la página 121
Identificar usuarios que no tienen permiso
para acceder a la lista de mensajes.
“Cómo denegar el acceso a la lista de
mensajes enviados” en la página 121
Habilitar la restricción de acceso.
“Cómo habilitar la restricción a la lista de
mensajes enviados” en la página 122
Resultados
Cuando haya finalizado estas tareas, la opción Envío de correos de eMessage del
menú Campaña, sólo estará visible para los usuarios con roles que otorguen
explícitamente permiso para acceder a la lista de correos.
120
IBM eMessage: Guía del administrador y de inicio
Cómo otorgar el acceso a la lista de mensajes enviados
Si restringe el acceso a la lista de mensajes enviados, debe otorgar específicamente
acceso a los usuarios que deben acceder a la lista.
Acerca de esta tarea
Los usuarios acceden a la lista de mensajes enviados pulsando el enlace Correos
de eMessage en el menú Campaña. Puede otorgar un acceso de usuario a la lista
de todos los mensajes enviados, asignando al usuario un rol administrativo de
nivel alto, que otorga explícitamente permiso para ver el enlace Correos de
eMessage.
Los roles predeterminados de nivel alto incluyen Admin, Ejecutar, Diseñar y
Revisar. Los permisos que otorgue a través de los roles de nivel alto, se aplican a
todos los objetos en la partición.
Procedimiento
1. Vaya a Valores > Permisos y roles de usuario > Campaña > partición (n).
2. Pulse Guardar y editar permisos. Se abrirá una lista de permisos para la
partición. Los roles de nivel alto disponibles se enumeran en la parte superior
de la página.
3. En la sección Administración, otorgue explícitamente el permiso Ver página de
la lista de correos enviados para cada rol.
Resultados
Cuando habilita restricciones de acceso para la lista de mensajes enviados, los
usuarios con roles que tengan otorgados explícitamente el permiso Ver página de
la lista de correos enviados, pueden ver el enlace Correos de eMessage en el
menú Campaña.
Qué hacer a continuación
Cree un rol para denegar el acceso a la lista de mensajes enviados.
Tareas relacionadas:
“Cómo denegar el acceso a la lista de mensajes enviados”
“Cómo habilitar la restricción a la lista de mensajes enviados” en la página 122
Cómo denegar el acceso a la lista de mensajes enviados
Si restringe el acceso a la lista de mensajes enviados, debe denegar específicamente
acceso a los usuarios que no deben acceder a la lista.
Acerca de esta tarea
Los usuarios acceden a la lista de mensajes enviados pulsando el enlace Correos
de eMessage en el menú Campaña. Puede evitar que un usuario acceda a la lista
de todos los mensajes enviados, asignando al usuario un rol administrativo de
nivel alto, que deniega explícitamente permiso para ver el enlace Correos de
eMessage.
Capítulo 10. Gestión del acceso de usuario a las funciones de mensajería
121
Los roles predeterminados de nivel alto incluyen Admin, Ejecutar, Diseñar y
Revisar. Los permisos que otorgue a través de los roles de nivel alto, se aplican a
todos los objetos en la partición. Puede crear roles de nivel alto nuevos para
complementar los roles de nivel alto predeterminados. Los roles nuevos pueden
otorgar o denegar permisos específicos.
Procedimiento
1. Vaya a Valores > Permisos y roles de usuario > Campaña > partición (n). Se
abrirá la página partición <n>.
2. Pulse Añadir rol. Asigne un nombre al rol y especifique una breve descripción.
Guarde los cambios y vuelva a la página partición <n>.
3. Configure el rol nuevo para denegar acceso a la lista de correos enviados.
a. Pulse Añadir roles y asignar permisos. Se abrirá la página Propiedades
para roles administrativos. El rol nuevo se muestra en la lista de roles.
b. Pulse Guardar y editar permisos. Se muestra una lista de permisos para la
partición como una matriz de iconos de selección que indican el estado de
los permisos para cada rol. El nuevo rol se muestra junto al resto de roles
de nivel alto, en la parte superior de la matriz.
c. En la sección Administración, deniegue explícitamente el permiso Ver
página de la lista de correos enviados para el nuevo rol. Guarde los
cambios.
4. Asigne el nuevo rol a los usuarios que no quiere que accedan a la página de la
lista de correos enviados.
a. Vaya a Valores > Usuarios. Seleccione el usuario que no quiere que acceda
a la lista de mensajes enviados.
b. Pulse Editar roles.El nuevo rol creado en la paso anterior (un rol
configurado para denegar acceso), aparece en la lista de Roles disponibles.
c. Mueva el rol nuevo de Roles disponibles a Roles. Guarde los cambios.
Resultados
Cuando habilita restricciones de acceso para la lista de mensajes enviados, un
usuario que tiene asignado el rol nuevo no podrá ver el enlace Correos de
eMessage.
Qué hacer a continuación
Actualice la configuración para habilitar restricciones de acceso para la lista de
mensajes enviados.
Tareas relacionadas:
“Cómo otorgar el acceso a la lista de mensajes enviados” en la página 121
“Cómo habilitar la restricción a la lista de mensajes enviados”
Cómo habilitar la restricción a la lista de mensajes enviados
Los usuarios acceden a la lista de mensajes enviados a través de la opción Correos
de eMessage en el menú Campaña. Si restringe el acceso a la lista de mensajes
enviados, la propiedad ID de función de seguridad, controlará la visualización de
esta opción de menú y, por lo tanto, controlará el acceso a la lista de mensajes
enviados.
122
IBM eMessage: Guía del administrador y de inicio
Acerca de esta tarea
Para restringir el acceso a la lista de mensajes enviados, debe actualizar la
propiedad ID de función de seguridad en la configuración de Marketing Platform.
Esta propiedad se aplica a todas las particiones de la instalación de Campaign.
Al rellenar el ID de función de seguridad con el valor correcto, la opción Correos
de eMessage, estará disponible sólo para aquellos usuarios con un rol que otorga
explícitamente el permiso Ver página de la lista de envío de correos. Los usuarios
con roles donde el permiso Ver página de la lista de envío de correos está
denegado o no otorgado, no pueden ver la opción Correos de eMessage.
Procedimiento
1. Vaya a Valores > Configuración > Plataforma > Navegación de toda la
plataforma > Menú Navegación principal > Campaña > Correos de eMessage.
Pulse Correos de eMessage para visualizar los valores de configuración.
2. Pulse en Editar configuración.
3. En el campo ID de función de seguridad, especifique 7000. Guarde los
cambios.
Para ver los resultados del cambio de la configuración, cierre la sesión del
sistema e inicie sesión de nuevo.
Resultados
Sólo los usuarios con roles que otorguen explícitamente el permiso Ver página de
la lista de envío de correos, pueden ver el enlace Correos de eMessage para
acceder a la lista de mensajes enviados.
Tareas relacionadas:
“Cómo otorgar el acceso a la lista de mensajes enviados” en la página 121
“Cómo denegar el acceso a la lista de mensajes enviados” en la página 121
Permisos para informes de eMessage
Los permisos de usuario determinan la capacidad para visualizar informes de
eMessage.
Para obtener información sobre cómo establecer permisos para acceder a informes
estándar de eMessage, consulte la sección sobre la creación de informes y la
seguridad de la publicación IBM EMM Reports Guía de instalación y configuración.
Capítulo 10. Gestión del acceso de usuario a las funciones de mensajería
123
124
IBM eMessage: Guía del administrador y de inicio
Antes de ponerse en contacto con el soporte técnico de IBM
Si encuentra un problema que no puede resolver consultando la documentación, la
persona responsable del contacto con el servicio de soporte técnico puede registrar
una llamada con el soporte técnico de IBM. Siga estas directrices para asegurarse
de que se resuelva el problema de forma eficaz y satisfactoriamente.
Si usted no es una de las personas responsables del contacto con el servicio de
soporte técnico en su empresa, póngase en contacto con su administrador de IBM
para obtener información.
Información a recopilar
Antes de ponerse en contacto con el soporte técnico de IBM, recopile la
información siguiente:
v Una breve descripción de la naturaleza del problema.
v Los mensajes de error detallados que ve cuando se produce el problema.
v Pasos detallados para reproducir el problema.
v Los archivos de registro, archivos de sesión, archivos de configuración y archivos
de datos relacionados.
v Información sobre el producto y el sistema de entorno, los cuales puede obtener
tal como se describe en "Información del sistema".
Información del sistema
Cuando llame al soporte técnico de IBM, es posible que se le pida información
sobre su entorno.
Si su problema no le impide iniciar sesión, gran parte de esta información está
disponible en la página Acerca de, que proporciona información acerca de las
aplicaciones de IBM instaladas.
Puede acceder a la página Acerca de seleccionando Ayuda > Acerca de. Si la
página Acerca de no es accesible, compruebe el archivo version.txt ubicado en el
directorio de instalación de su aplicación.
Información de contacto para el soporte técnico de IBM
Para conocer las formas de contacto con el soporte técnico de IBM, consulte el sitio
web del soporte técnico del producto IBM: (http://www.ibm.com/support/entry/
portal/open_service_request).
Nota: Para introducir una solicitud de soporte, debe iniciar sesión con una cuenta
de IBM. Esta cuenta debe estar asociada con su número de cliente de IBM. Para
obtener más información sobre cómo asociar su cuenta con su número de cliente
de IBM, consulte Recursos de soporte > Soporte autorizado de software en el
portal de soporte.
© Copyright IBM Corp. 1999, 2015
125
126
IBM eMessage: Guía del administrador y de inicio
Avisos
Esta información se ha escrito para productos y servicios ofrecidos en Estados
Unidos.
Es posible que IBM no ofrezca en otros países los productos, servicios o
características que se describen en este documento. Consulte al representante de
IBM de su localidad para obtener información acerca de los productos y servicios
que actualmente están disponibles en su localidad. Cualquier referencia a un
producto, programa o servicio de IBM no pretende establecer ni implicar que sólo
se pueda utilizar dicho producto, programa o servicio de IBM. Puede utilizarse en
su lugar cualquier producto, programa o servicio funcionalmente equivalente que
no infrinja ningún derecho de propiedad intelectual de IBM. No obstante, queda
bajo la responsabilidad del usuario evaluar y verificar el funcionamiento de
cualquier producto, programa o servicio que no sea de IBM.
IBM puede tener patentes o solicitudes de patente pendientes que afecten a los
temas tratados en este documento. La posesión de este documento no le otorga
ninguna licencia sobre dichas patentes. Puede realizar consultas sobre licencias, por
escrito, a:
IBM Director of Licensing IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
EE. UU.
Para consultas sobre licencias relacionadas con información de doble byte (DBCS),
póngase en contacto con el departamento de propiedad intelectual de IBM de su
país o envíe sus consultas, por escrito, a:
Intellectual Property Licensing Legal and Intellectual Property Law
IBM Japan, Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japón
El párrafo siguiente no se aplica en el Reino Unido ni en ningún otro país en el
que tales disposiciones sean incompatibles con la legislación local:
INTERNATIONAL BUSINESS MACHINES CORPORATION INTERNATIONAL
BUSINESS MACHINES CORPORATION SUMINISTRA ESTA PUBLICACIÓN TAL
CUAL, SIN GARANTÍA DE NINGUNA CLASE, YA SEA EXPLÍCITA O
IMPLÍCITA, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LAS GARANTÍAS O
CONDICIONES IMPLÍCITAS DE NO VULNERACIÓN, DE
COMERCIALIZACIÓN O IDONEIDAD PARA UN PROPÓSITO DETERMINADO.
Algunas legislaciones no contemplan la declaración de limitación de
responsabilidad, ni implícitas ni explícitas, en determinadas transacciones, por lo
que cabe la posibilidad de que esta declaración no se aplique en su caso.
Esta información puede contener imprecisiones técnicas o errores tipográficos.
Periódicamente, se efectúan cambios en la información incluida en este documento;
estos cambios se incorporarán en nuevas ediciones de la publicación. IBM puede
efectuar mejoras y/o cambios en los productos y/o programas descritos en esta
publicación en cualquier momento y sin previo aviso.
© Copyright IBM Corp. 1999, 2015
127
Las referencias contenidas en esta información a sitios web que no son de IBM se
proporcionan para su comodidad y de ningún modo son una recomendación de
dichos sitios web. Los materiales de dichos sitios web no forman parte de los
materiales para este producto de IBM y el uso de dichos sitios web corre a cuenta
y riesgo del Cliente.
IBM puede utilizar o distribuir cualquier información que se le proporcione en la
forma que considere adecuada, sin incurrir por ello en ninguna obligación para con
el remitente.
Los titulares de licencias de este programa que deseen tener información sobre el
programa con el fin de permitir: (i) el intercambio de información entre programas
creados independientemente y otros programas (incluido éste) y (ii) el uso mutuo
de información que se haya intercambiado, deben ponerse en contacto con:
IBM Corporation
170 Tracer Lane
Waltham, MA 02451
EE. UU.
Dicha información puede estar disponible, sujeta a los términos y condiciones
correspondientes, incluyendo, en algunos casos, el pago de una tarifa.
El programa bajo licencia que se describe en este documento y todo el material
bajo licencia que se encuentra disponible para el programa se proporcionan de
acuerdo con los términos del Acuerdo del Cliente de IBM, el Acuerdo Internacional
de Licencia de Programas de IBM o cualquier acuerdo equivalente entre IBM y el
Cliente.
Los datos de rendimiento incluidos en este documento se han obtenido en un
entorno controlado. Por lo tanto, los resultados obtenidos en otros entornos
operativos podrían variar de manera significativa. Es posible que algunas medidas
se hayan desarrollado con sistemas en nivel de desarrollo y no hay garantía de que
estas medidas sean las mismas en sistemas con disponibilidad general. Además, es
posible que algunas mediciones se hayan realizado por extrapolación. Los
resultados reales pueden variar. Los usuarios de este documento deben verificar
los datos aplicables a su entorno específico.
La información relacionada con productos que no son de IBM se ha obtenido de
los proveedores de dichos productos de sus anuncios publicados o de otras fuentes
de disponibilidad pública. IBM no ha probado esos productos y no puede
confirmar la precisión del rendimiento, la compatibilidad ni ninguna otra
afirmación relacionada con productos que no son de IBM. Las preguntas sobre las
prestaciones de los productos que no son de IBM deberán dirigirse a los
proveedores de dichos productos.
Todas las declaraciones sobre la dirección o el propósito futuro de IBM están
sujetas a cambios o retirada sin previo aviso, y sólo representan metas y objetivos.
Todos los precios de IBM que se muestran son precios actuales de venta al por
menor sugeridos por IBM y están sujetos a modificaciones sin previo aviso. Los
precios de los distribuidores pueden variar.
Esta información contiene ejemplos de datos e informes utilizados en el
funcionamiento diario de las empresas. Para ilustrar estas operaciones de la forma
más completa posible, los ejemplos incluyen nombres de personas, compañías,
128
IBM eMessage: Guía del administrador y de inicio
marcas y productos. Todos estos nombres son ficticios y cualquier similitud con los
nombres y las direcciones utilizados por una empresa real es pura coincidencia.
LICENCIA DE COPYRIGHT:
Esta información contiene programas de aplicación de muestra en lenguaje fuente,
que ilustran las técnicas de programación en distintos plataformas operativas.
Puede copiar, modificar y distribuir estos programas de ejemplo de cualquier
forma sin incurrir en pago alguno a IBM para fines de desarrollo, utilización,
comercialización o distribución de programas de aplicación destinados a la interfaz
de programación de aplicaciones para la plataforma operativa para la que se han
escrito los programas de ejemplo. Estos ejemplos no se han probado de forma
exhaustiva en todas las condiciones. En consecuencia, IBM no puede garantizar ni
afirmar la fiabilidad, utilidad o funcionalidad de estos programas. Los programas
de ejemplo se proporciona TAL CUAL sin garantía de ningún tipo. IBM no se
responsabiliza de ningún daño resultante de la utilización de los programas de
ejemplo.
Si consulta esta documentación en soporte software, puede que no aparezcan las
fotografías e ilustraciones en color.
Marcas registradas
IBM, el logotipo de IBM e ibm.com son marcas registradas o marcas comerciales
registradas de International Business Machines Corp., en muchas jurisdicciones de
todo el mundo. Otros nombres de productos y servicios pueden ser marcas
registradas de IBM o de otras empresas. Encontrará la lista actual de las marcas
comerciales de IBM en el sitio web "Copyright and trademark information" en la
dirección www.ibm.com/legal/copytrade.shtml.
Consideraciones sobre la política de privacidad y los términos de uso
Los productos de software de IBM, incluido el software como soluciones de
servicio ("Ofertas de software"), pueden utilizar cookies u otras tecnologías con el
fin de recopilar información de uso de un producto, ayudar a mejorar la
experiencia del usuario final, personalizar las interacciones con el usuario final o
con otros fines. Una cookie es un elemento de datos que un sitio web puede enviar
al navegador, que a continuación se puede almacenar en el sistema como una
etiqueta que identifica el sistema. En muchos casos, estas cookies no recopilan
información personal. Si una Oferta de software que utiliza le permite recopilar
información personal mediante cookies y tecnologías similares, le informamos
sobre los detalles a continuación.
Dependiendo de las configuraciones desplegadas, esta Oferta de software puede
utilizar cookies de sesión y persistentes que recopilen el nombre de cada usuario y
otra información personal para fines de gestión de sesiones, utilización de usuario
mejorada u otros fines funcionales o de seguimiento de uso. Estas cookies pueden
inhabilitarse, pero si se inhabilitan también se eliminará la funcionalidad que
habilitan.
Distintas jurisdicciones regulan la recopilación de información personal mediante
cookies y tecnologías similares. Si las configuraciones desplegadas para esta Oferta
de software le proporcionan como cliente la capacidad de recopilar información
personal de los usuarios finales mediante cookies y otras tecnologías, debe buscar
Avisos
129
asesoramiento legal sobre la legislación aplicable para la recopilación de dicha
información, incluidos los requisitos para proporcionar el aviso y consentimiento
donde corresponda.
IBM requiere que los Clientes (1) proporcionen un enlace claro y visible a los
términos de uso del sitio web del Cliente (por ej., política de privacidad) que
incluya un enlace a las prácticas de uso y recopilación de datos de IBM y del
Cliente, (2) notifiquen que IBM coloca, en nombre del cliente, cookies y balizas
web/gifs transparentes en el sistema del visitante, junto con una explicación de la
finalidad de dicha tecnología, y (3) en la medida requerida por ley, obtengan el
consentimiento de los visitantes del sitio web antes de la colocación de cookies y
balizas web/gifs por parte del Cliente o en nombre del Cliente, en dispositivos del
visitante del sitio web.
Para obtener más información sobre el uso de diversas tecnologías, tales como
cookies, para estos fines, consulte la Declaración de privacidad en línea de IBM en
la sección "Cookies, Web Beacons and Other Technologies", que encontrará en
http://www.ibm.com/privacy/details/us/en.
130
IBM eMessage: Guía del administrador y de inicio
Impreso en España