Support Home > Reference Information > Post-Install Event Examples

Post-Install Event Examples


Kochava standard post-install events have a finite list of event names and event keys. You can instrument your post-install events using one of the event names, and as many of the event keys (per event) as you would like.

 

BEST PRACTICES: Custom events can be sent to Kochava based upon the specific needs of each individual app. When instrumenting a custom or S2S event, be sure to set the values to the Raw Key names listed in the tables below when possible, while event names should directly match these standard event types.


Standard Event Types

Suggested post-install event types and their parameters are listed below. These parameters are optional and you can choose to add additional parameters to events as desired. Refer to the Standard Event Parameters section for a complete list of standard parameters.

Parameter Value Raw Key Type
User ID A unique user identifier. user_id string
Name Name of achievement. name string
Duration Elapsed time to complete the achievement, in seconds. duration number

NOTE: The Ad View event type is intended for True LTV use. A typical Ad View often consists only of Ad Type, Ad Network Name and Ad Placement, while other values should be populated if known.

Parameter Value Raw Key Type
Ad Type The type or identifier of the ad unit. ad_type string
Ad Network Name The ad network name. ad_network_name string
Ad Placement The location or placement of the ad unit. placement string
Ad Mediation Name The name of the mediation provider. ad_mediation_name string
Ad Campaign ID The campaign id. ad_campaign_id string
Ad Campaign Name The campaign name. ad_campaign_name string
Ad Size The size of the ad unit. ad_size string

Parameter Value Raw Key Type
User ID A unique customer identifier. user_id string
Name Name of item. name string
Content ID A unique item identifier. content_id string
Item Quantity The quantity added. quantity number
Referral Form Source or referral to attribute. referral_from string

Parameter Value Raw Key Type
User ID A unique customer identifier. user_id string
Name Name of item. name string
Content ID A unique item identifier. content_id string
Referral From Source or referral to attribute. referral_from string

Parameter Value Raw Key Type
User ID A unique customer identifier. user_id string
Name One or multiple names of the items in the cart. name string
Content ID One or multiple item identifiers of the items in the cart. content_id string
Checkout as Guest Any data related to guest checkout status. checkout_as_guest string
Currency Currency to be used. currency string

Parameter Value Raw Key Type
User ID A unique player identifier. user_id string
Name A name, number or description of the level completed. name string
Duration Elapsed time to complete the level, in seconds. duration number

Parameter Value Raw Key Type
User ID A unique customer identifier. user_id string
Name Name(s) of items purchased. name string
Content ID Identifier(s) of the items purchased. content_id string
Price The total revenue from this purchase. sum

price
number
Currency The currency used. currency string
Checkout as Guest Any data related to guest checkout status. checkout_as_guest string

Parameter Value Raw Key Type
Rating Value The rating value chosen. rating_value number
Maximum Rating The maximum possible rating value. max_rating_value number

Parameter Value Raw Key Type
User ID A unique user identifier. user_id string
User Name A unique user name. user_name string
Referral From Source or referral to attribute. referral_from string

Parameter Value Raw Key Type
URI The query string or uri. uri string
Results The results of the search. results string

Parameter Value Raw Key Type
User ID A unique player identifier. user_id string
Name Name or description of the tutorial completed. name string
Duration Elapsed time to complete the tutorial, in seconds. duration number

Parameter Value Raw Key Type
User ID A unique customer identifier. user_id string
Name Name of the item viewed. name string
Content ID A unique item identifier. content_id string
Referral From View source or referral to attribute. referral_from string


Standard Event Parameters

The following standard parameters may be included with any event. Custom parameters may also be used as needed, although it is highly recommended these standard parameters be used when possible. If implementing these parameters manually, please ensure that your values are sent under the Raw Key key names. You may mix and match parameters as desired for any given event, with a limit of 16 (sixteen) parameters at most.

 

Parameter Name Raw Key (S2S or Custom) Expected Type
Action action string
Background background boolean
Checkout as Guest checkout_as_guest string
Completed completed boolean
Content ID content_id string
Content Type content_type string
Currency currency string
Date now_date string
Description description string
Destination destination string
Duration duration number
End Date end_date string
Item Added From item_added_from string
Level level string
LTV Ad Campaign ID ad_campaign_id string
LTV Ad Campaign Name ad_campaign_name string
LTV Ad Group ID ad_group_id string
LTV Ad Group Name ad_group_name string
LTV Ad Mediation Name ad_mediation_name string
LTV Ad Network Name ad_network_name string
LTV Ad Placement placement string
LTV Ad Size ad_size string
LTV Ad Type ad_type string
Max Rating Vlaue max_rating_value number
Name name string
Order ID order_id string
Origin origin string
Price price

sum
number
Quantity quantity number
Rating Value rating_value number
Receipt ID receipt_id string
Referral From referral_from string
Registration registration_method string
Results results string
Score score string
Search Term search_term string
Spatial X spatial_x number
Spatial Y spatial_y number
Spatial Z spatial_z number
Start Date start_date string
Success success string
URI uri string
User ID user_id string
User Name user_name string
Validated validated string

References

Additional information and code examples regarding the creating and sending of post-install events may be found within the individual SDK integration and Server-to-Server integration pages.

 

SDK Documentation Class – KochavaEvent (iOS)

The class KochavaEvent provides a means of defining the parameters for a post-install event, providing standardized types and key names.

Class – Tracker.Event (Android)

The class Tracker.Event provides the details for passing post-install events.

Windows and Xbox One Integration

The methods and examples for sending post-install events in C++, C# and VB.

Unity Integration

The instructions for instrumenting post-install events.

SDK – KochavaTracker (Xamarin)

The class KochavaEvent provides a means of defining the parameters for a post-install event, providing standardized types and key names.

SDK – KochavaTracker (Adobe Air)

The methods and examples for sending post-install events.

SDK – KochavaTracker (PhoneGap/Cordova)

The methods and examples for sending post-install events.

Corona Labs

Sends a custom event or an event with pre-defined types and parameters to Kochava.

Web SDK

Instructions for attributing web conversion events.

Server-to-Server Integration Post-Install Event Setup

Instructions on sending a usage event from an application.

 
 

Last Modified: Dec 6, 2017 at 9:39 am