Create in-app products and promotions

Before you deliver an in-app product to Play Point members, you must create the product and set up a Play Points promotion.

In-app product requirements

When you create in-app products for Play Points promotions, you must follow the in-app product requirements in this section. These requirements ensure that you effectively promote your in-app products with a clear and consistent experience when players return to your game.

Name

Use a product name that is easily understood by users and Play Points members. If the same, or a similar item is already available in your game, they should have consistent names. The name should describe the item and the amount of the item, such as "100 Gems." Use a clear name to distinguish between similar items that have different functions in a game such as, paid items and free items.

Consider using different names for in-app products when they appear in the Play Console and when they appear in your game after being purchased with Play Points.

When you set up the product in the Play Console, ensure that the name does not mention Google, Play, or Play Points. Similarly, don't reference the name of your app. Your in-app product promotion will be featured under your app heading in the Play Points program automatically.

In your app, we recommend that the name reference Google Play Points so users can easily understand where the item originated.

Here's an example of in-app product naming for 50 gems:

  1. For Play Console and Play Points: “50 gems”
  2. In your app: “50 gems - from Play Points”

We recommend in-game products display names that are 20 characters or less in length, in order to display them on a single line in the Google Play app. However, display names can be up to 55 characters long if needed. To avoid using additional characters, don't include "Google Play Points" or the name of the app in the display name. Avoid using unnecessary characters including: "[]", "()", "*", "<>", "{}", "_".

Description

If you are displaying an item that is not well known in your game, provide a product description to clarify the benefits and value of the item. An example of this type of item is an exclusive item only available to members of Google Play Points. The description must be 200 single byte characters or less.

Icons

Each in-game item requires a unique icon that best represents that content. If the item is also available in your game, the icon should use the same visual used in the game so there is consistency for users. If you are submitting multiple items for an individual game, the artwork should be distinct to help users recognize that they are different items.

Uploading icons

Icons are uploaded using Play Console as part of in-app product creation. A preview of your icon is generated after the upload (with a border automatically applied) prior to submission of your Play Points promotion.

Promotional artwork is reviewed during pre-publishing checks by Google. If your asset does not meet the artwork criteria, your promotion will be rejected.

After your artwork is approved, Google generates 1x mini card, 2x mini card, and a haxagon version of your icon.

Here are the final image requirements:

  • Image size: 512 px by 512 px (icons must be centered and ~255 px by ~255 px)
  • File type: 32-bit PNG
  • Resolution: 72 PPI
  • Colorspace: sRGB
  • Max file size: Up to 1 MB

Icon model

A screenshot of TBD

  1. Main Artwork: 255 X 255 (roughly)

    The safe zone is where the main artwork in your icon should be placed. Stay within the recommended bounds to prevent any unnecessary cropping of your artwork.

  2. Background: 512 x 512

    Use a simple pattern or solid color for the background so the icon is easy to read.

These are examples of the Google generated versions:

  • 1x mini card

    Example of a 1x mini card

  • 2x mini card

    Example of a 2x mini card

  • Hexagon icon

    Example of a hexagon icon

Icon examples and tips

Here are some best practices and examples for designing icons:

Use the recommended safe zone (~255 x ~255) for the size of the artwork. Don't use artwork that is cropped by more than 10%.
A screenshot of TBD A screenshot of TBD

You can crop the artwork in your icon, but not by more than 10%.
A screenshot of TBD

Use a background that represents your brand or complements the artwork. Don't use a background that is the same tone and color as your artwork.
A screenshot of TBD A screenshot of TBD

Use a background that draws attention to your icon. Don't use a background that has a busy pattern.
A screenshot of TBD A screenshot of TBD

Use a background that contrasts with your icon. Don't use a white background or the borders of the card won't be visible.
A screenshot of TBD A screenshot of TBD

Don't add text or numeric descriptions. Don't add any type of promotional call-outs or promotional branding.
A screenshot of TBD A screenshot of TBD

Don't use low resolution image content. Don't use an image that is too small.
A screenshot of TBD A screenshot of TBD

Don't use complex imagery. Don't use objects that are off-centered.
A screenshot of TBD A screenshot of TBD

Don't use a hexagon shape in the card.
A screenshot of TBD

Create an in-app product

To create an in-app product for Play Points, use the Play Console to create the product while following the requirements in the previous section. For information about creating in-app products, see the in-app product guide in the Play Console help documentation.

Here's an example in-app product for a Play Points promotion:

  • Product Type: In-app product
  • Product ID: com.example.your_title.1500gems.rew
    • We recommend that you append "rew" (reward) to your Product IDs. This can help both you and Google more easily identify your Play Points promotions.
  • Name: 1500 Gems
  • Description: Detail about the in-app product
  • Icon: Upload an asset; see icon requirements
  • Default price: $10.00 USD (input a price or select from a pricing template)
  • Play Points exclusive: Check this box to prevent cash transactions for this in-app product
  • Status: Active (activate your in-app product post-setup)

Once the item is created, ensure that your game APK and your game server can access it. For more information, see Self-test using promo codes from Play Console.

Set up a Play Points promotion

After creating and activating your in-app product, use the Play Console to offer it as a Play Points promotion. You’ll then submit your promotion for review by Google prior to publishing it for redemption by Play Points members.