Adobe Analytics icon

Adobe Analytics

Use the Adobe Analytics API

Overview

This node integrates with the Adobe Analytics API to perform various operations on Adobe Analytics resources. Specifically, for the Date Range resource and the Update Date Range operation, it allows users to update the configuration of an existing date range by specifying its ID and providing new configuration details.

Use cases include:

  • Modifying predefined or custom date ranges used in Adobe Analytics reports.
  • Adjusting date range parameters dynamically within automated workflows.
  • Keeping date ranges up-to-date without manual intervention in the Adobe Analytics interface.

For example, you might update a date range to shift the start and end dates to reflect a new reporting period or change other metadata associated with that date range.

Properties

Name Meaning
Global Company ID The unique identifier of the company in Adobe Analytics under which the date range exists.
Date Ranges ID The identifier of the specific date range to update. Required for update operations.
Query Parameters Optional additional query parameters to filter or modify the request behavior.
Request Body JSON object containing the updated configuration details for the date range.

Query Parameters (examples)

These are optional and can be used to refine the request; some examples include:

  • approved: Whether to include approved calculated metrics (boolean).
  • limit: Maximum number of results to return (number).
  • startDate / endDate: Define date boundaries for filtering (string, ISO8601).
  • sortDirection: Sort order, either ASC or DESC.
  • Many others related to filtering logs, components, segments, etc.

The full list is extensive and covers many filtering and sorting options relevant to Adobe Analytics data.

Output

The node outputs the response from the Adobe Analytics API as JSON. For the Update Date Range operation, this typically includes the updated date range object reflecting the changes made.

If the API returns no content (e.g., HTTP 204), the output will indicate "Status Code": "204 No Content".

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for Adobe Analytics with client ID, client secret, and scope configured.
  • The node obtains an OAuth access token via Adobe's IMS token endpoint before making API calls.
  • Network connectivity to https://analytics.adobe.io and https://ims-na1.adobelogin.com is required.

Troubleshooting

  • Missing Credentials Error: 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 cause the node to error out. Check client ID, secret, and scope correctness.
  • Required Parameter Missing: For update operations, if the Date Ranges ID is not provided, the node throws an error stating it is required.
  • API Errors: Any errors returned by the Adobe Analytics API will be wrapped and reported with the message prefix "Error calling Adobe Analytics API".
  • Invalid JSON in Request Body: Ensure the JSON provided in the Request Body property is valid and matches the expected schema for updating a date range.

Links and References


This summary focuses on the "Date Range" resource and the "Update Date Range" operation as requested.

Discussion