1. Home
  2. Marketers
  3. Advanced Tools
  4. Alerting
  1. Home
  2. Marketers
  3. Alerting
Searching...

Alerting

Contents


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. Click on the Alerts Icon.

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.
  8. Copy the WebHook URL and Enter in the Kochava UI.

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.

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

 

  1. Enter the Channel.
  2. 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.
  2. Click Save.

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

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 Kochava automated system describing the alert details and the conditions that were met.

  1. Click Save.

Pagerduty Settings:

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

Editing an Action

  1. Click the Actions tab.
  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. 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:
Options:
  • Low
  • Medium
  • High
  1. Select an Action Type:
Options:
  • Slack to User
  • Email to User
  • Pagerduty
  • Text Message
  • Voice Call
  1. Select a Metric:
Options:
  • Conversion Rate
  • Influencers Per Conversion
  • MTTI (seconds)
  • Revenue Per Device
  • Revenue
  • Install Volume
  • Event Volume
  • Click VOlume
  • Impression Volume
  1. Select a Condition:
Options:
  • < (less than)
  • > (greater than)
  • = (equal to)
  • <= (less than or equal to)
  • >= (greater than or equal to)
  1. Enter a Threshold value.

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

  1. Select a Duration:
Options:
  • 1 Hr
  • 24 Hrs
  • 48 Hrs
  • 60 Hrs
  • 72 Hrs

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.

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

NOTE: Do not manually enter a value, only select the value from the provided drop-down list.

  1. Click Save.

Organizing Alerts

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

Sorting Alerts:

Alerts can be sorted in ascending or descending order by any of the available columns including Name, Type, Severity, Last Checked, Triggered and Status.

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

Filter:

Filters can be added in order to quickly locate a desired Action.

  1. Click Filter.

NOTE: By default 2 filters are already present, Status = Active and Action = All.

  1. Select the desired filter metric, and the desired option for display.

NOTE: No new filters can be added, only the 2 default filters can be modified.

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

A. The date the alert was checked.
B. The alert settings.
C. 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 Actions > 🖉 (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 Actions > Deactivate toggle.

NOTE: In order to view a deactivated alert, use the filter and set Status > 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 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.

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.
Updated on May 30, 2025

Was this article helpful?

Yes No