与 Adobe Campaign Classic 集成

上次更新: 2023-05-04
  • 创建对象:
  • Admin
注意

AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

注意

本文档介绍如何将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中的角色。

前提条件

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

注意

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

注意

操作详见 配置Adobe Campaign配置Adobe Experience Manager 要使AEM和Adobe Campaign之间的集成功能正常工作,需要部分内容。

安装AEM集成包

您必须安装 AEM集成 包在Adobe Campaign中。 要执行此操作:

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

  2. 选择​“工具”>“高级”>“导入软件包…”

    chlimage_1-132

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

    chlimage_1-133

  4. 单击 下一个,然后 开始.

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

    注意

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

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

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

    chlimage_1-134

配置AEM外部帐户

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

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

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

  1. 转到 管理 > 平台 > 外部帐户 节点。

  2. 创建新的外部帐户,然后选择 AEM 类型。

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

    注意

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

    chlimage_1-135 chlimage_1-136

  4. 确保 已启用 复选框。

验证AEMResourceTypeFilter选项

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

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

验证 AEMResourceTypeFilter 选项:

  1. 转到 平台 >选项.

  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,则可以将 公共URL 在OSGi的以下配置设置中(AEM徽标 > 工具 图标> 操作 > Web控制台 > OSGi配置 > AEM Campaign集成 — 配置):
公共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 的IP地址或AEM发布实例的地址。

    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的文件。
  • 必须为 aemserver运算符 在Adobe Campaign。 此外,在 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)。 有关更多信息,请参阅 配置 的双曲余切值。

  1. 转到 管理 > 配置 > 数据模式 节点。

  2. 选择 新建.

    chlimage_1-144

  3. 在弹出窗口中,选择 使用扩展模式扩展表中的数据 单击 下一个.

    chlimage_1-145

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

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

  6. 保存您的架构,然后通过 工具 > 高级 > 更新数据库结构 菜单。

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

示例

添加 注册编号 字段,则必须具有以下元素:

  • 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. 复制要从 nms:seedMember 扩展模式(cus:seedMember 例如)。

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

    例如,要隐藏 中间名 字段, 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. 转到 资源 > Campaign Management > 个性化块 节点。

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

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

    chlimage_1-147

管理目标扩展数据

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

注意

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

chlimage_1-148

在此页面上