Feature Summary: The Kochava 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 Kochava.
  2. Select the User drop-down menu > My Alerts.

    Alerting Interface

Adding a New Action

Slack Settings:

  1. Enter the Webhook.
  2. 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.

      Slack Menu


    4. Click Manage.

      Slack Manage


    6. Click Custom Integrations.

      Slack Custom Integrations


    8. Click Incoming WebHooks.
    9. Click Add Configuration.

      Slack Add Configuration


    11. 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.


      Slack WebHook


    13. Copy the WebHook URL and Enter in the Kochava UI.
    14. NOTE: If the WebHook needs to be edited, the same steps above may be used to access and edit the WebHook.

  3. Enter the Channel.
  4. Click Save.

    Action Settings


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.

    Email Settings


Text Message:

  1. Enter a Phone Number.
  2. 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).

  3. Click Save.

    Text Message Settings

Voice Call:

  1. Enter a Phone Number.
  2. 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 Kochava automated system describing the alert details and the conditions that were met.

  3. Click Save.

    Voice Call Settings


Pagerduty Settings:

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

    Pager Duty Settings

Editing an Action

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

    Editing an Action


  4. Adjust any settings as needed.
  5. 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. Kochava 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

    New Alert General Settings


  7. 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
  8. Select a Condition:
    1. < (less than)
    2. > (greater than)
    3. = (equal to)
    4. <= (less than or equal to)
    5. >= (greater than or equal to)
  9. Enter a Threshold value.
  10. NOTE: Thresholds are the point or number at which the alert is triggered and the associated action is taken.

  11. Select a Duration:
    1. 1 Hr
    2. 24 Hrs
    3. 48 Hrs
    4. 60 Hrs
    5. 72 Hrs
  12. NOTE: Duration pertains to the aggregate amount of time in which the threshold is calculated. Once the duration is set, Kochava 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, Kochava 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.


    New Alert Advanced Settings


  13. 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).


    Add a Filter


  14. 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.


Alert Indications
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
  2. 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
  2. NOTE: By default, all Action types are displayed.


Display Alerts by State:

  1. Select State:
    1. Active
    2. Disabled
  2. NOTE: By default, Active alerts are displayed.


Organizing Alerts
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.

Alert Details
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.

    Editing an Alert


  4. Adjust any settings as needed.
  5. 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.

Deactivate an Alert


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

Creating a Custom Query Alert

  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 condition that 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.



-- 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.


Last Modified: Dec 28, 2023 at 10:47 am