Alerting


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.

 

alertinguserdropdownmyalertshd


Adding a New Alert Action

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 Action.
    2. Enter an unique Action Name.
    3. Select an Action Type:

a. Slack
b. Email
c. Text Message
d. Voice Call
e. Pagerduty

 

 

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 into Slack.
      2. Select the Slack drop-down menu>Apps & integrations.

 

 

      1. Click Manage.

 

 

      1. Click Custom Integrations.

 

 

      1. Click Incoming WebHooks.
      2. Click Add Configuration.

 

 

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

 

 

      1. Copy the WebHook URL and Enter in the Kochava UI.

 

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

altertingnewactionslackhd

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.
    2. Click Submit.

 

altertingnewactionemailhd

 

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

    1. Click Submit.

 

altertingnewactiontextmessagehd

 

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

 

 

Pagerduty Settings:

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

altertingnewactionpagerdutyhd

Editing an Action

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

 

 

  1. Adjust any settings as needed.
  2. Click Save.

Add a New Alert

    1. Enter a unique Alert Name.

 

BEST PRACTICES: Using a consistent naming convention for alerts will provide a unified organization of them, as well as enabling the ability to quickly locate specific alerts by using the Live Search feature. A naming convention composed of (Metric_Condition_Threshold) is recommended.

    1. Select an App.
    2. Select a Severity level:

a. Low

b. Medium

c. High

 

NOTE: Severity settings do not place a higher or lower priority on the processing of alerts. Severity settings provide visual indications of alerts and allow them to be sorted.

 

    1. Select an Action.
    2. Select a Metric:

a. Conversion Rate

b. Clicks Per Conversion

c. MTTI (seconds)

d. Revenue Per Device

e. Revenue

f. Install Volume

g. Event Volume

h. Click Volume

i. Impression Volume

 

NOTE: All metrics are measured in absolute values, except where specifically noted.

 

Custom Query Alert:

In addition to the default metrics listed above, users have the ability to leverage Kochava Query and define custom alertable metrics. Any saved Query with a uniquely specified column name can be leveraged as a first class alert through any of the aforementioned actions. Below is an example query with proper definition of the required metric name.

 

 

NOTE: Alerts may also be created based upon custom Queries by setting the desired value to be alerted on to “alert_metric.”

 

NOTE: For more information on creating custom Queries, refer to our support documentation.

 

    1. Select a Condition:

a. < (less than)

b. > (greater than)

c. = (equal to)

d. <= (less than or equal to)

e. >= (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:

a. 1 Hr

b. 24 Hrs

c. 48 Hrs

d. 60 Hrs

e. 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 (ie. if the Duration is set at 1 hour, every 3 minutes the altering tool will check the prior 1 hour) to see if the condition/threshold was met or exceed and will trigger the alert accordingly. If the alert is triggered the defined Action will be taken. Once an alert is triggered, Kochava will continue checking every 3 minutes, but will not continue sending alerts. An alert will not trigger another action until the alert duration is no longer meeting or exceeding the condition and threshold.

 

    1. Click Add a Filter. (optional)

 

NOTE: Filters can be used to further refine alerts, and multiple filters may be added.

 

NOTE: Depending on the selected metric, different filters will be available.

 

a. Select a Filter:

i. Campaign.

ii. Network.

iii. Tracker.

iv. Geo City (MTTI).

v. Geo Country (MTTI).

vi. Geo Zip (MTTI).

vii. Device Version (Install Volume).

viii. Event Name (Event Volume).

ix. Network ID (Impression Volume).

x. Tracker ID (Impression Volume).

b. Select whether to filter In or Not In the selected Campaign, Network or Tracker.

c. Select the Metric.

  1. Click Submit

 

alertingnewalertsettingswithfilterhd

A. Adding Filter(s) is optional but can provide further refinement of alerts.


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.

alertingnewalertsindicationhd

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:

a. Last Triggered

b. Severity

c. Name

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

Display Alerts by Action:

    1. Select Action:

a. All

b. Slack

c. Text Message

d. Pagerduty

NOTE: By default, all Action types are displayed.

Display Alerts by State:

    1. Select State:

a. Active

b. Disabled

NOTE: By default, Active alerts are displayed.
alertingorganizingalertshd

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 User Drop-Down menu>My Alerts.
  2. Locate the desired app alerts.
  3. Click on the App expand button.
  4. Click on the app Alerts expand button.

alertingcreatedalertsoverviewhd

A. The date the alert was triggered.
B. The alert settings.
C. Alert that has not been triggered.
D. Alerts indicated in yellow are set with a low Severity and have been triggered.
E. Alerts indicated in orange are set with a medium Severity and have been triggered.
F. Alerts indicated in red are set with a high Severity and have been triggered.
G. Alerts indicated in green are active and have not been triggered.


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.

alertingalerttoolsedithd

  1. Adjust any settings as needed.
  2. 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.

alertingalerttoolsdeactivatehd

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

 

Last Modified: Mar 17, 2017 at 3:38 pm