> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gradial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adobe Analytics Integration

> Connect Gradial to Adobe Analytics for enterprise-grade content intelligence, self-serve reporting, and performance-driven workflows.

Once connected, teams can build and run Adobe Analytics reports directly in the Gradial web app, and the same connection powers Gradial's workflow tooling for guided analysis and reporting in broader task flows.

This means Adobe Analytics is not limited to the Report Builder screen. Once connected, Gradial can use the same integration to discover reporting options, pull analytics data, and feed those results into downstream optimization and personalization work.

<Info>
  Before connecting, confirm with your legal, privacy, or data governance team that your organization has approval to share analytics data with Gradial. This includes ensuring the connection complies with any applicable data processing agreements, privacy policies, or regional data regulations.
</Info>

***

## What You Can Do

<CardGroup cols={2}>
  <Card title="Report Builder" icon="table-columns">
    Choose a report suite, date range, dimension, and metrics. Apply saved Adobe Analytics segments. Review results in chart and table views — directly in Gradial.
  </Card>

  <Card title="Workflow tooling" icon="diagram-project">
    Use the Adobe Analytics connection inside Gradial workflows, not just the reporting screen. Pull segment-specific views, compare performance, and feed results into downstream decisions.
  </Card>

  <Card title="CX Optimizer" icon="arrow-trend-up">
    Bring Adobe Analytics performance data directly into CX Optimizer so insights inform what should happen next, instead of living in a separate reporting step.
  </Card>

  <Card title="Discovery" icon="magnifying-glass">
    Discover available report suites, valid dimensions and metrics for a selected suite, and saved segments for filtered analysis.
  </Card>
</CardGroup>

***

## Prerequisites

Before connecting Adobe Analytics to Gradial, make sure you have:

* An active **Adobe Experience Cloud** organization
* **System Admin** or **Developer** rights in your Adobe organization (required to set up the API integration)
* Access to **Adobe Developer Console** to create a project with OAuth Server-to-Server credentials
* Product profiles assigned that include the report suites, metrics, and dimensions you want Gradial to access
* Your **Global Company ID** for the Adobe Analytics company you want to query
* A Gradial organization **Administrator** role to complete setup

***

## How to Connect

<Steps>
  <Step title="Create an Adobe Developer Console project">
    1. Go to [Adobe Developer Console](https://developer.adobe.com/console/) and sign in for the correct Experience Cloud organization.
    2. Create or open the project you want to use for this integration.
    3. Click **Add API** and select **Adobe Analytics**.
    4. Choose **OAuth Server-to-Server** as the credential type. Adobe requires OAuth Server-to-Server for all new server-to-server integrations.
    5. Select the **Product Profiles** that include the report suites, metrics, and dimensions Gradial should be able to use.
    6. Save the project. Copy the **Client ID** and **Client Secret** from the credential details screen.
  </Step>

  <Step title="Find your Global Company ID">
    The Global Company ID identifies the Adobe Analytics company Gradial will query. Adobe's Discovery API returns this value, and many Adobe teams already track it as part of their Analytics setup. Your Adobe administrator can provide it if you don't have it on hand.
  </Step>

  <Step title="Add the integration in Gradial">
    1. In Gradial, go to **Settings → Integrations**.
    2. Find **Adobe Analytics** and click **+ Add**.
    3. Fill in the connection details:

    | Field                       | Value                                                                                          |
    | --------------------------- | ---------------------------------------------------------------------------------------------- |
    | **Integration Name**        | A display name (e.g., `My Adobe Analytics Connection`)                                         |
    | **Adobe Analytics API URL** | Pre-filled as `https://analytics.adobe.io` — leave as-is                                       |
    | **Client ID**               | From your Adobe Developer Console project                                                      |
    | **Client Secret**           | From your Adobe Developer Console project                                                      |
    | **Token URL**               | Use Adobe's standard token URL unless your Adobe team has specified a different approved value |
    | **Scope**                   | Use Adobe's standard Analytics scope unless otherwise directed                                 |
    | **Global Company ID**       | Your Adobe Analytics Global Company ID from Step 2                                             |

    4. Click **Save**.

    Once setup is complete, Gradial automatically applies the Global Company ID for all report requests — teams do not need to re-enter account identifiers when running reports.
  </Step>

  <Step title="Assign to an Environment">
    1. Go to **Settings → Environments** and select the Environment where analytics data should be available.
    2. Add the Adobe Analytics integration to that Environment.
    3. Repeat for any additional Environments.
  </Step>
</Steps>

***

## How It Fits Into Broader Workflows

| Use case                      | How to use it                                                                                                                                                                    |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fast self-serve reporting** | Use Report Builder when a PM or marketer wants a quick view of campaign, page, or segment performance without leaving Gradial                                                    |
| **Analytical workflow steps** | Use Gradial's workflow tooling when analytics needs to become part of a larger flow — comparing performance, drafting the next audience, or preparing a personalization decision |
| **CX Optimization**           | Bring Adobe Analytics directly into CX Optimizer so performance data informs what should happen next                                                                             |
| **Team alignment**            | Give PM, marketing, and delivery teams a common starting point for optimization work without sending people back into separate analytics tools                                   |

**Example flow:**

1. Pull a report for a campaign, journey, product area, or audience.
2. Compare performance across a dimension (page, channel, or segment).
3. Identify the strongest opportunity or biggest drop-off.
4. Use Gradial's workflow tooling to pull follow-up reporting or segment-specific views.
5. Feed that insight into CX Optimizer or a personalization flow.
6. Launch the next test, audience, or experience with much less back-and-forth.

***

## Troubleshooting

**"Invalid client" error when saving**
Double-check that the Client ID and Client Secret are copied exactly from Adobe Developer Console with no leading or trailing spaces.

**No report suites available**
Confirm the Product Profile linked to your Developer Console credential includes the correct report suites, and that Metrics and Dimensions access is enabled in Adobe Admin Console.

**Global Company ID not recognized**
The Global Company ID is a short alphanumeric string for your Adobe Analytics company. It is not the same as your IMS Organization ID (which ends in `@AdobeOrg`). Use Adobe's Discovery API or ask your Adobe administrator to retrieve it.

**Integration not available in a Workspace**
Assign the integration to the correct Environment under **Settings → Environments**.

***

## Support

Contact your Gradial onboarding lead or email [support@gradial.com](mailto:support@gradial.com) for help with setup or Report Suite configuration.