Embedded placements
Instead of a popup, place content in an area you reserve in your app, such as a home page banner or a recommendation slot below the cart. You change the content from the dashboard; no app update is needed. Decision record:…
Instead of a popup, place content in an area you reserve in your app, such as a home page banner or a recommendation slot below the cart. You change the content from the dashboard; no app update is needed.
Decision record: docs/adr/0068-gomulu-yerlesimler.md.
Creating a placement
On the In-App → New message screen, fill in the Embedded placement key field, for example ana_sayfa_ust. Audience, A/B, scheduling, frequency and statistics work the same as for in-app messages.
Differences from popup messages:
- Triggers are not evaluated: your app code is what opens the slot.
- The layout selection is ignored: your page determines the size.
- If you do not set an impression limit, there is no limit.
- On Web, messages with HTML content are not rendered in this slot; use block content.
These messages are not sent to older SDK versions and never appear as popups.
Web
<div id="ana-sayfa-ust"></div>const handle = await Pushizo.Placements.render('ana_sayfa_ust', document.getElementById('ana-sayfa-ust'));
if (handle.count === 0) showDefaultBanner();render draws the content inside a Shadow DOM, reports impressions and clicks itself, and clears the previous render when called again. To render with your own UI:
const [message] = await Pushizo.Placements.list('ana_sayfa_ust');
Pushizo.Placements.reportImpression(message);Android
Pushizo.Placements.list("ana_sayfa_ust") { messages ->
val message = messages.firstOrNull() ?: return@list
runOnUiThread { showBanner(message) }
Pushizo.Placements.reportImpression(message)
}iOS
let messages = try await Pushizo.Placements.list("ana_sayfa_ust")
if let message = messages.first {
showBanner(message)
Pushizo.Placements.reportImpression(message)
}Android and iOS return a model; rendering is up to you. Call reportImpression when the content appears on screen, reportClick on a button and reportDismiss on close.
Limits
- If there is no subscription or privacy consent is pending, the list is empty; show the slot's default content.
limitis 1–10, default 1. Results are sorted by priority.- The Flutter, React Native, Capacitor, Cordova, MAUI and Unity bridges provide
Placements.listand the report calls from 0.2.0 onward; they are not yet available in the KMP mobile package. - The persistent content card feed is a separate feature; this feature handles placement in a single slot.
HTML in-app messages, template gallery and carousel
Decision record: ADR-0027. In the in-app message editor, choose the HTML content type, or use Start from template to copy a layout from the gallery (24 ready-made templates, tr/en).
Notification inbox
The in-app notification inbox — adding messages with add_to_inbox, expiry, SDK and public API endpoints, read/archived states.