Actions
Create a Data Collection Action

In some cases when you trigger an action, you might not want to alter your site's content while still retaining the customer data involved with the action. In these cases, you can perform a Data Collect action.
You can set up a handler for a data collection action by 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 customer data.
While this data does not affect your site's content, you can use it for other cases elsewhere in code.
addEvent
This method adds a local event to the SDK's internal stack.
React Native
React Web
iOS
Android
addEvent Method
addEvent(context: EventTypes, events: ContextData): void
addEvent(context: EventTypes, events: ContextData): void
﻿
addEvent Method
addEvent(context: EventTypes, events: ContextData): void
addEvent(context: EventTypes, events: ContextData): void
﻿
addEvent Method
addEvent(context: <ContextEnum>, event: <MEvent?>)
addEvent(context: <ContextEnum>, event: <MEvent?>)
﻿
addEvent Method
public void addEvent(String context, Object event)
public void addEvent(String context, Object event)
﻿
The parameters are as follows:
context is name of the event.
event is the event data. 
You can use this method multiple times to add all the necessary events for an experience that you might want to trigger. The example code uses multiple method calls to fulfill the experience requirements.
Code Example
React Native
React Web
iOS
Android
addEvent Example
personalizationInstance.addEvent(EventTypes.ContextScreenSize,
{
  width: 23,
  height: 34
});
personalizationInstance.addEvent(EventTypes.ContextIpAddress,
{
  ipAddress: "10.0.0.2",
});
personalizationInstance.addEvent(EventTypes.ContextPageView,
{
  url: "http://www.monetate.com/index.html",
  pageType: "Home"
});
personalizationInstance.addEvent(EventTypes.ContextScreenSize,
{
  width: 23,
  height: 34
});
personalizationInstance.addEvent(EventTypes.ContextIpAddress,
{
  ipAddress: "10.0.0.2",
});
personalizationInstance.addEvent(EventTypes.ContextPageView,
{
  url: "http://www.monetate.com/index.html",
  pageType: "Home"
});
﻿
addEvent Example
personalizationInstance.addEvent(EventTypes.ContextScreenSize,
{
  width: 23,
  height: 34
});
personalizationInstance.addEvent(EventTypes.ContextIpAddress,
{
  ipAddress: "10.0.0.2",
});
personalizationInstance.addEvent(EventTypes.ContextPageView,
{
  url: "http://www.monetate.com/index.html",
  pageType: "Home"
});
personalizationInstance.addEvent(EventTypes.ContextScreenSize,
{
  width: 23,
  height: 34
});
personalizationInstance.addEvent(EventTypes.ContextIpAddress,
{
  ipAddress: "10.0.0.2",
});
personalizationInstance.addEvent(EventTypes.ContextPageView,
{
  url: "http://www.monetate.com/index.html",
  pageType: "Home"
});
﻿
addEvent Example
objPersonalization.addEvent(context: .PageView, event: PageView(pageType: "Homepage", path: "n/a", url: "n/a", categories: [], breadcrumbs: []))
objPersonalization.addEvent(context: .PageView, event: PageView(pageType: "Homepage", path: "n/a", url: "n/a", categories: [], breadcrumbs: []))
﻿
addEvent Example
personalization.addEvent(EventTypes.ContextIpAddress, ipAddress);
personalization.addEvent(EventTypes.ContextPageView, pageView);
personalization.addEvent(EventTypes.ContextScreenSize, screenSize);
personalization.addEvent(EventTypes.ContextIpAddress, ipAddress);
personalization.addEvent(EventTypes.ContextPageView, pageView);
personalization.addEvent(EventTypes.ContextScreenSize, screenSize);
﻿
getActionsData
This method sends the defined events to Monetate to trigger an experience. If the events fulfill the WHO settings of an experience, then that experience is triggered. A JSON object containing the experience response is then returned.
React Native
React Web
iOS
Android
getActionsData Method
getActionsData(actionType: Array<string>, includeReporting: boolean) : Promise<any>
getActionsData(actionType: Array<string>, includeReporting: boolean) : Promise<any>
﻿
The parameters are 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.
includeReports indicates whether the response will have impression reporting data. 
Use DataCollection as the action type for this method. includeReports must be set to true for this method to return data.
getActionsData Method
getActionsData(actionType: Array<string>, includeReporting: boolean) : Promise<any>
getActionsData(actionType: Array<string>, includeReporting: boolean) : Promise<any>
﻿
The parameters are 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.
includeReports indicates whether the response will have impression reporting data. 
Use DataCollection as the action type for this method. includeReports must be set to true for this method to return data.
getActionsData Method
getActionsData(requestId: <String>, includeReporting: <Bool>, arrActionTypes: <[String]>) 
getActionsData(requestId: <String>, includeReporting: <Bool>, arrActionTypes: <[String]>) 
﻿
The parameters in the iOS version are as follows:
requestID is the request ID for the API.
includeReporting indicates whether the response will have impression reporting data.
arrActionTypes is the types of action you want to request. You can specify multiple actions in an array to handle.
Use DataCollection as the action type for this method. includeReporting must be set to true for this method to return data.
getActionsData Method
public String getActionsData(String[] actionTypes, boolean includeReports)
public String getActionsData(String[] actionTypes, boolean includeReports)
﻿
The parameters are 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.
includeReports indicates whether the response will have impression reporting data. 
Use DataCollection as the action type for this method. includeReports must be set to true for this method to return data.
Code Example
React Native
React Web
iOS
Android
 getActionsData Example
