Registered profile · Protocol v1.0
Game Offer Profile
Describe a game with the cumulative download or install count reported by its source. Source-reported cumulative downloads or installs for a game.
- Selector
game- Required data
downloads- Value
Positive integer- Profile status
- protocol-v1.0.0-r36
Required Offer context
Complete the common Offer shell first
The profile adds domain facts; it does not replace the required Partner Offer fields.
- Category
hobbies_games_leisure.toys_games.games.online_games_puzzles- Commercial
- No additional price or quote requirement from the game profile.
- Identity and action
source_offer_id,version: "3.0",entity,action, andgoals. Game adds no offer_type or consumer_action restriction.
Presentation
Preserve what the source actually reports
Send downloads as a positive integer. For a published threshold such as 1M+, send 1000000. Do not round up, estimate, combine counts from different sources, or duplicate the count in offer_info.properties. Downloads describe source content; they do not imply AON endorsement or ranking. If no valid count is known, omit the entire details object.
Field reference
Paths below are complete Offer paths. Requirement labels are computed in the context of the selected profile.
Profile envelope
Closed supply-profile envelope. profile selects exactly one registered closed data shape.
| Field path | Type | Requirement | Meaning and constraints |
|---|---|---|---|
offer_info.details.profile | string | required | Registered supply Offer profile identifier in the stable v1.0 registry.Const: "game" |
offer_info.details.data | object | required | Closed public facts for a game Offer. It is descriptive content supplied with the Offer, not an AON endorsement or ranking signal.Closed object: unknown properties are not allowed |
Downloads
Source-reported cumulative download or install count for the game. When the source publishes a range or threshold such as 1M+, use its lower bound (1000000); never round up or estimate.
| Field path | Type | Requirement | Meaning and constraints |
|---|---|---|---|
offer_info.details.data.downloads | integer | required | Source-reported cumulative download or install count for the game. When the source publishes a range or threshold such as 1M+, use its lower bound (1000000); never round up or estimate.Minimum: 1 |
Canonical Partner Offer example
This canonical example converts a source-reported 1M+ threshold to its lower bound, 1000000. It intentionally omits commercial price facts.
{
"source_offer_id": "game-example-puzzle",
"version": "3.0",
"offer_info": {
"title": "Example Puzzle Game",
"offer_type": "digital_goods",
"category": {
"id": "hobbies_games_leisure.toys_games.games.online_games_puzzles"
},
"description": "A casual puzzle game with a source-reported download threshold of 1M+.",
"details": {
"profile": "game",
"data": {
"downloads": 1000000
}
}
},
"entity": {
"id": "example-game-studio",
"name": "Example Game Studio"
},
"action": {
"type": "open_url",
"consumer_action": "download",
"payload": {
"url": "https://example.com/games/puzzle"
}
},
"goals": [
{
"event": "install",
"pricing": {
"model": "cpa",
"amount": "1.5",
"currency": "USD"
}
}
]
}Semantic validation
- Use the Games category or a descendant: game carries descriptive facts for an Offer whose category.id is hobbies_games_leisure.toys_games.games or one of its descendants.
- Supply a positive integer download count: game downloads must be a positive safe integer
- Supply details do not imply live retrieval: These facts may appear on Public Offer, Partner Offer, Provider success and ordinary Query/MCP results, including non-real-time requests. Their presence does not imply live retrieval.