Adobe Analytics has a broad set of tools that you can use to integrate but no set of predefined integrations. This gives you a lot of flexibility in how you approach integrating with Adobe Analytics but it also adds complexity and you’ll need to do more work at the beginning of the project to understand these tools and decide which will work best for your use case.
Sections 1–3 describe the APIs and other features through which you could integrate your product with Adobe Analytics. Sections 4–5 describe how to set up credentials in your Adobe Analytics sandbox account so you can learn how Adobe Analytics works and so you can build and test your integration. Section 6 provides a link to an example of an Adobe Analytics integration that uses some of the tools from the list. Section 7 provides information on how to complete your Exchange listing in Developer Distribution. And finally section 8 is a reference section with links to more helpful documentation on each of the tools available to integrate with Adobe Analytics.
1. Adobe Analytics API (v2.0)
The most recent version of the Adobe Analytics API is version 2.0. While not all of the functionality from 1.4 has been moved over, this is the version of the API that will receive future support and we recommend that partners work with this version where possible. More functionality will be added to the API over time. See this documentation for details.
2. Adobe Analytics Legacy API (v1.4)
Adobe Analytics 1.4 APIs currently support the following APIs:
- Reporting
- Segments
- Calculated Metrics
- Classifications
- Saint
- Data Warehouse
- Data Insertion
- Data Sources
- Data Feeds
- Live Stream
Check out this documentation for details.
Until recently the 1.4 APIs used a legacy authentication process, however they have recently been updated to the Adobe I/O authentication method.
Note: While the JWT authentication method was recommended for server-to-server applications in the past, it has now been deprecated in favor of Oauth 2.0. See this article for details.
3. Adobe Experience Platform Data Collection
Adobe Experience Platform Data Collection is Adobe's tag management system and is the way that most new clients will deploy Adobe Analytics on their sites. Experience Platform Data Collection extensions are a great way to get data into Adobe Analytics. Check out the developer documentation to see if building an Experience Platform Launch extension would make sense for your integration. You might find that what you thought was an Adobe Analytics integration is actually better suited to an Experience Platform extension or that an Experience Platform extension will form a part of your integration.
4. Adobe Analytics sandbox account
Once you choose one of those two Adobe Analytics API connections in the App Manager, App Manager will automatically send a sandbox request to our provisioning team (if you don't already have an Adobe Analytics sandbox). You’ll need an Adobe Analytics sandbox to understand how Adobe Analytics works and to build and test your integration. See this help article for instructions on how to set up your user accounts and obtain access to your sandbox once it's been provisioned for you.
5. Obtaining test credentials for Adobe Analytics API version 2.0/1.4
This documentation details how you can use the new version of the Adobe Analytics API and how to obtain credentials through Adobe I/O to test the API to see if it will work for your use case with your clients.
6. Adobe Analytics integration case study
Here’s an example of how to use the Adobe Analytics product features and APIs to create an integration (in this case, an email service provider integration): Case Study Link.
7. Creating a listing using Developer Distribution
Developer Distribution is a tool that helps you create an integration listing for the Adobe Exchange. Clients that want to enable your integration will be able to search for your integration on the Adobe Exchange. When they click on your listing, they will be presented with details about the integration and instructions for how to enable the it.
Once you've figured out how your integration will work and built the necessary infrastructure. You can create your integration listing by adding the necessary licensing, documentation, instructions, and other media. This article describes how to complete a listing with Developer Distribution.
8. Other helpful links
Below are links to more documentation about Adobe Analytics product features that might be useful to a partner trying to integrate with Adobe Analytics. This documentation may be useful to you as you plan on how to build your integration.
Methods for getting data out of Adobe Analytics
- This Adobe Analytics Reporting API Comparison Table can help you to pick the right data export option for your use case.
- Adobe Analytics API v 2.0 documentation
- Adobe Analytics Legacy API (1.4) documentation:
Methods for getting Data into Adobe Analytics:
- This guide lists the various data collection methods available in Adobe Analytics. The ones used most commonly by partners are:
- Data Sources (used for importing batch offline data into Adobe Analytics):
- Classifications (used for uploading metadata to classify variables in Adobe Analytics):
- The Data Insertion API (a server-side alternative to client-side data collection):