These instructions assume familiarity with basic Android development and Eclipse configuration.

  1. Project Set Up
    • Download the latest version of the Adcenix SDK for Android.
    • Unpack the Adcenix download package.
    • Import the AdcenixSDK project into your IDE.

      In Eclipse do the following and then navigate to the location of the AdcenixSDK project on your machine: File -> Import -> Existing Projects Into Workspace

    • AdcenixSDK must be added to your game project as a 'Library Project'.
      1. Right-click on your game project in Eclipse.
      2. Select 'Properties'.
      3. Select 'Android'
      4. Select the 'Add' button in the 'Library' section.
      5. Locate the AdcenixSDK and click it.
  2. Updating the Android Manifest

      Following changes must be made to your applicatons manifest.xml file

    • Min SDK Version

      Adcenix SDK required a minimum Android version 4 to work properly.

          <uses-sdk android:minSdkVersion="4" />
    • Permissions

      Following permissions are required by Adcenix SDK:

              <uses-permission android:name="android.permission.INTERNET" />
              <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    • Activities

      Following activity definitions must be added between the application tag.

              <activity android:name="com.adcenix.MoreAppsListActivity" />
              <activity android:name="com.adcenix.MoreAppsWebActivity" />
        
              <receiver
                 android:name="com.adcenix.ReferrerReceiver"
                   android:exported="true" >
                  <intent-filter>
                       <action android:name="com.android.vending.INSTALL_REFERRER" />
                  </intent-filter>
               </receiver>
    • SDK Key

      Add the SDK key obtained from your application profile on server to manifest as ADCENIX_KEY meta-data tag.

              <meta-data
                  android:name="ADCENIX_KEY"
                  android:value="054e5428-ff03-4540-8933-18528c0a20b9" />
  3. SDK Usage

    Use the following code snippet to call Adcenix SDK methods

    • Show your apps as native android listview
              Intent i = new Intent(AppPromoterDemoActivity.this,
                              MoreAppsListActivity.class);
              startActivity(i);
      SCREENSHOT
    • Show your apps in webview
              Intent i = new Intent(AppPromoterDemoActivity.this,
                              MoreAppsWebActivity.class);
              startActivity(i);
      SCREENSHOT
    • Integrate Featured-View in your own layouts

      Add the following XML block to your layout definition

              <com.adcenix.FeatureView
                  android:id="@+id/featureview"
                  android:layout_width="fill_parent"
                  android:layout_height="wrap_content" />
      SCREENSHOT

Check out the AdcenixDemo example in sdk folder for a complete sample.

Additional Questions?

If you are having trouble or have any additional questions about integrating with our SDK, feel free to email us at EMAILADDRESS and we’ll walk you through the process.