This webhook is triggered once when the store is loaded, informing the publisher which offers are made available to the player. It provides a snapshot of all offers that the player can see upon loading the store, but it does not track real-time activity like scrolling or browsing.
Webhook Endpoint
- URL: https://{publisher-server}/events
- Method: POST
Event Data Structure
The following data will be included in the report:
- event (string): The type of event related to the offer. Possible values are:
offers_shown
: Indicates an offer was shown to a player.offers_loaded
: Indicates that offers were loaded.
- timestamp (string): The time when the event occurred.
- playerId (string): The unique identifier of the player involved in the event.
- appVersion (string): The game store version.
- sessionMetadata (object): Relevant only to PIS users, the player session metadata object received from the Player Info Sync Webhook.
- offers (array): A list of offers related to the event. Each offer includes:
- publisherOfferId (string): Unique identifier for the offer.
- offerType (string): Type of the offer. Possible values are
Bundle
,SpecialOffer
, orPopUp
. - offerSubType (string, optional): Subtype of the offer. Will only be sent if offerType is
PopUp
. Possible values areDailyBonus
orPostPurchase
. - pricePoint (number, optional): The base price of the offer.
- offerIndex (number, optional): The index of the offer in the list.
Note: Currently, this field represents the day sequence of the daily bonus. - products (array, optional): Publisher products. If sent, it will include:
- publisherProductId (string): The publisher's product ID.
- amount (string): The quantity of the product. Must be between 0 and 24 digits long.
Example Payload
Here is an example of what the payload might look like:
{
"timestamp":1726130178951,
"event":"offers_loaded",
"playerId":"player ID",
"appVersion": "v1.1.80.4.87",
"offers":[
{
"publisherOfferId":"time1",
"offerType":"Bundle",
"pricePoint":20.99,
"products":[
{
"publisherProductId":"main_product_1",
"amount":"300000000"
},
{
"publisherProductId":"time_product_1",
"amount":"122"
}
]
}
]
}