Evaluating Tag Change events within Urban Airship Connect

This article refers to data returned by Urban Airship Connect. Please visit the Urban Airship Connect User Guide for general usage data for Urban Airship Connect.

 

This article will provide an overview of the following:

  • Common usage for Tag Change data
  • Data returned for Tag Change event types

 

Urban Airship Connect streams multiple event types to various services such as S3.  

Tag Change events allow you to evaluate changes in user attributes due to their behavior in your app, devices that fall under different segmentation categories, or performance across multiple different segmentation based on changes in tags.

{
  "id": "00000152-4639-25e7-024b-457f821dd465",
  "offset": "103187",
  "occurred": "2016-01-15T16:58:16.423Z",
  "processed": "2016-01-15T16:58:20.145Z",
  "device": {
    "android_channel": "8f830618-b8ae-4949-a1bd-fbb13055b92f",
    "named_user_id": "willis"
  },
  "body": {
    "add": {
      "device": [
        "I_like_horses"
      ]
    },
    "current": {
      "device": [
        "I_like_horses"
      ]
    }
  },
  "type": "TAG_CHANGE"
}
{
  "id": "00000152-4639-2db6-0a4a-a0d0e370d906",
  "offset": "103188",
  "occurred": "2016-01-15T16:58:18.422Z",
  "processed": "2016-01-15T16:58:23.506Z",
  "device": {
    "android_channel": "8f830618-b8ae-4949-a1bd-fbb13055b92f",
    "named_user_id": "willis"
  },
  "body": {
    "remove": {
      "device": [
        "I_like_cats"
      ]
    },
    "current": {
      "device": [
        "I_like_horses"
      ]
    }
  },
  "type": "TAG_CHANGE"
}

 In the above two (2) TAG_CHANGE events, there are the following key data points:

  • A Named User id
  • A Channel ID
  • A list of any tag (segmentation attribute) added or removed
  • The final current list of tags (segmentation attributes)

Since data is streamed out as events happen, it is possible to get a breakdown or even just a simple count of all Channel IDs or Named Users under any given segmentation attribute such as the above listed ""current" tag: {"device": ["I_like_horses"]}".

You can see how this data changes over time and relates to other attributes added or removed.  It can also be paired up with Push Body events to see what devices would have been targeted by a push that went out to any given segmentation attribute such as "I_like_horses".

 

Related Content: