campaign 缩写_使用Configuration Manager增强IBM Campaign和IBM Marketing Cloud的集成-优快云博客

本文介绍了一种增强的集成解决方案，旨在简化IBMCampaign与IBMMarketingCloud之间的数据交换，尤其强调了自动上传联系人数据到Engage的功能。通过使用基于Web的工具，营销人员可以轻松管理上传配置，验证数据一致性，并触发邮件发送。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

总览

IBM Campaign与IBM Marketing Cloud的集成（也称为IBM Silverpop Engage）为数字营销人员提供了个性化和跟踪每个客户交互，通过多种渠道进行交流以及保护敏感个人数据的能力。

Campaign与Engage解决方案集的基本集成基于一整套可下载的脚本。这些脚本配置为可以在Campaign和Engage之间安全，自动地交换细分，联系和跟踪数据。您可以从命令行运行数据上载和下载脚本，也可以通过将脚本添加到Campaign流程图中来自动执行数据交换。有关更多详细信息，请下载基础集成指南，该指南在参考资料部分中链接到。

使用Campaign流程图和存储的触发器通过这些脚本自动将数据从Campaign上载到Engage涉及一系列过程，这些过程可能对营销人员来说很难实施。例如，用户需要指定几个ID来标识联系人列表，父数据库，邮件模板和邮件收件人列表。要确定这些ID，用户必须登录到Engage，转到相应的部分，然后搜索相应的项目。

用于IBM Campaign和IBM Marketing Cloud的增强集成的配置管理器是使用基本集成脚本的基于Web的应用程序工具。该工具提供了一个界面，可轻松管理和简化Campaign细分和联系人数据到Engage数据库和联系人列表的上传。

增强的集成通过Java™EE应用程序提供了新的Web用户界面，使数字营销人员能够通过易于创建和编辑的上传配置快速运行数据上传。这些配置由一组人类可读的设置组成，这些设置在运行时会解释为将联系人数据从Campaign上载到Engage。（可选）可以将设置配置为请求Silverpop服务器将电子邮件发送到特定的收件人列表。

请访问Silvia Bellucci（silviabellucci@it.ibm.com）或Alice Guidotti（alice.guidotti@it.ibm.com），以请求增强的集成包。

图1.概述

提供的解决方案使用Python，Java和JavaScript™开发，增强了IBM Campaign和IBM Marketing Cloud的基础集成。增强的集成使用基本集成的命令行脚本，并使用Web 2.0技术通过直观的用户界面改善了用户体验。

使用增强集成的基于Web的工具，用户可以：

创建，查看，更新，复制或删除上传配置。
针对Silverpop Engage中的数据验证配置。
在Silverpop Engage中创建和查看联系人列表。
使用自动创建的触发器轻松将Campaign数据上传到Engage。

建筑

用于IBM Campaign和IBM Silverpop Engage的增强集成的配置管理器基于两个定制软件组件：一个Java EE Web应用程序，它提供了用于管理上载配置的新的基于Web的用户界面，以及一组Python脚本，它们为将联系人数据上传到Engage服务器。

该Web应用程序包含一个Web归档模块（WAR），该模块必须部署到安装了IBM Campaign的Java EE服务器上。该环境是托管Campaign Analytics服务器的本地环境。增强的集成管理器可在IBMWebSphere®Application Server上的IBM Campaign和UNIX®，Linux®和Windows系统上的Oracle WebLogic Server上安装。

Python脚本实现了上载引擎，并调用了基础集成的脚本。这些脚本安装在与安装基本集成解决方案相同的本地Campaign环境中。

图2.架构图

用户手册

从控制台，用户可以创建，删除或修改用于将联系人从Campaign上传到Silverpop的配置。用户还可以创建新的联系人列表，而无需在线访问Silverpop控制台。

为了简化用户体验，可以使用定制的Portlet或仪表板将此应用程序提供的Web控制台包含在IBM Campaign界面中。这样，可以在IBM Campaign UI中轻松找到在本地执行的所有操作。用户必须使用其个人IBM Marketing Cloud帐户登录才能在IBM Campaign中查看其Silverpop联系人列表。

