Skip to main content

Event Filters

As with Global Filters, Event Filters are available to select from the Query Builder, by interacting with the button with the same name.

Event filter options will change depending on the event type selected to reflect the unique properties for that event. An example of an Event Filter would be a filter by an item name from an IAP transaction (business event).

info

Session Start and Session End have no properties to filter on and selecting these (and selecting All events) will result in Event filters being disabled.

Event typeFiltersScreenshot
Ad events
  • Ad type
  • Ad Action
  • Ad placement
  • Ad SDK name
  • Ad failure reason
    		• Ad events
    Business events
  • Item Type
  • Item ID
  • Converting
  • Cart type
  • Receipt status
    		• Business events
    Design events
  • Event ID 01
  • Event ID 02
  • Event ID 03
  • Event ID 04
  • Event ID 05
    		• Design events
    Error events
  • Message
  • Severity
    		• Error events
    Progression events
  • Status (Start, Complete, Fail)
  • Progression 01 (World name)
  • Progression 02 (Level name)
  • Progression 03 (Phase name)
    		• Progression events
    Resource events
  • Flow type (Sink, Source)
  • Item Type
  • Item ID
  • Virtual currency
    		• Resource events
    Impression events
  • ILRD SDK vendor
  • ILRD network name
  • ILRD Ad format
  • ILRD placement
    		• Impression events

    Event filter customisations​

    Event filters allow multiple rows connected by an OR relationship.

    Event Filters

    Above is an example of filtering event data using an OR relationship between 2 different filter rows on the Business event (IAP).

    The logic between Event filter types on each row is an AND. When selecting multiple values within an Event filter type (e.g. Item Id above) the logic between is an OR. The above definition would result in a query filter like this being applied.

    (Item Type = Reward AND Item Id = Muscle) OR (Item Type = Booster AND (Item Id = FasterThanLight OR UniversalSolvent))

    Event filters can also be used to exclude data. For example excluding Item Id=LaserSword would exclude all events with that property value.

    Event Hierarchies​

    Certain event types contain event ids that are connected in a hierarchy in addition to other standalone properties. For example a Business event contains an Item Id with a parent called Item Type. When defining filters this relationship is shown via the following icon.

    Event Hierarchies

    Event typeEvent hierarchy available
    Business eventItem Type → Item Id
    Resource eventItem Type → Item Id
    Progression eventProgression 01 → Progression 02 → Progression 02
    Design eventEvent id 01 → Event id 02 → Event id 03 → Event id 04 → Event id 05

    When selecting filter values for a hierarchy then values listed (in the dropdown) for a filter type will be filtered by any selection in parent filters.

    info

    Consider the following example of 4 Business events sent from the SDK describing the Item Type and Item Id separated by a colon.

    Weapon:LaserSword
    Weapon:PlasmaGun
    Health:LargePack
    Health:SmallPack

    Opening the Item Id dropdown without selecting any Item Type would then list LaserSword, PlasmaGun, LargePack, Small Pack.

    Specifying first Item Type to be Weapon and then opening the Item Id dropdown will show only LaserSword and PlasmaGun.