Types of Postback Events #

Monetag’s unified postback system sends server-side notifications for key ad events in your Telegram Mini App. These events are triggered only after they are confirmed by the Monetag system and are used for accurate monetization, reward logic, and analytics.

Postbacks are available exclusively for reward-based formats: Rewarded Interstitial and Rewarded Popup. In-App Interstitial is excluded from the postback system.

Impression #

What it means:
The ad started rendering in the user’s Telegram Mini App.
This confirms that the user has seen the ad on screen.

Important:
Impression is triggered immediately at the start of the creative display — not after the ad completes or is clicked.

Available in:

✅ Rewarded Interstitial
✅ Rewarded Popup
❌ In-App Interstitial (not supported in postback system)

Use cases:

CPM-based monetization
Viewability tracking
Triggering reward logic on backend

Click #

What it means:
The user clicked on the ad creative.

Important:
A click confirms user interaction, but does not guarantee a redirect to the advertiser’s landing page.
The redirect may fail due to:

Feed unavailability
Network issues
Internal anti-fraud filters

Available in:

✅ Rewarded Interstitial (only if the user clicks)
❌ Rewarded Popup (click event is not sent)
❌ In-App Interstitial (not supported in postback system)

Use cases:

CPC-based monetization
Engagement analytics
Confirming intentional user interaction

Summary Table #

Format	Impression Sent	Click Sent (on user action)	Reward Postback Supported
Rewarded Interstitial	✅	✅	✅
Rewarded Popup	✅	❌	✅
In-App Interstitial	❌	❌	❌

What’s Included in the Postback #

Each postback request includes the following parameters:

Parameter	Description
`event_type`	Event type: `impression` or `click`
`ymid`	Unique identifier you pass via SDK (user/session/action tracking)
`zone_id`	Main zone ID configured for the SDK
`sub_zone_id`	The specific zone where the event occurred
`request_var`	Identifier for the trigger (e.g., button or screen name)
`telegram_id`	Telegram user ID from the Telegram WebApp SDK (if provided)
`reward_event_type`	One of: `valued` or `not_valued` — whether the event was paid or not
`estimated_price`	Approximate revenue in USD; may be zero for fallback or unvalued traffic

Key Takeaways #

Postbacks are only available for Rewarded Interstitial and Rewarded Popup
In-App Interstitial does not trigger any postbacks
Rewarded Popup always sends impression, but never sends click
A click means user interacted with the creative, not that they reached the landing page
reward_event_type helps you determine whether to reward the event (valued) or ignore it (not_valued)
Fraudulent and unpaid traffic is grouped under not_valued