创建配置后，用户可以按照与基本集成指南中所述类似的说明进行操作，以自动将数据从Campaign上载到Engage。它是一组过程，涉及包含邮件列表过程和流程图触发器的流程图。基本上，用户在Campaign 流程图中添加一个Mail List流程 ，以将上游流程图流程的输出组合成一个制表符分隔的文件 ，该文件可以上传到Engage。新的增强集成功能创建了触发器和制表符分隔的文件，只有在配置了用于联系人上传的邮件列表过程时，才需要选择该触发器和制表符分隔的文件。

以下各节提供有关Web应用程序控制台功能的更多详细信息。

管理上传配置

登录到Web应用程序
图3.登录UI

默认情况下，可以在Campaign服务器的地址上访问Web配置工具。例如，使用安全的HTTPS连接进行访问：
https：// <活动服务器>：<端口> /SilverpopIntegrationConsole/login.xhtml

要访问Web应用程序控制台，必须使用任何标准Silverpop用户的凭据进行身份验证（服务器需要访问Internet）。

您可以使用您的个人Silverpop帐户。您不需要了解或使用为运行脚本（ contactUpload.bat ）而配置的凭据，这些脚本是在安装基本集成文件（即Integration User）时设置的。
查看Silverpop中的联系人列表
图4.联系人列表UI

您可以通过浏览“联系人列表”选项卡中的文件夹结构直接查看Silverpop中所有现有的共享联系人列表，而无需登录到Silverpop控制台。
在Silverpop中创建新的联系人列表
图5.创建一个新的联系人列表

您也可以通过单击“联系人列表”选项卡上的“ 创建联系人列表”来创建新的联系人列表，而无需离开Web配置工具。

注意。该工具未提供标准Silverpop控制台的所有联系人列表管理功能。特别是：
- 联系人列表是在根文件夹中创建的，并且
- 不支持删除联系人列表。
查看现有的上传配置
图6.查看现有配置

在“配置”选项卡上，您可以轻松查看所有可用上传配置的设置。

配置包含一组易于阅读的设置，可在运行时使用这些设置将联系人数据从Campaign上载到Engage。（可选）可以将设置配置为请求Silverpop服务器将电子邮件发送到特定的收件人列表。
管理配置：创建，更新，删除
图7.管理配置：创建，更新，删除

您可以轻松地创建，更新，复制和删除配置。

通过单击“ 创建配置” ，将打开一个工具并指导您选择数据库，联系人列表，上载选项，以及可选的邮件模板和收件人列表。
验证现有配置
图8.验证现有配置

通过单击“ 验证配置” ，您可以验证已保存的配置列表，以验证与当前在Silverpop中注册的数据是否存在任何不一致。

验证消息使无需运行配置即可轻松检测异常。这样，您就可以在运行时预测问题并快速应用必要的更改。
在IBM Campaign内的定制portlet和仪表板中显示Web控制台
图9.在IBM Campaign中显示仪表板

图10.在IBM Campaign中管理Portlet

图11.在IBM Campaign中编辑定制portlet

（可选）您可以轻松配置市场营销平台门户网站（广告系列），以在Engage控制台旁边显示Web应用程序工具的内容。例如，可以使用自定义portlet在单独的仪表板中显示内容。要访问这两个应用程序，您需要进行两次身份验证（不支持单点登录）。

自动将数据从Campaign上载到Engage

将联系人数据从Campaign上载到Engage（可以选择在上传后触发Engage邮件），需要进行类似IBM Campaign和IBM Silverpop Engage集成指南（即基本集成）中所述的准备工作和流程图配置。请参阅集成指南以获取更多信息。

特别是，在Campaign流程图中，您可以添加一个Mail List流程，以将上游流程图流程的输出组合成一个制表符分隔的文件，该文件可以上传到Engage。为了支持将数据自动上传到Engage，“邮件列表”过程与存储的流程图触发器一起使用。

主要区别在于引入了使用Web应用程序工具创建的配置。使用Web配置工具，从Campaign上载数据时，无需在contactUpload脚本中查找并指定联系人列表，数据库和邮件模板ID作为参数。

该Web应用程序工具还创建一个存储的触发器和一个空的制表符分隔文件，可以从它们的名称（文件名以配置名称开头）中轻松识别。这样，必须通过选择适当的制表符分隔的文件和适当的触发器来配置邮件列表过程。

图12.自动上传过程

图13.邮件流程配置

图14.选择输出文件

