Support Home > SDK Integration > SDK – KochavaTracker

SDK – KochavaTracker

SDK

KochavaTracker (Adobe AIR)


The KochavaTracker Adobe AIR SDK allows advertisers to integrate a single SDK to leverage the hundreds of ad network and publisher partners integrated with Kochava. This limits the number of 3rd party SDKs required to run a successful UA strategy and greatly reduces complexity during update cycles.


Preface

You can also find documentation for other SDKs, plugins, and Server-to-Server Integrations here.

 

Minimum Requirements:

  • Adobe AIR – 18.0 or higher, supporting iOS 64bit
  • iOS Target: Xcode 8 or later
  • iOS Target: iOS 8.0 or later
  • Android Target: Android API Level 9 (Version 2.3) or later

 

If you are still using an earlier version of Xcode, or want to support an earlier operating system version, or want to support an earlier Android API Level, you may consider using an earlier version of the Adobe AIR SDK.
See KochavaTracker Adobe AIR SDK Versions.

 

Before Beginning:

  • The Kochava Extension uses Adobe AIR 18.0 or higher for iOS 64bit support. Download the latest version of Adobe AIR.
  • Review AS3 documentation.
  • Review ‘example/KochavaExample.as’ for a sample application.
  • Retrieve the Kochava App GUID(s).

 

NOTE: KochavaExample.as is a Document Class. If you’re a Flash Professional user and don’t know how to use a document class, refer to Troubleshooting and Frequently Asked Questions at the end of this guide.


SDK Integration

  1. Select your SDK variant
  2. There are several different variants of the KochavaTracker Adobe AIR SDK, depending on host that it is being embedded within and its capabilities. For more information on current variants see KochavaTracker Adobe AIR SDK Version 2.0.1.

  3. Add the SDK native extension into your project.
  4.  

    For Flash Professional CS6 or Higher:

    1. Create a new Android or iOS project.
    2. Choose File>Publish Settings.
    3. Select the wrench icon next to Script for ActionScript Settings.
    4. Select the Library Path tab.
    5. Click Browse for Native Extension (ANE) File and select the com.kochava.extensions.Kochava.ane file.
    6. Click OK.
    7. Select the wrench icon next to Target for Player Settings.
    8. Select the Permissions tab, and enable:
      • ACCESS_NETWORK_STATE
      • ACCESS_WIFI_STATE
    9. Check the Manually manage permissions and manifest additions for this app box.
    10. Click OK.

     

    For Flash Builder 4.6 or Higher:

    1. Go to Project Properties.
    2. Select Native Extensions under Actionscript Build Path.
    3. Choose Add ANE… and navigate to the com.kochava.extensions.Kochava.ane file.
    4. Select Actionscript Build Packaging > Google Android (or iOS if building for that target).
    5. Select the Native Extensions tab, and click the Package checkbox next to the extension.

Update Application Descriptor

For Kochava to work, changes are required to the application XML file for the app. Modify the XML file created by your IDE with the following changes:

 

NOTE: If you’re a Flash Professional user, make sure to follow the steps detailed in Include the Library, otherwise Flash might undo your changes as you make them.

 

  1. Set your AIR SDK to 16.0 in the app descriptor file.
  2.  

  3. Include a link to the extension in the descriptor.
  4.  

  5. Update your Android Manifest Additions in the XML element.

FAQs


Using the SDK

Once an SDK has been integrated into your project, it’s time to make use of the included classes and resources.

 

Symbols:

public class KochavaTracker

The KochavaTracker class provides an interface between a host application and Kochava’s Attribution and Analytics Servers. A tracker manages the exchange of data between these two entities, along with the associated tasks and network transactions.

private class KochavaEvent

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

 
 

Last Modified: May 18, 2017 at 8:13 am