与Adobe Campaign Classic集成

注意

本文档介绍如何将AEM与内部部署解决方案Adobe Campaign Classic集成。 如果您使用的是Adobe Campaign Standard,请参阅与Adobe Campaign Standard集成以获取这些说明。

Adobe Campaign允许您直接在Adobe Experience Manager中管理电子邮件投放内容和表单。

要同时使用两个解决方案,您必须首先将它们配置为彼此连接。 这涉及在Adobe Campaign和Adobe Experience Manager中执行配置步骤。 本文档详细介绍了这些步骤。

在AEM中使用Adobe Campaign包括通过Adobe Campaign发送电子邮件的功能,有关该功能的介绍,请参阅使用Adobe Campaign。 它还包括在AEM页面上使用表单来处理数据。

此外,将AEM与Adobe Campaign集成时,可能会关注以下主题:

如果您要扩展与Adobe Campaign的集成,则可能希望看到以下页面:

AEM和Adobe Campaign集成工作流

本节介绍创建营销活动和投放内容时AEM和Adobe Campaign之间的典型工作流程。

典型的工作流涉及以下内容,并对其进行了详细描述:

  1. 开始构建您的营销活动(在Adobe Campaign和AEM中)。
  2. 在链接内容和交付之前,请先在AEM中个性化您的内容,并在Adobe Campaign中创建交付。
  3. 在Adobe Campaign中链接内容和交付。

开始构建营销活动

您可以随时开始构建营销活动。 在链接内容之前,AEM和AC是独立的。这意味着营销人员可以在Adobe Campaign中开始创建他们的营销活动和定位,而内容创建者则在AEM中处理设计。

在链接内容和投放之前

在链接内容并创建投放机制之前,您需要执行以下操作:

在AEM中

  • 使用​文本与个性化​组件中的个性化字段进行个性化

在 Adobe Campaign 中:

  • 创建类型​aemContent​的投放

链接内容并设置投放

准备好内容以进行链接和交付后,您可以准确确定链接内容的方式和位置。

所有这些步骤均在Adobe Campaign中完成。

  1. 指定要使用的AEM实例。
  2. 单击同步按钮以同步内容。
  3. 打开内容选取器以选取您的内容。

如果您是初次使用AEM

如果您是初次使用AEM,可能会发现以下链接有助于您了解AEM:

配置Adobe Campaign

配置Adobe Campaign涉及以下事项:

  1. 在Adobe Campaign中安装AEM集成包。
  2. 配置外部帐户。
  3. 验证AEMResourceTypeFilter是否正确配置。

此外,您还可以进行一些高级配置,包括:

  • 管理内容块
  • 管理个性化字段

请参阅高级配置

注意

要执行这些操作,您必须在Adobe Campaign中具有​administration​角色。

前提条件

请事先确保您具有以下元素:

注意

如果您运行的版本低于Adobe Campaign Classic内部版本8640,请参阅升级文档以了解更多信息。 请注意,必须将客户端和数据库都升级到同一内部版本。

注意

要使AEM与Adobe Campaign之间的集成功能正常工作,必须在配置Adobe Campaign配置Adobe Experience Manager部分中详细介绍的操作。

安装AEM集成包

必须在Adobe Campaign中安装​AEM Integration​包。 要执行此操作:

  1. 转到要与AEM链接的Adobe Campaign实例。

  2. 选择​工具 > 高级 > 导入包……

    chlimage_1-132

  3. 单击​安装标准包,然后选择​AEM Integration​包。

    chlimage_1-133

  4. 单击​Next,然后单击​Start

    此包包含​aemserver​运算符,该运算符将用于将AEM服务器连接到Adobe Campaign。

    注意

    默认情况下,不会为此运算符配置安全区域。 要通过AEM连接到Adobe Campaign,必须选择一个。

    在​serverConf.xml​文件中,必须将选定安全区域的​allowUserPassword​属性设置为​true,以授权AEM通过登录/密码连接Adobe Campaign。

    我们强烈建议创建一个专用于AEM的安全区,以避免出现任何安全问题。 有关更多信息,请参阅安装指南

    chlimage_1-134

配置AEM外部帐户

您必须配置一个外部帐户,以便将Adobe Campaign连接到AEM实例。

注意
  • 安装​AEM Integration​包时,会创建外部AEM帐户。 您可以通过该实例配置与AEM实例的连接,也可以创建一个新实例。
  • 在AEM中,确保为campaign-remote用户设置密码。 您需要设置此密码才能将Adobe Campaign与AEM连接。 以管理员身份登录,在用户管理控制台中,搜索campaign-remote用户,然后单击​设置密码

