Create/Edit Apps


The following document defines the process for creating an app within Kochava. Creating an app will need to be completed before integrating with Kochava.

NOTE: The following procedures are for all app platforms. Where differences exist between platforms, specific instructions have been provided.


Required Settings

  1. Log in to Kochava.
  2. Select the desired Account.
  3. Select App Configurations > Apps & Assets

Feature Note: To add this menu item to your Favorites Menu, select the “+” sign that appears when you hover over the menu. The Features Menu provides quick access to your most frequently visited areas of the Kochava UI.

  1. Click + Add an App.
  1. Select the OS (Operating System)
Options
  • Android
  • Android Instant App
  • Android TV
  • Chromecast
  • Daydream
  • Fire OS
  • HTC Vive
  • iOS
  • iOS App Clip
  • LGWebOS
  • Linux
  • macOS
  • Nintendo Switch
  • Nintendo WiiU
  • Oculus GO
  • Oculus Rift
  • Playstation
  • Roku
  • Samsung Gear VR
  • Tizen OS
  • tvOS
  • Vizio Smartcast OS
  • Web
  • WebGL
  • Windows
  • Windows Xbox
  1. Enter App Name & App Store ID
  2. Click Save.

BEST PRACTICES: Kochava recommends the following naming convention (App Name-Platform-AccountName) in order easily locate specific apps. The use of dashed, dots or hyphens is acceptable to use to separate the different parts of the app name.


After saving your new app, it will appear on your All Apps page. Selecting your app will take you to the App Setting page.

Available Settings:

General
  • App Name
  • Platform

The Platform cannot be edited after the app is created initialy

  • Is your app live?
    • Yes (App is live on an app store)
    • No (App is not live on an app store)

Switching the “Is your app live” toggle to yes will allow you to enter a default App Store URL, App Store ID, and SKU

  • App Store URL (Optional)

NOTE: The App Store URL is the location from which the app can be downloaded (Google Play, Google Market  or iTunes Store URL) if available. Once entered, the App Store URL will become the Default Destination URL for click tracking links.

BEST PRACTICES: For Android apps, it is more efficient to set your App Store URL to Google Market.  For more information, refer to the Google Linking to Your Product support documentation.

  • Utilize Google Install Referrer Begin Time: (Android only)

This setting is recommended for Android apps that utilize the Kochava SDK as it collects the exact time that a user clicked the download button from the Google Play Store vs. the time of first app launch. For more information, reach out to support@kochava.com

  • Child-Directed App?

IMPORTANT NOTE: App is directed to children. By indicating ‘Yes’, Kochava will remove all Identifiers from all third-party postbacks.

Configure App Integraiton
  • Select App Integraiton
    • SDK
    • Server to Server

The Kochava SDK is the most robust option for mobile apps. It’s a pre-built library that automatically handles iOS privacy (SKAN), fraud detection, and deep linking with minimal developer effort. Choose this for the most accurate, “out-of-the-box” attribution. Server-to-Server (S2S) A flexible API-based integration where your server sends data to Kochava. It requires manual developer configuration for all tracking and privacy signals but allows for total control without adding third-party code to your app.

Default Report Delivery Method
  • Default Delivery Method
    • Custom S3 Bucket
    • SFTP

These settings are optional, but allow you to save your Custom S3 Bucket or SFTP configuration details so that they are auto-populated when selecting those options in the Reporting tool. For more information, see Pulling Reports.

Consent

Intelligent Consent Management is Kochava’s tool to comply with the General Data Protection Regulation (GDPR) enacted by the European Union and the California Consumer Privacy Act (CCPA).

For more information on GDPR, refer to the EU General Data Protection Regulation overview documentation.

For more information on CCPA, refer to the IAB’s U.S. Privacy String specification.

GDPR:

  • Select level of Consent Management
    • Off – Set as default, there will be no request for consent from any user no matter the location.
    • Present in EU Only – A request for consent will be made for any user within the EU, if consent is not given data will not be processed.
    • Present Globally – A request for consent will be made for any user regardless of location, if consent is not given data will not be processed.
  • Reprompt Interval (For Opted Out Users) number of days.

NOTE: Users who have opted out of GDPR may be sent reprompts at a specific interval. The Reprompt Interval by default is set to 30 days.

  • Enter the Prompt Version.

NOTE: The Prompt Version enables the internal tracking of when and why prompts were sent to users. Descriptive prompts will enable the quick location of information. For more information on GDPR prompts, contact your Client Success Management team.

