Lists

Sometimes when you send messages to customers, you want to include “a set of information” such as a list of items they`ve left in the shopping cart. So, what do you do then? An automatic campaign using customer attributes called Lists would be the best way forward.

The lists, available to Moments users, are stored per customer. Depending on the communication you want to create, you can send separate messages to the same customer about each of the stored items, mention all the objects from the stored list or just the first few.

If, for example, one person has more than one loan and you need to notify them about the approaching payment date for just one of the loans, this is where the Lists will come in handy. Keep in mind that a Person Profile represents one real person and all the data related to this person is stored within the same profile – different loans, information about different lines in the family cell phone plan where this person is a primary subscriber, etc.

What Are Lists

These custom attributes represent a list of objects with the type that you define. The image below should give you an idea about how this works in practice: the list name is Cart and each object consists of 4 fields: ProductName, Picture, Price, URL.

list attribute showing items in the cart
 

Lists are created on our web interface, and the values are set using API, WEB SDK, Mobile SDK. When composing messages that will be sent via Broadcast or Flow, you can use Lists to remind customers about items left in the cart, upcoming payment dates, or something else.

Create New List

After signing in to our web interface, navigate to People module > Configuration > Create Custom Attribute. Decide on the name for your list and select the type: List of objects.

The next step would be to enter all the information you want to have for each of the items on the list. In the abandoned cart scenario, the list consists of items left in the cart, and the information you might want to include is the following:

  • Product Name
  • Product Price
  • Product Image
  • Product Category
     

creating list type user attribute
 

Manage Lists

Once you have selected the objects for your list, you need to configure it so that your system and the Infobip platform can exchange information (set up data stream to fill the lists with values).

Use the following methods:

  • People API

 - Create people profiles and set the list values while creating profiles: Create a New Person, Batch People Create.

 - Set the whole new list: Partial Person Update, Batch people update. This method lets you clear the list or rewrite all the values in it.

 - To add an item to the list, use the Append List method. It will just add one more item to an existing list.

  • JS SDK

 - Go to the Web SDK Library on our web interface for information on how to update information in the person profile. With the Infobip Web SDK, you can set the List value straight from your website. The Update Person method will let you set the list or erase it. 

 See an example below on how to update a customer field of the type List called “ShopperCart.”

pe.updatePerson({
	"customAttributes": {
		"Shopper Cart": [
			{ "productName": 'Sneakers' ,
			 "productPrice": 25.33 ,
			 "productImage": "url here" ,
			 "productCategory": "Sport Sneakers"
                       },
                       { "productName": 'T-Shirt' ,
			 "productPrice": 9.99 ,
			 "productImage": "url2 here" ,
			 "productCategory": "Casual"
                       }
	       ]
	}
})