Gömülü yerleşimler

Açılır pencere yerine uygulamanızda ayırdığınız bir alana içerik yerleştirin: ana sayfa bandı, sepet altı öneri alanı gibi. İçeriği panelden değiştirirsiniz, uygulama güncellemesi gerekmez. Karar kaydı: docs/adr/0068-gomulu-yerlesimler.md.

OluşturmaBağlantıyı kopyala

In-App → Yeni mesaj ekranında Gömülü yerleşim anahtarı alanını doldurun, örneğin ana_sayfa_ust. Kitle, A/B, zamanlama, sıklık ve istatistikler uygulama içi mesajla aynıdır.

Açılır mesajdan farkları:

• Tetikler değerlendirilmez: alanı açan uygulama kodunuzdur.
• Düzen seçimi yok sayılır: boyutu sayfanız belirler.
• Gösterim sınırı girmezseniz sınır yoktur.
• Web'de HTML içerikli mesaj bu alanda çizilmez, blok içerik kullanın.

Bu mesajlar eski SDK sürümlerine gönderilmez, açılır pencere olarak görünmez.

WebBağlantıyı kopyala

<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 içeriği Shadow DOM içinde çizer, gösterim ve tıklamayı kendisi bildirir, yeniden çağrılınca önceki çizimi siler. Kendi arayüzünüzle çizmek için:

const [message] = await Pushizo.Placements.list('ana_sayfa_ust');
Pushizo.Placements.reportImpression(message);

AndroidBağlantıyı kopyala

Pushizo.Placements.list("ana_sayfa_ust") { messages ->
    val message = messages.firstOrNull() ?: return@list
    runOnUiThread { showBanner(message) }
    Pushizo.Placements.reportImpression(message)
}

iOSBağlantıyı kopyala

let messages = try await Pushizo.Placements.list("ana_sayfa_ust")
if let message = messages.first {
    showBanner(message)
    Pushizo.Placements.reportImpression(message)
}

Android ve iOS model döner, çizim sizdedir. İçerik ekrana gelince reportImpression, düğmede reportClick, kapatmada reportDismiss çağırın.

SınırlarBağlantıyı kopyala

• Abonelik yoksa veya gizlilik onayı bekleniyorsa liste boş döner; alanın varsayılan içeriğini gösterin.
• limit 1–10, varsayılan 1. Sıralama önceliğe göredir.
• Flutter, React Native, Capacitor, Cordova, MAUI, Unity ve KMP köprülerinde henüz yoktur.
• Kalıcı içerik kartı akışı ayrı bir özelliktir; bu özellik tek alana yerleşimi çözer.