Coverage Scenario
Create Coverage Scenarios to test run a simulation for customers and know if they have enough offer coverage for each group of their customer base, or for certain groups or segments.
Adding a new Coverage scenario
To add a new Coverage scenario, complete the following steps:
Procedure
-
In the Coverage tab, click +
Scenario.
A panel appears containing three tabs: General, Parameters, and Zone.
-
In the General tab:
-
In the Parameters tab:
- Define parameters for a coverage scenario, which are parameters passed into Interact Runtime API startSession call, the first API called in a coverage simulation. The Select Parameters dropdown lists all system defined parameters for startSession API. Users can either select from the dropdown or define new session parameter by typing in Name textbox. If the system parameters SimSaveProfileAttr (in the dropdown) is selected and set to 1, the profile attributes will be included in results of scenario simulation.
-
In the Zone tab:
-
Click Save button to save the scenario.
Note: You must save the unsaved changes before running the scenario. If you run the scenario without saving, the last saved scenario will get executed.
Results
- General
- Parameter
- Zone
- Simulation results
- Run history
Running the Coverage scenario
After saving the created coverage scenario, you can test it by running the scenario.
Procedure
- Open a scenario.
-
Click Run
The Select Server Group dialog appears.
-
Perform the following steps:
-
Click the Refresh button to check the status.
Interact UI does not automatically refresh the History tab to show its progress. Sometimes a coverage scenario can take long time to run due to large number of audiences that need to be processed. From this version, the UI request to Interact Design time to run a scenario is an asynchronous call. If the response from Runtime side is not received within the specified timeout time (default 30 second), the request from Design time will come back with run status as Running. Users can click Refresh button to check running process. We have introduced Reporting running progress so that you can export successful run results to a CSV file. Similar to run scenario, you can check exporting progress as percentage in Status column of run history record that is exporting.
- Cancel running: This icon is available only for the Simulator Coverage Scenario when a run starts or when the status is Running. When user clicks on this icon, the running of the Simulator Coverage Scenario is stopped.
Viewing the Simulation Results
After running the Coverage scenario you will see the following results:
About this task
Simulation Results tab
This tab is populated for following fields only after ‘Simulator Coverage Scenario’ is executed successfully by clicking on the Run button. For the failed run, this tab will be empty.
This tab will be always displayed for a coverage scenario. If there are no run results, user clicks it, it will say “No simulation result available". Once a run is completed and there are results in specified result tables, clicking the tab will make the simulation results, with two sections:
Section 1: ‘Run Summary’, which displays:
Overall status of this run in ‘Run Status’ field, Total time for the run in seconds in Duration (sec) field.
How many audiences being processed in ‘Audiences processed’ field and total number of offers are presented in ‘Offer count’ field.
Section 2: It displays a table with columns of
- Segment: Segment to which the AudienceID belongs
- Zone: Zone to which offer is assigned.
- Offer: Name of the offer which is presented to the audience.
- Audiences served offer: Number of audiences being served offers
This table will help user to know how their coverages are for their customer base.
Viewing the Run History
About this task
This tab displays all run history records in pagination. By default 10 run results are displayed on one page.
This tab is populated with following columns only after ‘Simulator Coverage Scenario’ is RUN.
- Run ID: The application will generate a unique RUNID for every run of Simulator Coverage Analysis scenario. This will be displayed on screen after the run is completed.
- Start time: It store the run start time of the Coverage Scenario run. By default it displays the start time in the ‘MMM DD, YYYY hh:mm:ss’ format.
- Run duration (sec): This column display the time taken by the Simulator Coverage Scenario takes to run.
- Run on: Interact Runtime URL on which the simulation run is executed.
- Status: : This column, display the status of the Simulator Coverage Scenario run.
The different status are as follows:
- Succeeded: If the Coverage Scenario run is completed successfully.
- Failed: If the Coverage Scenario run is failed to complete successfully.
- Running: If the Coverage Scenario run is still in progress.
- Exported to CSV: If the run result of the Simulator Coverage Scenario is exported into CSV file, then the status of the Coverage Scenario is set to Exported to CSV. By default user can export only the latest run result of scenario.
Number of audiences processed: This column displays the number of audience IDs processed in each run of the Simulator Coverage Scenario. This column will be populated only when the status is “Succeeded" or “Exported to CSV", It will be blank if the run is failed.
Summary: This column displays the summary for the status of each Simulator Coverage Scenario.
If Run is in progress then the Summary is displayed as ‘Running’.
If Run is Succeeded then the Summary is displayed as ‘Running simulation succeeded’
If Run is Failed then the Summary is displayed as ‘Server error running simulation’.
If run result of the Simulator Coverage Scenario is exported into CSV file the it gives the location where this file is exported.
Actions: This column displays the icon with actions within it. These icons are as below:
- Delete history record: This is available for every Simulator coverage scenario Run. By clicking on this icon the corresponding history record can be deleted.
- Download CSV: This icon appears only when the run result of the Simulator Coverage Scenario is exported into CSV. When it is clicked, the system retrieve CVS file saved on the DT server and download it to user’s browser.
- Refresh: Checks the run status.
- Delete all histories: Deletes all the run history
- Export to CSV: When user clicks on this link, latest run of the Simulator Coverage Scenario is exported to CSV and the status of this run is changed to Exported to CSV.
Export to CSV
Only latest results are saved in result tables, Interact system will pick up records from result tables and export them to an CSV file. The file name is in format of <ResultTableName>_<RunID>.csv.
The status for that run is changed to Exporting to CSV while DT server is processing (A message like “Exporting CSV is in processing" will be displayed). User can also see status in Run History tab. Once the CSV file is generated, the run history’s status changes to “Exported to CSV". The CSV file will be saved in system temp folder(/tmp/Interact_ExportedCSV/ ) of DT web server. The file name with full path will be saved in Summary field of the run history record.
For a coverage analysis, which could results in millions records, exporting could take long time. User can check run status for when it is done. For small set of data and if user session is still alive, the CSV file will be downloaded to user’s browser as well.