Feature Summary: The Free App Analytics alerting system has been designed to provide an easy way to create and manage data-driven alerts for your app. These alerts are intended to inform you of changes in critical metrics associated with your app. The following document defines the process for creating and editing actions and alerts.

---

Alerting Interface

1. Log in to Free App Analytics.
2. Select the User drop-down menu > My Alerts.

 

---

Adding a New Action

Slack Settings:

1. Enter the Webhook.

NOTE: The Slack Webhook is found and configured by the Slack team administrator (or those with privileges) and is located in Custom Integrations > Incoming Webhooks.

 

Locating/Creating a Slack WebHook —

1. Log in to Slack.
2. Select the Slack drop-down menu > Apps & integrations.

 



 

3. Click Manage.

 



 

4. Click Custom Integrations.

 



 

5. Click Incoming WebHooks.
6. Click Add Configuration.

 



 

7. If a Channel has not been selected, Select a Channel to send the Slack notification to.

 



A. Select the group or single user, that the Slack message will be sent to. The @ symbol must be included for the WebHook to be setup properly.



 

8. Copy the WebHook URL and Enter in the Free App Analytics UI.

NOTE: If the WebHook needs to be edited, the same steps above may be used to access and edit the WebHook.


2. Enter the Channel.
3. Click Save.

 



 

---

Email Settings:

NOTE: The email address of the user currently logged-in will be automatically entered into the recipient field. Additional email addresses may be added as needed.

1. Enter additional Recipients Email Addresses. (optional)
2. Click Save.

 



 

---

Text Message:

1. Enter a Phone Number.

NOTE: For phone numbers within the United States, format as (Area Code)-Local Number (e.g., 555-123-4567). For international phone numbers, format as +(Country Code) (Area Code) Local Number (e.g., +1 8 8232-6262).

2. Click Save.

 

---

Voice Call:

1. Enter a Phone Number.

NOTE: For phone numbers within the United States, format as (Area Code)-Local Number (e.g., 555-123-4567). For international phone numbers, format as +(Country Code) (Area Code) Local Number (e.g., +1 8 8232-6262).

NOTE: When the alert conditions have been met, a voice call will be placed by the Free App Analytics automated system describing the alert details and the conditions that were met.

2. Click Save.

 



 

---

Pagerduty Settings:

1. Enter the Service Key.
2. Click Save.

 

---

Editing an Action

1. Click Actions.
2. Select Action Tools (⋮) > Edit.

 



 

3. Adjust any settings as needed.
4. Click Save.

---

Adding a New Alert

Actions provide the means to signal the user that an alert has been triggered.

 

BEST PRACTICES: Ensure that all the information entered within each Action is correct. Free App Analytics does not validate any of the information entered within the Action fields. If the information within an Action is not correct, notification may be sent to the wrong location once an alert has been triggered.

 

1. Click Add an Alert.
2. Enter an unique Alert Name.
3. Select an App.
4. Select a Severity level:
   1. Low
   2. Medium
   3. High
5. Select an Action Type:
   1. Slack to User
   2. Email to User
   3. Pagerduty
   4. Text Message
   5. Voice Call

 


 

