Before you [deliver an in-app product](https://developer.android.com/guide/playpoints/deliver-items) 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](https://support.google.com/googleplay/android-developer/answer/1153481).
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.
| **Note:** Icons for coupon promotions are automatically generated by Google.

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: Between 512 px by 512 px (minimum) and 1080 px by 1080 px (maximum)
- Aspect ratio: 1:1
- Main artworks should be centered and sized between \~255 px by \~255 px (minimum) and \~537 px by \~537 px (maximum)
- File type: 32-bit PNG
- Resolution: 72 PPI
- Colorspace: sRGB
- Max file size: Up to 8 MB

#### Icon model

![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon-model.png)

1. Main Artwork: between \~255 by \~255 (minimum) to \~537 by \~537 (maximum)

   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: between 512 by 512 (minimum) and 1080 by 1080 (maximum)

   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](https://developer.android.com/static/images/guide/playpoints/1x-mini-card-512-1080.png)
- 2x mini card

  ![Example of a 2x mini card](https://developer.android.com/static/images/guide/playpoints/2x-mini-card-512-1080.png)
- Hexagon icon

  ![Example of a hexagon icon](https://developer.android.com/static/images/guide/playpoints/hexagon-icon-512-1080.png)

#### Icon examples and tips

Here are some best practices and examples for designing icons:

<br />

|-------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
| **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](https://developer.android.com/static/images/guide/playpoints/icon01.png) | ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon02.png) |

<br />

<br />

<br />

|-------------------------------------------------------------------------------------------------|
| You can crop the artwork in your icon, but not by more than 10%.                                |
| ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon04.png) |

<br />

<br />

<br />

|-------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
| **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](https://developer.android.com/static/images/guide/playpoints/icon05.png) | ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon06.png) |

<br />

<br />

<br />

|-------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
| **Use** a background that draws attention to your icon.                                         | **Don't** use a background that has a busy pattern.                                             |
| ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon07.png) | ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon08.png) |

<br />

<br />

<br />

|-------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
| **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](https://developer.android.com/static/images/guide/playpoints/icon09.png) | ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon10.png) |

<br />

<br />

<br />

|-------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
| **Don't** add text or numeric descriptions.                                                     | **Don't** add any type of promotional call-outs or promotional branding.                        |
| ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon11.png) | ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon12.png) |

<br />

<br />

<br />

|-------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
| **Don't** use low resolution image content.                                                     | **Don't** use an image that is too small.                                                       |
| ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon13.png) | ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon14.png) |

<br />

<br />

<br />

|-------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------|
| **Don't** use complex imagery.                                                                  | **Don't** use objects that are off-centered.                                                    |
| ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon15.png) | ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon16.png) |

<br />

<br />

<br />

|-------------------------------------------------------------------------------------------------|
| **Don't** use a hexagon shape in the card.                                                      |
| ![A screenshot of TBD](https://developer.android.com/static/images/guide/playpoints/icon17.png) |

<br />

<br />

## 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](https://developer.android.com/guide/playpoints/create-products#requirements) in
the previous section. For information about creating in-app products, see the
[in-app product](https://support.google.com/googleplay/android-developer/answer/1153481?ref_topic=3452890)
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](https://developer.android.com/guide/playpoints/create-products#icons)
- 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](https://developer.android.com/guide/playpoints/test).

## 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](https://support.google.com/googleplay/android-developer/answer/10366692#zippy=%2Ccreate-a-promotion). You'll then submit your promotion for review by Google prior to
publishing it for redemption by Play Points members.