Configuring the Analytics Ingredient

You can configure the Analytics Ingredient as a Trigger to make Potion execute its Action(s) in response to certain changes on your Social Analytics and cloud-based MisoData widgets.

This task shows you how to:


Before you begin:
  • Configure at least one Social Analytics widget that does not contain any content from private or secret 3DSwym communities you are not an owner of, or one cloud-based MisoData widget, and pin it to your dashboard.
  • During the configuration of Potion, add the Analytics Ingredient as a Trigger. For more information, see Add Triggers.

Configure the My chart is updated Trigger

You can configure your Potion so it can execute its Action(s) whenever a series of the chart of a Social Analytics or cloud-based MisoData of your dashboard is updated, that is when there is a new value associated to a new point in time.

This trigger is only compatible with charts that have values that depend on a point in time, which are:

AppChart KindRelated Topic
Social AnalyticsWhat is said?—Except any chart that contains content from private or secret 3DSwym communities you are not an owner of.About Social Analytics Chart Kinds
How is it perceived?—Except any chart that contains content from private or secret 3DSwym communities you are not an owner of.
MisoData Quantitative Time-series1 - Select Data Type

  1. From the When list, select My chart is updated.
  2. From the in Analytics app list, select the Social Analytics or MisoData that triggers the Potion when its chart is updated.
  3. From the Series list, select the series of the chart that triggers the Potion when it is updated.
  4. Required: From the Use the forecast value option, select either of the following:
    OptionDescription
    Yes The new value of the series considered by the Trigger is the forecast value, that is the value from the forecast statistical curve. For more information, see Editing Series.
    No The new value of the series considered by the Trigger is the actual value of the series.
  5. Required: From the Include option, select either of the following:
    OptionDescription
    Only the new chart value Potion only uses the most recent value from the series when it executes its Action(s). For example, when the Action is Send an email, the email only contains the most recent value from the series.
    Chart values from the past Potion uses all the values available for all the points in time within the time frame you specified with this option when it executes its Action(s). For example, when you specify a 7-day time frame and the Action is Send an email, the email contains the values of all the points in time of the series that are within the last seven days.
    Note: The values must have been retrieved into your dashboard before your Potion is triggered for them to be included in the Action(s).
  6. Optional: Depending on the option you selected in step 5, you can add one or several of the following conditions:
    • If you selected the Only the new chart value option, you can add a Value condition to make the value trigger your Potion only when it is greater than, less than, or equal to the value of your choice. For example, if you select is greater than and enter 100, your Potion only executes its Action(s) when the series of the chart is updated with a new value that is over 100.
    • If you selected the Chart values from the past option, you can add one or several of the following conditions:
    ConditionDescription
    Newest Value Potion executes its Action(s) only when the chart of the Social Analytics or cloud-based MisoData you selected is updated with a new value which is greater than, less than, or equal to the value you enter in the field of this condition.
    Oldest Value Potion executes its Action(s) when the chart of the Social Analytics or cloud-based MisoData you selected is updated with a new value and the oldest value within the time frame you specified at step 5 is greater than, less than, or equal to the value you enter in the field of this condition.
    My chart is trending Potion executes its Action(s) when the chart of the Social Analytics or cloud-based MisoData you selected is updated with a new value and this new value makes the series follow the trend you select for this condition.
    Inflection point Potion executes its Action(s) when the chart of the Social Analytics or cloud-based MisoData you selected is updated with a new value which changes the trend of the series to the other direction.
    New max/min Select either of the following:
    • Highest value for Potion to execute its Action(s) when the chart of the Social Analytics or MisoData you selected is updated with a new value that is greater than all the other values within the time frame you specified at step 5.
    • Lowest value for Potion to execute its Action(s) when the chart of the Social Analytics or MisoData you selected is updated with a new value that is less than all the other values within the time frame you specified at step 5.
    Variation Potion executes its Action(s) when the chart of the Social Analytics or MisoData you selected is updated with a new value which varies from the oldest value of the time frame you specified at step 5 according to the options you select for this condition.

Configure the Entry enters the top Trigger

You can configure your Potion so it can execute its Action(s) whenever the position of the entry of your choice reaches the top of the chart. This trigger is only compatible with charts whose values do not depend on points in time. Therefore, the compatible charts are:

App Chart Kind Related Topic
Social Analytics Where is it happening?—Except any chart that contains content from private or secret 3DSwym communities you are not an owner of. About Social Analytics Chart Kinds
Who is talking?—Except any chart that contains content from private or secret 3DSwym communities you are not an owner of.
MisoData Quantitative Series 1 - Select Data Type
Qualitative Series

  1. From the When list, select Entry enters the top.
  2. From the Top list, select the number of positions that constitute the top of the chart. For example, select 3 to consider that the top of your chart is made of its first 3 entries.
  3. From the in Analytics app list, select the Social Analytics or MisoData that you want to trigger the Potion with when an entry enters its top.
  4. From the Series list, select the series of the chart that you selected at step 2 that you want to trigger the Potion with when it is updated.
  5. From the Include option, select either of the following:
    OptionDescription
    Only the new top entry Potion only uses the entry that triggered it by entering the top when it executes its Action(s). For example, when the Action is Send an email, the email only contains the entry that entered the top of the chart.
    Top entries from the past Potion uses all the entries that ever entered the top within the time frame you specified with this option when it executes its Action(s). For example, when you specify a seven-day time frame and the Action is Send an email, the email contains all the entries that ever entered the top within the last seven days.
  6. Optional: You can add one or both of the following conditions:
    ConditionDescription
    Newest entry position Potion executes its Action(s) only when an entry enters the top at the position that is greater than, less than, or equal to the position number you enter in the field of this condition. For example, if you selected 10 at step 2, select is greater than and enter 5, Potion only executes its Action(s) if an entry enters the top 10 at position 5, 6, 7, 8, 9, or 10.
    Newest entry name contains Potion executes its Action(s) only when the entry that enters the top contains the text value you have entered in this field.

Configure the Entry exits the top Trigger

You can configure your Potion so it can execute its Action(s) whenever the position an entry of the chart exists its top.

This trigger is only compatible with charts whose values do not depend on points in time. Therefore, the compatible charts are:

App Chart Kind Related Topic
Social Analytics Where is it happening?—Except any chart that contains content from private or secret 3DSwym communities you are not an owner of. About Social Analytics Chart Kinds
Who is talking?—Except any chart that contains content from private or secret 3DSwym communities you are not an owner of.
MisoData Quantitative Series 1 - Select Data Type
Qualitative Series

  1. From the When list, select Entry exits the top.
  2. From the Top list, select the number of positions that constitute the top of the chart. For example, select 3 to consider that the top of your chart is made of its first 3 entries.
  3. From the in Analytics app list, select the Social Analytics or MisoData that you want to trigger the Potion with when an entry exits its top.
  4. From the Series list, select the series of the chart you select at step 2 that you want to trigger the Potion with when an entry exits its top.
  5. From the Include option, select either of the following:
    OptionDescription
    Only the new top entry Potion only uses the entry that triggered it by exiting the top when it executes its Action(s). For example, when the Action is Send an email, the email only contains the entry that exited the top of the chart.
    Top entries from the past Potion uses all the entries that exited the top within the time frame you specify with this option when it executes its Action(s). For example, when you specify a seven-day time frame and the Action is Send an email, the email contains all the entries that exited the top within last seven days.
  6. Optional: You can add the following condition:
    ConditionDescription
    Newest entry name contains Potion executes its Action(s) only when the entry that exits the top contains the text value you have entered in this field.