Actions
Create Social Proof Actions
Social proof is a demonstration that other people have purchased or found value in a product or service. This demonstration helps the product or service stand out from others and makes the customer more likely to purchase it. These demonstrations often reflect existing customer behavior. For example, labelling a product as a bestseller is a social proof demonstration.
You can set up a handler for Omnichannel Social Proof actions using two methods. The addEvent method defines the events that can trigger the action. The getActionsData method is then used as the trigger and requests the decision based on the defined events. getActionsData then returns a JSON object containing social proof data that you can then handle in code.
You must first create an Omnichannel Social Proof action in the Monetate platform for the methods to reference. Refer to Configure an Omnichannel Social Proof Action in the Monetate Knowledge Base for instructions.
Make note of the WHO settings because they correspond to events your code listens for. The example experience in this article uses the following WHO settings:
- IP address is 1.0.0.2
- Screen height is at least 500 pixels and screen width is at least 300 pixels
Also make note of the Social Proof type that you're creating.
The full code examples fulfill these conditions and will trigger the Social Proof action.
This method adds event data to the SDK's internal stack.
React Native
React Web
iOS
Android
addEvent Method
1addEvent(context: EventTypes, events: ContextData): void
The parameters are as follows:
- context is name of the event.
- events is the event data.
addEvent Method
1addEvent(context: EventTypes, events: ContextData): void
The parameters are as follows:
- context is name of the event.
- events is the event data.
addEvent Method
1addEvent(context: <ContextEnum>, event: <MEvent?>)
The parameters are as follows:
- context is name of the event. (Required)
- event is the event data. (Required)
addEvent Method
1public void addEvent(String context, Object event)
The parameters are as follows:
- context is name of the event. (Required)
- event is the event data. (Required)
You can use this method multiple times to add all the necessary events for an experience you want to trigger. The example code uses multiple method calls to fulfill the experience requirements.
React Native
React Web
iOS
Android
addEvent Example
1personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
2
3personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
4 ipAddress: "10.0.0.2",
5});
addEvent Example
1personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
2
3personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
4 ipAddress: "10.0.0.2",
5});
addEvent Example
1objPersonalization.addEvent(context: .ScreenSize, event: ScreenSize(height: 1000, width: 400))
2
3objPersonalization.addEvent(context: .IpAddress, event: IPAddress(ipAddress: "192.168.1.52"))
addEvent Example
1IpAddress ipAddress = new IpAddress();
2ipAddress.setIpAddress("10.0.0.2");
3
4ScreenSize screenSize = new ScreenSize();
5screenSize.setHeight(23);
6screenSize.setWidth(34);
7
8PageView pageView = new PageView();
9pageView.setPageType("Cartpage");
10pageView.setUrl("https://www.monetate.com");
11
12// addEvent
13personalization.addEvent(EventTypes.ContextScreenSize, screenSize);
14personalization.addEvent(EventTypes.ContextIpAddress, ipAddress);
15personalization.addEvent(EventTypes.ContextPageView, pageView);
This method sends the defined events to Monetate to trigger an experience. If the events fulfill the WHO settings and the other required conditions of an experience, that experience is triggered. A JSON object containing the experience response is then returned.
React Native
React Web
iOS
Android
getActionsData Method
1getActionsData(actionType: Array<string>, includeReporting?: boolean) : Promise<any>
The parameter is as follows:
- actionType is the type of action you want to request. You can specify one action or multiple actions in an array to handle.
- includeReporting indicates whether the response will have impression reporting data.
getActionsData Method
1getActionsData(actionType: Array<string>, includeReporting?: boolean) : Promise<any>
The parameter is as follows:
- actionType is the type of action you want to request. You can specify one action or multiple actions in an array to handle.
- includeReporting indicates whether the response will have impression reporting data.
getActionsData Method
1getActionsData(requestId: <String>, includeReporting: <Bool>, arrActionTypes: <[String]>
The parameters are as follows:
- requestID is the request ID for the API.
- actionType is the type of action you want to request. You can specify one action or multiple actions in an array to handle.
- includeReporting indicates whether the response will have impression reporting data.
getActionsData Method
1public String getActionsData(String[] actionTypes, boolean includeReports)
The parameters are as follows:
- actionTypes is the type of action you want to request. You can specify one action or multiple actions in an array to handle.
- includeReports indicates whether the response will have impression reporting data.
React Native
React Web
iOS
Android
getActionsData Example
1let socialProofData;
2personalizationInstance
3 .getActionsData("monetate:action:SocialProofDataV2")
4 .then(res => {
5 socialProofData = res[0].actions;
6 })
7 .catch(error => {
8 console.warn('Error!', error);
9 });
getActionsData Example
1let socialProofData;
2personalizationInstance
3 .getActionsData("monetate:action:SocialProofDataV2")
4 .then(res => {
5 socialProofData = res[0].actions;
6 })
7 .catch(error => {
8 console.warn('Error!', error);
9 });
getActionsData Example
1objPersonalization.getActionsData(
2 requestId: "123456 ", includeReporting: false,
3 arrActionTypes: ["monetate:action:SocialProofDataV2"]
4)
5.on { res in
6 if res.status == 200 {
7 let data = JSON(res.data as Any)
8 for item in data["data"]["responses"].arrayValue {
9 if item["requestId"].string == res.requestId {
10 for socialProof in item["actions"].arrayValue {
11 self.handleSocialProofs(res: socialProof)
12 }
13 }
14 }
15 } else {
16 // Error Handling
17 }
18}
getActionsData Example
1String responseData = personalization.getActionsData(new String[]{"monetate:action:SocialProofDataV2"},true);
The following code examples are for each type of Social Proof messaging.
Viewed Product Full Code Example
This Social Proof type displays the message on products as determined by the number of times customers viewed a specific product detail page.
React Native
React Web
iOS
Android
Viewed-Based Social Proof Action Example
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextPageView, {
10 url: "http://www.monetate.com/index.html",
11 pageType: "Home"
12});
13
14// Get Social Proof Actions
15// ----------------------------------------------------
16let socialProofData;
17personalizationInstance
18 .getActionsData("monetate:action:OmniSocialProofDataV2")
19 .then(res => {
20 socialProofData = res[0].actions;
21 })
22 .catch(error => {
23 console.warn('Error!', error);
24 });
Viewed-Based Social Proof Action Example
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextPageView, {
10 url: "http://www.monetate.com/index.html",
11 pageType: "Home"
12});
13
14// Get Social Proof Actions
15// ----------------------------------------------------
16let socialProofData;
17personalizationInstance
18 .getActionsData("monetate:action:OmniSocialProofDataV2")
19 .then(res => {
20 socialProofData = res[0].actions;
21 })
22 .catch(error => {
23 console.warn('Error!', error);
24 });
This Social Proof type requires the ContextPageView event to be added.
Viewed-Based Social Proof Action Example
1// Add Context / Events
2//-------------------------------------------------------------------------
3objPersonalization.addEvent(context: .ScreenSize, event: ScreenSize(height: 1000, width: 400))
4objPersonalization.addEvent(context: .IpAddress, event: IPAddress(ipAddress: "192.168.1.52"))
5objPersonalization.addEvent(
6 context: .PageView,
7 event: PageView(pageType: "PDP", path: "n/a", url: "n/a", categories: [], breadcrumbs: []))
8
9// Get Social Proof Actions
10// ----------------------------------------------------
11objPersonalization.getActionsData(
12 requestId: "123456", includeReporting: false,
13 arrActionTypes: ["monetate:action:SocialProofDataV2"]
14)
15.on { res in
16 if res.status == 200 {
17 let data = JSON(res.data as Any)
18 for item in data["data"]["responses"].arrayValue {
19 if item["requestId"].string == res.requestId {
20 for socialProof in item["actions"].arrayValue {
21 self.handleSocialProofs(res: socialProof)
22 }
23 }
24 }
25 } else {
26 // Error Handling
27 }
28}
You must handle the getActions method in a Thread or AsyncTask. To update the main thread, you can use either Handler or runOnUiThread. This full code example uses Thread and Handler to update the main thread and change the UI.
Viewed-Based Social Proof Action Example
1Personalization personalization = new personalization(user, account);
2
3// Events/context data
4Product product = new Product();
5product.setProductId("97");
6product.setSku("SKU");
7ProductDetailView productDetailView = new ProductDetailView();
8productDetailView.setProducts(new Product[]
9{
10 product
11});
12
13PageView pageView = new PageView();
14pageView.setPageType("Cartpage");
15pageView.setUrl("https://www.monetate.com");
16
17// addEvent
18personalization.addEvent(EventTypes.ContextProductDetailView, productDetailView);
19personalization.addEvent(EventTypes.ContextPageView, pageView);
20
21// getActionsData
22String responseData;
23new Thread(new Runnable()
24{
25
26 @Override
27 public void run()
28 {
29
30 // Get the responseData using getActionsData
31 responseData = personalization.getActionsData("monetate:action:SocialProofDataV2");
32
33 // Once you receive the responseData from getActionsData, use the Handler and parse the required data
34 new Handler(Looper.getMainLooper()).post(new Runnable()
35 {
36 @Override
37 public void run()
38 {
39
40 // Parse the received responseData, get the requiredData from it and use it accordingly
41 try
42 {
43 // Example: textView.setText(requiredData);
44 }
45 catch (Exception ex)
46 {
47 // Catch any exception that occured while parsing
48 ex.printStackTrace();
49 }
50
51 }
52 });
53 }
54}).start();
Carted Product Full Code Example for Product Detail Pages
This Social Proof type displays the message on products most frequently added to a cart. To target product detail pages, you must add the ContextProductDetailView event.
React Native
React Web
iOS
Android
Carted-Based Social Proof Action Example—Product Detail Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductDetailView, {
10 products: [
11 {
12 productId: "94",
13 sku: "sku",
14 },
15 ],
16});
17
18// Get Social Proof Actions
19// ----------------------------------------------------
20let socialProofData;
21personalizationInstance
22 .getActionsData("monetate:action:OmniSocialProofDataV2")
23 .then(res => {
24 socialProofData = res[0].actions;
25 })
26 .catch(error => {
27 console.warn('Error!', error);
28 });
Carted-Based Social Proof Action Example—Product Detail Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductDetailView, {
10 products: [
11 {
12 productId: "94",
13 sku: "sku",
14 },
15 ],
16});
17
18// Get Social Proof Actions
19// ----------------------------------------------------
20let socialProofData;
21personalizationInstance
22 .getActionsData("monetate:action:OmniSocialProofDataV2")
23 .then(res => {
24 socialProofData = res[0].actions;
25 })
26 .catch(error => {
27 console.warn('Error!', error);
28 });
Carted-Based Social Proof Action Example—Product Detail Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3objPersonalization.addEvent(context: .ScreenSize, event: ScreenSize(height: 1000, width: 400))
4objPersonalization.addEvent(context: .IpAddress, event: IPAddress(ipAddress: "192.168.1.52"))
5objPersonalization.addEvent(
6 context: .ProductDetailView,
7 event: ProductDetailView(products: [Product(productId: "BackP_010", sku: "Blue_BackP_010")]))
8
9// Get Social Proof Actions
10// ----------------------------------------------------
11objPersonalization.getActionsData(
12 requestId: "123456", includeReporting: false,
13 arrActionTypes: ["monetate:action:SocialProofDataV2"]
14)
15.on { res in
16 if res.status == 200 {
17 let data = JSON(res.data as Any)
18 for item in data["data"]["responses"].arrayValue {
19 if item["requestId"].string == res.requestId {
20 for socialProof in item["actions"].arrayValue {
21 self.handleSocialProofs(res: socialProof)
22 }
23 }
24 }
25 } else {
26 // Error Handling
27 }
28}
29
You must handle the getActions method in a Thread or AsyncTask. To update the main thread, you can use either Handler or runOnUiThread. This full code example uses Thread and Handler to update the main thread and change the UI.
Carted-Based Social Proof Action Example—Product Detail Pages
1// Add Context and Events
2Product product = new Product();
3product.setProductId("97");
4product.setSku("SKU");
5ProductDetailView productDetailView = new ProductDetailView();
6productDetailView.setProducts(new Product[]
7{
8 product
9});
10PageView pageView = new PageView();
11pageView.setPageType("Cartpage");
12pageView.setUrl("https://www.monetate.com");
13
14// addEvent
15personalization.addEvent(EventTypes.ContextProductDetailView, productDetailView);
16personalization.addEvent(EventTypes.ContextPageView, pageView);
17
18// Get Social Proof Actions
19// getActionsData
20String responseData;
21new Thread(new Runnable()
22{
23 @Override
24 public void run()
25 {
26 // Gets the responseData using getActionsData
27 responseData = personalization.getActionsData(new String[]
28 {
29 "monetate:action:SocialProofDataV2"
30 }, true);
31 // Once you receive the responseData from getActionsData, use the Handler and parse the required data from it
32 new Handler(Looper.getMainLooper()).post(new Runnable()
33 {
34 @Override
35 public void run()
36 {
37 // Parse the received responseData, get the requiredData from it and use it accordingly
38 try
39 {
40 // Example: textView.setText(requiredData);
41 }
42 catch (Exception ex)
43 {
44 // Catch any exception that occurs while parsing
45 ex.printStackTrace();
46 }
47 }
48 });
49 }
50}).start();
Carted Product Full Code Example for Pages Displaying Multiple Product IDs
This code example is for displaying a Social Proof message on the products most frequently added to a cart on page types that contain multiple product IDs, such as product category listings, search results pages, and cart pages. To target multi-PID pages, you must add the ProductThumbnailView event.
React Native
React Web
iOS
Android
Carted-Based Social Proof Action Example—Multi-PID Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductThumbnailView, {
10 "products": ["104","94","97" ]
11});
12
13// Get Social Proof Actions
14// ----------------------------------------------------
15let socialProofData;
16personalizationInstance
17 .getActionsData("monetate:action:OmniSocialProofDataV2")
18 .then(res => {
19 socialProofData = res[0].actions;
20 })
21 .catch(error => {
22 console.warn('Error!', error);
23 });
Carted-Based Social Proof Action Example—Multi-PID Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductThumbnailView, {
10 "products": ["104","94","97" ]
11});
12
13// Get Social Proof Actions
14// ----------------------------------------------------
15let socialProofData;
16personalizationInstance
17 .getActionsData("monetate:action:OmniSocialProofDataV2")
18 .then(res => {
19 socialProofData = res[0].actions;
20 })
21 .catch(error => {
22 console.warn('Error!', error);
23 });
Carted-Based Social Proof Action Example—Multi-PID Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3objPersonalization.addEvent(context: .ScreenSize, event: ScreenSize(height: 1000, width: 400))
4objPersonalization.addEvent(context: .IpAddress, event: IPAddress(ipAddress: "192.168.1.52"))
5objPersonalization.addEvent(
6 context: .ProductThumbnailView,
7 event: ProductThumbnailView(products: Set(["BackP_010", "BackP_011"])))
8
9// Get Social Proof Actions
10// ----------------------------------------------------
11objPersonalization.getActionsData(
12 requestId: "123456", includeReporting: false,
13 arrActionTypes: ["monetate:action:SocialProofDataV2"]
14)
15.on { res in
16 if res.status == 200 {
17 let data = JSON(res.data as Any)
18 for item in data["data"]["responses"].arrayValue {
19 if item["requestId"].string == res.requestId {
20 for socialProof in item["actions"].arrayValue {
21 self.handleSocialProofs(res: socialProof)
22 }
23 }
24 }
25 } else {
26 // Error Handling
27 }
28}
You must handle the getActions method in a Thread or AsyncTask. To update the main thread, you can use either Handler or runOnUiThread. This full code example uses Thread and Handler to update the main thread and change the UI.
Carted-Based Social Proof Action Example—Multi-PID Pages
1// Add Context and Events
2ProductThumbnailView productThumbnailView = new ProductThumbnailView();
3productThumbnailView.setProducts(new String[]
4{
5 "94",
6 "97",
7 "104"
8});
9PageView pageView = new PageView();
10pageView.setPageType("Cartpage");
11pageView.setUrl("https://www.monetate.com");
12
13// addEvent
14personalization.addEvent(EventTypes.ContextProductThumbnailView, productThumbnailView);
15personalization.addEvent(EventTypes.ContextPageView, pageView);
16
17// Get Social Proof Actions
18// getActionsData
19String responseData;
20new Thread(new Runnable()
21{
22 @Override
23 public void run()
24 {
25 // Gets the responseData using getActionsData
26 responseData = personalization.getActionsData(new String[]
27 {
28 "monetate:action:SocialProofDataV2"
29 }, true);
30 // Once you receive the responseData from getActionsData, use the Handler and parse the required data from it
31 new Handler(Looper.getMainLooper()).post(new Runnable()
32 {
33 @Override
34 public void run()
35 {
36 // Parse the received responseData, get the requiredData from it and use it accordingly
37 try
38 {
39 // Example: textView.setText(requiredData);
40 }
41 catch (Exception ex)
42 {
43 // Catch any exception that occurs while parsing
44 ex.printStackTrace();
45 }
46 }
47 });
48 }
49}).start();
Purchased Product Full Code Example for Product Detail Pages
This Social Proof type displays a message on products most frequently purchased. To target product detail pages, you must add the ContextProductDetailView event.
React Native
React Web
iOS
Android
Purchased-Based Social Proof Action Example—Product Detail Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductDetailView, {
10 products: [{productId: "94",sku: "sku"}],
11});
12
13// Get Social Proof Actions
14// ----------------------------------------------------
15let socialProofData;
16personalizationInstance
17 .getActionsData("monetate:action:OmniSocialProofDataV2")
18 .then(res => {
19 socialProofData = res[0].actions;
20 })
21 .catch(error => {
22 console.warn('Error!', error);
23 });
Purchased-Based Social Proof Action Example—Product Detail Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductDetailView, {
10 products: [{productId: "94",sku: "sku"}],
11});
12
13// Get Social Proof Actions
14// ----------------------------------------------------
15let socialProofData;
16personalizationInstance
17 .getActionsData("monetate:action:OmniSocialProofDataV2")
18 .then(res => {
19 socialProofData = res[0].actions;
20 })
21 .catch(error => {
22 console.warn('Error!', error);
23 });
Purchased-Based Social Proof Action Example—Product Detail Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3objPersonalization.addEvent(context: .ScreenSize, event: ScreenSize(height: 1000, width: 400))
4objPersonalization.addEvent(context: .IpAddress, event: IPAddress(ipAddress: "192.168.1.52"))
5objPersonalization.addEvent(
6 context: .ProductDetailView,
7 event: ProductDetailView(products: [Product(productId: "BackP_010", sku: "Blue_BackP_010")]))
8
9// Get Social Proof Actions
10// ----------------------------------------------------
11objPersonalization.getActionsData(
12 requestId: "123456", includeReporting: false,
13 arrActionTypes: ["monetate:action:SocialProofDataV2"]
14)
15.on { res in
16 if res.status == 200 {
17 let data = JSON(res.data as Any)
18 for item in data["data"]["responses"].arrayValue {
19 if item["requestId"].string == res.requestId {
20 for socialProof in item["actions"].arrayValue {
21 self.handleSocialProofs(res: socialProof)
22 }
23 }
24 }
25 } else {
26 // Error Handling
27 }
28}
You must handle the getActions method in a Thread or AsyncTask. To update the main thread, you can use either Handler or runOnUiThread. This full code example uses Thread and Handler to update the main thread and change the UI.
Purchased-Based Social Proof Action Example—Product Detail Pages
1// Add Context and Events
2Product product1 = new Product();
3product1.setProductId("97");
4product1.setSku("SKU");
5ProductDetailView productDetailView = new ProductDetailView();
6productDetailView.setProducts(new Product[]
7{
8 product1
9});
10PageView pageView = new PageView();
11pageView.setPageType("Cartpage");
12pageView.setUrl("https://www.monetate.com");
13
14// addEvent
15personalization.addEvent(EventTypes.ContextProductDetailView, productDetailView);
16personalization.addEvent(EventTypes.ContextPageView, pageView);
17
18// Get Social Proof Actions
19// getActionsData
20String responseData;
21new Thread(new Runnable()
22{
23 @Override
24 public void run()
25 {
26 // Gets the responseData using getActionsData
27 responseData = personalization.getActionsData(new String[]
28 {
29 "monetate:action:SocialProofDataV2"
30 }, true);
31 // Once you receive the responseData from getActionsData, use the Handler and parse the required data from it
32 new Handler(Looper.getMainLooper()).post(new Runnable()
33 {
34 @Override
35 public void run()
36 {
37 // Parse the received responseData, get the requiredData from it and use it accordingly
38 try
39 {
40 // Example: textView.setText(requiredData);
41 }
42 catch (Exception ex)
43 {
44 // Catch any exception that occurs while parsing
45 ex.printStackTrace();
46 }
47 }
48 });
49 }
50}).start();
Purchased Product Full Code Example for Pages Displaying Multiple Product IDs
This Social Proof type displays a message on products most frequently purchased. To target page types that contain multiple product IDs—such as product category listings, search results pages, and cart pages—you must add the ProductThumbnailView event.
React Native
React Web
iOS
Android
Purchased-Based Social Proof Action Example—Multi-PID Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductThumbnailView, {
10 "products": ["88","86","97" ]
11});
12
13// Get Social Proof Actions
14// ----------------------------------------------------
15let socialProofData;
16personalizationInstance
17 .getActionsData("monetate:action:OmniSocialProofDataV2")
18 .then(res => {
19 socialProofData = res[0].actions;
20 })
21 .catch(error => {
22 console.warn('Error!', error);
23 });
Purchased-Based Social Proof Action Example—Multi-PID Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductThumbnailView, {
10 "products": ["88","86","97" ]
11});
12
13// Get Social Proof Actions
14// ----------------------------------------------------
15let socialProofData;
16personalizationInstance
17 .getActionsData("monetate:action:OmniSocialProofDataV2")
18 .then(res => {
19 socialProofData = res[0].actions;
20 })
21 .catch(error => {
22 console.warn('Error!', error);
23 });
Purchased-Based Social Proof Action Example—Multi-PID Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3objPersonalization.addEvent(context: .ScreenSize, event: ScreenSize(height: 1000, width: 400))
4objPersonalization.addEvent(context: .IpAddress, event: IPAddress(ipAddress: "192.168.1.52"))
5objPersonalization.addEvent(
6 context: .ProductThumbnailView,
7 event: ProductThumbnailView(products: Set(["BackP_010", "BackP_011"])))
8
9// Get Social Proof Actions
10// ----------------------------------------------------
11objPersonalization.getActionsData(
12 requestId: "123456", includeReporting: false,
13 arrActionTypes: ["monetate:action:SocialProofDataV2"]
14)
15.on { res in
16 if res.status == 200 {
17 let data = JSON(res.data as Any)
18 for item in data["data"]["responses"].arrayValue {
19 if item["requestId"].string == res.requestId {
20 for socialProof in item["actions"].arrayValue {
21 self.handleSocialProofs(res: socialProof)
22 }
23 }
24 }
25 } else {
26 // Error Handling
27 }
28}
You must handle the getActions method in a Thread or AsyncTask. To update the main thread, you can use either Handler or runOnUiThread. This full code example uses Thread and Handler to update the main thread and change the UI.
Purchased-Based Social Proof Action Example—Multi-PID Pages
1// Add Context and Events
2ProductThumbnailView productThumbnailView = new ProductThumbnailView();
3productThumbnailView.setProducts(new String[]
4{
5 "94",
6 "97",
7 "104"
8});
9PageView pageView = new PageView();
10pageView.setPageType("Cartpage");
11pageView.setUrl("https://www.monetate.com");
12
13// addEvent
14personalization.addEvent(EventTypes.ContextProductThumbnailView, productThumbnailView);
15personalization.addEvent(EventTypes.ContextPageView, pageView);
16
17// Get Social Proof Actions
18// getActionsData
19String responseData;
20new Thread(new Runnable()
21{
22 @Override
23 public void run()
24 {
25 // Gets the responseData using getActionsData
26 responseData = personalization.getActionsData(new String[]
27 {
28 "monetate:action:SocialProofDataV2"
29 }, true);
30 // Once you receive the responseData from getActionsData, use the Handler and parse the required data from it
31 new Handler(Looper.getMainLooper()).post(new Runnable()
32 {
33 @Override
34 public void run()
35 {
36 // Parse the received responseData, get the requiredData from it and use it accordingly
37 try
38 {
39 // Example: textView.setText(requiredData);
40 }
41 catch (Exception ex)
42 {
43 // Catch any exception that occurs while parsing
44 ex.printStackTrace();
45 }
46 }
47 });
48 }
49}).start();
Recommended Product Full Code Example
This Social Proof type uses a recommendation strategy to determine and display a message on products the customer is most likely to purchase. You must add the ContextProductDetailView event.
React Native
React Web
iOS
Android
Recommendation Strategy-Based Social Proof Action Example
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductDetailView, {
10 products: [{productId: "94",sku: "sku"}],
11});
12
13// Get Social Proof Actions
14// ----------------------------------------------------
15let socialProofData;
16personalizationInstance
17 .getActionsData("monetate:action:OmniSocialProofDataV2")
18 .then(res => {
19 socialProofData = res[0].actions;
20 })
21 .catch(error => {
22 console.warn('Error!', error);
23 });
Recommendation Strategy-Based Social Proof Action Example
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductDetailView, {
10 products: [{productId: "94",sku: "sku"}],
11});
12
13// Get Social Proof Actions
14// ----------------------------------------------------
15let socialProofData;
16personalizationInstance
17 .getActionsData("monetate:action:OmniSocialProofDataV2")
18 .then(res => {
19 socialProofData = res[0].actions;
20 })
21 .catch(error => {
22 console.warn('Error!', error);
23 });
Recommendation Strategy-Based Social Proof Action Example
1// Add Context / Events
2//-------------------------------------------------------------------------
3objPersonalization.addEvent(context: .ScreenSize, event: ScreenSize(height: 1000, width: 400))
4objPersonalization.addEvent(context: .IpAddress, event: IPAddress(ipAddress: "192.168.1.52"))
5objPersonalization.addEvent(
6 context: .ProductDetailView,
7 event: ProductDetailView(products: [Product(productId: "BackP_010", sku: "Blue_BackP_010")]))
8
9// Get Social Proof Actions
10// ----------------------------------------------------
11objPersonalization.getActionsData(
12 requestId: "123456", includeReporting: false,
13 arrActionTypes: ["monetate:action:SocialProofDataV2"]
14)
15.on { res in
16 if res.status == 200 {
17 let data = JSON(res.data as Any)
18 for item in data["data"]["responses"].arrayValue {
19 if item["requestId"].string == res.requestId {
20 for socialProof in item["actions"].arrayValue {
21 self.handleSocialProofs(res: socialProof)
22 }
23 }
24 }
25 } else {
26 // Error Handling
27 }
28}
You must handle the getActions method in a Thread or AsyncTask. To update the main thread, you can use either Handler or runOnUiThread. This full code example uses Thread and Handler to update the main thread and change the UI.
Recommendation Strategy-Based Social Proof Action Example
1// Add Context and Events
2Product product1 = new Product();
3product1.setProductId("97");
4product1.setSku("SKU");
5ProductDetailView productDetailView = new ProductDetailView();
6productDetailView.setProducts(new Product[]
7{
8 product1
9});
10PageView pageView = new PageView();
11pageView.setPageType("Cartpage");
12pageView.setUrl("https://www.monetate.com");
13
14// addEvent
15personalization.addEvent(EventTypes.ContextProductDetailView, productDetailView);
16personalization.addEvent(EventTypes.ContextPageView, pageView);
17
18// Get Social Proof Actions
19// getActionsData
20String responseData;
21new Thread(new Runnable()
22{
23 @Override
24 public void run()
25 {
26 // Gets the responseData using getActionsData
27 responseData = personalization.getActionsData(new String[]
28 {
29 "monetate:action:SocialProofDataV2"
30 }, true);
31 // Once you receive the responseData from getActionsData, use the Handler and parse the required data from it
32 new Handler(Looper.getMainLooper()).post(new Runnable()
33 {
34 @Override
35 public void run()
36 {
37 // Parse the received responseData, get the requiredData from it and use it accordingly
38 try
39 {
40 // Example: textView.setText(requiredData);
41 }
42 catch (Exception ex)
43 {
44 // Catch any exception that occurs while parsing
45 ex.printStackTrace();
46 }
47 }
48 });
49 }
50}).start();
Inventory Full Code Example for Product Detail Pages
This Social Proof type displays a message on products based on your current inventory, which may indicate that a product is popular due to limited inventory count. To target product detail pages, you must add the ContextProductDetailView event.
React Native
React Web
iOS
Android
Inventory-Based Social Proof Action Example—Product Detail Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductDetailView, {
10 products: [{productId: "94",sku: "sku"}],
11});
12
13// Get Social Proof Actions
14// ----------------------------------------------------
15let socialProofData;
16personalizationInstance
17 .getActionsData("monetate:action:OmniSocialProofDataV2")
18 .then(res => {
19 socialProofData = res[0].actions;
20 })
21 .catch(error => {
22 console.warn('Error!', error);
23 });
Inventory-Based Social Proof Action Example—Product Detail Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductDetailView, {
10 products: [{productId: "94",sku: "sku"}],
11});
12
13// Get Social Proof Actions
14// ----------------------------------------------------
15let socialProofData;
16personalizationInstance
17 .getActionsData("monetate:action:OmniSocialProofDataV2")
18 .then(res => {
19 socialProofData = res[0].actions;
20 })
21 .catch(error => {
22 console.warn('Error!', error);
23 });
Inventory-Based Social Proof Action Example—Product Detail Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3objPersonalization.addEvent(context: .ScreenSize, event: ScreenSize(height: 1000, width: 400))
4objPersonalization.addEvent(context: .IpAddress, event: IPAddress(ipAddress: "192.168.1.52"))
5objPersonalization.addEvent(
6 context: .ProductDetailView,
7 event: ProductDetailView(products: [Product(productId: "BackP_010", sku: "Blue_BackP_010")]))
8
9// Get Social Proof Actions
10// ----------------------------------------------------
11objPersonalization.getActionsData(
12 requestId: "123456", includeReporting: false,
13 arrActionTypes: ["monetate:action:SocialProofDataV2"]
14)
15.on { res in
16 if res.status == 200 {
17 let data = JSON(res.data as Any)
18 for item in data["data"]["responses"].arrayValue {
19 if item["requestId"].string == res.requestId {
20 for socialProof in item["actions"].arrayValue {
21 self.handleSocialProofs(res: socialProof)
22 }
23 }
24 }
25 } else {
26 // Error Handling
27 }
28}
You must handle the getActions method in a Thread or AsyncTask. To update the main thread, you can use either Handler or runOnUiThread. This full code example uses Thread and Handler to update the main thread and change the UI.
Inventory-Based Social Proof Action Example—Product Detail Pages
1// Add Context and Events
2Product product1 = new Product();
3product1.setProductId("97");
4product1.setSku("SKU");
5ProductDetailView productDetailView = new ProductDetailView();
6productDetailView.setProducts(new Product[]
7{
8 product1
9});
10PageView pageView = new PageView();
11pageView.setPageType("Cartpage");
12pageView.setUrl("https://www.monetate.com");
13
14// addEvent
15personalization.addEvent(EventTypes.ContextProductDetailView, productDetailView);
16personalization.addEvent(EventTypes.ContextPageView, pageView);
17
18// Get Social Proof Actions
19// getActionsData
20String responseData;
21new Thread(new Runnable()
22{
23 @Override
24 public void run()
25 {
26 // Gets the responseData using getActionsData
27 responseData = personalization.getActionsData(new String[]
28 {
29 "monetate:action:SocialProofDataV2"
30 }, true);
31 // Once you receive the responseData from getActionsData, use the Handler and parse the required data from it
32 new Handler(Looper.getMainLooper()).post(new Runnable()
33 {
34 @Override
35 public void run()
36 {
37 // Parse the received responseData, get the requiredData from it and use it accordingly
38 try
39 {
40 // Example: textView.setText(requiredData);
41 }
42 catch (Exception ex)
43 {
44 // Catch any exception that occurs while parsing
45 ex.printStackTrace();
46 }
47 }
48 });
49 }
50}).start();
Inventory Full Code Example for Pages Displaying Multiple Product IDs
This Social Proof type displays a message on products based on your current inventory, which may indicate that a product is product due to limited inventory count. To target page types that contain multiple product IDs—such as product category listings, search results pages, and cart pages—you must add the ProductThumbnailView event.
React Native
React Web
iOS
Android
Inventory-Based Social Proof Action Example—Multi-PID Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductThumbnailView, {
10 "products": ["90","91","92" ]
11});
12
13// Get Social Proof Actions
14// ----------------------------------------------------
15let socialProofData;
16personalizationInstance
17 .getActionsData("monetate:action:OmniSocialProofDataV2")
18 .then(res => {
19 socialProofData = res[0].actions;
20 })
21 .catch(error => {
22 console.warn('Error!', error);
23 });
Inventory-Based Social Proof Action Example—Multi-PID Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3personalizationInstance.addEvent(EventTypes.ContextScreenSize, { width: 23, height: 34 });
4
5personalizationInstance.addEvent(EventTypes.ContextIpAddress, {
6 ipAddress: "10.0.0.2",
7});
8
9personalizationInstance.addEvent(EventTypes.ContextProductThumbnailView, {
10 "products": ["90","91","92" ]
11});
12
13// Get Social Proof Actions
14// ----------------------------------------------------
15let socialProofData;
16personalizationInstance
17 .getActionsData("monetate:action:OmniSocialProofDataV2")
18 .then(res => {
19 socialProofData = res[0].actions;
20 })
21 .catch(error => {
22 console.warn('Error!', error);
23 });
Inventory-Based Social Proof Action Example—Multi-PID Pages
1// Add Context / Events
2//-------------------------------------------------------------------------
3objPersonalization.addEvent(context: .ScreenSize, event: ScreenSize(height: 1000, width: 400))
4objPersonalization.addEvent(context: .IpAddress, event: IPAddress(ipAddress: "192.168.1.52"))
5objPersonalization.addEvent(
6 context: .ProductThumbnailView,
7 event: ProductThumbnailView(products: Set(["BackP_010", "BackP_011"])))
8
9// Get Social Proof Actions
10// ----------------------------------------------------
11objPersonalization.getActionsData(
12 requestId: "123456", includeReporting: false,
13 arrActionTypes: ["monetate:action:SocialProofDataV2"]
14)
15.on { res in
16 if res.status == 200 {
17 let data = JSON(res.data as Any)
18 for item in data["data"]["responses"].arrayValue {
19 if item["requestId"].string == res.requestId {
20 for socialProof in item["actions"].arrayValue {
21 self.handleSocialProofs(res: socialProof)
22 }
23 }
24 }
25 } else {
26 // Error Handling
27 }
28}
You must handle the getActions method in a Thread or AsyncTask. To update the main thread, you can use either Handler or runOnUiThread. This full code example uses Thread and Handler to update the main thread and change the UI.
Inventory-Based Social Proof Action Example—Multi-PID Pages
1// Add Context and Events
2ProductThumbnailView productThumbnailView = new ProductThumbnailView();
3productThumbnailView.setProducts(new String[]
4{
5 "104",
6 "94",
7 "97"
8});
9PageView pageView = new PageView();
10pageView.setPageType("Cartpage");
11pageView.setUrl("https://www.monetate.com");
12
13// addEvent
14personalization.addEvent(EventTypes.ContextProductThumbnailView, productThumbnailView);
15personalization.addEvent(EventTypes.ContextPageView, pageView);
16
17// Get Social Proof Actions
18// getActionsData
19String responseData;
20new Thread(new Runnable()
21{
22 @Override
23 public void run()
24 {
25 // Gets the responseData using getActionsData
26 responseData = personalization.getActionsData(new String[]
27 {
28 "monetate:action:SocialProofDataV2"
29 }, true);
30 // Once you receive the responseData from getActionsData, use the Handler and parse the required data from it
31 new Handler(Looper.getMainLooper()).post(new Runnable()
32 {
33 @Override
34 public void run()
35 {
36 // Parse the received responseData, get the requiredData from it and use it accordingly
37 try
38 {
39 // Example: textView.setText(requiredData);
40 }
41 catch (Exception ex)
42 {
43 // Catch any exception that occurs while parsing
44 ex.printStackTrace();
45 }
46 }
47 });
48 }
49}).start();