Skip to main content

Debug options

Debug mode​

You can enable debug mode to add is-test field with value of 1 to the settings request, as well as to add debug field with value of true to analytics requests.

PAAnalytics.enableDebugMode()

You can also disable it with:

PAAnalytics.disableDebugMode()

Realtime Debugging​

We offer some ways of debugging your events. For one, you can enable or disable direct send. By default it's disabled. When enabled, logged event/attribute will be sent immediately without waiting for the batch size to reach the limit, and without waiting for the time interval to pass.

PAAnalytics.enableDirectSend()

And disable it with

PAAnalytics.disableDirectSend()

UI Debugging​

The Analytics SDK provides a simple UI to facilitate testing experiments and modifying configurations in analytics. You are responsible for presenting it modally or pushing it onto the navigation stack. To obtain a prepared instance of the appropriate view controller, you should call:

PAAnalytics.debugUIController()
     
debugui_9debugui_Adebugui_Bdebugui_Cdebugui_D

UI Events Monitoring Widget​

The Analytics SDK includes a simple widget that overlays all views and enables monitoring of analytics events occurring in the system. In its collapsed state, this widget displays the following:

  • Count of fired events
  • Count of transferred events
  • Count of events with warnings
  • Count of invalid events (after backend validation)

By clicking on the widget, you can access detailed information about each event, such as its internal structure, fields, reasons for invalidation, and more. In its expanded state, the widget also provides access to the Analytics SDK settings, allowing you to modify the SDK's behavior at runtime. To manage the widget's visibility and monitoring mode, you can use the appropriate API calls provided by the Analytics SDK.

PAAnalytics.configSet(trackingMonitoringEnabled: true, preferPreviousChoice: true)
     
debugui_1debugui_2debugui_3debugui_4debugui_5
Danger Zone

Please make sure this UI cannot be opened in production builds so your users can't see this UI. It's designed only for debuging.