Set up and manage Interest Alerts

In Blueshift, you can access and define the Interest Alerts criteria by going to Customer Data > Interests in the left navigation. You can also test your interest alerts setup.

The following diagram shows the steps involved in setting up Interest Alerts and sending updates to users.

 

Subscribe users to topics

Based on the user preference data you have, send information about topics your users are interested in to Blueshift. Use the Interest Alerts APIs to subscribe users to a topic that they are interested in.

If a user is no longer interested in a particular topic, use the Interest Alerts APIs to unsubscribe users from a topic.

Viewing interests for a user

The interests of your users are part of the 360-degree user profile of the user. To view information about your users, go to Customer Data > Profiles, search for a user and click on view. Go to the Interests tab to view topics that the user has subscribed to.

For more information, see 360-Degree user view.

View Interest Alerts

To view Interest Alerts that are already set up in Blueshift, go to Customer Data > Interests in the left navigation.

Use the actions menu to Edit, Clone or Delete an Interest Alert.

Note: An Interest Alert event can be deleted only if there are no campaigns associated with the event.

Define Interest alert criteria

To add an interest alert event, complete the following steps:

1. Go to Customer Data > Interests in the left navigation.
2. Click +Alert on the Interest Alerts index page.

   
   

3. Add the name of the event. All interest alert event names start with interest_. For example, interest_news_alert or interest_game_alert.
4. Add a description for the alert.
5. Click Create.

Edit interest alerts

To edit an interest alert, click the interest alert name on the Interest Alerts index page.

• The Properties tab shows general properties and lists all the campaigns that use the interest alert.
• The History tab shows the history of the Interest Alert API calls.
• Test the alert by triggering the Interest Alert API call from the Test tab.

Add attributes for an update

You can add various attributes when you send an update for an interest alert. Attributes are used to provide more information about a particular topic. For example, for an interest alert about sports, the attributes can include the city where the game is being played, the time at which the game starts, the final score, and so on.

To view the attributes for the Interest Alert, go to the Test tab.

Test your setup

Before you can test your setup, you must set up an event triggered campaign for the interest alert.

After you have completed setting up the interest alerts and the campaign, you can test the alert by triggering the Interest Alert API call from the Test tab. You can also test the subscribing and unsubscribing of topics for a user from the Test tab. After you have completed the testing, the alert is ready for you to use.

Note: The Test tab is provided only for you to try and test your setup. Use the Interest Alerts APIs to subscribe users to topics and to send updates to users about topics they have subscribed to.

Send an update for a topic

To test your setup and to send an update for a topic from the Test tab, complete the following steps:

1. Click the Interest Alert name on the Interest Alerts index page.
2. Go to the Test tab.

   

3. In the Topic Alert pane, select Specific Customer to send an update to a particular customer. Select All Customers to send an update to all customers who have subscribed to a topic.
4. If you are notifying a Specific Customer, add the email address for the customer.
5. Add the topic for which the update is being sent.
6. Click +Attribute to add attributes for the topic.
7. Click Publish to trigger the associated campaign and send an update.

Subscribe to an interest alert topic

To test the API and add an interested customer to a topic from the Test tab for the interest alert, complete the following steps:

1. Click the Interest Alert name on the Interest Alerts index page.
2. Go to the Test tab.

   

3. In the Topic Subscription pane, select Action as Subscribe.
4. Add the email address for the customer.
5. Add the topic that the customer is interested in.
6. Click Publish.

Unsubscribe from an interest alert topic

To test the API and remove a customer from an interest alert topic from the Test tab for the Interest Alert, complete the following steps:

1. Click the Interest Alert name on the Interest Alerts index page.
2. Go to the Test tab.

   

3. In the Topic Subscription pane, select Action as Unsubscribe.
4. Add the email address for the customer.
5. Add the topic that the customer is unsubscribing from.
6. Click Publish.

APIs for Interest Alerts

The APIs for Interest Alerts are listed in the following table. For more information about the parameters for the APIs and the usage, see the Interest Alerts API developer documentation.

Task	API
Subscribe to a topic that the customer is interested in.	API: Send an event Set event as subscribe_interest to indicate that the customer is subscribing to an interest alert. Specify at least one of the following: customer_id, event, device_id, cookie, or email. Specify the topic that the customer is interested in.
Remove a customer who is no longer interested in a topic.	API: Send an event Set event as unsubscribe_interest to indicate that the customer is unsubscribing from an interest alert. Specify at least one of the following: customer_id, event, device_id, cookie, or email. Specify the topic that the customer is no longer interested in receiving updates about.
Get all the topics that a customer is interested in.	API: Get customer subscriptions You must specify at least one of the following fields: customer email address customer uuid customer ID customer phone number customer device ID
Trigger the campaign and send an update to customers about a topic they have subscribed to.	API: Interest alerts - Update or alert customers Specify the event. Specify the topic for which the alert is being sent. Specify any attributes to provide more information about the update.