Kochava
Step-by-step guide to send event data from RudderStack to Kochava.
Last updated
Was this helpful?
Step-by-step guide to send event data from RudderStack to Kochava.
Last updated
Was this helpful?
Kochava is a leading mobile measurement and app analytics platform that offers unique dynamic deep linking, audience segmenting and data accessibility features for your business.
RudderStack allows you to send relevant events to Kochava through a S2S (Server-to-Server) integration with the platform.
Find the open-source transformer code for this destination in our GitHub repo.
Before configuring your source and destination on the RudderStack app, please check whether the platform you are working on is supported by Kochava. Refer the table below:
Connection Mode
Web
Mobile
Server
Device mode
-
Supported
-
Cloud mode
-
Supported
-
To know more about the difference between Cloud mode and Device mode in RudderStack, read the RudderStack connection modes guide.
Once you have confirmed that the platform supports sending events to Kochava, perform the steps below:
From your RudderStack dashboard, add the source from which you want to send the event data.
Once you have added the source, select Kochava from the list of destinations.
In the Connection Settings page, please enter the relevant information in the fields shown in the following screen:
Destination Settings for Kochava
To successfully configure Kochava as a destination, you will need to configure the following settings:
App GUID: Kochava generates a unique ID for your application, called the App GUID. You can find this ID by going to your Kochava account and navigating to Apps & Assets - All Apps. You can then select your app to the view the App GUID.
NOTE: The following two settings are applicable for iOS Device Mode
only:
Enable AppTrackingTransparency (ATT): Enable this setting if you want to enable the AppTrackingTransparency
feature provided by the Kochava iOS SDK.
Make sure you include the key NSUserTrackingUsageDescription
in your info.plist
along with a string value explaining why you are requesting authorization to track.
Enable skAdNetwork: Enable this setting if you want to enable the skAdNetwork
feature provided by the Kochava iOS SDK.
Android iOS To add Kochava to your Android project and enable functionalities like push notifications, follow these steps :
Open your project level build.gradle
file, and add the following:
Also, add the following under the dependencies
section:
Initialize the RudderStack SDK in the Application
class' onCreate()
method as shown:
Follow these steps to add Kochava to your iOS project:
Go your Podfile
and add the Rudder-Kochava
extension as shown below:
After adding the dependency followed by pod install
, you can add the imports to your AppDelegate.m
file as shown:
Finally, change the initialization of your RudderClient
as shown:
The track
event captures information related to the actions performed by the user. For more information, refer to the the RudderStack API Specification documentation.
RudderStack transforms the following events to Kochava's Standard Events, as shown in the table below:
Product Added
Add to Cart
Product Added to Wishlist
Add to Wishlist
Checkout Started
Checkout Start
Order Completed
Purchase
Product Reviewed
Rating
Products Searched
Search
Rest of the events are sent to Kochava as custom events.
You can send an event with the name same as that of an Kochava's standard event to get perceived as Standard Event
in Kochava.
A sample track
event for sending event data to Kochava looks like the following code snippet:
According to the table above, this will change the Product Added
event to Add to Cart
event in Kochava dashboard and pass the properties along with this.
The screen
method allows you to record whenever a user sees the mobile screen, along with any associated optional properties. This call is similar to the page
call, but exclusive to your mobile device.
A sample screen
call looks like the following code snippet:
In the above snippet, RudderStack captures all the information related to the viewed screen, along with any additional info associated with that event. In Kochava, the above screen
call will be shown as - "screen view Sample Screen Name
" along with the properties.
Note that screen
call will be sent to Kochava as a custom event.
Follow these steps to configure push notifications for Kochava for the platform of your choice:
Android iOS
Register push notifications for your Android device in the Kochava dashboard.
Add the following dependency in your project level build.gradle
file inside the buildscript
:
Next, add the following dependencies and plugin to your app level build.gradle
file:
Place the google-services.json
downloaded from the Firebase console
into the root folder of your app
.
Passing the new Push Token received from FCM to the Kochava SDK. For more information, look into the **sample-kotlin** app.
Add Push Notification as a capability by navigating to **Target** - **Signing & Capabilities** of your app when opened in Xcode.
Enable **Background Modes/Remote notifications** by navigating to **Targets** - **Your App** - **Capabilities** - **Background Modes** and then check Remote notifications
Register the push notifications for the iOS devices in your Kochava dashboard.
Then, add the following code in your app just after initializing RudderStack's iOS SDK to register the push notifications.
Finally, add the below handlers to handle the tokens and push notifications accordingly:
To get your Kochava app GUID, please follow these steps:
Log in to Kochava. Then, go to your account and select the application for the specific campaign.
Under Apps & Assets, select All Apps
Click on the desired app for which you want the procure the App GUID.
You will be able to see the App GUID under the title of your application, within the details.
For more information, please check the Kochava support guide.
If you come across any issues while configuring Kochava with RudderStack, please feel free to contact us. You can also start a conversation in our Slack community; we will be happy to talk to you!