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
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
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.
- Dimensions
- Metrics
- Derived fields
- Shared metrics and dimensions (For more information, see Shared metrics and dimensions.)
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).