Notification Placeholders
Spendgo offers placeholders for dynamic information. Place the placeholder within your message to add personalized or dynamic content. The following list outline all the available placeholders to you.
Placeholders are currently supported in the Emma and Mailchimp email integrations.
| Placeholder Name | Description | Example |
|---|---|---|
| event_name | The name of the event | offer_earned |
| campaign_id | The associated campaign id with the event | 12345 |
| created_at | The UTC timestamp of the event | 2020-06-10T00:00:00Z |
| event_source | The source of the event | spendgo.com |
| event_store_code | The store code where the event took place | 99999 |
| spendgo_id | The member's unique Spendgo id | 1234567890 |
| first_name | The member's first name | Sophia |
| last_name | The member's last name | Smith |
| dob | The member's date of birth | 1998-11-12 |
| gender | The member's gender | F |
| postal_code | The member's postal_code | 90210 |
| favorite_store_code | The member's favorite store code | 99999 |
| The member's email | email@example.com | |
| phoe | The member's phone number | 5555555555 |
| sms_optin | The member's text message subscription status | true |
| email_optin | The member's email subscription status | true |
| password_reset_link | The member's unique password reset link generated upon request to reset password | https://my.spendgo.com/abc123 |
| loyalty_status | The member's loyalty status | activated |
| loyalty_units | The loyalty program units are either "points", "stamps" or "visits" | points |
| balance | The members loyalty balance in points, stamps or visits | 40 |
| next_reward_at | The unit threshold to the next reward | 50 |
| next_reward_at | The number of units till the next reward | 10 |
| reward_name | The name of the reward linked to event | $5 Off |
| reward_code | The promo code associated with the reward linked to event | WELCOME |
| reward_expiration | The reward linked to event expiration UTC timestamp | 2020-07-10T00:00:00Z |
| reward_value | The value of the reward in points (when applicable) | 50 |
For more details on how to use placeholders within your templates, please review your provider’s guides as implementation will be different per platform.
For Emma
If your content includes:
Congrats, you’ve earned [%reward_name%]!When a $5 Off reward is earned your recipient will see, “Congrats, you've earned $5 Off!”
For MailChimp
If your content includes:
Congrats, you’ve earned *|EVENT:reward_name|*!When a $5 Off reward is earned your recipient will see, “Congrats, you've earned $5 Off!”
Requested Password Reset
When a member requests a password reset, they must provide their account email through the Member Portal forgot password page or through the Spendgo APIs. Once this request has been submitted, the member will be sent a password reset link that directs them to provide and confirm their new password.
You have the option to define how a member can receive their password reset link — either by Spendgo’s default email notifications, text notifications, or your third party email integration.
Via Default Spendgo Email
No setup is required, this is automatically enabled using the Spendgo template and sent from ‘donotreply@spendgo.com’.
Via Text Notification
In the Spendgo dashboard you can enable the Requested Password Reset text notification:
Navigate to Settings > Notifications
Create a new notification
Select the notification type Requested Password Reset and click Next Step
Enter a unique Event Name
Define whether to require opt-in for members.
Note: We recommend to leave require opt-in turned off; you will want all requests to receive this one-time notification.Select your medium as Text
Enter in your text message content and click Next Step. For more info, see Text Message Compliance
Note: The unique reset password link is automatically appended to the end of each member’s message on send. A placeholder link "https://my.spendgo.com/p/placeholder" is displayed in the UI.Review and confirm by clicking to Create your notification
Via 3rd-Party Email Notification
The benefit of using your email integration is to send the link within your own template and from your own domain. In the Spendgo dashboard you can enable the Requested Password Reset email notification:
Navigate to Settings > Notifications
Create a new notification
Select the notification type Requested Password Reset and click Next Step
Enter a unique Event Name
Note: Jot down the event name as you have entered it. You will use this to map your event to the mailing in your email provider platform.Select your medium as Email
Review and confirm by clicking to Create your notification
Log into your integrated email provider platform to create your template. Insert the reset password link placeholder into your template. See notification placeholders.
Configure your event name trigger and complete the setup.
Helpful links:
• Setup a custom event in Emma
• Setup an automated event API in Mailchimp
• Event notification placeholders
Both Emma and MailChimp require emails to be subscribed in order to send an email. This is a limitation that can result in some members not receiving their notification.
Notifications
Notifications are automated messages sent to members when a specific event occurs. There are two types of notifications that can be sent — a campaign notification and a settings notification. Below explains both:
Campaign notifications are periodically sent messages based upon the member’s loyalty activity. For instance, if a member earns a specific offer, you can trigger an email message to notify them each time the offer is earned encouraging them to make a purchase and redeem it. Campaign notifications always require the member to be subscribed to send them the notification (e.g. they must be subscribed to your email and/or text messages).
Offer earned - send a notification when a member earns a specific campaign offer.
Offer used - send a notification when a member uses a specific campaign offer.
Reward earned - send a notification when a member earns a reward.
Reward used - send a notification when a member uses a reward.
Settings notifications are one-time messages typically expected, as it contains information the member wants to check or confirm, such as when they request to reset their password or have completed an order, you can send a notification about those events.
Add points (via Support) - when your Support team adds points to a members account, the member can be notified they were successfully added.
Requested Password Reset - when your members request to reset their password, you can send them an email or text notification with their unique reset password link.
Things to keep in mind
You must have an email or text message integration set up for the notifications to work.
Only subscribed members to the specific medium chosen will receive the notifications.
Campaign notifications ARE marketing messages, and the content options are more flexible.
Settings notifications ARE NOT marketing messages, members do not need to be subscribed, which means it is important to craft your message to meet the member’s expectations. Only send content that aligns with what they agreed to receive. For more information, see Text Message Compliance. You can choose to only send to subscribers by enabling the “Require Opt-In” field in the notification setup.
When setting up email notifications, the mailing must be configured in your email provider’s platform. See how to setup the event within your email integration provider: Emma, Infobip, or Mailchimp.
Create Notification
Text Notification
For Campaign notifications, navigate to Campaigns > Notifications. For Settings notifications, navigate to Settings > Notifications.
Add + a new notification.
Select the event that will trigger the notification and click Next.
Enter a unique and easy to understand event name.
Notes: Additional required fields may vary based on event type, enter all required information.Select text as the medium.
Note: Medium options will only be displayed if the integration is enabled.Enter your text message content. See Text Message Compliance for content guidelines.
Enter the start and end dates.
Review and Create your new notification.
Email Notification
For Campaign notifications, navigate to Campaigns > Notifications. For Settings notifications, navigate to Settings > Notifications.
For Emma
Add + a new notification.
Select the event that will trigger the notification and click Next.
Enter a unique and easy to understand event name.
Notes: Additional required fields may vary based on event type, enter all required information.Select email as the medium.
Jot down the event name as you have entered it. You will use this to map your event to the mailing within your email provider’s platform.
Enter the start and end dates.
Review and Create your new notification.
Log in to Emma and navigate to the Automation page.
Create new workflow.
Name your workflow.
(Optional) Choose an audience if you want to further segment sends.
Choose your event trigger, select Custom API Event and click Next.
Create the filter statement (ex. event_name equals reward_earned) and click Next.
Key = “event_name”
condition remains “equals”
Value = the exact event name that you jotted down in Step 5Select send every time event is triggered, click Next, and then Confirm.
Add action to workflow to send email and follow the onscreen instructions to design your mailing template.
Activate the workflow and Save workflow to turn on the notifications.
Visit Emma for more documentation on how to trigger custom events.
Location of Infobip template ID
For Infobip
Add + a new notification.
Select the event that will trigger the notification and click Next.
Enter a unique and easy to understand event name.
Notes: Additional required fields may vary based on event type, enter all required information.Select email as the medium.
Enter the template id of the mailing you want to send on the event.
You can either get the template id # from the bottom right corner of the template module. If you have not already created your template, create your template.Notes: Only Infobip “Broadcast” Templates can be used for notifications.
Enter the start and end dates.
Review and Create your new notification.
For Mailchimp
Add + a new notification.
Select the event that will trigger the notification and click Next.
Enter a unique and easy to understand event name.
Notes: Additional required fields may vary based on event type, enter all required information.Select email as the medium.
Note: Medium options will only be displayed if the integration is enabled.Jot down the event name as you have entered it. You will use this to map your event to the mailing within Mailchimp.
Enter the start and end dates.
Review and Create your new notification.
Log in to your Mailchimp and navigate to Automations.
Create an automated Event API email.
Name your campaign and Begin.
Edit the trigger.
Set the delay to immediately.
Enter the the exact event name that you jotted down in Step 5 and click Update trigger.
Design or select your email template, Save And Continue.
Confirm your settings and click Start sending.
Edit Notification
For Campaign notifications, navigate to Campaigns > Notifications. For Settings notifications, navigate to Settings > Notifications.
Select Manage > Edit in the row of the notification you intend to edit.
Enter your updates and Save Changes.
Delete Notification
For Campaign notifications, navigate to Campaigns > Notifications. For Settings notifications, navigate to Settings > Notifications.
Select Manage > Delete in the row of the notification you intend to delete.
Click Delete to confirm.
A Delete cannot be undone once confirmed.