Add component descriptions

Descriptions help users know how to use the various components when building projects in Analysis Workspace or when viewing reports.

Customer Journey Analytics administrators can add descriptions for components (dimensions, metrics, segments, and date ranges) within a data view or using the Data Dictionary.

Data view

You can add a description to a component you have added to your data view. See Component settings.

Data Dictionary

The Data Dictionary in Analysis Workspace helps both users and administrators keep track of and better understand the components in their Customer Journey Analytics environment. The Data Dictionary allows administrators to add component descriptions directly within Analysis Workspace.

For information about editing a component description in the data dictionary, see Edit component entries in the Data Dictionary.

For general information about the Data Dictionary, see the Data Dictionary overview.

Automatically generate descriptions

AVAILABILITY
The functionality described in this section is in the Limited Testing phase of release and might not be available yet in your environment. This note will be removed when the functionality is generally available. For information about the Customer Journey Analytics release process, see Customer Journey Analytics feature releases.

Instead of writing each description manually, Customer Journey Analytics can use generative AI to write descriptions for you. You can generate a description for a single component or generate descriptions for many components at the same time.

Generated descriptions:

  • Are no more than 3 sentences long.
  • End with the text Generated by Adobe using AI, so users know the description was generated.
  • Can be edited after they’re generated.

Prerequisites

Before you can generate descriptions, your organization must agree to certain generative AI legal terms. If your organization hasn’t agreed to these terms, the option to generate descriptions is dimmed. Select the information icon Info next to the option to learn how to enable the feature, or contact your organization’s administrator or Adobe account team.

How descriptions are generated

Generated descriptions are based on the component’s definition and on additional context about how the component is used in your data view, such as:

  • The top items of a dimension
  • Components that are frequently used with the component

When a calculated metric or segment references another segment, the generated description explains the definition of the referenced segment.

Generate descriptions from various locations

You can generate descriptions in the following areas of Customer Journey Analytics. Some locations allow you to generate descriptions for multiple components while others do not.

Select a location to learn how to generate descriptions there.

Location
Supported components
Single component
Multiple components
Data Dictionary
  • Dimensions
  • Metrics
  • Calculated metrics
  • Segments
  • Date ranges
Yes
Yes
Data view
Yes
Yes
Segment Builder
Segments
Yes
No
Segments manager
Segments
No
Yes
Calculated metric builder
Calculated metrics
Yes
No
Calculated metrics manager
Calculated metrics
No
Yes
Date range builder
Date ranges
Yes
No
Date ranges manager
Date ranges
No
Yes

Generate descriptions for shared metrics and dimensions

You can generate descriptions for shared metrics and dimensions only from within a data view, as shown in the table in Generate descriptions from various locations. You can’t generate descriptions from the Shared Metrics & Dimensions manager.

Consider the following when you generate a description for a shared metric or dimension within a data view:

  • The description applies to all data views where the component is shared, and replaces any existing description for that component in all other data views and in the Shared Metrics & Dimensions manager.

  • The description is based on context from the data view where you generate it (such as the data view’s top dimension items).

recommendation-more-help
analytics-platform-help-main