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

# Adobe Analytics

> Sync your analytics data from your warehouse to Adobe Analytics

## Overview

Adobe Analytics is a web analytics service that provides tools to understand customer behavior, measure marketing campaigns, and optimize the user experience. With Hightouch, you can send data from your data warehouse to Adobe Analytics to enrich your analytics with valuable customer data from various sources. This helps you build a more complete view of the customer journey and improve your marketing and product strategies.

This destination uses the [Adobe Analytics Batch Data Insertion (BDIA) API](https://developer.adobe.com/analytics-apis/docs/2.0/guides/endpoints/bulk-data-insertion/), which allows you to upload large amounts of data in batches.

## Supported syncing

| Type | Description | Supported Sync Modes |
| - | - | - |
| **Events** | Sync event data to Adobe Analytics for detailed analysis. | Insert |

For more information about sync modes, refer to the [sync modes](https://docs.hightouch.com/syncs/types-and-modes.md#sync-modes) docs.

## Connect to Adobe Analytics

Go to the [**Destinations** overview page](https://app.hightouch.com/destinations?from=docs) and click the **Add destination** button. Select **Adobe Analytics** and click **Continue**. You can then authenticate Hightouch to **Adobe Analytics** by entering the following required fields:

* **API Key (Client ID)**
* **Client Secret**

These credentials are not your Adobe Analytics login details. They are obtained by creating an OAuth app in the Adobe Developer Console.

For more information on how to create an OAuth app and obtain these credentials, see [Adobe's documentation](https://developer.adobe.com/developer-console/docs/guides/authentication/ServerToServerAuthentication/implementation#setting-up-the-oauth-server-to-server-credential)

## Sync configuration

Once you've set up your **Adobe Analytics** destination and have a [model](https://docs.hightouch.com/getting-started/concepts.md#models) to pull data from, you can set up your sync configuration to begin syncing data. Go to the [**Syncs** overview page](https://app.hightouch.com/syncs?from=docs) and click the **Add sync** button to begin. Then, select the relevant model and the Adobe Analytics destination you want to sync to.

This destination allows you to sync event data to Adobe Analytics. Each row in your model should represent a single event or interaction.

### Visitor identification

You can match rows from your model to visitors in Adobe Analytics using one of the following identifiers. Ensure the data types of the model column and the Adobe Analytics field you select match.

* **Visitor ID**: A unique identifier for the visitor.
* **Marketing Cloud Visitor ID**: The Adobe Marketing Cloud visitor identifier.
* **IP Address**: The visitor's IP address.
* **Customer ID**: Your internal customer identifier.

Refer to the [record matching docs](https://docs.hightouch.com/syncs/record-matching.md) for more information.

> [!NOTE]
>
> In **Insert** mode, Adobe Analytics automatically generates an identifier for
> every new record synced, so there is no need to match an existing record if
> you are only sending new events. However, providing a stable visitor
> identifier is crucial for tying events to the correct user profiles.

### Field mapping

Hightouch lets you sync event fields via [field mapping](https://docs.hightouch.com/syncs/mapping-data.md). You can map data from any of your model columns to standard and custom Adobe Analytics fields. The following fields are required:

* **Report Suite ID**: Your Adobe Analytics report suite identifier.
* **Timestamp**: The time of the interaction, in Unix timestamp or ISO-8601 format.
* **User Agent**: The device's user agent string.

For a full list of available fields, refer to the [Adobe Analytics BDIA API documentation](https://developer.adobe.com/analytics-apis/docs/2.0/guides/endpoints/bulk-data-insertion/file-format/#required-columns).

## Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the [live debugger](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).