Aimtell

Aimtell Documentation

Welcome to the Aimtell documentation hub. You'll find comprehensive guides and documentation to help you start working with Aimtell as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Using Variables in Notifications (Attributes)

There are two types of ways you can pass variables into your notifications with Custom Attributes or Event Values.

This document walks you through an example of using custom attributes as variables in your notifications.

If you are looking to see how to pass custom event values into your notifications, please see: https://documentation.aimtell.com/docs/passing-event-labels

Generally speaking, most notifications that are sent to users are static. For instance, you may send a web notification to users such as:

Title: Happy Easter
Message: Save $50 off any order over $100
Link: https://yoursite.com

However, sometimes you may want to send notifications that are more dynamic in nature. Perhaps you want to address the user by their name or append an additional field within the url.

In order to use custom attributes within push notifications, simply use the following anywhere in your title, body or link of your push notification: {custom_attribute:ATTRIBUTE|FALLBACK}

For instance, let’s say we’ve been tracking the custom attribute “username” as well as the individual’s unique id (in this case known as objectId). So we could schedule a push notification campaign that would be set up like this:

Title: Hey {custom_attribute:username|there}
Body: You’ve got five new broadcasts to check out. Click to view them now!
Link: https://hangwith.com?userid={custom_attribute:objectId}

When the notification is sent out it will replace the individuals username if it exists. If there is no username, it will fallback and say “Hey there”. Fallbacks are completely optional. The link, for instance, will simply be empty if there is no objectId.

Advanced Tip:

You can also pass the subscriber uid by calling {custom_attribute:subscriber_uid}

Custom attributes within notifications are supported anywhere (event based notifications, api, manual, triggered, etc).

For easy testing, we recommend tracking yourself down within your subscribers list and sending a few test notifications to yourself first.

Using Variables in Notifications (Attributes)