8. Data Tokens

 

 

 

  • Lesson Overview

     

    Transcription

    Welcome to this training video on using data tokens within your managed tags. My name is Richard Jones, and I'm a mobile implementation consultant at InsightOn. So far, through these training videos, we've gone through the creation of an app, creating events, picking out data from the app, and sending that data to a tag. All this has been done through the Mobile UI. However, if you want to create a tag that is not yet available in the Mobile UI, well, the good news is you can use, manage and use any of the events or tokens created in the Mobile UI.

    We first start by selecting a tag. For the sake of clearly showing you how to return a token, we will just use the standard custom JS app. But you can use any other app. So first things first, how do you bring back data from a token? If we wanted to use the page token that is automatically created for us when using a Page View data tracker, we would use the line Bootstrapper Getmobile Token Page.

    It's that simple. This syntax is used to return any token created, with the only change being the token name between the brackets. So with that logic, to return the token that contains all the page data, we use the code Bootstrapper Git Mobile Token Pagedata. We need to remember that the Page data token is actually a JSON object. So if you want to return a specific value within it, you will need to navigate through the object.

    For example, if we want to return the product name, we can use the code Bootstrapper Gitmobiletoken Pagedata Product Name. Now, all that Bootstrapper Git Mobile Token is actually doing is creating a shortcut to that part of a larger object. If required, you can access all the global and custom tokens directly by looking in Bootstrapper Mobile. You can of course create a data definition that returns this value by selecting Custom in the Get data from Dropdown and returning the code we have discussed above. With this knowledge, let's send a basic image pixel returning the page name and product name.

    Using this code, you can see that we are simply putting the page name and product name into two variables using the Bootstrapper Gitmobile Token method we talked about and then adding them to a new image pixel. With that done, we can continue on to the next section where we want to choose which event we want to fire this tag on. As we are picking up Page data, we want to send this event on each page view. We can do this by setting it to the Page tracker event we created in previous videos. All mobile events are automatically created and managed behind the scenes.

    When you create them in the Mobile UI, they also all follow the same naming convention. That being Token Name App ID Version we know that the event name we created is simply called Page View. So putting Page view into the filter, we can see all the events that I've created with this name. As we also know our app ID, we can easily see this as the event we need. With that selected, we can click Done and then save and commit the tag.

    We went through testing our events and tags in the previous video. So with that knowledge, let's see the tag we created in action using Charles and connecting my device. When navigating page to page, we can see that an image request is fired. And looking at the query parameters, we can see the data that we have picked up from the app.

    Thank you for joining me for this video. I hope you've enjoyed these training videos. But more importantly, I hope that you've learned how to successfully create your first InsightOn mobile implementation. If you have any questions then please contact our support team via Support@insighton.com.

     

Feeling confident in your Ensighten Manage skills? Take our Ensighten Certified Professional - Mobile Quiz to see how you stack up!