要配置外部AEM帐户,请执行以下操作:

  1. 转到​Administration > Platform > External Accounts​节点。

  2. 创建新的外部帐户并选择​AEM​类型。

  3. 输入AEM创作实例的访问参数:用于连接到此实例的服务器地址以及ID和密码。 campaign-api用户帐户密码与您在AEM中为设置密码的campaign-remote用户相同。

    注意

    确保服务器地址​​以尾随斜杠结尾。 例如,输入https://yourserver:4502,而不是https://yourserver:4502/

    chlimage_1-135 chlimage_1-136

  4. 确保选中​Enabled​复选框。

验证AEMResourceTypeFilter选项

AEMResourceTypeFilter​选项用于筛选可在Adobe Campaign中使用的AEM资源类型。 这允许Adobe Campaign检索专门设计为仅在Adobe Campaign中使用的AEM内容。

此选项应进行预配置;但是,如果更改此选项,可能会导致集成无法正常运行。

要验证​AEMResourceTypeFilter​选项的配置情况:

  1. 转到​Platform >Options

  2. 在​AEMResourceTypeFilter​选项中,检查路径是否正确。 此字段必须包含值:

    mcm/campaign/components/newsletter,mcm/campaign/components/campaign_newsletterpage,mcm/neolane/components/newsletter

    或者在某些情况下,该值如下所示:

    mcm/campaign/components/newsletter

    chlimage_1-137

配置Adobe Experience Manager

要配置AEM,您必须执行以下操作:

  • 配置实例之间的复制。
  • 通过AEM将Cloud Services连接到Adobe Campaign。
  • 配置外部器。

在AEM实例之间配置复制

首先,从AEM创作实例创建的内容会发送到发布实例。 您需要进行发布,以便新闻稿中的图像可在发布实例上和新闻稿的收件人获得。 因此,必须将复制代理配置为从AEM创作实例复制到AEM发布实例。

注意

如果您不想使用复制URL,而是使用面向公众的URL,则可以在OSGi的以下配置设置中设置​公共URL(AEM徽标 > 工具​图标> 操作 > Web控制台 > OSGi配置 促销活动 — 配置):
公共URL: com.day.cq.mcm.campaign.impl.IntegrationConfigImpl#aem.mcm.campaign.publicUrl

要将某些创作实例配置复制到发布实例中,还需要执行此步骤。

要在AEM实例之间配置复制,请执行以下操作:

  1. 在创作实例中,选择​AEM徽标> 工具​图标> 部署 > 复制 > 创作上的代理,然后单击​默认代理

    chlimage_1-138

    注意

    配置与Adobe Campaign的集成时,请避免使用localhost(AEM的本地副本),除非发布和创作实例都位于同一台计算机上。

  2. 点按或单击​编辑 ,然后选择​传输​选项卡。

  3. 通过将​localhost​替换为AEM发布实例的IP地址或地址来配置URI。

    chlimage_1-139

将AEM连接到Adobe Campaign

在将AEM和Adobe Campaign结合使用之前,您必须在两个解决方案之间建立链接,以便它们能够进行通信。

  1. 连接到AEM创作实例。

  2. 选择​AEM徽标 > 工具​图标> 部署 > Cloud Services,然后在Adobe Campaign部分中选择​立即配置

    chlimage_1-140

  3. 通过输入​标题​并单击​创建​创建新配置,或选择要与Adobe Campaign实例链接的现有配置。

  4. 编辑配置,使其与Adobe Campaign实例的参数匹配。

    • 用户名: aemserver,Adobe Campaign AEM集成包运算符,用于在两个解决方案之间建立链接。
    • 密码:Adobe Campaign aemserver操作员密码。您可能需要直接在Adobe Campaign中为此运算符重新指定密码。
    • API端点:Adobe Campaign实例URL。
  5. 选择​连接到Adobe Campaign​并单击​确定

    chlimage_1-141

    注意

    创建并发布电子邮件后,您需要将配置重新发布到发布实例。

    chlimage_1-142

注意

如果连接失败,请确保检查以下内容:

  • 使用到Adobe Campaign实例(https)的安全连接时,您可能会遇到证书问题。 您必须将Adobe Campaign实例证书添加到AEM实例JDK的​cacherts​文件中。
  • 必须在Adobe Campaign中为aemserver运算符配置安全区域。 此外,在​serverConf.xml​文件中,必须将安全区域的​allowUserPassword​属性设置为​true,以使用登录/密码模式授权AEM与Adobe Campaign的连接。

