Google Play Store

Prep for Google Play

You cannot use the debugged version of the app's APK to submit to Google Play. You have to create a released version of the app's APK.

  1. Use the keystore that was created earlier and then go back to PhoneGap Build
  2. This time select the key and create a released version of the app's APK to use on Google Play.

Register As A Google Play Developer

To distribute apps through the Google Play, you'll need a Google Play Developer Account.

  1. Go to developer.android.com.
  2. Click the Distribute link at the top of the page and then click the the Developer Console link.
    NOTE: If you're not logged in with a Google account ID, you'll need to create one and then come back to this page. On this page, you can read the Google play developer distribution agreement, by clicking the link. Read through it thoroughly and make sure that its terms are acceptable to you.

  3. Go back to the Developer Console page and select the agree to the terms checkbox.
  4. Click the Continue to payment button and then follow the prompts on this screen to complete your purchase through Google Wallet.
    NOTE: Once your payment has been accepted, you'll see a dialog box and you can continue the registration process. You will need to pay a one tine $25 registration fee to become a Google Play developer.


  5. Fill out the information in the Google wallet and then click the Accept and continue button.


  6. On the Continue your Account detail section, enter:
    1. a unique developer name (e.g., Rich Media Creative Services)
    2. email address (e.g., cornelius@richmediacs.com)
    3. website (e.g., http://www.richmediacs.com/)
    4. phone number (e.g., 512-731-1234)
    5. (Optional) Select I'd the like to receive occasional emails about development and opportunities checkbox.


  7. Click the Complete Registration button.
  8. If you see the message, "Your payment is still processing...", click the "x" button to dismiss it.

Publish App

If your registration is accepted, another screen will appear and you'll be ready to publish an app.

  1. Click the Publish an Android App on Google Play button.


  2. In the ADD NEW APP dialog box that appears, select the following:
    1. Default language (e.g., English (United State) - en-US)
    2. Title (e.g., Chopinisms)
    3. Click the Upload APK button
      NOTE: Later you will be coming back to this page to select the Prepare Store Listing button.


    4. On the Developer Console page that appears review the details about your uploaded app (e.g., version, upload date, status). Notice also in the left panel there is a list of steps that are needed to be completed.

Create Listing

Once you've created a new app record in the Developer Console, you don't have to do it all in one session, simply come back to this page.

APK

  1. To edit the record, click it and you'll go the Store Listing screen. If you haven't uploaded the APK yet, do it now.
  2. Click the APK link and click the button to Upload your APK to Production.
  3. Either browse for the APK or drag and drop it.
    - You don't need to be concerned about the long name of the APK. The user will never see it.
  4. Click the Open button to upload the APK.
    - Your app will be analyzed by the Google and will show:
    • how many devices will be supported based on the Android version and the different permissions that have been registered
    • a list of excluded devices.
  5. You can click that link and add different devices that you know your app won't run on.
    - If you review the menu on the left, you will see checkboxes appear as you complete each step.

Store Listing

Once you upload your app, you should see in the Developer Console page, a checkmark next APK and Content Rating. The next step is to specify the Store Listing.

  1. Click the Store Listing link and enter required values that are indicated by an asterisk:
    • Title (Up to 30 characters)
    • Short Description
    • Full Description
    • Provide Graphic assets (See Create Graphics for details on how to create images).
      - You have to provide at least two app screenshots but you can have up to eight. There are other promotional graphics that you have to add. The ones with an asterisks are required.
  2. Click the Plus icon and browse to the images you created in the section on Create Graphic or drag and drop the image into the gray area.


  3. CHECK POINT: You should see the screenshot in the placeholder area.
  4. Repeat the previous step for the other graphics that you need. The ones with an asterisks are required.
  5. Provide high-resolution icon and feature graphic.
    1. Click the Plus icon and browse to the images you created in the section on Create Graphic or drag and drop the image into the gray area.
    2. Repeat the previous step for the feature graphic NOTE: It can be a JPG or a 24 bit PNG image without alpha and is 1024x500 pixels that you can create manually.
    3. (Optional) You can also add a promo graphic and a TV banner. You can also create a promotional video that is hosted on Youtube by entering the URL.
    4. Under the CATEROGIZATION section, choose:
    1. Click again on the Store Listing link.
      WHY: To refresh the screen and then scroll down so that you can see your content ratings.
    2. Under CONTENT DETAILS section, enter:
      • Enter website, Email and phone. (Only the email is required). promo text if you want. This promo text will be displayed in some environments, but isn't required.
    3. Under PRIVACY POLICY section:
      • Either enter a privacy policy URL or select the "Not submitting a privacy policy at this time." checkbox.
    4. Scroll back to top of page and then click the Save Draft button.
    5. CHECK POINT: You should see that there is a check next to the Store Listing link in the left side panel.

Set Pricing and Distribution

After creating your store listing, the next step is to set the pricing and distribution options.

  1. Click on the Pricing and Distribution link in the left panel.
  2. Decide whether your app will be paid or free.
    - To create a paid app, you have to satisfy two conditions.
    1. Click on the set up a merchant account link and on the screen that appears fill out your business information with Google Wallet that lets you accept credit card payments. All payments for apps will be processed though Google Play and you'll receive payments from Google.
    2. mark the app as paid and select the price or select free.

  3. Indicate what countries you want to distribute your app in. If there aren't any restrictions, you can just check the option to Select All Countries checkbox even if you have not localized the app by adding language translations.
    - You'll see how many countries are currently available for distribution.
  4. The next three options are for different Android platforms:
    1. ANDROID WEAR: If you built-in feature for an Android watch, you want to select this option.
    2. ANDROID TV: If you built in features for an Android TV, you want to select this option.
    3. ANDROID AUTO: If you built in features for an Android watch, you want to select this option. However, you will have to accept the terms before uploading.
  5. The next two options are for Marketing:
    1. DESIGNED FOR FAMILIES: Tell kids and families audience about your app.
    2. GOOGLE PLAY FOR EDUCATION: Select this option if you think you app can be useful to schools.
  6. The next three options are for Consent (Marketing opt-out is optional and the others are required)
    1. Marketing opt-out: It is best to leave this UNSELECTED so that others can promote your app.
    2. Content guidelines: You need to read through the guidelines and check this option.
    3. US export laws: You need to check this option to acknowledge export laws.
  7. Select whether you want to include the application In the Google Play for Education channel. This is a specific marketing channel through the Google Play store. You don't have to do anything special in your app.
  8. Set consent options: Indicate whether you want your app promoted on Google Play.
  9. Check the option that indicates that the app meets Android content guidelines.
    - If you don't know what those guidelines are, read through them thoroughly. It's very important that you satisfy these guidelines, and failure to do so can result in the app being pulled from the store later.
  10. US export laws.
    - Once again, there is a link where you can learn about export compliance. What sorts of restrictions there might be that would prevent your app from being eligible for selling overseas. Read through that information thoroughly, then come back and check the option that indicates that your software app is subject to export laws.
  11. Scroll back to the top of the page and click the Save Draft button.
  12. CHECK POINT: You should see the check mark appear on the Pricing and Distribution link in the left side panel. You should also see that you have meet the minimum requirement to publish your app by seeing the phrase "READY TO PUBLISH."

(Optional) Add In-app Products

Once you've unloaded your APK, filled in your store listing, set your pricing and distribution options, your app is ready to publish. But there are some additional features you want to implement (e.g., App Billing).

    1. Add billing permission to your APK. Click on the Upload a new APK link.
    2. Set up a Google Wallet Merchant account. Click on the Set up a merchant account link.


      NOTE: There are two basic kinds of in-app products:
      1. Consumable might be extra features in a game (e.g., extra strength that the use can purchase repeatably).
      2. Non-consumable is a one-time purchase (featured app).

      NOTE: Learn more about in-app billing at DEVELOPER.ANDROID.COM/GOOGLE/PLAY/BILLING.   Remember, you will need to repackage the APK to the App Store.

(Optional) Services and APIs

The Google Play Store supports a variety of other services and APIs.

  1. Click on the Services and APIs link in the left side panel.
  2. Select link from the list of services below for more details:
    1. Google Cloud Messaging System allows you to send data from a server to your apps. You will need a sender ID.
    2. To prevent unauthorized use of your app, you can implement the license key that is automatically assigned to it. This is a Base64 encoded public key. You have to copy and paste it into your app manifest. To learn more, go to: developer.android.com/google/play/licensing.
    3. Google Play Game Services allows you to keep track of scores, achievements, and other game features across devices and implement multi-user playing.
    4. If you want to internationalize your app, you can use the APK Translation Service. This service assumes that you've used string resources for all of the strings that are presented to the user in your app. This is a paid service lets you have your strings SNL file translated into as many different languages as you need.
    5. App indexing for Google Search lets you deep link into your app. The idea is that when a user searches for some search string, your app can provide results. And when they click on a link, that's supported by the app, instead of just going to the app's homepage, you can deep link, taking the user to the particular bit of content that they're interested in. This is a service that you need to implement. It's not automatic. But once implemented, it can increase engagement with you user base.

Publish and Unpublish App

If you've completed the minimum amount of information, you are ready to publish your app.

  1. Click on Publish App link at the top of the screen.
    NOTE: It can take a couple of hours for the app to show up on the Google Play store and up to 24 hours before it is fully searchable.

  2. If you want to stop publishing your app, click the APK link in the left side panel.
  3. Click on Switch to Advanced Mode button and then click on the Deactivate button.


  4. NOTE: You'll see the message that says "This configuration cannot be published for the following reason(s)..."  You can then upload a new version of the APK to production. You might have to update the version to make that happen. And then you can continue the publication process. And again, once the app has been published, you should see an Unpublish button under the package ID.

Track App

Once your app has been in the Google Play Store for a while, you can go back to see how many people have installed, uninstalled, and used your app.

  1. Click on the Statistics link in the left side panel to see the default screen (Current installs by device).


  2. Click on drop-down list next to the word STATISTICS to see a host of options (See screenshot below):


    NOTE: You can change the time span by clicking on one of the Show options on the top right side of the screen (See large screenshot above).
    TIP: If you change the time span to ALL and then select Current installs by device, you can see the growth over time of your install base.

  3. In next set of charts, you can break out installations by the following (See example in screenshot below):
    1. Android Version
    2. Device
    3. Tablets (7" and 10+")
    4. Country
    5. Language
    6. App Version (if you have more than one version)
    7. Carrier


      NOTE: These charts show how fragmented the Android market is because of the multitude of versions and OS's. There may be a warning reminding you that if I want to support tablet usage, you should upload screenshots. There may be a large percentages under the Other category. These are devices with one or two installations.

    8. You can also break down usage by user but you need Google Analytics for Mobile Apps. To learn more click the links at the bottom of the page.

App Reports

There are more information that allow you to track the performance of your app:

  1. Finance (sales for app and in-app products)
    1. Overview
    2. Revenue
    3. Buyer
    4. Conversion (track spending/buyer and conversion rate)
  2. Rating and Review (user evaluations)
  3. Crashes and ANRS (ANR stands for APP NOT REPONDING)
  4. Optimization Tips (recommendations on how to improve your app distribution and performance.

You can download these reports as CSV files and then open them in a spreadsheet application (e.g., Microsoft Excel) for further analysis.