Create/Edit Apps

Feature Summary: The following document defines the process for creating an app within Free App Analytics. Creating an app will need to be completed before integrating with Free App Analytics.


NOTE: If you are using our pixel tracking option to track something other than an app on a landing page (such as registrations, searches, or offer accepts), you can create an “app” that is your landing page. The process is the same.

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 Free App Analytics.
  2. Select the desired Account.
  3. Select Apps & Assets > All Apps.


  5. Click Add an App.
  6. Enter the App Name.

    BEST PRACTICES: Free App Analytics 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.


  8. Select a Platform:
    • Android
    • BlackBerry 5-7
    • BlackBerry 10
    • iOS
    • Kindle
    • Roku
    • Web
    • Windows
  9. Select an Integration:
    • SDK: Adobe Air
    • SDK: Cordova (PhoneGap)
    • SDK: Cordova
    • SDK: Native iOS
    • SDK: ReactNative
    • SDK: Unity
    • SDK: Xamarin
    • Server to Server


  11. If no additional settings need to be modified, Click Save.
  12. If additional settings need to be modified, proceed to the Optional Settings section of this document.

Optional Settings

  1. Select Is Your App Live On An App Store?:
    • Yes (App is live on an app store)
    • No (App is not live on an app store)
  2. Enter the App Store URL. (optional)
  3. 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.


    NOTE: For apps targeting the Samsung marketplace, please use the following DeepLink convention for App Store URL. Example: samsungapps://ProductPage/ProdoctDetail

  4. Enter the App Store ID. (optional)
  5. Enter the app SKU. (optional)
  6. Select Utilize Google Install Referrer Begin Time: (Android only)
    • Yes
    • No

Enabling Push Messages

FAA Limited Option: This feature is not available within Free App Analytics. Contact us for more information on upgrading to a paid Kochava account.

In order to enable Push Messaging, an app must be created and the app GUID verified.

  1. Log in to Kochava.
  2. Select the desired Account.
  3. Select Account Options>All Apps.


  5. Locate the desired app.
  6. Click App Tools Menu>Edit App.

    iOS Push Settings:

    1. Select a Push Certificate Type:
      1. APNS
      2. APNS_Sandbox
    2. Click Upload Certificate File, and upload the certificate file.
    3. Enter the Certificate Password.


    Android Push Settings:

    1. Enter the GCM Key.

Custom S3 Bucket

Custom S3 Bucket provides the ability to send all reports run for this app to be sent to a customer S3 bucket.

  1. Enter the Bucket Name.
  2. Enter the Bucket Region.
  3. Enter the AWS Access Key.
  4. Enter the AWS Secret Key.


Intelligent Consent Management (ICM)

Intelligent Consent Management is Free App Analytics’ tool to comply with the General Data Protection Regulation (GDPR) enacted by the European Union. For more information on GDPR, refer to the EU General Data Protection Regulation overview documentation.

  1. 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.
  2. Enter the 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.

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


    A. Select when prompts will be sent to users.
    B. Click the provided link to view GDPR regulations.
    C. After an app has been created, click the link to view partners that postbacks are being sent to for the associated app.


  1. Adjust Group Permissions. (optional)
  2. NOTE: Turning a group OFF will not allow that specific group access to this app, while turning a group ON will allow that group access.


Advanced Settings


  1. Enable Traffic Processing. (optional)
  2. NOTE: By default Traffic Processing is disabled.

  3. Enable iBeacons. (optional)
  4. NOTE: By default iBeacons is disabled. For more information about iBeacons, contact your Client Success Managers.



  1. Select the Transaction Time:
    • Device
    • Kochava
  2. NOTE: By default the Transaction Time is set to Device which sends the time of install based on the device’s time. When Kochava is selected, if the device does not have internet access at the time of first launch, the time of attribution will be logged at the time Free App Analytics receives the install attribution data. On S2S installs if Kochava is selected the attribution time will always be logged at time of receipt.

  3. Enable Overwrite Origination IP. (optional)
  4. 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.

  5. Enable Use Short Version. (optional)
  6. 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.



  1. Enable Currency Normalization.
  2. NOTE: By default Currency Normalization is enabled. When this option is enabled, Free App Analytics will dynamically convert all inbound purchase events with a non-US currency to a US Dollar currency.



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
  • SSID
  • Affinity Group
  • Email Address (OFF by default)
  • Send Identifier Updates (OFF by default

NOTE: Send Identifier Updates when enabled notifies Free App Analytics 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).



Last Modified: Oct 1, 2019 at 10:00 am