此外,请参阅对AEM/Adobe Campaign集成进行故障诊断

配置外部器

您需要在创作实例的AEM中配置外部器。 外部器是一种OSGi服务,它允许您将资源路径转换为外部URL和绝对URL。 此服务提供了一个配置和构建这些外部URL的中心位置。

有关常规说明,请参阅配置外部器。 对于Adobe Campaign集成,请确保在https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImpl配置发布服务器,其位置不是localhost:4503,而是指向Adobe Campaign控制台可访问的服务器。

如果指向localhost:4503或Adobe Campaign无法访问的其他服务器,则您的图像将不会显示在Adobe Campaign控制台上。

chlimage_1-143

高级配置

您还可以执行一些高级配置,即:

  • 管理个性化字段和块。
  • 停用个性化块。
  • 管理Target扩展数据。

管理个性化字段和块

用于在AEM中向电子邮件内容添加个性化的字段和块由Adobe Campaign管理。

提供了默认列表,但可以修改。 您还可以添加或隐藏个性化字段和块。

添加个性化字段

要向已有可用的个性化字段添加新个性化字段,您必须按如下方式扩展Adobe Campaign nms:seedMember​模式:

注意

您需要添加的字段必须已通过收件人模式扩展(nms:recipient)添加。 有关详细信息,请参阅Configuration指南。

  1. 在Adobe Campaign导航中,转到​Administration > Configuration > Data schemas​节点。

  2. 选择​新建

    chlimage_1-144

  3. 在弹出窗口中,选择​使用扩展架构扩展表中的数据,然后单击​下一步​

    chlimage_1-145

  4. 输入扩展架构的不同参数:

    • 架构:选择 nms: seedMemberschema。窗口中的其他字段会自动填写。
    • 命名空间:个性化扩展架构的命名空间。
  5. 编辑架构的XML代码,以指定要添加到该架构的字段。 有关在Adobe Campaign中扩展架构的更多信息,请参阅配置指南

  6. 保存您的架构,然后通过控制台中的​Tools > Advanced > Update database structure​菜单更新Adobe Campaign数据库结构。

  7. 断开连接,然后重新连接到Adobe Campaign控制台以保存更改。 现在,新字段会显示在AEM中可用的个性化字段列表中。

示例

要添加​Registration Number​字段,您必须具有以下元素:

  • nms:recipient​模式扩展名为​cus:recipient​包含:
<element desc="Recipient table (profiles)" img="nms:recipient.png" label="Recipients" labelSingular="Recipient" name="recipient">

  <attribute dataPolicy="smartCase" desc="Recipient registration number" 
  label="Registration Number"
  length="50" name="registrationNumber" type="string"/>

</element>

nms:seedMember​模式扩展名为​cus:seedMember,包含:

<element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">

  <element name="custom_nms_recipient">
    <attribute name="registrationNumber" 
    template="cus:recipient:recipient/@registrationNumber"/>
  </element>

</element>

注册编号​字段现在是可用个性化字段的一部分:

chlimage_1-146

隐藏个性化字段

要在已有可用的个性化字段中隐藏个性化字段,必须扩展Adobe Campaign nms:seedMember​模式,如添加个性化字段一节中所述。 应用以下步骤:

  1. 复制您要从扩展架构(例如​cus:seedMember)的​nms:seedMember​架构中获取的字段。

  2. 将​advanced="true" XML属性添加到字段。 它不再显示在AEM中可用的个性化字段列表中。

    例如,要隐藏​Middle Name​字段,cud:seedMember​架构必须包含以下元素:

    <element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">
    
      <element name="custom_nms_recipient">
        <attribute advanced="true" name="middleName"/>
      </element>
    
    </element>
    

停用个性化块

要取消激活可用个性化块中的个性化块,请执行以下操作:

  1. 在Adobe Campaign导航中,转到​资源 > 促销活动管理 > 个性化块​节点。

  2. 选择要在AEM中停用的个性化块。

  3. 清除自定义菜单​中的​可见复选框并保存更改。 块不再显示在Adobe Campaign中可用的个性化块列表中。

    chlimage_1-147

管理目标扩展数据

您还可以插入Target扩展数据以进行个性化。 Target扩展数据(也称为“Target数据”)来自于例如在营销活动工作流中扩充查询或在查询中添加数据。 有关更多信息,请参阅创建查询扩充数据一节。

注意

只有将AEM内容与Adobe Campaign交付同步时,目标中的数据才可用。 请参阅将AEM中创建的内容与Adobe Campaign的投放同步

chlimage_1-148

在此页面上