选择使用Adobe Analytics和Adobe Target opting-into-adobe-analytics-and-adobe-target

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

管理员

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

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

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

通过任务配置集成。

可以立即执行也可以稍后执行，在执行某些操作之前，任务将保留在收件箱中。无论哪种情况，配置都可以直接在UI中完成，或使用预定义的.properties文件完成。
选择退出集成。

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

配置集成 configuring-the-integration

选择与集成：

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

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

NOTE

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

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

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

NOTE

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

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

要选择加入预加载的现成任务，请执行以下操作：

在收件箱中，选择并打开配置分析和定位任务。
对于Analytics：
1. 输入Analytics的用户帐户信息，然后单击相应的添加按钮。
2. 相应的凭据已进行身份验证。
3. 在Analytics帐户通过身份验证后，选择要使用的Analytics报表包。 AEM会检索这些Analytics报表包。状态已更新为 已添加。
对于Target：
1. 输入Target的用户帐户信息，然后单击相应的添加按钮。
2. 相应的凭据已进行身份验证。状态已更新为 已添加。
选择 下一步。
选择应使用Analytics和/或Target的站点。

选择完成以完成。

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

选择退出集成 opting-out-of-the-integration

在执行以下操作时退出与Analytics和Target的集成：

不想与这些产品集成。
希望手动配置集成。

有关手动配置集成的信息，请参阅与Adobe Analytics集成和与Adobe Target集成。

要选择退出，您需要完成预加载任务：

在收件箱中，选择并完成配置分析和定位任务。

使用属性文件提供帐户信息 providing-account-information-using-a-properties-file

安装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=

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

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

note note
NOTE
工作目录通常是包含jar或`license.properties`文件的目录。
但是，它也可以由系统属性定义为绝对路径：
`mac.provisioning.file.container`

根据您的Analytics和/或Target帐户添加属性值。
启动或重新启动服务器，然后使用管理员帐户登录。
打开配置Analytics和Targeting任务，如配置集成中所述。向导使用.properties文件中的值，而不是请求您的帐户信息。

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

关于云配置 about-the-cloud-configurations

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

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

NOTE

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

准确定位意味着，云服务配置将等到上下文加载完后，再加载内容。因此，就性能而言，准确定位可能会导致加载内容前有几毫秒的延迟。

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

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

CAUTION

当您选择加入Analytics配置并选择特定的reportsuite时，框架将限制为发布运行模式。这意味着跟踪仅适用于发布实例。

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

通过脚本配置设置和预配 configuring-the-setup-and-provisioning-via-script

作为管理员，您可能希望使用脚本触发设置和预配，而不是手动逐步执行向导。您可以通过以下方式来实现这一点：

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

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

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

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

例如，同时创建Analytics和Target配置并将它们附加到we.retail页面的curl请求如下所示：

code language-shell

code language-shell
`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`

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=用于附加已创建的AEM服务配置的Cloud Service页面的路径；可以定义多个路径
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请求将是：

code language-shell

code language-shell
`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`

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

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2