Adobe Analytics 2.0 API changes in the last few weeks: any documentation? | Community
Skip to main content
Level 2
January 10, 2024
Question

Adobe Analytics 2.0 API changes in the last few weeks: any documentation?

  • January 10, 2024
  • 4 replies
  • 2214 views

Happy New Year all!

 

I've been using the Reporting 2.0 API to power our Tableau dashboards for years. Since the Christmas break, I've noticed that all the API responses have changed and I can't find any API-specific documentation to learn more. Are more changes coming? What is the intention of the changes? 

 

For example, when requesting visits by week by tracking code, the response used to include the following data: 

data: list

itemId: str

value: str

 

Now, I see the addition of two lists:

data: list

itemId: str

itemIds: list

value: str

values: list

 

Any ideas? 

This post is no longer active and is closed to new replies. Need help? Start a new post to ask your question.

4 replies

Jennifer_Dungan
Community Advisor and Adobe Champion
Community Advisor and Adobe Champion
January 10, 2024

This isn't the first post about changes to the APIs... I haven't seen any new documentation yet, but I have reached out to someone at Adobe to see if we can get some info for people.

Gigazelle
Adobe Employee
Adobe Employee
January 10, 2024

Which API endpoint is this for? Reporting API, Data Warehouse API, or something else?

Level 2
January 10, 2024

Reporting.

Level 2
January 10, 2024

Similar thread is here: Adobe Analytics API - Adobe Experience League Community - 643303

A few members have surfaced the same issue of having new fields "itemIds" and "values", with "s" on the end. 

@gigazelle FYI regarding the other thread but I'm assuming you're already aware. 

Level 2
January 11, 2024

I just got this reply on my support ticket:

 


The fix is pushed to prod. Additional fields `itemIds` and `values` are removed from the response in traditional analytics.

 

Level 2
January 11, 2024

Additional info from support: 

In the future, Adobe may add additional fields to the JSON response in their APIs. Customers should not rely on strict JSON parsing and should be flexible to the presence of new fields in the future.

 

Well-built (interoperable) JSON parsing and data handling systems are expected to ignore new members that they don't understand and thus new members should be addable to an object without affecting existing members.

 

In addition, the Report API documentation Reporting API (adobe.com) specifically states, "This guide does not include descriptions for all request and response parameters for the reports endpoint. "

 

Adobe reserves the right to add additional members to JSON objects and considers the addition of new members to existing objects to be a non-breaking change and thus does not version API methods when new members are added. A breaking change, which would result in versioning of the API methods, would be something like changing the name of a member or deleting or no longer returning a member.

Jennifer_Dungan
Community Advisor and Adobe Champion
Community Advisor and Adobe Champion
January 11, 2024

I agree with this.. processing the response shouldn't be rigid... if a data field was changed that would cause a breakage (actually switching a string to list, etc)...  but adding new fields should roll through (if the process was coded properly).

 

If you rely on "key in position 1" and "key in position 2", instead of on the key names, this can cause issues because new fields may filter into those positions unexpectedly.