Evaluating Tag Change events within Urban Airship Connect

This article refers to data returned by Urban Airship Connect. Please visit the Urban Airship Connect Primer 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 can stream many different event types to various services such as S3.  

Tag Change events allow you to keep track of devices that fall under different segmentation categories within your own apps or to evaluate performance across multiple different segmentation attributes.

{
  "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, 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": {"device": ["I_like_horses"]}".

You can see how this data changes over time.  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: