Detect and deliver in-app items

This topic describes how to detect and deliver in-app products in your game after players purchase them with Play Points in the Google Play app.

Once users redeem their Play Points for an in-app product in the Google Play app, the items should be delivered immediately in your game. The following displays how a user purchases items with Play Points.

1. Click Play Points.	1. Click the Use tab to view items.	2. Select an item and click Use Points to complete the purchase.	3. Receive the item.

In the example, the game is not running while the product is purchased. Users can also exchange Play Points for products when the game isn't installed on their device. Because of this, you must design your game to handle in-app item delivery from outside of the in-game store.

Before you get started

Before you detect and deliver an in-app product, you must create the product and Play Points promotions.

Delivery requirements

When you deliver in-app products in your game using a Play Points promotion, you must follow the requirements in this section.

Delivery timing

When a player exchanges Play Points for an in-app product, use Google Play Billing Library to deliver the item in a timely manner.

Delivery message

Once a user returns to your game after purchasing an in-app product outside of the game, you must display a confirmation that the product was successfully granted within the game. The message should come in the form of a pop-up dialog or an in-game message. Users should not have to take any additional steps to receive the item.

Here's the required messaging format:

• A clear message that the item has been received.

• Refer to the item name clearly and refer to “Play Points” to ensure users can distinguish it from other content they receive.

• The name of the item must also include the correct denomination of the item if there are similar items with multiple denominations.

• The pop-up dialog, message, or in-game notification should be visible to the user until the user clicks a confirmation such as, Continue or OK. There should not be a cancel button, as this message is only meant to notify users of the item they have received in-game. If there is no confirmation button, then the message should be visible to users for at least 3 seconds before disappearing to ensure users know they have received their item.

Here's an example message:

"Item received! You just got 100 Gems with Play Points. Continue."

Users should see an animation or some visual confirmation displaying the increase in their balance of in-game currency. If the item is a durable or consumable in-app item, users should be directed to where the item has been unlocked or is available within the game.

Detect items received outside of the game

If your game uses the Google Play's billing system, see Detect and process purchases to detect in-app products that are received outside of the game.

Display a delivery confirmation

When users redeem Play Points and receive an exchange item, they expect the game to show an in-game message, or use some kind of notification to let them know that the game correctly received and processed the item. See Notify the User to acknowledge the successful purchase.

Updates for specific game engines

Here are some considerations to make for specific game engines:

• If your game is built with Unity, we recommend that you verify whether the IAP implementation you're using already supports Play Points promotions.

• If your game is built with Cocos2d-x or Unreal Engine (C/C++), you will most likely need to write the JNI code that calls Java APIs from your C/C++ code.

Server-side best practices

This section contains server-side best practices to use for Play Points promotions:

• If you call Purchases.products: get on your server, verify whether you need to handle Play rewards exchange items and other in-app products separately based on the productId values.

• If you use Inappproducts: list on your server, verify whether you need to separate Play rewards exchange items from other in-app products by productId values.

• Review the following best practices to verify whether you need to make additional changes:

  • Reference:
    • Fight fraud and abuse
    • Best practices for unique identifiers
  • Implement server-side signature verification.
  • Ensure that the purchaseToken and orderId values are unique and have not been used before.

Troubleshooting

This section contains recommendations for scenarios that can result in customer inquiries.

Multiple user accounts

If a user has multiple Google Accounts on their device and they redeem Play Points on the wrong account, Google cannot transfer the items to the other accounts. Likewise, your app can't transfer the item by calling the getPurchases() method. In this scenario, consider manually providing the in-app items to the user using your customer support operations.

Delayed or missing items

If players experience delayed or missing rewards items, see the troubleshooting guide for in-app purchases in the Google Play help documentation.