Using Postman to Make Adobe Analytics 2.0 API Requests
- Topics:
- API
CREATED FOR:
- Experienced
- Developer
This video walks through how to setup Postman, an API client, to send Adobe Analytics 2.0 API requests. It includes setting up an Adobe I/O integration (NOTE: you need to be a system admin in Experience Cloud to set this up), where to find your global company ID, and more.

Transcript
Hi this is Jen Lasser with Adobe Analytics product management. In this video, I’m going to show you how to use Postman. Which is an API client to make requests to the Adobe Analytics 2.0 API. The first thing that you want to do when setting up Postman is request an Adobe IO client ID and client secret. So in Adobe IO we’ll go ahead and set up a new integration. So access in API is the option you want to select. And we’ll click continue.
On this screen, we’ll go ahead and select Experience Cloud Adobe Analytics and then OAuth Integration. Hit continue. On the next screen we can go ahead and hit continue again. And then this is the final screen of setting up the integration. You’ll type in your name, for the integration. Description. Default redirect URI and redirect URI pattern. The redirect URI and redirect URI pattern for Adobe is https www adobe.com and then the redirect URI pattern is just the same thing with the periods escaped. Check the captcha and then go ahead and create integration. I’ve already set up an integration so I’ll just go ahead and click cancel. So I’m going to pull up the integration that I already created. We’ll go ahead and hit view here. You can see it has a trend of how many API calls I’ve made. But the important part on this screen is the client ID and the client secret. These are the two things that you’ll need to type into Postman to set up access to the 2.0 API.
The second thing that you’ll need for setting up Postman is your company ID. To get your company ID, you can go to swagger and run any requests. Down in the response section you’ll see the request URL. This request URL is very helpful for Postman as well, so you can copy that. But a piece of this is the company ID, so mine is AdobePA. So you’ll want to remember that as well as we head into Postman. In Postman, you can set up your first request. To do this, you’ll want to go to authorization, and select type Oauth 2.0. From here, you’ll hit, get new access token. We have a full documentation page that tells you all the different inputs that you need here. So I’ve pre-populated them. Callback URL will be the same thing as the redirect URI that you set up in Adobe IO. The client ID can be copied over from Adobe IO as well as the client secret. So we go ahead and copy the client ID. And we’ll paste that in here. Then we’ll also retrieve our client secret. And we’ll copy that as well. And paste that into the client secret field.
Then you can hit request token after you filled out the rest of the form. The request will take you through the Experience Cloud login process.
And then it will retrieve an access token that you can use for this session.
So go ahead and click x here. And under available tokens, you will now see the token that we just retrieved. So go ahead and select that.
You can preview requests. Which will set the headers that you need for the request you’re about to make. Over in the header section, that preview request action set up this authorization key with a bearer value.
The other two keys that you want to set up are the x proxy global company ID. This is where we’ll take that value that we got from swagger and paste it in. And then the API key is the client ID that you got from Adobe IO. So we’ll paste that here. Once you have the header set up, you’re all set to run your first request. So you can use swagger to find different types of requests that you can make. The first one that I wanted to demonstrate is just the ability to get a list of your users. The request string looks like this. With your global company ID in it. And then the method that you want to use. And then I’ll limit the request to return 500 rows on a single page. And we’ll go ahead and click send. You’ll see in the body below the response says returned. And you can start to see a list of users that are a part of your company. I want to show you one more method beyond the users method. And that is the reports method in the 2.0 API. To do a reports method, you want to change from get to post. And then you also want to change your URL to reports. For the reports method, you want to enter in some content to the body. If you don’t know how to formulate API 2.0 requests, we’ve put together another video about how to use analysis workspace to build a request for you that you can check out. Once on the body tab, click over to raw, and then change your format to jSON application. From here, you can enter in our API request or paste it in from the value that you got out of analysis workspace. And then go ahead and click send. Sending the request will generate a new body below.
In the body you can see the results of the request that you made. So I made a pages request, I just wanted the top 50 values with visits pulled in. So you can see, it has returned the top pages. Starting with home page, which had 36,000 visits. And then the next page of purchase step one, so on and so forth. This has been a demonstration of setting up Postman to make API 2.0 requests. We covered the users method as well as the reports method which is used in analysis workspace. Hope you guys enjoy exploring the new API 2.0.
For more information, visit the documentation.
Analytics
- Analytics tutorials
- Introduction to Analytics
- What is analytics
- What Can Adobe Analytics Do For Me?
- How Adobe Analysis Workspace Can Change Your Business
- It’s More Than Data. It’s Customer Intelligence
- Adobe Sensei and Adobe Analytics
- Customer Use Case - ServiceNow
- Customer Use Case - Accent Group
- Customer Use Case - The Home Depot
- Summit 2019 Super Session - Travel and Hospitality
- Summit 2019 Super Session - Retail
- Summit 2019 Super Session - High Tech
- Strategy & thought leadership
- Transitioning from other platforms
- Analytics Basics
- Customizing the UI
- Getting Help
- Analysis Workspace
- Analysis Workspace Basics
- Analysis Workspace quick intro
- Analysis Workspace overview
- Navigate the new landing page
- Start your analysis with a pre-built report
- Building a Workspace project from scratch
- Create and manage custom templates in Analysis Workspace
- Understanding how data gets into your Analysis Workspace project
- Foundational metrics in Adobe Analytics
- Component management in Analysis Workspace
- Selecting a report suite in Analysis Workspace
- View Analysis Workspace performance metrics
- Create bot reports
- Tips and Tricks
- Navigating Workspace Projects
- Data Dictionary in Analysis Workspace
- Starting your first project
- Training tutorial template
- Use folders in Analysis Workspace
- Copy and insert panels and visualizations
- Create a table of contents
- Right-click for Workspace efficiency
- Keyboard shortcuts
- Annotations
- View density
- Use filters
- Use multi-select drop-down filters
- Real-time reports
- Using Panels
- Using Tables, Visualizations, and Panels in Analysis Workspace
- Quick Insights Panel in Analysis Workspace
- Using the Attribution IQ Panel
- Media Concurrent Viewers Panel in Analysis Workspace
- Media Playback Time Spent Panel
- Using Drop-down Filters
- Using Panels to Organize your Analysis Workspace Projects
- Choose segments for a panel
- Multiple Report Suites in Analysis Workspace
- Next/Previous and Page Summary Workspace Panels & Reports
- Understanding attribution panel and lookback windows
- Building Freeform Tables
- Understand your data–freeform tables
- Use the left rail to build freeform tables
- Easy drag and drop to blank projects
- Work with dimensions in a freeform table
- Work with metrics in a freeform table
- Row and column settings in freeform tables
- Freeform table totals
- Use the freeform table builder
- Right-click for workspace efficiency
- Reorder static rows
- Use Attribution IQ in freeform tables
- Cross-sell analysis
- Freeform table filters
- Time-parting dimensions
- Visualizations
- Visualization types and overview
- Visualization use cases
- Data visualization playbook
- Getting data into visualizations
- Using component drop-downs in Workspace
- Area and area stacked visualizations
- Bar and bar stacked visualizations
- Bullet graph visualization
- Donut visualization
- Histogram visualization
- Unlocking insights with histograms
- Line visualization
- Combo charts
- Adding trend lines to line visualizations
- Map visualization
- Summary number and summary change visualizations
- Key metric summary visualization
- Text visualization
- More than words - Using text visualizations and descriptions
- Scatterplot visualization
- Treemap visualization
- Venn diagram visualization
- Use the cumulative average function to apply metric smoothing
- Flexible layouts
- Changing the scale/axis on visualizations
- Dimension-graph live linking
- Set the granularity for visualizations
- Link inside or outside of your project
- Customize visualization legends
- 100% stacked visualizations
- Table and visualization data source settings
- Build a time-parting heatmap
- Analyzing Customer Journeys
- Applying Segments
- Apply segments to your Analysis Workspace project
- Apply ad hoc segments
- Use different Attribution IQ models with segments
- Choose segments for a panel
- Use segments as Dimensions in Analysis Workspace
- Use segments to limit data in Analysis Workspace
- Quick segments in Analysis Workspace
- Building Customer Journey Segments
- Building Customer Journey Segments - Part 2
- Metrics
- Dimensions
- Calendar and Date Ranges
- Curate and Share Projects
- Attribution IQ
- Using Cross-tab Analysis to Explore Basic Marketing Attribution
- Adding side-by-side comparisons of Attribution IQ Models
- Attribution IQ in Calculated Metrics
- Using Attribution IQ in Freeform Tables
- Using the Attribution IQ Panel
- Using different Attribution IQ models with segments
- Algorithmic Model in Attribution IQ
- Custom Look-back Windows in Attribution IQ
- Cohort Analysis
- Cohort Analysis in Analysis Workspace
- Understand your data–Cohort Tables
- Overview of Cohort Tables
- Cohort Table Settings
- Churn Analysis with Cohort Tables
- Cohort Analysis Using Any Dimension
- Latency Analysis with Cohort Tables
- Calculate Rolling Retention in Cohort Tables
- Use Cohort Analysis to Understand Customer Behavior
- Voice Analytics
- How to Manage and Track Your Voice Assistant App Data
- Understand Differences Across Voice-Enabled Devices
- Finding Opportunities To Increase Engagement for Voice Apps
- Reducing Error Rates and Improving Success Rates in Your Voice App
- Understand User Behavior on Voice Assistants
- Understanding the User’s Voice Journey
- Analysis Workspace Basics
- Administration
- Key Admin Skills
- Creating an empowered community
- Simplify and spend less time training users
- Getting the Right People on Your Analytics Team
- Gaining a seat at the table
- Telling impactful stories with data
- Translating Adobe Analytics technical language in a non-technical way
- Working cross-functionally
- Are you asking the right questions?
- Admin Tips and Best Practices
- Download the implementation playbook
- Audit your data dictionary
- Create standardized naming conventions
- Create standardized code templates
- Create basic videos and training
- Create an internal Adobe Analytics site
- Use a global report suite
- Create a news & announcements project
- Drive success with executive summary dashboards
- Create Operational Dashboards
- Company Settings
- User Management
- Manage Report Suites
- How to Configure General Account Settings
- Customize Calendar Settings
- Configure Paid Search Detection
- Set up marketing channels
- Create marketing channel processing rules
- Manipulating incoming data with Processing Rules
- Configuring Traffic Variables (props)
- Configure traffic classifications
- Configure hierarchy variables
- Configuring Variables in the Admin Console
- Configure conversion classifications
- Configuring List Variables
- Configure Finding Methods
- Set Internal URL Filters
- Configuring Zip and Postal Code Settings
- Enable the Timestamp Optional setting
- Configure bot rules in Analytics
- Data Governance and GDPR
- Traffic Management
- Logs
- Key Admin Skills
- Implementation
- Implementation Basics
- Experience Platform Tags
- Implement Experience Cloud solutions in websites using Tags
- Basic configuration of the Analytics extension
- Configure library management in the Analytics extension
- Configure general settings in the Analytics extension
- Configure global variable settings in the Analytics extension
- Use custom code in the Analytics extension
- Use a data layer to set variables
- Use doPlugins and implementation plug-ins
- Configure easy download link tracking
- Configure easy exit link tracking
- Prepare Tags for your Analytics implementation
- Create data elements for the Analytics implementation
- Create a global page load rule
- Validate the global page load rule
- Create rules for special pages
- Create rules for success events
- Publish Tags libraries to stage and production
- Using JavaScript
- Components
- Segmentation
- Segment builder overview
- Finding and creating segments
- Rolling date ranges in segments
- Segment comparison in Analysis Workspace
- Segment containers
- Segment management and sharing
- Applying segments in Analysis Workspace
- Using segments as dimensions
- Using segments to limit data
- Differences between the segment builder and quick segments
- Sequential segmentation
- Before/After sequences in sequential segmentation
- Segmentation on distinct dimension counts
- Dimension models in segmentation
- Use ‘equals any of’ in segmentation
- Analytics Insider Webinar - Customer Segmentation Strategies
- Now just wait a segment… Using segmentation to discover new insights
- Calculated Metrics
- Calculated metric builder overview
- Calculated metrics - implementation-less metrics
- Calculated metrics - segmented metrics
- Calculated metrics - functions
- Approximate count distinct function in calculated metrics
- Quick calculated metrics in Analysis Workspace
- Manage your calculated metrics
- Attribution IQ in calculated metrics
- Use dimensions in calculated metrics
- Take your data analysis to the next level with calculated metrics
- Classifications
- Virtual Report Suites
- Activity Map
- Segmentation
- Additional Tools
- Exporting
- From the UI
- Data Warehouse
- Data Feeds
- Report Builder
- Upgrade and reschedule workbooks
- Add Segments to Multiple Requests at Once in Report Builder
- Anomaly Detection in Report Builder
- Edit Metrics across Requests
- Using Report Builder to learn the Adobe Analytics API
- Get started with Report Builder
- Schedule a Report Builder request
- Use Report Builder advanced delivery options for Power BI
- Integrations
- Experience Cloud
- Audience Manager
- Target
- Adobe Advertising DSP
- Configuring Advertising Analytics
- Implementing tracking templates into search engines
- Introduction to the Adobe Advertising DSP integration
- Create a Pre-launch campaign analysis
- Report on Advertising DSP marketing channels
- Create Analytics site journey profiles
- Create Analytics segments for activation and reporting
- Create Advertising DSP alerts with Adobe Analytics
- Create Analytics custom metrics with Advertising DSP data
- Create Advertising DSP site entry reports
- Create Advertising DSP dashboards
- Ad Hoc Analytics
- Power BI
- Magento
- Data Science
- Vertical-Specific
- Media Analytics
- Mobile App Analytics
- APIs
- Analysis Use Cases