CCPA:

  • Select the Jurisdiction:
    • Off – Set as default, there will be no request for consent from any user no matter the location.
    • California – A request for consent will be made for any user within California, the US privacy consent string will reflect whether the user has opted out.
    • All States – A request for consent will be made for any user regardless of location within the United States, the US privacy consent string will reflect whether the user has opted out.
  • Enter the Package ID:

WARNING: Once the Package ID has been entered, it cannot be updated. Before saving, ensure that the information is correct.

NOTE: Google Play Package Name (e.g. com.company.app) or Apple Bundle (e.g. com.company.app).

  • Select the LSPA (Limited Service Provider Agreement):
    • No — Set as default, a flag will be added to the privacy string indicating that the user declined to opt out.
    • Yes — A flag will be added to the privacy string indicating that the user opted out.
  • Privacy Policy
    • Enter the Link Text. (What will be displayed to the user)
    • Enter the Link URL. (Where the user will be linked to)
  • Data Access
    • Enter the Link Text. (What will be displayed to the user)
    • Enter the Link URL. (Where the user will be linked to)
  • Data Deletion
    • Enter the Link Text. (What will be displayed to the user)
    • Enter the Link URL. (Where the user will be linked to)
Groups
  • Adjust Group Permissions

Add or remove groups that have access to a particular app. For more information, see Groups Overview.

Advanced
  • Currency Normalization.

NOTE: By default Currency Normalization is enabled. When this option is enabled, Kochava will dynamically convert all inbound purchase event revenue to the desired currency type based on current exchange rates.

  • Processing:
    • Transaction Time:
      • Device
      • Kochava

NOTE: By default the Transaction Time is set to Device which sends the time of install based on the device’s time (Time of first app launch). When Kochava is selected, the time of attribution will be logged at the time Kochava receives the install attribution data. On S2S installs if Kochava is selected the attribution time will always be logged at time of receipt.

  • Overwrite Origination IP. (optional)

NOTE: By default Overwrite Origination IP is disabled. When enabled, the IP provided with origination_ip will be overwritten with the IP sent with the request. This setting should remain disabled unless specifically instructed by your Client Success Managers.

  • Use Short Version. (optional)

NOTE: By default Use Short Version is disabled. When enabled the app version is reported as CF BundleShortVersionString instead of CF BundleVersion for iOS, and versionName instead of versionCode for Android.

  • Seasonal App. (optional)

NOTE: By default Seasonal App is disabled. This feature is supported on Android 3.7.2 and iOS 3.15.0 SDK versions and higher. When enabled the SDK will send a new install if the App GUID changes from a previous install, or if the app updates from a previously unsupported SDK version to a supported SDK version. If not enabled, the SDK will not send a new install if the App GUID is changed in code, which may result in orphaned post install events for devices which sent an install under the previous App GUID.

  • Truncate IPs. (optional)

NOTE: By default IP Truncation is disabled. If this feature is enabled we will still perform attribution using the IP address from the device. However, the IP address provided by the app traffic will not be written into app or account tables. The IP address from the ad signal will still be written.

  • SDK Device Identifier Gathering:

    This section provides access to determine whether specific types of device IDs are gathered or not. The following device IDs may be selected for collection:
  • MAC
  • ODIN
  • Open UDID
  • Facebook Attribution ID
  • Android ID
  • ADID
  • IMEI
  • ADID + Others
  • IDFV
  • BSSID
  • SSID
  • Affinity Group
  • Email Address (OFF by default)
  • Send Identifier Updates (OFF by default)

NOTE: Send Identifier Updates when enabled notifies Kochava when a device ID has been updated and provides the new device ID for the associated device. Before toggling this setting to ON, contact your Client Success Managers for further details.

NOTE: When ‘ADID + Others’ is toggled on ADID and all other identifiers will be gathered if ADID is present. If ‘ADID + Others’ is toggled off no other identifiers will be gathered if ADID is present(unless toggled on individually).

  • SDK AppTrackingTransparency (ATT):

    This section provides access to determine the settings associated with AppTrackingTransparency (ATT). The settings allows for the override of the ATT configuration provided in code to the SDK, which determines whether the Kochava SDK may trigger an ATT authorization prompt. Minimum Kochava SDK version with ATT framework support is required. In addition, a NSUserTrackingUsageDescription info.plist entry is required by Apple in order to prompt a user for ATT, and for this setting to take effect.

NOTE: This feature is only available for iOS apps and will not appear for other platforms.

  • One of the following settings may be selected:
    • Default to SDK settings
    • Disable for all users
    • Enable for 14.0 and greater OS versions only
Updated on April 14, 2026

Was this article helpful?