Vielen Dank für deinen Besuch. Diese Seite ist nur in Englisch verfügbar.

App Start Conversion Tracking Guide

This is a guide for enabling downloaded app start conversion metrics for advertising campaigns using the Amazon Mobile Ads API. The Advertise Your App program reports these metrics, giving you a more complete picture of Google Play conversions related to your ads along with Amazon Appstore and web site conversions.

Note: Showing ads is not required for tracking app start conversions. If you're interested in monetizing with Amazon ads, you should refer to the ads-specific Quick Start Guide for a full integration of the Amazon Mobile Ads API.

To learn about advertising your app with more support beyond the self-service tools, please contact the Display Advertising team.

Before You Use the Amazon Mobile Ads API

The Amazon Mobile Ads API for Android requires Android 2.3 (Gingerbread) or later and assumes you have Eclipse installed with Android Development Tools (ADT) Plugin. Familiarity with Android development is also required.

Account Registration - Self Service

Sign in to your Amazon Appstore account, which you can access through the Amazon Appstore home page. If you do not already have one, you can create an account.

Submit Your Payment Information and Tax Information

Submit your payment information through the Payment Information Page and your tax information through the Tax Identity Interview Page (skip this step if you have already submitted this information through the Amazon Apps & Games Developer Portal). This information is required to receive ads.

Obtain an Application Key

Once signed in, click on the My Apps tab and select an existing app or click on the Add a New App button. When creating a new app, just fill in the App title and Category fields and click the Save button. Click the Mobile Ads tab and answer the Child Directed question, and click Submit. It's important to note that apps that are directed at children under 13 are not eligible to participate in the Amazon Mobile Ad Network. See Personal Information and COPPA Policy to learn more.

If you answer that your app is not directed at children under 13, the next screen will show the unique Application Key value, which is a 32-character globally unique alphanumeric string that is used to identify your app. The same Application Key can be used across platforms, but each distinct app must have a unique Application Key. For example, the IMDb app uses the same Application Key on Android phone and Fire tablets, but the IMDb Trivia app has a different Application Key.

The Application Key is used in the setAppKey call mentioned in Step 3 of this guide, and your developer reports will aggregate data by Application Key. Proper use of your Application Key permits accurate tracking, reporting, and accrual of advertising fees.

Add the Google Play Services SDK to Your App

Important: This step is required to attribute conversions from Google Play (or other online sources) to an ad impression or click on the Amazon Mobile Ad Network. In addition, since August 1, 2014, ad-serving apps distributed through Google Play must comply with the Google Play Services Advertising Identifier conditions outlined on Google’s policy page. To ensure adherence to these new conditions, developers intending to distribute apps integrated with the Amazon Mobile Ads API on Google Play must follow these instructions:

  • Integrate the Google Play Services SDK into the app by following the Google Play Services SDK Setup Instructions.
  • Ensure that the version of the Amazon Mobile Ads Android API that's being used is 5.4.46 or higher. Older versions do not support the required identification changes.

Enabling Conversion Tracking in Your App

This section of the guide steps you through adding ads to an existing Android app Eclipse project:

Note: If you choose to incorporate the Amazon Mobile Ads API into your project via the Amazon Mobile App SDK Eclipse Plugin, Step 1 and Step 2 will be completed automatically. You can learn more about the Eclipse plugin by visiting the Eclipse Plugin Page.

1. Incorporate the API into Your Project

Add the Amazon Mobile Ads API Jar to Your Eclipse Project

You need to add the amazon-ads-x.y.z.jar to your project build path. In Eclipse:

  1. Click on project Properties, which opens the Properties dialog
  2. Select "Java Build Path"
  3. Select Libraries on the top
  4. Click "Add External JARs…" to open the JAR Selection dialog
  5. Select the amazon-ads-x.y.z.jar and click "Open"

Fig. 1: Screenshot depicting the addition of Amazon Mobile Ads API jar to a project in the Eclipse environment

2. Update the Android Manifest

Tracking app first start conversions requires the INTERNET permission. See the permission declaration below:

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

Example Manifest

For an illustration of how the declaration is implemented into an AndroidManifest.xml file, please refer to the example below:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.company"
    android:versionCode="1"
    android:versionName="1.0" >
    <uses-sdk android:minSdkVersion="4" android:targetSdkVersion="17" />
    <application
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name" >
        <activity
            android:name=".AdTestAppActivity"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
    <uses-permission android:name="android.permission.INTERNET" />
</manifest>

Note: If you plan to display ads then you'll need to add additional declarations. Please see the ads-specific Quick Start Guide for instructions.

3. Set Your Application Key and Register Your App

You must set your Application Key in order to receive ads. This allows Amazon to track your impressions and clicks, and associate them with your account. You should have your app call the AdRegistration.setAppKey() method on every app start using the Application Key from the Amazon Mobile App Distribution. You could add this call to your activity's onCreate method, or some other app initialization code. Here's an example of setAppKey in onCreate:

public void onCreate(Bundle savedInstanceState)
{
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

    AdRegistration.setAppKey("0123456789ABCDEF0123456789ABCDEF"); // Replace with your app's Application Key
    AdRegistration.registerApp(getApplicationContext());
}

4. Verify Ad Registration

The AdRegistration.registerApp method creates an AsyncTask to contact the Amazon Ad Network. To verify that the AdRegistration.registerApp call succeeded, you should review the logcat output. If the call fails, that will be reported as an error. To view additional debug messages in your log you should call the AdRegistration.enableLogging method before calling AdRegistration.registerApp. For example:

AdRegistration.enableLogging(true); // Remove this line once testing is complete
AdRegistration.setAppKey("0123456789ABCDEF0123456789ABCDEF"); // Replace with your app's Application Key
AdRegistration.registerApp(getApplicationContext());

Logcat Message Table:

Priority Message Description
D Sending: http://... Register network request, please provide to Amazon if your register calls are failing.
E SIS registration call failed: Status code: ... The network call failed to connect the Amazon Ad Network, e.g. network error
E SIS failed registering device -- code: ... The call was sent, but an error was returned from the server.
E JSON error parsing return from SIS: ... The call was sent, but we were unable to parse the response.
D Register Device returned adid: ... Success!

Should My App Continue to Call Register?

Yes, we recommend that you call AdRegistration.registerApp on every app start. The AdRegistration.registerApp call checks to see if your app has already been registered. If so then it checks the timestamp. If the timestamp is recent (less than 24 hours old), then AdRegistration.registerApp does nothing. If the timestamp is older than 24 hours, the AdRegistration.registerApp method makes a couple of network calls to refresh the Amazon Mobile Ad Network information. These calls help Amazon to optimize future download advertising campaigns.

Note: In the future, if you add the Amazon ads to your app, you should remove the AdRegistration.registerApp call since it is automatically made when your app calls the loadAd method.