What You Can Do
Data Views & Dimensions
List data views and explore their dimensions, metrics, and date ranges. Pull the schema context Gradial needs to interpret your cross-channel data correctly.
Workspace Projects
Read Analysis Workspace projects, panels, and visualizations. Use project context to generate summaries, highlight trends, and draft recommendations.
Filters & Calculated Metrics
List and inspect filters (segments) and calculated metrics. Reference audience definitions and custom KPIs when drafting briefs or activation plans.
Insight to Action
Turn funnel analysis, behavior data, and segment performance into campaign briefs, content updates, journey plans, or execution steps in a connected system.
Prerequisites
- An active Adobe Experience Cloud organization with Customer Journey Analytics licensed and live
- Access to the Adobe Developer Console to create a project and generate server-to-server OAuth credentials
- Your IMS Org ID and the data view IDs Gradial should have access to
- A product profile with CJA API access granted in Adobe Admin Console
- A Gradial organization Administrator role to complete setup
How to Connect
Create an Adobe Developer project
- Go to Adobe Developer Console and sign in with your Adobe ID.
- Select your organization from the org switcher.
- Click Create new project and give it a name (e.g.,
Gradial – CJA Integration).
Add the Customer Journey Analytics API
- Inside your new project, click Add API.
- Filter by Experience Cloud and select Customer Journey Analytics.
- Choose OAuth Server-to-Server as the authentication type and click Next.
- Select or create a Product Profile that grants CJA API access. The profile must be configured in Adobe Admin Console under Customer Journey Analytics.
| Scope | Required | Purpose |
|---|---|---|
adobeanalytics.read | Yes | Read data views, dimensions, metrics, and projects |
adobeio.appregistry.read | Yes | Required for OAuth token exchange |
read_organizations | Yes | Resolve IMS org context |
additional_info.projectedProductContext | Yes | Confirm CJA product entitlement |
- Click Save configured API.
Copy your credentials
From the project’s OAuth Server-to-Server credential page, copy:
- Client ID
- Client Secret
- IMS Org ID
- Technical Account ID
Identify your data view IDs
Gradial reads CJA data using data view IDs. To find them:
- In CJA, go to Data Management → Data Views.
- Open each data view you want Gradial to access.
- Copy the Data View ID from the URL or the data view settings panel (format:
dv_xxxxxxxxxxxxxxxxxx).
Add the integration in Gradial
- In Gradial, go to Settings → Integrations.
- Find Adobe Customer Journey Analytics and click + Add.
- Fill in the connection details:
| Field | Value |
|---|---|
| Integration Name | A display name (e.g., Acme – CJA Production) |
| IMS Org ID | From step 3 |
| Client ID | From step 3 |
| Client Secret | From step 3 |
| Technical Account ID | From step 3 |
| Data View IDs | Comma-separated list of data view IDs from step 4 |
- Click Save. Gradial validates the credentials and confirms access to the specified data views.
How It Fits Into Broader Workflows
| Use case | How to use it |
|---|---|
| Performance to brief | Ask Gradial to summarize a Workspace project or data view trend, then draft a campaign brief based on what the data shows |
| Funnel gap analysis | Pull funnel metrics into a Gradial thread and ask it to identify drop-off points and recommend content or journey changes |
| Segment-driven content | Reference a CJA filter to have Gradial tailor copy, subject lines, or page content for a specific audience |
| Cross-channel activation | Use CJA insight to execute or draft a follow-up in AJO, SFMC, Marketo, AEM, or another connected system |
| Reporting summaries | Ask Gradial to translate a complex Workspace project into an executive summary or stakeholder brief |
- Ask Gradial to list your CJA data views and pick the relevant one.
- Have Gradial pull the funnel visualization from a Workspace project.
- Ask Gradial to identify the biggest drop-off step and draft a re-engagement email.
- Execute the draft in a connected system — AJO, SFMC, or Marketo — in the same thread.
- Ask Gradial to list the filters defined in a data view.
- Select a high-value segment and ask Gradial to draft a tailored landing page headline and body copy.
- Have Gradial push the update to AEM or your connected CMS.
What’s Not Covered Yet
- Writing back to CJA — the integration is read-only; Gradial cannot create or modify data views, projects, or filters through the API.
- Raw event-level data queries — Gradial reads aggregated project and dimension data, not individual event streams.
- Report Suite data from legacy Adobe Analytics — use the Adobe Analytics integration for that context.
- Real-time streaming data — CJA’s API returns processed batch data, not live event streams.
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
401 Unauthorized | Invalid or expired credentials | Regenerate the Client Secret in Adobe Developer Console and update Gradial |
403 Forbidden | Product profile lacks CJA API access | Confirm the profile has CJA API permission in Adobe Admin Console |
404 Not Found on data view | Data view ID is incorrect or not shared | Verify the data view ID and confirm the technical account has been added to the data view’s access list |
| No data views returned | IMS Org ID mismatch | Confirm the IMS Org ID matches the organization where CJA is provisioned |
| Token exchange fails | Missing required OAuth scopes | Re-add the API in Adobe Developer Console and confirm all required scopes are selected |
Good to Know
- Data view access is explicit: The technical account created by the Adobe Developer project must be added to each CJA data view individually under Data Views → Access. If Gradial returns an empty data view list, this is the most common cause.
- Workspace projects are read via the Projects API: Only projects saved in Analysis Workspace are accessible. Auto-saved or unsaved drafts are not returned.
- Calculated metrics are org-scoped: Gradial can read calculated metrics defined at the org level. Data-view-scoped calculated metrics require the matching data view ID to be in scope.
- Rate limits apply: The CJA API enforces rate limits per org. For high-volume analysis threads, Gradial batches requests automatically.