Content Analytics guided configuration
- Topics:
- Content Analytics
CREATED FOR:
- Admin
The guided configuration helps you to configure Content Analytics quickly and easily. The guided configuration uses a wizard to set up the requirements to configure Content Analytics automatically for your organization. In the Configuration screen, you can either create a new configuration or edit an existing configuration.
To access the Content Analytics configuration
- Select Data Management > Content Analytics Configuration from the main menu in Customer Journey Analytics.
In the Content Analytics Configurations screen, you see a table of existing Content Analytics configurations.
For each configuration, the following details are available:
You can use
From the Content Analytics Configuration screen, you can create a new configuration or edit an existing configuration.
To create a new configuration:
- Select Create configuration. This action opens the guided configuration wizard.
To edit an existing configuration:
- Select
Guided configuration wizard
The guided configuration wizard consists of four sections (Details, Data view, Experience capture & definition, and Data collection), each prompting you for details that are required to set up and configure Content Analytics properly. Complete each section before moving to the next section, as some settings in a section might depend on configuration values in earlier sections.
Details
Each configuration requires a unique name. For example, Example Content Analytics configuration
. The name is required to save or implement a configuration.
Data view
Your configuration requires the selection of a Data view.
-
Select a Data view
-
To select a new Data view for a configuration, use
-
To modify a Data view for a configuration, select
In both scenarios, you see a Data view dialog, where you can select a Data view for your configuration.
For a new configuration, the list only shows Data views that are associated with sandboxes that do not have an active configuration. Also, you only see data views associated with sandboxes that you have access to and connections you have the rights to modify.
If you edit an existing configuration, the list only shows Data views available within the sandbox already associated with the existing configuration.
You can perform the following actions:
- To search for a specific Data view, use the
- To filter the list of available Data views, select
Use - To define which columns to show in the table, select
-
-
Select
-
Select Save to confirm the selected Data view. Select Cancel to cancel.
In Customer Journey Analytics, a Data view is tied to a Customer Journey Analytics Connection. And a Connection is based on a sandbox within your organization. Once you save the configuration, Sandbox is auto populated with the name of the sandbox, based on the selected Data view.
Experience capture and definition
In this section, you can select to include Experiences in the data you collect with Content Analytics. An experience is all text on a web page that is reproducible using the URL used by the initial user visiting that web page.
By default, Include experiences is turned off. When selected, you have to define for which URLs you want to include experiences.
Only consider to include experiences when the following is applicable:
- The pages on the site must be reproducible using the page URL.
- The text content seen by any given user can be reproduced using the page URL and does not depends on cookies or other personalization mechanisms.
To include Experiences in a new or not implemented configuration:
-
Enable Include experiences. The toggle to enable experiences affects the following:
- Data collection in the Content Analytics extension
- The process that generates experience attributes from Content Analytics event data
- The reporting template in Customer Journey Analytics.
-
Specify the parameters for how content is rendered on your website. The parameters are zero or more combinations of a Domain regular expression and Query parameters. The query parameters indicate what parameters affect the content on your page. This input allows Content Analytics to ignore any parameters that don’t affect content on the page, when defining a unique experience.
- Enter a Domain regular expression, for example
/^(?!.*\b(store|help|admin)\b)/
. Ensure you escape regular expressions, using/
. The domain regular expression indicates which URLs these parameters apply to. For example, you may have multiple sites, and for each site different parameters drive the content. If the query parameters apply to all of your pages, then you can use.*
to indicate all pages. - Specify a comma separated list of Query parameters, for example
outdoors, patio, kitchen
.
- Enter a Domain regular expression, for example
-
Select Remove if you want to remove a combination of domain regular expression and query parameters.
-
Select Add Regex if you want to add another combination of a regular expression and query parameters.
To edit existing or include new Experiences in an implemented configuration:
-
Toggle Include experiences to enable or disable the availability of experience components, visualizations, panels and templates in Analysis Workspace.
-
Select
Data collection
In this section, you configure how to collect your content analytics data.
New configuration
In a new configuration, you need to define whether you want to use an existing Tags property or create a new Tags property. And you need to define the pages and assets you want to include or exclude, using regular expressions.
-
To use an existing Tags property:
- Select Choose existing.
- Select an existing property from the Tags property dropdown menu. You can start typing to search for and limit the available options. You cannot select a Tags property that already is used by another implemented Content Analytics configuration.
-
To create a new Tags property:
- Select Create new.
- Specify a Tags name, for example
ACA Test for Documentation
. - Specify Domains, for example,
example.com
.
-
Indicate which pages should be included or excluded when collecting data for Content Analytics.
Specify a Regular expression string for Pages to include / exclude.
For example:^(?!.*documentation).*
to exclude all documentation pages from Content Analytics. -
Indicate which assets should be included or excluded when collecting data for Content Analytics.
Specify a Regular expression string for Assets to include / exclude.
For example:^(?!.*(logo\.jpg|\.svg)).*$
to exclude all logo JPEG and SVG images from Content Analytics.
Existing configuration
For an existing configuration, you cannot edit the Tags property. You can, however, edit the pages and assets to include or exclude.
-
To edit which pages should be included or excluded when collecting data for Content Analytics, select
-
To edit which assets should be included or excluded when collecting data for Content Analytics, select
Summary
Once you have provided all necessary details, a summary provides details on the artifacts that are created or modified.
-
You see a You’re almost ready to implement configuration name for Content Analytics summary when you implement a new configuration.
-
For existing implemented configurations, you see a You have implemented configuration name for Content Analytics summary.
Actions
When you create or edit a configuration you have these options:
-
Discard: All changes made as part of configuration are discarded.
-
Save for later: Changes made to a configuration are saved. You can revisit the configuration at a later stage to make further changes, or implement the configuration. Only a value for Name is required to save a configuration.
-
Implement: Settings for or changes made to a configuration are saved and implemented. All fields marked as
-
Customer Journey Analytics configuration:
- The selected Data view is updated to include Content Analytics dimension and metrics.
- The Connection tied to the selected Data view is modified to include Content Analytics events and attributes datasets.
- A Content Analytics reporting template is added to Workspace.
-
Adobe Experience Platform configuration:
- The creation of schemas to model Content Analytics events, asset attributes, and (if configured) experience attributes.
- The creation of datasets to collect Content Analytics events, asset attributes and (if configured) experience attributes.
- The creation of a dataflow that uses the featurization service to generate and update content attributes from Content Analytics events.
-
Data collection configuration:
- The new or existing Tags property is configured to support Content Analytics data collection. This configuration implies the inclusion of the Adobe Content Analytics extension for Tags.
- A datastream is created for Content Analytics events.
- The Adobe Content Analytics extension is configured to ensure that Content Analytics events are sent to the datastream for Content Analytics.
- If the Web SDK is not configured for the Tags property, a new Web SDK configuration is created to send only Content Analytics events.
- If the Web SDK is configured for this Tags property, no changes are made to the existing Web SDK configuration.
-
-
Save: Changes made to an implemented configuration are saved and the implementation is updated.
-
Exit. Exits the guided configuration. All changes made to an implemented configuration are discarded.
Publish
To start collecting data for your Content Analytics configuration, you need to manually publish the Tags property that is created after you selected Implement.