PushizoDocs
Channels

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.
  • limit is 1–10, default 1. Results are sorted by priority.
  • The Flutter, React Native, Capacitor, Cordova, MAUI and Unity bridges provide Placements.list and 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.

On this page