Batch can collect custom data to improve your targeting and send better messages to your users. There are three types of custom data you can gather: Attributes, tags or events.
Before tagging your app, you need to take some time to consider what information you really need in order to target your users. The preparation of the tagging plan is fundamental in building your push strategy and getting the most out of Batch.
Attributes are useful as they provide information on who your users are (1 value per attribute). You can collect different kind of values:
You can also use attributes to customise the content of your push notifications.
E.g. John, you're only on level 4, come back and play !
A tag is a collection of strings. You can add/remove strings to your tag collection and clear the strings list at any moment. There are two things you can do with tags:
Tags may be called Channels or Topics with other push providers. The difference is that Batch attaches a "tag" to your user and will only make the list of users once you have created your campaign on the dashboard or from the API.
If you have a shopping app, you can use a tag collection to know what your users' favorite brands are and send them contextual notifications. The tag collection would look like this: favorite_brands=["nike", "adidas", "reebok"].
Users can then come back later and change their choices to add or remove brands. The tag collection will be updated accordingly: favorite_brands=["adidas", "puma", "lacoste"]
You can also use tags to manage your users’ push options (e.g. user_optins). The tag collection would look like this: user_optins=["sports", "culture"]. You will only have to target the tag "sports" when you send a push on this topic.
Events track information on what, when and how many times a user does something in your app. Use them exclusively for meaningful interactions: Item purchased, read/shared content, page visited, etc.
You can get the following information from an event:
E.g. item_purchase. Label: "Nike shoes". Last occurrence was 30 days ago.
You can also use events as a trigger to display an In-App message.
E.g. Display an In-App message when users trigger the event "added_to_cart" with the label "shoes".
The very first step is to list a maximum of 10 questions you have on your users. Here are a few recommendations you can use.
Here is an example for an mcommerce app. We have only selected questions that may have an interest to target users, customise the content of the notifications or trigger In-App messages:
You should not track data on racial or ethnic origin, political opinions, religious or philosophical beliefs, trade-union membership and health or sex life unless users have the option not to provide that kind of information.
Try to write generic questions and delete the ones that are not 100% necessary.
E.g. Does my user visit the sunglasses section? And the pants sections?
→ Which sections does my user visit?
There are two information you should not track with an attribute:
Don’t use Batch to do path analytics (Did my user tap on the “OK” button of the welcome screen?). This information is not significant when segmenting your base and sending contextual notifications.
Track exclusively meaningful events: purchase, consulted categories, comment, etc.
All you have to do now is to choose an attribute, a tag or an event for each question. Read the introduction again if you have trouble understanding the differences.
Attribute (string): John.
Attribute (string): Paris/Rome/etc.
Attribute (string): male/female/not specified.
Attribute (boolean): true/false.
Event. An event will allow you to see:
Always use events when you want to know something about an action (purchase, read content, etc).
Event. In addition to the date, you’ll be able to find out which article they checked and in turn their interests.
Event. This event will give information on both the total number of items added to the wishlist and on the last item added.
Attribute (boolean). Allows you to send a notification each time your user abandons an item in their cart.
The last step consists in finding the right name for your attributes and events. You can use the letters a-z, underscores and hyphens. Here are our recommendations:
We recommend you use a past tense verb at the beginning + additional information (E.g. purchased_item).
Here is how we could name our 7 attributes and events:
We recommend you put all the information in a spreadsheet:
This will help you to modify your tagging plan over time and share it with your team.
All you have to do now is to tag your app using our technical documentation:
Once your tagging plan is integrated, you will need to go to the dashboard settings > "Custom data" tab to manually enable every attributes, tags or events sent to Batch.
Then you will be able to use the custom data to: