选择加入Adobe Analytics和Adobe Target

AEM有一个选择加入过程，可帮助您与Adobe Analytics和Adobe Target集成。 这是现成的，即分配给管理员用户组的预加载任务。

当您以管理员身份登录时，收件箱中会显示此任务（配置Analytics和定位）。 根据您提供的凭据，它可帮助您配置和集成这些服务。

您可以使用以下选项来配置集成：

  • 通过任务配置集成。

    此操作可以立即执行，也可以稍后执行，该任务将保留在收件箱中，直到执行某些操作为止。 无论哪种情况，配置都可以直接在UI中完成，也可以使用预定义的.properties文件完成。

  • 选择退出集成。

    如果您希望手动配置集成，请考虑此选项。 另请参阅使用DTM将AEM与Adobe Target和Adobe Analytics集成。

  • 使用脚本配置设置和配置。

配置集成

选择加入与的集成：

  • Analytics，以便能够使用其页面跟踪和分析功能。
  • Target以启用其个性化功能。

对于任一选项，您都需要提供用户帐户信息并指定要跟踪的页面。

注意

您可以选择使用在服务器启动时读取的属性文件来提供Analytics和Target帐户信息。 请参阅使用属性文件提供帐户信息。

选择加入集成后，AEM会执行以下任务：

  • 创建可启用与Analytics和Target连接的云配置。
  • 创建用于确定所跟踪数据的框架。
  • 配置网页以使用这些服务。
注意

AT.js是默认的客户端库。 这是在您的target云服务配置下配置的。

Adobe建议您使用AT.js作为客户端库。

要选择加入预加载的即装即用任务，请执行以下操作：

  1. 从收件箱中，选择并​打开​配置Analytics和定位任务。

    optin-01

  2. 对于Analytics:

    1. 输入Analytics的用户帐户信息，然后单击相应的​Add​按钮。
    2. 相应的凭据已进行身份验证。
    3. 在Analytics帐户进行身份验证后，选择要使用的Analytics报表包。 AEM会检索这些Analytics报表包。 状态将更新为​Added。

  3. 对于Target:

    1. 输入Target的用户帐户信息，然后单击相应的​Add​按钮。
    2. 相应的凭据已进行身份验证。 状态将更新为​Added。

  4. 选择​下一步。

  5. 选择应使用Analytics和/或Target的网站。

  6. 选择​完成​以完成。

    注意

    选择加入配置后，您需要发布受影响的站点/页面，以将这些更改复制到发布实例。

退出集成

在以下情况下选择退出与Analytics和Target的集成：

要选择禁用，您需要完成预加载的任务：

使用属性文件提供帐户信息

安装AEM在服务器启动时读取的属性文件，以配置与Analytics和Target集成的帐户属性。 使用属性文件时，选择加入向导会自动使用文件中的属性，并且会相应地创建云配置。

属性文件是名为marketingcloud.properties的文本文件，您将其保存在AEM进程所使用的工作目录中（通常与JAR文件相同的目录）。 文件包含以下属性：

  • analytics.server:您使用的Analytics数据中心的URL。
  • analytics.company:与您的Analytics用户帐户关联的公司。
  • analytics.username:您的Analytics用户名。
  • analytics.secret:与您的Analytics用户名关联的密钥。
  • analytics.reportsuite:要使用的Analytics报表包的名称。
  • target.clientcode:与您的Target帐户关联的客户端代码。
  • target.email:用于验证Target帐户的电子邮件地址。
  • target.password:与您的电子邮件地址关联的密码。

属性和值以等号(=)进行分隔。 Analytics属性以analytics为前缀，Target属性以target为前缀。 要配置服务，请为该服务的所有属性提供值。 如果不想配置服务，则不提供该服务的值。

以下示例.properties文件包含用于为Analytics创建云配置的属性值：

analytics.server=https://test.omniture.com/login/
analytics.company=MyCompany
analytics.username=sbroders
analytics.secret=12345678
analytics.reportsuite=myreportsuite
target.clientcode=
target.email=
target.password=

以下过程介绍如何使用属性文件选择加入集成。

  1. 在AEM进程正在使用的工作目录（创作实例）中创建marketingcloud.properties文件。

    注意

    工作目录通常是存放jar或license.properties文件的目录。

    但是，它也可以由系统属性定义为绝对路径：

    mac.provisioning.file.container

  2. 根据您的Analytics和/或Target帐户添加属性值。

  3. 启动或重新启动服务器，然后使用管理员帐户登录。

  4. 按照配置集成中的所述，打开配置分析和定位任务。 向导不会请求您的帐户信息，而是使用.properties文件中的值。

    为相应的服务选择​添加，然后继续向导。

    optin-02

关于云配置

当您配置与Analytics和Target的集成时，AEM会自动创建所需的云配置和框架。 例如，Analytics云配置称为已配置的Analytics帐户。

您无需更改云配置。 但是，您可以根据需要配置框架。 (请参阅使用Adobe Analytics属性映射组件数据和添加目标框架。)

注意

默认情况下，当您选择加入Adobe Target配置向导时，将启用“准确定位”。

准确定位意味着云服务配置在加载内容之前会等待上下文加载。 因此，就性能而言，准确定位可能会在加载内容之前造成几毫秒的延迟。

创作实例始终启用准确定位。 但是，在发布实例上，您可以选择全局关闭准确定位，方法是清除云服务配置中准确定位旁边的复选标记(http://localhost:4502/etc/cloudservices.html)。 无论云服务配置中的设置如何，您仍可以为各个组件打开和关闭准确定位。

如果​已经​创建了目标组件，并且更改了此设置，则所做的更改不会影响这些组件。 您必须直接对这些组件进行任何更改。

注意

选择启用Analytics配置并选择特定的reportsuite时，框架将限制为发布运行模式。 这意味着跟踪仅在发布实例上有效。

如果需要对创作实例进行跟踪，则应将值更改为all。

通过脚本配置设置和配置

作为管理员，您可能希望使用脚本触发设置和配置，而不是手动逐步完成向导。 您可以通过以下方式执行此操作：

  • 使用所需参数向​/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json​发送POST请求。

您发送的参数取决于以下各项：

  • 如果要使用已填写所有必需凭据的​marketingcloud.properties​文件，则必须发送以下参数：

    • automaticProvisioning= true
    • servicename= analytics|target
    • path=用于附加已创建的云服务配置的AEM页面的路径

    例如，创建Analytics和Target配置并将其附加到we.retail页面的curl请求将为：

    curl -v -u admin:admin -X POST -d"automaticProvisioning=true&servicename=target&servicename=analytics&path=/content/we-retail" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json

  • 如果您不想使用​marketingcloud.properties​文件，则必须发送凭据和参数；例如：

    • automaticProvisioning= true
    • servicename= analytics|target
    • path=path到AEM页面以附加创建的云服务配置；可以定义多个路径
    • analytics.server= https://servername
    • analytics.company= Name of company
    • analytics.username= me
    • analytics.secret= secret
    • analytics.reportsuite= we-retail
    • target.clientcode= mycompany
    • target.email= me@adobe.com
    • target.password= password

    在这种情况下，用于创建Analytics和Target配置并将其附加到we-retail页面的curl请求将为：

    curl -v -u admin:admin -X POST -d"automaticProvisioning=false&servicename=target&servicename=analytics&path=/content/we-retail&analytics.server=https://servername/&analytics.company=Name of company&analytics.username=me&analytics.secret=secret&analytics.reportsuite=weretail&target.clientcode=mycompany&target.email=me@adobe.com&target.password=password" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json

在此页面上