Adobe AnalyticsInstall

Overview

The "List Tag Names" operation under the "Component Meta Data" resource in this Adobe Analytics node retrieves component IDs associated with specified tag names. This is useful for users who want to filter or identify components (such as dimensions, metrics, or segments) by their tags within an Adobe Analytics environment.

Typical use cases include:

• Fetching all components tagged with certain keywords to organize or analyze them.
• Automating workflows that depend on metadata tagging for reporting or data management.
• Integrating tag-based filtering into larger analytics automation pipelines.

For example, a user might want to list all components tagged with "marketing" and "Q2" to generate reports only for those relevant components.

Properties

Output

The output is a JSON array where each element corresponds to the response from the Adobe Analytics API for the requested tag names. The structure typically includes component IDs associated with the specified tags and possibly additional metadata depending on the query parameters.

If the API returns binary data (not typical for this operation), it would represent raw content related to the components or tags, but this operation primarily deals with JSON metadata.

Example output snippet (conceptual):

[
  {
    "tagName": "marketing",
    "componentIds": ["comp123", "comp456", "comp789"]
  },
  {
    "tagName": "Q2",
    "componentIds": ["comp234", "comp567"]
  }
]

Dependencies

• Requires an Adobe Analytics API credential with client ID, client secret, and appropriate scopes.
• The node makes authenticated HTTP requests to Adobe's IMS token service to obtain an access token.
• Subsequent API calls are made to the Adobe Analytics API endpoint using the acquired token.
• 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 indicating missing credentials.
• Access Token Retrieval Failure: Failure to get an access token from Adobe IMS will result in an error. Check client ID, client secret, and scope correctness.
• Required Parameter Missing: If required parameters like Global Company ID or Tag Names are missing, the node will throw an error specifying which parameter is required.
• API Errors: Any errors returned by the Adobe Analytics API (e.g., invalid tag names, permission issues) will be surfaced as node errors with descriptive messages.
• Pagination Issues: If large result sets are expected, ensure pagination parameters are correctly set to avoid incomplete data.
• Date Format: Ensure date parameters follow ISO8601 format to prevent API rejections.

Links and References

• Adobe Analytics API Documentation
• Adobe IMS Authentication
• n8n Documentation on Credentials
• ISO 8601 Date Format