Actions57
- Annotation Actions
- Calculated Metric Actions
- Component Meta Data Actions
- Add Tags
- Delete Multiple Tags
- Delete One Tag
- Delete Shared Component
- Get Shared Component
- Get Tag
- List Shared Components by the User
- List Shared Components to the User
- List Tag Names
- List Tags
- Save Tags
- Search Shared Components
- Search Tags for Multiple Components
- Search Tags for One Component
- Share Component with Multiple User
- Share Component with One User
- Date Range Actions
- Dimension Actions
- Metric Actions
- Project Actions
- Report Actions
- Segment Actions
- Usage Log Actions
- User Actions
Overview
The node integrates with the Adobe Analytics API to update an existing Calculated Metric. Calculated Metrics are custom metrics defined by users to enhance data analysis by combining or transforming standard metrics. This operation allows users to modify the definition or properties of a specific Calculated Metric within their Adobe Analytics environment.
Typical use cases include:
- Adjusting metric formulas to reflect new business logic.
- Correcting or refining existing calculated metrics without recreating them.
- Updating metadata or configuration related to a calculated metric for better reporting.
For example, a marketing analyst might update a calculated metric that measures "Engagement Score" by changing its formula to include new interaction types.
Properties
| Name | Meaning |
|---|---|
| Global Company ID | The unique identifier of the company in Adobe Analytics under which the calculated metric exists. |
| Calculated Metric ID | The identifier of the calculated metric to update. This is required to specify which metric will be modified. |
| Query Parameters | Optional parameters to filter or control the request. Includes options such as: Approved (boolean), Favorite (boolean), Limit (number), Locale (string), Start Date, End Date, Sort Direction (ASC/DESC), and many others to refine the context or scope of the request. |
| Request Body | JSON object containing the updated definition or properties of the calculated metric. This should include the new metric formula, name, description, or other relevant fields as per Adobe Analytics API specification. |
Output
The output is a JSON array where each element corresponds to the response from the Adobe Analytics API after attempting to update the calculated metric. The structure typically includes:
- Confirmation of the updated calculated metric details.
- Status codes or messages indicating success or failure.
- If the API returns no content, a status message "204 No Content" is provided.
No binary data is output by this node.
Dependencies
- Requires an Adobe Analytics API credential with appropriate permissions.
- Needs valid client credentials (client ID, client secret) and scope to obtain an access token.
- The node makes HTTP requests to Adobe's IMS token service to authenticate and then to the Adobe Analytics API endpoints.
- Proper configuration of the Adobe Analytics API credentials in n8n is necessary.
Troubleshooting
- Missing Credentials: If the Adobe Analytics API credentials are not set or invalid, the node will throw an error "Missing Adobe Analytics API Credentials".
- Access Token Retrieval Failure: If the node cannot retrieve an access token, it throws "Failed to retrieve access token". Check client ID, secret, and scope.
- Required Parameter Missing: If the Calculated Metric ID is not provided when updating, the node throws "Calculated Metric ID is required".
- API Errors: Any errors returned by the Adobe Analytics API are wrapped and thrown as "Error calling Adobe Analytics API" with the original message and stack trace.
- Invalid JSON in Request Body: Ensure the JSON provided in the Request Body property is correctly formatted; otherwise, parsing errors may occur.