November 20, 2020

Events log

This article describes the Event log metrics in detail and explains how to access the Event log. Additionally, it explains how to prepare a file and import events.

Events log

Step-by-step instructions

  • Navigate to the "Analytics" section.

  • Click the "Events log" button.

  • Filter data by specific criteria: Domains, Custom Events, Contact Sources, Event Types, and Date ranges.

  • Click the "Export to XLS file" icon to download the filtered data for further analysis.

  • Filters
    Icon caret
    • Domains - allows filtering by the domain name associated with contact lists; useful for accounts with multiple active domains to isolate specific reports.
    • Custom Event - filters the report to display only contacts associated with a specific registered event.
    • Contact Source - generates reports by customer acquisition origin, allowing users to be tracked by their original traffic source.
    • Event Type - a specialized filter used to identify and display specific events where a conversion took place.
    • Date range - a selector for a specific timeframe; limits the report data to the chosen dates for precise interval analysis.
  • Details
    Icon caret
    • Date - the specific date and time when the event was performed or recorded.
    • Project Domain - the domain name linked to one or more events within the system.
    • Event - the official name of the registered event in the Wooxy system.
    • Contact - the specific user or recipient to whom the event was assigned.
    • Contact Source - the original customer acquisition source, tracking users by their initial traffic origin.
    • Value - the monetary value or cost associated with the completed event.
    • Device - the hardware device used by the contact to complete the event.
    • UTM - the UTM tags assigned to the user at the moment of event completion for tracking purposes.

Preparing import file

The .XLS sample files are available for download and can be used as templates by replacing placeholder data with actual event information.

  • File headers
    Icon caret
    • date - The date when the event occurred.
    • time - The time when the event occurred.
    • dateTime - The combined date and time of the event in ISO8601 format. If the date and time fields are left empty, the system will automatically use the timestamp of the event's creation on the platform.
    • eventId - The unique ID of the event, which must be pre-registered in the system.
    • eventName - The unique name of the event, which must be pre-registered in the system.
    • contact - The recipient's identifier, such as an email address, userId, or phoneNumber, matching the data stored in the contact list.
    • value - The event value provided in ENUM_STRING format.
    • currency - The currency code (e.g., EUR, USD). Must be provided in uppercase Latin letters only; numbers and special symbols are not permitted.
    • ipAddress - The identifying IP address associated with the user's computer or network.
    • userAgent - The string identifying the browser type, version, and operating system (e.g., Mozilla/5.0... Chrome/85.0...).
    • httpReferer - An optional header field identifying the address of the webpage that linked to the requested resource.
    • utmSource - The specific traffic source (e.g., Direct, Adwords, Website).
    • utmMedium - The traffic type or marketing medium (e.g., Social Media, Banner, Email Newsletters, Retargeting).
    • utmCampaign - The specific name of the advertising campaign.
    • utmContent - An arbitrary tag used to differentiate similar content or links within the same ad (e.g., Banner Text).
    • utmTerm - The specific keyword or dynamic parameter used for search queries.

Step-by-step instructions

  • Navigate to the "Analytics" section.

  • Click the "Events log" button.

  • Press the “Import” button.

  • Select the import file via the "Choose File" button.

  • Activate the data upload process by clicking the "Import" button.

  • Observe the file validation process: larger files may require additional processing time. It is necessary to remain on the page until validation is complete; after that, the system handles the remaining import steps automatically.

  • Access to all processed results and data history within the “Event Log” section.