What information should we display for offers?

Partners using our API integration occasionally ask which offer details are absolutely essential to your users' experience and success.

Best practices

To help users complete offers successfully, display all offer details from the Games and Deals APIs. We recommend showing the full offer description and goals up front so users clearly understand the requirements before starting the offer.

Here's a list of key information—beyond the obvious title, reward, and link to the offer—that you should highlight:

Offer descriptions
Goals and milestones
Time limits
Operating system requirements
Reward pending periods (if applicable)

Key response attributes

Response attribute	Description	Example
Offer
`description`	A full-length description of the offer.	"👑Welcome to Domino Dreams! Play this fun, free to play domino royal game created for Solitaire and Domino lovers and discover a new world in the most relaxing board game in the world! 👑🏰Solve challenging domino puzzles and help King Richard on his royal tour adventure! Just play and relax while you enjoy the game's art design.🏰Complete Level 250 in 10 days after installing to earn $10, and Level 500 in 15 days after installing to earn an additional $40 -- $50 in total. In-app purchases can enable you to complete the Levels faster! Note: Chargebacks, deleting the app, and/or skipping levels may lead to a reversal of a pending reward."
`details`	Guidelines for completing the game offer, including OS requirements and pending periods.	"<p>Users must have newer phones (less than 3 years on the market) and the latest Operating Systems (please update your OS to the latest ASAP, before installing any games). Otherwise, you may not qualify for any of these promotions, and your transactions may not track at all, or fully</p><p>All rewards applied to user accounts will have a Pending Period typically ranging from 1 day to 31 days (average of 14 days) to validate transactions. Pending Rewards may not be redeemed until the transaction(s) have been validated and the reward(s) actualized. </p><p>Chargebacks, deleting the app, and/or skipping levels will lead to a reversal of the reward or pending reward.</p><p>Any Pending Reward may also be removed if the Player stops playing or uninstalls the game during the Pending Period.</p><ul><li>New Players Only!</li></ul>"
`points`	Key details about the offer, which can be formatted as bullet points in the UI. Each point is preceded by `"title"`.	`"points": [{` `"title": "Players must win FIRST place to be eligible for rewards."` `},{` `"title": "Compete in multiplayer tournaments for cash prizes!"` `},{` `"title": "Enjoy competing against family and friends."` `},{` `"title": "Experience fair competition matched to your skill level."` `},{` `"title": "Reminder: You can earn on future challenges even if you miss an earlier goal."` `}]`
Goals
`goal_id`	The goal ID.	`"L7HmeCOmxpID_204"`
`amount`	Within the `goal` array, the amount the user will earn in points, coins, or dollars after completing the goal. If you’ve configured your currency, the value will be in that currency; otherwise, it will be in US dollars.	`8000`
`text`	A short description of the goal.	`"Level 32 Completion"`
`days_left`	The number of days the user has to complete the goal from the installation date. This is a static value. The value is `null` for the `“install”` goal.	`11`

For more best practices, see Best practices for API integration, or refer to the documentation for the specific APIs you are using.

Games International API