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 sent for Rewarded Interstitial, Rewarded Popup and In-App Interstitial. In-App Interstitial sends impression postbacks only, no click.

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

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 (can be sent from a zone linked to the popup zone; sub_zone_id is that zone ID)
❌ In-App Interstitial (click is not sent)

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). Rewarded Popup: prefixed with the main zone ID, `<main zone ID>_<requestVar>`
`telegram_id`	Telegram user ID from the Telegram WebApp SDK (empty string if not available)
`reward_event_type`	One of: `valued` or `non_valued` — whether the event was paid or not
`estimated_price`	Estimated earnings for this event in USD (7 digits after the point); `0.0000000` for `non_valued` events

📖 See the Macro Reference section for a full description for each field.

Key Takeaways #

Postbacks are sent for Rewarded Interstitial, Rewarded Popup and In-App Interstitial
In-App Interstitial sends impression and never click
Rewarded Popup sends impression from the popup zone and can also send click from a zone linked to it
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 (non_valued)
Fraud and fallback traffic is reported as non_valued