This webhook is triggered in real time based on player activity, such as scrolling or interacting with the store. It informs the publisher which specific offers the player is currently viewing. As the player continues to browse the store and new offers become visible, this event updates accordingly, ensuring the publisher is aware of what the player is seeing at any given moment.
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.
- 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_shown",
"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"
}
]
}
]
}