responseData = personalizationInstance.getActionsData("monetate:action:DataCollection", true);
responseData = personalizationInstance.getActionsData("monetate:action:DataCollection", true);
﻿
getActionsData Example
responseData = personalizationInstance.getActionsData("monetate:action:DataCollection", true);
responseData = personalizationInstance.getActionsData("monetate:action:DataCollection", true);
﻿
 getActionsData Example
objPersonalization.getActionsData(requestId: "123456", includeReporting: true, arrActionTypes:["monetate:action:DataCollection"]).on{res in 
  if res.status==200 {
    self.handleRecommendations(res: res)
  } else {
  }
 }
}
objPersonalization.getActionsData(requestId: "123456", includeReporting: true, arrActionTypes:["monetate:action:DataCollection"]).on{res in 
  if res.status==200 {
    self.handleRecommendations(res: res)
  } else {
  }
 }
}
﻿
 getActionsData Example
String responseData = personalization.getActionsData(new String[]{"monetate:action:DataCollection"},true);
String responseData = personalization.getActionsData(new String[]{"monetate:action:DataCollection"},true);
﻿
Full Code Example
React Native
React Web
iOS
Android
Data Collection Action Full Example
// Add Context / Events
// ----------------------------------------------------
personalizationInstance.addEvent(EventTypes.ContextScreenSize,
{
  width: 23,
  height: 34
});
personalizationInstance.addEvent(EventTypes.ContextIpAddress,
{
  ipAddress: "10.0.0.2",
});
personalizationInstance.addEvent(EventTypes.ContextPageView,
{
  url: "http://www.monetate.com/index.html",
  pageType: "Home"
});
// ----------------------------------------------------
// Get Actions
let recData;
personalizationInstance
  .getActionsData("monetate:action:DataCollection", true)
  .then(res =>
  {
    recsData = res[0].actions;
  })
  .catch(error =>
  {
    console.warn('Error!', error);
  });
// Add Context / Events
// ----------------------------------------------------
personalizationInstance.addEvent(EventTypes.ContextScreenSize,
{
  width: 23,
  height: 34
});
personalizationInstance.addEvent(EventTypes.ContextIpAddress,
{
  ipAddress: "10.0.0.2",
});
personalizationInstance.addEvent(EventTypes.ContextPageView,
{
  url: "http://www.monetate.com/index.html",
  pageType: "Home"
});
// ----------------------------------------------------
// Get Actions
let recData;
personalizationInstance
  .getActionsData("monetate:action:DataCollection", true)
  .then(res =>
  {
    recsData = res[0].actions;
  })
  .catch(error =>
  {
    console.warn('Error!', error);
  });
﻿
Data Collection Action Full Example
// Add Context / Events
// ----------------------------------------------------
personalizationInstance.addEvent(EventTypes.ContextScreenSize,
{
  width: 23,
  height: 34
});
personalizationInstance.addEvent(EventTypes.ContextIpAddress,
{
  ipAddress: "10.0.0.2",
});
personalizationInstance.addEvent(EventTypes.ContextPageView,
{
  url: "http://www.monetate.com/index.html",
  pageType: "Home"
});
// ----------------------------------------------------
// Get Actions
let recData;
personalizationInstance
  .getActionsData("monetate:action:DataCollection", true)
  .then(res =>
  {
    recsData = res[0].actions;
  })
  .catch(error =>
  {
    console.warn('Error!', error);
  });
// Add Context / Events
// ----------------------------------------------------
personalizationInstance.addEvent(EventTypes.ContextScreenSize,
{
  width: 23,
  height: 34
});
personalizationInstance.addEvent(EventTypes.ContextIpAddress,
{
  ipAddress: "10.0.0.2",
});
personalizationInstance.addEvent(EventTypes.ContextPageView,
{
  url: "http://www.monetate.com/index.html",
  pageType: "Home"
});
// ----------------------------------------------------
// Get Actions
let recData;
personalizationInstance
  .getActionsData("monetate:action:DataCollection", true)
  .then(res =>
  {
    recsData = res[0].actions;
  })
  .catch(error =>
  {
    console.warn('Error!', error);
  });