6. Select a Metric:
   1. Conversion Rate[
   2. Influencers Per Conversion
   3. MTTI (seconds)
   4. Revenue Per Device
   5. Revenue
   6. Install Volume
   7. Event Volume
   8. Click Volume
   9. Impression Volume
7. Select a Condition:
   1. < (less than)
   2. > (greater than)
   3. = (equal to)
   4. <= (less than or equal to)
   5. >= (greater than or equal to)
8. Enter a Threshold value.

NOTE: Thresholds are the point or number at which the alert is triggered and the associated action is taken.

9. Select a Duration:
   1. 1 Hr
   2. 24 Hrs
   3. 48 Hrs
   4. 60 Hrs
   5. 72 Hrs

NOTE: Duration pertains to the aggregate amount of time in which the threshold is calculated. Once the duration is set, Free App Analytics will check every 3 minutes against a rolling duration (i.e., if the Duration is set at 1 hour, every 3 minutes the alerting tool will check the prior 1 hour) to see if the condition & threshold was met and will trigger the alert accordingly. If the alert is triggered, the defined notification action will be taken. Once an alert is triggered, Free App Analytics will continue checking every 3 minutes, but will not continue sending repeat alerts. An alert will not trigger another notification action until after the threshold no longer meets the condition for a minimum of one duration cycle.

 



 

10. Click Add a Filter. (optional)
1. Select a Dimension:
1. Campaign
2. Network
3. Tracker
2. Select a Modifier:
1. In
2. Note In
3. Select Value(s).

 



 

11. Click Save.

---

Alert Indications

Once alerts have been created, an orange dot will appear next to the username and the current number of active alerts will appear in the User Drop-Down menu.

 

A. Indicates that alerts are being processed.
B. Indicates the number of active alerts, in this case (3).

---

Organizing Alerts

Alerts can be searched, organized or displayed in multiple ways in order to quickly locate specific alerts.

 

Sorting Alerts:

1. Select Sort:
   1. Last Triggered
   2. Severity
   3. Name

NOTE: By default, alerts are sorted by Last Triggered.

 

Display Alerts by Action:

1. Select Action:
   1. All
   2. Slack
   3. Email
   4. Text Message
   5. Voice Call
   6. Pagerduty

NOTE: By default, all Action types are displayed.

 

Display Alerts by State:

1. Select State:
   1. Active
   2. Disabled

NOTE: By default, Active alerts are displayed.

 

A. Enter a term to search through alerts.
B. Sort alerts by Last Triggered, Severity, or Name. The example has been sorted by Severity.
C. Display all alerts or alerts that send notifications by Slack, Text Messages, or Pagerduty alerts.
D. Display either Active or Disabled alerts.

---

Viewing Alert Details

The My Alerts section displays all of the triggered and non-triggered alerts that have been setup by the user logged-in, and organized by apps. Click on an Action’s expand button to display the Type, Duration, Severity, Action Type, Last Checked and whether the alert has been triggered or not.

1. Click on the desired Alert.

 

A. The date the alert was checked.
B. The alert settings.
C. Alert that has not been triggered.
D. Alert Severity.

---

Editing an Alert

Once alerts have been created, they can be edited to refine or completely change any of the alert settings.

1. Locate the desired alert.
2. Click Alert Tools (⋮) > Edit.

 



 

3. Adjust any settings as needed.
4. Click Save.

---

Deactivating an Alert

At any point after the creation of an alert, the alert may be deactivated.

1. Locate the desired alert.
2. Click Alert Tools (⋮) > Deactivate.

 

 

NOTE: In order to view a deactivated alert, Select State>Disabled.

---

Creating a Custom Query Alert

 

FAA Limited Option: This feature is not available within Free App Analytics. Contact us for more information on upgrading to a paid Kochava account.

 

1. Write a query that returns a single value under the column alert_metric.
2. Save the query in the Kochava Query interface.
3. When creating an alert, Select the alert query as the metric.
4. Select a threshold and conditionthat will check against the alert_metric value returned by the query.

 

Things to Consider when Writing the Query:

• The date range needs to be set dynamically in your query as the duration setting in the alerting UI is ignored.
• Only a single value can be returned or the alert will fail.
• The column name must be alert_metric.

 

Example:

-- Returns the event revenue from the previous hour.  Set the threshold that will trigger the alert in the UI.
SELECT SUM(event_value) AS alert_metric
FROM events_primary
WHERE date_occurred BETWEEN DATE_ADD(CURRENT_TIMESTAMP(), -1, 'hour') AND CURRENT_TIMESTAMP() -- Set dynamic date range here.
    AND event_name = 'Purchase'; -- Update event name here to reflect your app's revenue event.