图15.存储的触发器定义

安装说明

先决条件
在使用增强集成解决方案之前，您必须完成以下活动：
1. IBM Marketing Cloud：需要一个Silverpop帐户才能登录并建立对Engage中组织的访问权限。
2. IBM Campaign：在本地计算环境中安装和配置IBM Campaign （Campaign要求您还安装和配置IBM Marketing Platform）。请参阅《 IBM Campaign安装指南》。
3. IBM Campaign与IBM Marketing Cloud的集成：在下载集成包之后，请按照《集成指南》中的指示进行安装和配置基本集成解决方案。基本集成的1.2版是先决条件。
要下载基础集成软件包，请转至IBMdeveloperWorks®上的Campaign Silverpop集成页面。
安装整合套件
Campaign与Engage的增强集成取决于您在安装Campaign的环境中安装的文件集合和WAR模块。必须使用以下软件包来完成集成解决方案的设置：
- SilverpopIntegrationConsole.war ：Java EE Web存档应用程序
- SilverpopIntegrationExt.zip ：适用于Windows，UNIX或Linux的脚本和配置文件
所有安装和配置任务均在安装了“基本”集成解决方案的本地Campaign环境中完成。该环境在安装了托管Campaign Analytics服务器的（WebSphere）Application Server的本地计算机上。
安装集成脚本和配置文件
在Campaign Analytics服务器上执行以下简单步骤：
1. 将压缩的存档解压缩到下面的文件夹中
  ../Campaign/partition/partition1/
  安装文件的文件夹（例如campspext ）被视为<CS_EXT_HOME>目录。
2. 在<CS_EXT_HOME> ，验证并设置conf目录中configExt.properties文件中定义的属性。根据文件中的注释指示，提供的所有默认值可能都是合适的。
3. 在<CS_EXT_HOME>配置contactUploadExt.bat在Windows或contactUploadExt.sh在或UNIX / Linux的bin目录。唯一的要求是将CS_HOME变量设置为Campaign and Engage集成文件夹（基本集成）的路径。
设置Java属性CS_EXT_HOME
在WebSphere Application Server上：
1. 登录到Campaign Analytics服务器的WebSphere Application Server的管理控制台（例如， https://unicavmdemo:9060/ibm/console ）。
2. 添加Java系统属性CS_EXT_HOME 。 转到服务器>服务器类型> WebSphere应用程序服务器> server1 ，然后在服务器基础结构下转到Java和进程管理>进程定义> Java虚拟机>定制属性（在附加属性下）。选择新建...，然后设置属性CS_EXT_HOME ，该属性指定在Campaign Analytics服务器上安装脚本文件的绝对路径。
3. 单击“ 确定”后 ，将更改保存到主配置。
在WebLogic应用程序服务器上：
1. 找到文件startWeLogic.cmd在Windows系统或startWeLogic.sh在Linux系统上，并打开它进行编辑。
2. 将Java系统属性CS_EXT_HOME添加到JAVA_OPTIONS 。 设置属性CS_EXT_HOME指定在Campaign Analytics服务器上安装脚本文件的绝对路径：
  将-DCS_EXT_HOME=<your_cs_ext_home_fullpath>追加到set JAVA_OPTIONS=命令行中。
3. 保存文件。
安装Silverpop SSL证书Strong >
在WebSphere Application Server上：
1. 如果尚未登录，请登录到Campaign Analytics服务器的WebSphere Application Server的管理控制台（例如， https://unicavmdemo:9060/ibm/console ）。
2. 在WebSphere信任库中安装Silverpop证书。转到安全性> SSL证书和密钥管理>密钥库和证书> [NodeDefaultTrustStore]>签名者证书，选择从端口检索，输入以下信息，然后选择检索签名者信息： host1=api0.silverpop.com; port=443; alias=Silverpop host1=api0.silverpop.com; port=443; alias=Silverpop
  注意。给出的主机地址是默认的Silverpop地址。输入分配给您的Silverpop组织的pod的值。请咨询您的组织管理员以获取此值。
3. 按确定。
在WebLogic应用程序服务器上：
1. 通过使用Web浏览器从https://engage0.silverpop.com下载Silverpop SSL证书，手动将Silverpop证书添加到密钥库。
  注意。给出的URL是默认的Silverpop地址。输入分配给您的Silverpop组织的值。请咨询您的组织管理员以获取此值。
