A universal debugger for Adobe Analytics/AEP products for analysts and developers alike. A spiritual successor of AAD, Switch, AEPD.
Universal Adobe Debugger Extension
🔍 Universal Adobe Debugger: Simplifying Adobe Analytics, AEP and Launch Debugging 🦝
Crafted by analysts, for analysts, Universal Adobe Debugger is your go-to tool for effortlessly debugging Adobe Analytics, AEP and Launch (Tags). Simply open the console while invoking Adobe Analytics or Web SDK calls to reveal powerful insights.
Key Features:
* Streamlined Debugging: Log Adobe Analytics server calls directly in the console for quick troubleshooting.
* Efficient Launch Debugging: Access Adobe Launch debugging info with ease.
* Library Replacement Functionality: Seamlessly replace Adobe Launch libraries for enhanced debugging capabilities.
* Handy Snippets Collection: Explore a curated collection of snippets for analytics and consent debugging.
* AEP Web SDK Logging: Monitor AEP Web SDK server calls directly from the console with custom logging options to avoid going into the nested objects every time.
Whether you're a seasoned analytics expert or someone tangentially involved in analytics, Universal Adobe Debugger offers a universal solution tailored to your needs.
🛠️ Contributions and Feedback Welcome:
Have a suggestion or noticed a bug? Don't hesitate to reach out! Visit our GitHub repository at [link] to leave feedback or report issues.
Ready to contribute? Join us in making debugging easier for everyone!
Changelog:
2024-11-08 -> 1.21
* [x] Change the extension icon depending on the env:
* grey for when the extension hasn't yet executed all code or doesn't have the permission to do so;
* green indicates that the Launch env is production;
* yellow indicates that the Launch env is dev or staging;
* red indicates that the Launch library is not loaded or loaded incompletely. Basically, _satellite?.environment?.stage is falsy. The rest of the functionality won't be stopped by this, however.
* [x] Update the extension icon.
* [x] Disable Launch UI improvements on by default.
* [x] Multiple small bugfixes and refactories.
2024-10-04 -> 1.20
* [x] Add onInstalled/onStartup callbacks to set the default set of settings specifically for those who don't open the popup after installation.
* [x] Support for Mozilla FF. Same extension. Cross-browsers. Seems like mostly only background will have to be reimplemented, but many APIs may be off. We'll see.
2024-10-01 -> 1.10
* [x] Appmeasurement: Prettify the product string printing.
* [x] Appmeasurement: Add transaction id in the product string prettifier.
* [x] Implement Launch UI improvements POC:
* [x] Launch UI: Add the red indicator whenever a lib is not selected.
* [x] Launch UI: Add a hint about how to change the Launch UI via Chrome flags.
* [x] Add an option to print general alloy config in the snippets tab. Make sure it does so for all Alloy instances.
2024-09-02 -> 1.09.1
* [x] Rename the content-script.js to something more interesting. It's visible in the console and can be filtered by.
* [x] Web SDK: Further improve the custom logging, allowing shorthands: p12/c12/v12/e12/l2.
* [x] Apply all the shorthanded custom logging to Appmeasurement logging too.
2024-08-26 -> 1.09.1
* [x] Fix a bug in custom logging, in event shortcuts for the data.__adobe.analytics usecases.
* [x] Fix a bug in custom logging, in prop shortcuts for the data.__adobe.analytics usecases.
2024-08-25 -> 1.09:
* [x] Web SDK: Expose the event type in the logging header.
* [x] Web SDK: Improve the custom logger to also check the data.__adobe.analytics object when using shortcuts.
* [x] Web SDK: Make it easier for non-technical people to use the custom logging: don't require them to specify the full path to evars, props or events for xdm payloads. If users ask for evars and it's an xdm event, just add the correct path to it.
* [x] Reimplement page load time to something like performance.getEntriesByType(\"navigation\")[0]?.duration
2024-08-20 -> 1.08.1:
* [x] Increased the delay at which the response is no longer expected to six seconds. Because AA can be very slow to respond.
2024-08-18 -> 1.08:
* [x] Web SDK: On errors, in custom logs, add an indication that the request resulted in an error. This is for people who use filters in the console like pros. Thanks Arun for noticing.
* [x] Web SDK: MVP tracking the navigator.sendBeacon() ping network requests. No access to their payloads, however, because the Chrome devteam neglects fixing related bugs.
* [x] Delete requests from the map on other callbacks too to avoid misreporting calls as such that didn't receive the server response.
2024-08-14 -> 1.07.01:
* [x] Increased the delay at which the response is no longer expected to two seconds.
* [x] Cleanup.
2024-08-13 -> 1.07:
* [x] Print the extension version, getting it from the manifest.
* [x] UX improvements, CSS fixes.
* [x] Add a bug submission button in info.
* [x] Web SDK: Add an option to log all fields there are, giving the user the raw object.
* [x] Add a callback and error logging for \"cancelled\" requests. That's when the browser cancels the request. And a few other types of requests. Thanks to Arun for the suggestion.
* [x] Web SDK: Apply the error logging logic to Web SDK tracking too
* [x] Small popup UI improvements.
2024-06-02 -> 1.06 - Byanka:
* [x] Replace the counter of PVs and links with AA calls and WebSDK calls
* [x] Web SDK: Improve autodebugging: indicate when linkClicks will be treated as pageviews in AA due to the web fields set.
* [x] Web SDK: Surface the Edge config ids for every request, make them visible just like AA Report Suites. To ease the debugging of multi-destinational tracking. First 5 characters should suffice.
* [x] Web SDK: Improve the tracking of network errors when edge network requests fail.
* [x] Web SDK: Refactor logging. Make it less confusing. No more nested groups.
* [x] Web SDK: Change the default logging a bit to maybe try and expand the analytics object automatically.
* [x] Web SDK: Add a setting to remove the essentially useless xdm fields that are rarely useful to look at. On by default.
* [x] Web SDK: Improve the logging for non-object fields.
* [x] Web SDK: Add logging for the data.__adobe object. Off by default in settings.
* [x] Web SDK: Reinforce the custom logging field, allow people to use the xdm. reference in the list of params.
2024-03-02 -> 1.05:
* [x] QOL Improvements for the custom web SDK logging.
* [x] Allow the underscore in the field names.
* [x] Small reporting improvements.
2024-03-02 -> 1.04:
* [x] Configure selective logging for the web SDK.
2024-02-16 -> 1.03:
* [x] CSS improvements of the extension popup. Thanks Chip!
* [x] Fix a bug in the new custom logging code.
* [x] Add a line to indicate the end of the main logging group for easier reading.
2024-02-13 -> 1.02:
* [x] Allow the user to set their own variables to be included in the header of the logging.
* [x] Improve _satellite.setDebug(0) to work immediately rather than after a page reload.
* [x] Small cosmetic improvements.
2024-02-06 -> 1.01:
* [x] Code refactory in the popup scripts.
* [x] Add a feature to highlight merch events that aren't present in s.events. Why would Adobe do this? Feels like a bug.
* [x] Merchandising variables logging improvements (\", \" delimiter instead of the pipe \"|\").
* [x] Add reporting for s.zip, currency code, org id (mcorgid) and visitor id (mid).
* [x] The \"Other\" reporting section is now collapsed by default due to the number of not-so-useful new dimensions added there.
* [x] A bit more ui improvements.
* [x] Raccoon.
For older versions, please refer to github releases here: https://github.com/cthae/Adobe-Launch-Debugger/releases
Read more
Crafted by analysts, for analysts, Universal Adobe Debugger is your go-to tool for effortlessly debugging Adobe Analytics, AEP and Launch (Tags). Simply open the console while invoking Adobe Analytics or Web SDK calls to reveal powerful insights.
Key Features:
* Streamlined Debugging: Log Adobe Analytics server calls directly in the console for quick troubleshooting.
* Efficient Launch Debugging: Access Adobe Launch debugging info with ease.
* Library Replacement Functionality: Seamlessly replace Adobe Launch libraries for enhanced debugging capabilities.
* Handy Snippets Collection: Explore a curated collection of snippets for analytics and consent debugging.
* AEP Web SDK Logging: Monitor AEP Web SDK server calls directly from the console with custom logging options to avoid going into the nested objects every time.
Whether you're a seasoned analytics expert or someone tangentially involved in analytics, Universal Adobe Debugger offers a universal solution tailored to your needs.
🛠️ Contributions and Feedback Welcome:
Have a suggestion or noticed a bug? Don't hesitate to reach out! Visit our GitHub repository at [link] to leave feedback or report issues.
Ready to contribute? Join us in making debugging easier for everyone!
Changelog:
2024-11-08 -> 1.21
* [x] Change the extension icon depending on the env:
* grey for when the extension hasn't yet executed all code or doesn't have the permission to do so;
* green indicates that the Launch env is production;
* yellow indicates that the Launch env is dev or staging;
* red indicates that the Launch library is not loaded or loaded incompletely. Basically, _satellite?.environment?.stage is falsy. The rest of the functionality won't be stopped by this, however.
* [x] Update the extension icon.
* [x] Disable Launch UI improvements on by default.
* [x] Multiple small bugfixes and refactories.
2024-10-04 -> 1.20
* [x] Add onInstalled/onStartup callbacks to set the default set of settings specifically for those who don't open the popup after installation.
* [x] Support for Mozilla FF. Same extension. Cross-browsers. Seems like mostly only background will have to be reimplemented, but many APIs may be off. We'll see.
2024-10-01 -> 1.10
* [x] Appmeasurement: Prettify the product string printing.
* [x] Appmeasurement: Add transaction id in the product string prettifier.
* [x] Implement Launch UI improvements POC:
* [x] Launch UI: Add the red indicator whenever a lib is not selected.
* [x] Launch UI: Add a hint about how to change the Launch UI via Chrome flags.
* [x] Add an option to print general alloy config in the snippets tab. Make sure it does so for all Alloy instances.
2024-09-02 -> 1.09.1
* [x] Rename the content-script.js to something more interesting. It's visible in the console and can be filtered by.
* [x] Web SDK: Further improve the custom logging, allowing shorthands: p12/c12/v12/e12/l2.
* [x] Apply all the shorthanded custom logging to Appmeasurement logging too.
2024-08-26 -> 1.09.1
* [x] Fix a bug in custom logging, in event shortcuts for the data.__adobe.analytics usecases.
* [x] Fix a bug in custom logging, in prop shortcuts for the data.__adobe.analytics usecases.
2024-08-25 -> 1.09:
* [x] Web SDK: Expose the event type in the logging header.
* [x] Web SDK: Improve the custom logger to also check the data.__adobe.analytics object when using shortcuts.
* [x] Web SDK: Make it easier for non-technical people to use the custom logging: don't require them to specify the full path to evars, props or events for xdm payloads. If users ask for evars and it's an xdm event, just add the correct path to it.
* [x] Reimplement page load time to something like performance.getEntriesByType(\"navigation\")[0]?.duration
2024-08-20 -> 1.08.1:
* [x] Increased the delay at which the response is no longer expected to six seconds. Because AA can be very slow to respond.
2024-08-18 -> 1.08:
* [x] Web SDK: On errors, in custom logs, add an indication that the request resulted in an error. This is for people who use filters in the console like pros. Thanks Arun for noticing.
* [x] Web SDK: MVP tracking the navigator.sendBeacon() ping network requests. No access to their payloads, however, because the Chrome devteam neglects fixing related bugs.
* [x] Delete requests from the map on other callbacks too to avoid misreporting calls as such that didn't receive the server response.
2024-08-14 -> 1.07.01:
* [x] Increased the delay at which the response is no longer expected to two seconds.
* [x] Cleanup.
2024-08-13 -> 1.07:
* [x] Print the extension version, getting it from the manifest.
* [x] UX improvements, CSS fixes.
* [x] Add a bug submission button in info.
* [x] Web SDK: Add an option to log all fields there are, giving the user the raw object.
* [x] Add a callback and error logging for \"cancelled\" requests. That's when the browser cancels the request. And a few other types of requests. Thanks to Arun for the suggestion.
* [x] Web SDK: Apply the error logging logic to Web SDK tracking too
* [x] Small popup UI improvements.
2024-06-02 -> 1.06 - Byanka:
* [x] Replace the counter of PVs and links with AA calls and WebSDK calls
* [x] Web SDK: Improve autodebugging: indicate when linkClicks will be treated as pageviews in AA due to the web fields set.
* [x] Web SDK: Surface the Edge config ids for every request, make them visible just like AA Report Suites. To ease the debugging of multi-destinational tracking. First 5 characters should suffice.
* [x] Web SDK: Improve the tracking of network errors when edge network requests fail.
* [x] Web SDK: Refactor logging. Make it less confusing. No more nested groups.
* [x] Web SDK: Change the default logging a bit to maybe try and expand the analytics object automatically.
* [x] Web SDK: Add a setting to remove the essentially useless xdm fields that are rarely useful to look at. On by default.
* [x] Web SDK: Improve the logging for non-object fields.
* [x] Web SDK: Add logging for the data.__adobe object. Off by default in settings.
* [x] Web SDK: Reinforce the custom logging field, allow people to use the xdm. reference in the list of params.
2024-03-02 -> 1.05:
* [x] QOL Improvements for the custom web SDK logging.
* [x] Allow the underscore in the field names.
* [x] Small reporting improvements.
2024-03-02 -> 1.04:
* [x] Configure selective logging for the web SDK.
2024-02-16 -> 1.03:
* [x] CSS improvements of the extension popup. Thanks Chip!
* [x] Fix a bug in the new custom logging code.
* [x] Add a line to indicate the end of the main logging group for easier reading.
2024-02-13 -> 1.02:
* [x] Allow the user to set their own variables to be included in the header of the logging.
* [x] Improve _satellite.setDebug(0) to work immediately rather than after a page reload.
* [x] Small cosmetic improvements.
2024-02-06 -> 1.01:
* [x] Code refactory in the popup scripts.
* [x] Add a feature to highlight merch events that aren't present in s.events. Why would Adobe do this? Feels like a bug.
* [x] Merchandising variables logging improvements (\", \" delimiter instead of the pipe \"|\").
* [x] Add reporting for s.zip, currency code, org id (mcorgid) and visitor id (mid).
* [x] The \"Other\" reporting section is now collapsed by default due to the number of not-so-useful new dimensions added there.
* [x] A bit more ui improvements.
* [x] Raccoon.
For older versions, please refer to github releases here: https://github.com/cthae/Adobe-Launch-Debugger/releases
Source Manifest.json
{"update_url": "https://clients2.google.com/service/update2/crx", "manifest_version": 3, "name": "Universal Adobe Debugger", "description": "A universal debugger for Adobe Analytics/AEP products for analysts and developers alike. A spiritual successor of AAD, Switch, AEPD.", "version": "1.21.1", "action": { "default_popup": "main.html", "default_icon": "favicon 16-4 - grey.png" }, "icons": { "16": "favicon 16-4 - green.png", "32": "debuggerFavicon 32.png", "48": "debuggerFavicon 48.png" }, "background": { "scripts": ["js/background.js"], "service_worker": "js/background.js" }, "content_scripts": [{ "matches": ["", "http://*/*", "https://*/*"], "js": ["js/UAD-cs.js"] }, { "matches": ["https://assets.adobedtm.com/extensions/*", "https://launch.adobe.com/*", "https://experience.adobe.com/*"], "js": ["js/adobe-launch.js"], "css": ["css/adobe-launch.css"], "all_frames": true } ], "host_permissions": ["", "http://*/*", "https://*/*"], "externally_connectable": { "ids": ["*"], "matches": ["", "http://*/*", "https://*/*"], "accepts_tls_channel_id": false }, "permissions": [ "storage", "webRequest", "declarativeNetRequest", "activeTab", "scripting" ], "browser_specific_settings": { "gecko": { "id": "universal-adobe-debugger@c" } }}
Read more