﻿
Data Collection Action Full Example
import MarqueeLabel
import UIKit
import monetate_ios_sdk

class CategoryViewController: UIViewController {
  final var objPersonalization = Personalization(
    account: Account(
      instance: "p", domain: "localhost.org", name: "a-701b337c", shortname: "localhost"),
    user: User(deviceId: "62bd2e2d-213d-463f-83bb-12c0b2530a14"))
  override func viewDidLoad() {
    super.viewDidLoad()
  }
  override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    dataCollectionEvent()
  }
  func dataCollectionEvent() {
    objPersonalization.addEvent(context: .PageView, event: PageView(pageType: "Homepage", path: "n/a", url: "n/a", categories: [], breadcrumbs: []))
     
    objPersonalization.getActionsData(requestId: "test_request_id", includeReporting: true, arrActionTypes: ["monetate:action:DataCollection"]).on { (res) in
      if res.status == 200 {
        let data = JSON(res.data)
        print(data)
        self.handleAction(res: res)
      } else {
      }
    }
  }
}
import MarqueeLabel
import UIKit
import monetate_ios_sdk

class CategoryViewController: UIViewController {
  final var objPersonalization = Personalization(
    account: Account(
      instance: "p", domain: "localhost.org", name: "a-701b337c", shortname: "localhost"),
    user: User(deviceId: "62bd2e2d-213d-463f-83bb-12c0b2530a14"))
  override func viewDidLoad() {
    super.viewDidLoad()
  }
  override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    dataCollectionEvent()
  }
  func dataCollectionEvent() {
    objPersonalization.addEvent(context: .PageView, event: PageView(pageType: "Homepage", path: "n/a", url: "n/a", categories: [], breadcrumbs: []))
     
    objPersonalization.getActionsData(requestId: "test_request_id", includeReporting: true, arrActionTypes: ["monetate:action:DataCollection"]).on { (res) in
      if res.status == 200 {
        let data = JSON(res.data)
        print(data)
        self.handleAction(res: res)
      } else {
      }
    }
  }
}
﻿
Data Collection Action Full Example
// Events and context data
IpAddress ipAddress = new IpAddress();
ipAddress.setIpAddress("1.0.0.0");
ScreenSize screenSize = new ScreenSize();
screenSize.setHeight(1011);
screenSize.setWidth(2011);
PageView pageView = new PageView();
pageView.setPageType("homepage");
pageView.setUrl("https://www.monetate.com");

// addEvent
personalization.addEvent(EventTypes.ContextIpAddress, ipAddress);
personalization.addEvent(EventTypes.ContextPageView, pageView);

//getActionsData
String responseData;
new Thread(new Runnable()
{
  @Override
  public void run()
  {
    // Gets the responseData using getActionsData
    responseData = personalization.getActions(EventTypes.ContextIpAddress, address, new String[]
    {
      "monetate:action:DataCollection"
    }, true);
    // Once you receive the responseData from getActionsData, use the Handler and parse the required data from it 
    new Handler(Looper.getMainLooper()).post(new Runnable()
    {
      @Override
      public void run()
      {
        // Parse the received responseData, get the requiredData from it and use it accordingly
        try
        {
          // Example: textView.setText(requiredData);
        }
        catch (Exception ex)
        {
          // Catch any exception that occurs while parsing 
          ex.printStackTrace();
        }
      }
    });
  }
}).start();
// Events and context data
IpAddress ipAddress = new IpAddress();
ipAddress.setIpAddress("1.0.0.0");
ScreenSize screenSize = new ScreenSize();
screenSize.setHeight(1011);
screenSize.setWidth(2011);
PageView pageView = new PageView();
pageView.setPageType("homepage");
pageView.setUrl("https://www.monetate.com");

// addEvent
personalization.addEvent(EventTypes.ContextIpAddress, ipAddress);
personalization.addEvent(EventTypes.ContextPageView, pageView);

//getActionsData
String responseData;
new Thread(new Runnable()
{
  @Override
  public void run()
  {
    // Gets the responseData using getActionsData
    responseData = personalization.getActions(EventTypes.ContextIpAddress, address, new String[]
    {
      "monetate:action:DataCollection"
    }, true);
    // Once you receive the responseData from getActionsData, use the Handler and parse the required data from it 
    new Handler(Looper.getMainLooper()).post(new Runnable()
    {
      @Override
      public void run()
      {
        // Parse the received responseData, get the requiredData from it and use it accordingly
        try
        {
          // Example: textView.setText(requiredData);
        }
        catch (Exception ex)
        {
          // Catch any exception that occurs while parsing 
          ex.printStackTrace();
        }
      }
    });
  }
}).start();
﻿
﻿
Create Social Proof Actions
Create a No Action Handler