1. Home
  2. /Guides
  3. /Messaging
  4. /User guide
  5. /Data + Analytics
  6. /Performance Analytics
  7. /Exploring
  8. /Tag Events Explore custom queries and reference

Tag Events Explore custom queries and reference

Use the Tag Events Explore to see information about adding and removing tags to/from your audience.

Access history related to TagMetadata that you can associate with channels or named users for audience segmentation. Generally, they are descriptive terms indicating user preferences or other categorizations, e.g., wine_enthusiast or weather_alerts_los_angeles. Tags are case-sensitive. adds and removals, get Tag values at the time of Tag-related events, and get information about channels associated with specific Tags and/or Tag events.

Data availability depends on your Performance Analytics plan.

To access the Explore:

  1. Go to Reports, then Performance Analytics.
  2. Select the folder icon (), then Shared.
  3. Under Looks, select Explore Glossary (Explore Glossary EUCS for EU customers).
  4. Select Tag Events, then Navigate to Explore.

For a list of all Explores in the glossary, see Predefined Explores in Exploring Performance Analytics data.

Field categories

The sidebar lists categories for various filters, DimensionsGenerally, a string field in Performance Analytics. They can be grouped and can act as filters or members of a data set., and MeasuresA numeric field in Performance Analytics — like a count or sum. Measures appear in orange within an explore. you can use to explore your data. To see their definitions, hover over an item, then select the “i” icon ().

Field categories in the Tag Events Explore:

CategoryDescription
Query ParametersTarget all or specific projects, and specify dates and response windows, where relevant.
Tag EventsSet Tag parameters for the query.
Tags CurrentGet Tag values associated with the channels at the time the report is run.
Tags RelativeGet Tag values associated with the channels at the time the filtered Tag event occurred.
User DetailGet information about the channel that performed the filtered event.
User Detail - DerivedGet historical information about the channel that performed the filtered event.

Default filters

Use filters to reduce the number of records scanned and results returned. Each Explore includes filters that cannot be removed from the query.

The filter name, field category, and usage information for the default filters in the Tag Events Explore:

Filter nameField categoryUse the filter to...
Current Project OnlyQuery ParametersDetermine which projects are included in the query. Default selection: Yes. To include other projects within your company, select No, then:
  1. In the sidebar, select Query Parameters.
  2. Under Dimensions, select the filter icon () next to Project name.
  3. In the Filters section, select the entry field next to the Project Name filter and choose which projects to include.
Date RangeQuery ParametersTarget events that occurred on a specific date or within a specific date range.
Tag Action FilterTag EventsReturn Tags that were set, removed, or either. Use with operator is. Select one of: Add, Delete, All.
Tag Group FilterTag EventsSpecify the Tag GroupAn array of tags that you can associate with both channels and named users. you want to return tags for. Default selection: Notification Opt-in. Must not be empty. Use with operator is equal to.
Tag Name FilterTag EventsReturn results for specific Tags. Enter Tags by name. Default value: false. Default operator: is equal to. To return all possible Tags for the filtered Tag Group, select the operator is not null.

The Tag Action, Group, and Name Filters include non-matched (null) records. To return matched records only, add the Tag Action, Tag Group, and Tag Name Dimensions from the Tag Events field category.

Building custom queries

The following sections walk you through using the Tag Events Explore to create custom queries that answer:

Get Tags in a Tag Group

Follow these steps to get a list of Tags in a Tag Group and the number of users who had the Tag set over the past 30 days. We only need to use the default filters.

 Note

  • This report does not return whether or not users still have the Tag set. To return that data, use the Audience with Attributes Explore.
  • If a Tag does not appear for selection in Performance Analytics, it means that no add or remove event has occurred for the Tag during the specified time range.

First, open the Tag Events explore, and then configure your query:

  1. Set up the filters:

    1. Leave Current Project Only set to Yes.
    2. Set the Date Range filter to is in the past 30 complete days.
    3. Leave the Tag Action set to Add.
    4. Set the Tag Group filter to the Tag Group you want to return Tags for.
    5. Set the Tag Name operator to is not null.

  2. In the sidebar, specify the value and measurement to display:

    1. Select Tag Events, then select the Dimension Tag Name.
    2. Select User Detail, then select the Measure User Count.

Now you are ready to get your data. Select Run, and you should see results similar to the below image. To save your custom query for later access, follow the steps in Saving Performance Analytics queries.

Tag Events Explore custom queries and reference
Creating a custom query from the Tag Events Explore

Get Tag adds for button interaction

Follow these steps to get a list of users that had a Tag added after interacting with a button in an In-App AutomationMessages that are cached on users’ devices and displayed when your users meet certain conditions within your app, such as viewing a particular screen or opening the app a certain number of times.. We only need to use the default filters. You must know the name of the Tag for the button interaction. Users will be identified by Channel IDAn Airship-specific unique identifier used to address a channel instance, e.g., a smartphone, web browser, email address..

First, open the Tag Events explore, and then configure your query:

  1. Set up the filters:

    1. Leave Current Project Only set to Yes.
    2. Set the Date Range filter to a range that makes sense for your query.
    3. Leave the Tag Action set to Add.
    4. Set the Tag Group filter to the Tag Group containing the Tag you want results for.
    5. Set the Tag Name operator to is equal to and select the Tag associated with the button interaction.

  2. In the sidebar, specify the value and measurement to display:

    1. Select Tag Events, then select the Dimension Tag Name.
    2. Select User Detail, then select the Dimension Channel ID and Measure User Count. If you’re using Named UsersA customer-provided identifier used for mapping multiple devices and channels to a specific individual. in your project, you can also add the Dimension Named User to identify these users in your database.

Now you are ready to get your data. Select Run, and you should see results similar to the below image. To get count of users, select Totals in the Data header. To save your custom query for later access, follow the steps in Saving Performance Analytics queries.

Tag Events Explore custom queries and reference
Creating a custom query from the Tag Events Explore