This document describes the event data model implemented by all Digioh Tracking Plugin Apps, e.g. for Google Analytics 4 and Amplitude. It is the standard data model for Digioh Box user interactions.
Default Properties Common to all Events
- digioh_box_name = Example Box Name
- digioh_box_type = lightbox | sidebar | banner | inline
- digioh_box_id = 12345
- digioh_box_variation_id = 12345 (not set if box has no variation)
- digioh_url_path = /some/path/
- digioh_hq_id = 12345 (this is cryptically named to avoid being flagged as PII)
Default Events
These events are all tracked automatically by the Digioh GA4 app.
- digioh_box_display: Standard event when box is rendered on the page.
- digioh_box_engaged: Standard event when user transitions beyond first box page.
- digioh_box_submit: Standard event when box-page-form is submitted. Sets these additional properties:
- digioh_box_page = main | thx | ep1 …
- digioh_box_redirect: Standard event when box redirects due to button click. Sets:
- digioh_box_redirect_domain = Domain of the redirect target
- digioh_box_redirect_path = Path of the redirect target
- digioh_box_close: Standard event when the box is closed.
- digioh_box_download: Standard event when file is downloaded. Sets:
- digioh_box_download_url : Full URL of the asset
- digioh_box_conversion: New event when reaching a page or clicking a button that is configured with conversion : someMeaningfulLabel metadata. Sets additional properties:
- digioh_box_page = Configured Page Title | main | thx | ep1 …
- digioh_box_conversion = someMeaningfulLabel
- digioh_box_conversion_type = page | button
- digioh_box_pageview: New event that tracks individual page views. Set these additional properties:
- digioh_box_page = Configured Page Title | main | thx | ep1 …
- digioh_collected_email: New event that tracked when email address is captured in a form. Only happens automatically for native email fields, so you need to configure a custom GA4 event when collecting emails via Custom Fields.
- digioh_collected_phone New event that tracked when phone number is captured in a form. Only happens automatically for native phone fields, so you need to configure a custom GA4 event when collecting emails via Custom Fields.