2. 将证书添加到WebLogic密钥库。有关更多信息，请参见WebLogic文档。
3. 通过查找文件禁用主机名验证startWeLogic.cmd在Windows系统或startWeLogic.sh在Linux系统上，并打开它进行编辑。
4. 以与CS_EXT_HOME变量类似的方式，将-Dweblogic.security.SSL.ignoreHostnameVerification=true附加到JAVA_OPTIONS 。
5. 保存文件。
在应用程序服务器上部署Web应用程序
在WebSphere Application Server上：
1. 如果尚未登录，请登录到WebSphere管理控制台（例如， https://unicavmdemo:9060/ibm/console ）。
2. 部署Web应用程序。 转到应用程序>应用程序类型> WebSphere企业应用程序，选择“安装”，然后继续执行安装Web应用程序的步骤。将SilverpopIntegrationConsole.war指定为要上传和安装的WAR模块。
3. 由于需要重新启动Campaign Analytics服务器才能使所有先前的更改生效，因此请立即重新启动WebSphere Application Server。
在WebLogic应用程序服务器上：
1. 如果尚未登录，请登录到WebLogic管理控制台（例如， http://unicavmdemo:7001/console/login ）。
2. 部署Web应用程序。 转到部署，选择安装，然后继续执行安装Web应用程序的步骤。将SilverpopIntegrationConsole.war指定为要上传和安装的WAR模块。
3. 重新启动WebLogic应用程序服务器，以确保传播更改。

故障排除

启用WebSphere日志消息。 登录到Campaign Analytics服务器的WebSphere Application Server的管理控制台（例如， https://unicavmdemo:9060/ibm/console ）。转到故障排除>日志和跟踪> server1>诊断跟踪服务>更改日志详细信息级别并指定以下日志详细信息级别： *=info: SSL_*=all 。

调试触发器行为。 该触发器由Web应用程序工具自动创建，它使用新的命令行（ contactUploadExt ），该命令行在基本集成所使用的命令行方面得到了简化。在测试和故障排除期间，手动运行contactUploadExt脚本可能会很有用。将触发器定义复制到Campaign Analytics服务器上的命令行，然后检查其输出。

通过使用命令行调试触发器。 新的命令脚本contactUploadExt仅支持两个主要参数和必需参数（不支持映射文件）。

关于contactUploadExt的手册

2016-07-15 05:47:04,073 INFO  Running contactUploadExt...

contactUploadExt.bat/sh

Purpose: Use contactUploadExt to upload a tab-separated file that contains
         contact and segmentation data from tables in IBM Campaign to databases
         and contact lists in IBM Silverpop Engage. The command matches fields
         in Campaign to corresponding fields in Engage and uses configuration
         settings grouped and managed together through the web application of
         of the Campaign Integrated Console for Silverpop.

Usage:
contactUploadExt -i <inputFile> -n <configDataName> [-c <configPropertiesFile> -s <spPropertiesFile> -j <jdbcPropertiesFile>]

  -i | --inputFile             Tab-separated file from Campaign.
  -n | --configDataName        Name for a saved configuration that specifies:

          --listID             Name for Engage database that receives the data.
          --contactListIDs     Names for one or more contact lists in Engage.
          --importType         By default, the import adds and updates records
                               (specify OPT_OUT to upload only opt-out records).
          --mailingTemplateID  Send mailing after upload. Specify template name.
          --recipientListID    Contact list name for list of mailing recipients.
          --removeContactData  Remove existing data from contact list,
                               replace with data from input file.

  The following options are passed to and processed by contactUpload.bat/sh:
  -c | --configPropertiesFile  Absolute or relative path to config.properties.
  -s | --spPropertiesFile      Absolute or relative path to sp.properties.
  -j | --jdbcPropertiesFile    Absolute or relative path to jdbc.properties.

  Using an appropriate configuration you can:
    - Upload to an Engage database
    - Upload to a single contact list
    - Upload to multiple contact lists
    - Upload to contact list(s) and trigger a mailing to a single contact list

