# Kochava Integration

#### Step 1: Integrate RZR as a Media Partner

1. Log in to your **Kochava** account.
2. Select the relevant **Account** and **App**.
   * If the app has not been created yet, please follow [this link](https://console.support.kochava.com/articles/create-manage-apps/195-create-edit-apps) to set it up.
3. Navigate to **Apps & Assets** → **Partner Configuration**.
4. Click **➕ Add a Configuration**.
5. Under **Media Partner**, select **RZR**.
6. Click **Save** to complete the integration.

<div align="left"><figure><img src="https://2844562966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbf2aFJzUmZBP8K9N7TjT%2Fuploads%2FiF5C7gscSGSxFHo6dBTN%2FKOCHAVA_integration%20page.png?alt=media&#x26;token=3968cb55-4f75-4c7d-a16c-91b226ba5df0" alt=""><figcaption></figcaption></figure></div>

#### Step 2: Configure Postbacks

1. **Install Event Postback:**\
   Navigate to **Install** → **Postback Tools** → click **Edit**\
   \&#xNAN;*(Refer to section A in the screenshot below)*
2. **Post-Install Active Events:**\
   Locate the desired event and click **Edit Postback**\
   \&#xNAN;*(Refer to section B in the screenshot below)*
3. **App Identifier:**\
   Enter the **Package Name** for Android or the **Bundle ID** for iOS.<br>

   <div align="left" data-full-width="true"><figure><img src="https://2844562966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbf2aFJzUmZBP8K9N7TjT%2Fuploads%2FtcoPWsiS4i9MY3qRbMYK%2Fkochava_package%20name.png?alt=media&#x26;token=e98bfbf4-bb6b-4024-8605-40150fed7019" alt=""><figcaption></figcaption></figure></div>
4. **Delivery Delay:**\
   Select **Realtime Delivery**
5. **Retry Attempts:**\
   Set to **3 attempts**
6. **Delivery Method:**\
   Choose **Select All**
7. **Save Settings:**\
   Click **Save** to finalize the postback configuration.

<div align="left"><figure><img src="https://2844562966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbf2aFJzUmZBP8K9N7TjT%2Fuploads%2FNfJ23pMNOFIgRuOR7g28%2Fkochava_postback%20configuration.gif?alt=media&#x26;token=cbb7245d-0bc9-4d7a-a2eb-1aeab0a9fa0f" alt=""><figcaption></figcaption></figure></div>

#### Step 3: Tracker Setup

1. Log in to your **Kochava** account.
2. Select the relevant **Account** and **App**.
3. Navigate to **Engagement** → **Campaign Manager**.

   <div align="left"><figure><img src="https://2844562966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbf2aFJzUmZBP8K9N7TjT%2Fuploads%2FchIld9FJU7rGJNFHjjm5%2Fkochava_tracker%20setup.gif?alt=media&#x26;token=ac3fcf01-533e-4458-8188-ff87b93c49a0" alt=""><figcaption></figcaption></figure></div>
4. Click **➕ Add** under **Campaigns** to create a new campaign.

   <div align="left"><figure><img src="https://2844562966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbf2aFJzUmZBP8K9N7TjT%2Fuploads%2F17FMegLNBAIjKQ2UEkXD%2Fkochava_tracker%20setup_2.gif?alt=media&#x26;token=0a448920-330b-41f5-8bc9-30c0cb96886e" alt=""><figcaption></figcaption></figure></div>

   <br>

   <div align="left"><figure><img src="https://2844562966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbf2aFJzUmZBP8K9N7TjT%2Fuploads%2FP49ZYlIhPBGNpCrgB7s3%2Fkochava_tracker%20setup_3.gif?alt=media&#x26;token=1a6beeef-807e-451d-a9c9-bb8c6a607530" alt=""><figcaption></figcaption></figure></div>
5. **Enter a Campaign Name**
6. **Enter the** [**Default Destination URL**](https://console.support.kochava.com/glossary/destination-url/)
7. Click **Add** to save the campaign

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdrRkJb18xUX5W_lplHPGfVyXDDaJXBjNxZMq8_Avy3Vha9Ljad_Zn2gQnT1JMGKLdg5HRNfyPbJtstsjTGAs5xVbtaHL52trAQsiF_HS9GuXyQDnRLE9DI8vy0pvoUCEkjxXKqyw?key=_rJ7M_yDnacs_57bGhduPQ" alt=""><figcaption></figcaption></figure>

**Creating a Segment**

1. Select the desired **Campaign**.
2. Click **➕ Add** under **Segment**.
3. Enter a **Segment Name**.
4. Enter a **Segment Description**.<br>

   <div align="left"><figure><img src="https://2844562966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbf2aFJzUmZBP8K9N7TjT%2Fuploads%2F92a6GeO1MXYVWUw9hGg5%2Fkochava_segment%20creation.gif?alt=media&#x26;token=5ca71290-5918-498a-9af7-ed68ac1ec206" alt=""><figcaption></figcaption></figure></div>
5. Click **Add** to save the segment

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeot8QsIl4hffMBs1mWpdH6EltcuNv8Bgjhm8zl_R3qOMqDIckAHM0uuHEX67BWXXkeOuPpg5YQLDkFlq7OG3ZLfB8BmjGDvbT1T2Z7TwTRrmaNhWenaJTiBue8UBI-jCChK0az?key=_rJ7M_yDnacs_57bGhduPQ" alt=""><figcaption></figcaption></figure>

**Creating a Tracker**

1. Select the desired **Segment**.

2. Click **Segment Tools** (⋮) → **➕ Add a Tracker**\
   \&#xNAN;*or* click **➕ Add** under **Tracker**.

3. Enter a **Tracker Name**.

4. **Select Tracker Type:**
   * For acquisition campaigns, choose **Acquisition** (default selection)
   * For re-engagement campaigns, choose **Reengagement**

5. **Select Media Partner:** Choose **RZR**<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeGd_MxCbE1AatVSPP45DYcjjZ5YtMfSX7eIutGK2T_o4P91DMLg8QBSPy9BI8vOOSJOg7uvUMCvDWgN4bEgFAm8GxhhvdxL4BqchEndYn3GAQ3N-rRG3gOQ4E6SLrwy9HMBFdOJA?key=_rJ7M_yDnacs_57bGhduPQ" alt=""><figcaption></figcaption></figure>

   <div align="left"><figure><img src="https://2844562966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbf2aFJzUmZBP8K9N7TjT%2Fuploads%2Ff7NINZPuuhTcOQGXrTe0%2Fkochava_tracker%20creation.gif?alt=media&#x26;token=1747c651-1c46-4e7e-9b2d-856c09910251" alt=""><figcaption></figcaption></figure></div>

   \ <mark style="color:red;">**Note:**</mark> Be sure to enable **Share with Publisher** as shown in the screenshot below **(marked as A)**.<br>

   <div align="left"><figure><img src="https://2844562966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbf2aFJzUmZBP8K9N7TjT%2Fuploads%2F7Nbss4noyOjhFBpNirpG%2Fkochava_tracker%20creation_2.gif?alt=media&#x26;token=77e78462-16f4-43e2-bb54-67b8494628ed" alt=""><figcaption></figcaption></figure></div>

6. **Select an Agency Partner** (optional)\
   Choose from the list if applicable.

7. **Select Destination URL Type:**
   * **Custom**
   * **Google Referrer** (Android only)
   * **Landing Page**

8. **Add a Custom Parameter** (optional)

9. Click **Add a Parameter**

10. **Enter the Custom Parameter**\
    Refer to the example shown in the screenshot below (marked as **A**) for correct formatting.

    <div align="left"><figure><img src="https://2844562966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbf2aFJzUmZBP8K9N7TjT%2Fuploads%2FRCji3MiALPTLgrmKZCIY%2Fkochava_customer%20parameter.gif?alt=media&#x26;token=47749ae4-f412-4328-9d6f-533b0f89a3fb" alt=""><figcaption></figcaption></figure></div>

11. **Add Additional Custom Parameters** (optional)\
    Repeat the previous step to include more parameters as needed.

12. **Save Settings**\
    Click **Save** to complete the tracker setup.

#### Step 4: Audiences

1. Log in to your **Kochava** account.
2. Select the relevant **Account**.
3. Navigate to **Audiences** → **Activations**.

<div align="left"><figure><img src="https://2844562966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fbf2aFJzUmZBP8K9N7TjT%2Fuploads%2FdP40XLqam7ng2aEqANjo%2Fkochava_audience%20activation.gif?alt=media&#x26;token=1574ebf3-151d-45c0-8601-6304c46d32f0" alt=""><figcaption></figcaption></figure></div>

**Activating Audiences**

1. Click **Activate**, or locate the desired Audience and click **Audience Tools** (⋮) → **Activate**
2. **Select the Audience** you wish to activate
3. Choose the appropriate **Timezone**
4. Set the **Frequency**:
   * **One-Time**
   * **Scheduled / Recurring**
5. Select a **Date Range**:
   * **Today**
   * **Yesterday**
   * **Week-to-Date**
   * **Last Week**
   * **Last 7 Days**
   * **Month-to-Date**
   * **Last Month**
   * **Last 30 Days**
   * **Custom Range**
6. Enter the **Recipient(s)** email address(es)
7. Select the **Activation Partner**
8. Enter the **Activation Partner Credentials**

> 💡 **Cost Integration Tip:**\
> For integrating cost data, refer to Kochava’s [Cost API documentation](https://console.support.kochava.com/articles/analytics-reports-api/36083-cost-api/)

This document outlines the complete setup details required for configuring your Kochava account. Please review each section carefully and follow the outlined steps to ensure accurate tracking, attribution, and reporting.

If you need any help with the configuration document, feel free to reach out to your **RZR Account Manager/Account co-ordinator** for assistance.
