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
This node integrates with the Adobe Analytics API to create a new calculated metric within a specified Adobe Analytics company account. Calculated metrics allow users to define custom metrics by combining existing metrics and applying mathematical or logical operations, enhancing data analysis capabilities.
Typical use cases include:
- Creating tailored performance indicators that are not available as standard metrics.
- Automating the creation of calculated metrics for consistent reporting across teams.
- Integrating Adobe Analytics calculated metrics creation into automated workflows.
For example, a marketing analyst might use this node to create a calculated metric representing "Conversion Rate" by dividing the number of conversions by the number of visits, enabling more insightful campaign analysis.
Properties
| Name | Meaning |
|---|---|
| Global Company ID | The unique identifier of the Adobe Analytics company (global company) where the calculated metric will be created. |
| Query Parameters | Optional parameters to filter or modify the request. Includes options such as: Approved (include only approved metrics), Favorite (include favorites), Limit (max results), Start Date, End Date, Sort Direction (ASC/DESC), and many others for fine-tuning the query. |
| Request Body | JSON object containing the definition of the calculated metric to create. This includes the metric's name, description, formula, and other configuration details as per Adobe Analytics API requirements. |
Output
The output is a JSON array where each item corresponds to the response from the Adobe Analytics API after attempting to create a calculated metric. The JSON structure typically contains details about the newly created calculated metric, such as its ID, name, definition, and status.
If the API returns no content (e.g., HTTP 204), the output will indicate "Status Code": "204 No Content".
No binary data output is produced by this node.
Dependencies
- Requires an Adobe Analytics API credential configured in n8n with appropriate permissions.
- Needs network access to Adobe's IMS token endpoint (
https://ims-na1.adobelogin.com/ims/token/v3) for OAuth2 client credentials flow. - Requires the Adobe Analytics API base URL (
https://analytics.adobe.io/api/{globalCompanyId}).
Troubleshooting
- Missing Credentials: If the Adobe Analytics API credentials are not set or invalid, the node will throw an error indicating missing credentials.
- Access Token Retrieval Failure: Failure to obtain an access token from Adobe IMS will result in an error. Ensure client ID, client secret, and scope are correctly configured.
- Required Parameter Missing: If the
Global Company IDor required IDs (like calculated metric ID for update/delete) are missing, the node throws an error specifying the missing parameter. - Invalid JSON in Request Body: The
Request Bodymust be valid JSON. Malformed JSON will cause the request to fail. - API Errors: Any errors returned by the Adobe Analytics API (e.g., validation errors on the calculated metric definition) will be surfaced as node errors with descriptive messages.
- Rate Limits or Network Issues: Temporary failures due to rate limiting or connectivity issues may occur; retrying the workflow or checking network settings can help.