Examples:

  Upload to Engage and optionally trigger mailing using data in a configuration
    contactUploadExt.bat/sh -i <inputFile> -n <configDataName>
    <CS_EXT_HOME>\bin\contactUploadExt.bat -i C:\IBM\Campaign\partitions\partition1\CSint\Uploads\FC_out.tsv -n "Premium teams"

  Upload to an Engage, renamed properties file in a new location
    contactUploadExt.bat/sh -i <inputFile> -n <configDataName> -s <spPropertiesFile>
    <CS_EXT_HOME>\bin\contactUploadExt.bat -i C:\IBM\Campaign\partitions\partition1\CSint\Uploads\FC_out.tsv -n "All employees" -s C:\IBM\Campaign\partitions\partition1\CSint\CS_admin\SPaccessProps.properties

NOTE: A mapping file (.xml) defines the mapping between fields in the input
   file and fields in the Engage database. The file specifies also the database
   ID, and optionally, the contact list ID and import type (OPT_OUT). For this
   reason, if you want to specify a custom mapping file (-m) not use this
   script but use the standard script <CS_HOME>\bin\contactUpload.bat.

contactUploadExt必需参数

contactUploadExt -i <inputFile> -n <onfigDataName>

     -i | --inputFile             Tab-separated file from Campaign.
     -n | --configDataName        Name for a saved configuration

选项	contactUpload （增强集成）	contactUploadExt （增强集成）
-一世	（必需）制表符分隔的文件的路径，其中包含要上载到Engage的值的列表。	必需的选项（与contactUpload中的含义相同）。
-n	不支持。	用于标识配置的名称（保留在JSON文件中）。
-l	接收上载值的Engage数据库的ID（必填）。指定“参与”界面中定义的ID。	您可以在配置中指定数据库ID。
-米	文件（.xml）的绝对或相对路径，该文件定义输入文件中的字段与Engage数据库中的字段之间的映射。	不支持。
-t	如果未指定任何值，则系统将使用输入文件（-i）中的数据添加和更新指定的Engage数据库中的记录。所有输入值均被视为选择加入触点。如果指定（-t OPT_OUT），则将与现有记录匹配的上载记录添加为“选择退出”联系人。	您可以在配置中指定导入类型。
-p	用于将联系人数据上传到“参与”中定义的一个或多个联系人列表。指定您要上传到的联系人列表的ID。通过提供联系人列表ID的逗号分隔列表（无空格），将其上传到多个列表。	您可以在配置中指定联系人列表ID。
-e	指定后，在将分段数据上传并添加到使用（-l）选项指定的数据库后，Engage将发送邮件。输入定义邮件配置的模板的邮件模板ID。模板必须指定与使用（-p）选项或（-m）选项指定的联系人列表相同的联系人列表。将数据上传到多个联系人列表时，请使用（-g）选项标识邮件收件人列表。	您可以在配置中指定邮件模板ID。
-G	将值上载到多个联系人列表并发送电子邮件（-e）时使用。指定用于定义单个邮件收件人列表的联系人列表的ID。	您可以在配置中指定邮件收件人ID。
-r	指定后，系统将删除联系人列表中的值，并将其替换为上载的制表符分隔文件中包含的值。	您在配置中指定此选项。
-c，-s，-i	这些文件被重命名或不在默认位置时，用于指定三个不同属性文件的路径的选项（有关详细信息，请参见文档）。	受支持（这些属性未使用，但在调用时传递给contactUpload脚本）。

结论

总之，用于IBM Campaign和IBM Marketing Cloud增强集成的配置管理器是一个有用的图形工具，支持将联系人数据从IBM Campaign自动上载到IBM Marketing Cloud。

因为可以使用自定义Portlet和仪表板配置IBM Campaign的Marketing Platform门户，所以可以从门户本身内部提供新功能，从而改善了用户体验。

翻译自: https://www.ibm.com/developerworks/commerce/library/co-integrate-campaign/index.html

campaign 缩写_使用Configuration Manager增强IBM Campaign和IBM Marketing Cloud的集成

总览

图1.概述

建筑

图2.架构图

用户手册

管理上传配置

图3.登录UI

图4.联系人列表UI

图5.创建一个新的联系人列表

图6.查看现有配置

图7.管理配置：创建，更新，删除

图8.验证现有配置

图9.在IBM Campaign中显示仪表板

图10.在IBM Campaign中管理Portlet

图11.在IBM Campaign中编辑定制portlet