Apps Kit SDK logoApps Kit SDK
Dokümantasyon · Apps Kit SDK Portal

Native Reklam Şablonları

Native Reklam Şablonları, uygulamanızın kod üzerinden bir native reklam düzeni sağlaması yerine, native reklamın görsel düzenini doğrudan Portal'da tasarladığınız bölümdür. Bu bölüm, SDK'nin showTemplatedNative() çağrısının (Android'de AdsManager.showTemplatedNative, iOS'te AppsKitSDKAdsManagerIOS.instance.showTemplatedNative) Portal tarafındaki karşılığıdır: burada bir şablon kullanacak şekilde yapılandırılmış reklam yer tutucusu, çalışma zamanında bu SDK çağrısıyla tam olarak o tasarımla görüntülenir. Tasarım burada tanımlandığı için uygulama herhangi bir düzen kaynağı (res/XIB) iletmez.

Şablon Listesi

Reklam Şablonları sayfası (kenar çubuğunda Markalar ve Bölge Grupları ile aynı gruptadır), tasarladığınız tüm native reklam şablonlarını bir tabloda listeler.

1786548205099-Screenshot_2026-08-12_at_8.22.34_PM.png

Her satırda şunlar gösterilir: sıra numarası, düzenin küçük bir Görsel önizlemesi, Şablon Adı, Öğe sayısı (simge, başlık, medya, CTA gibi kullanılabilir yapı taşlarından kaçının şablonda kullanıldığı), Durum rozeti (Yayınlandı veya Taslak), sıralanabilir Oluşturulma Tarihi / Güncellenme Tarihi alanları ve İşlemler menüsü. Arama kutusu ada göre filtreleme yapar; Filtre, Durum ve Marka açılır menüleri listeyi daha da daraltır. Tümünü Temizle ile filtreleri sıfırlayabilirsiniz. Sayfalama, Portal genelinde kullanılan "Y kayıttan X tanesi gösteriliyor" alt bilgi biçimini izler. Yeni bir şablon oluşturmak için + Şablon Oluştur'a, mevcut bir şablonu aşağıda açıklanan Tuval düzenleyicisinde açmak için ilgili satıra tıklayın.

Şablon Tasarlama (Tuval)

Yeni veya mevcut bir şablonu açtığınızda, düzeni öğe öğe oluşturabileceğiniz Tuval düzenleyicisine yönlendirilirsiniz.

1786548453622-Screenshot_2026-08-12_at_8.27.14_PM.png

  • Öğeler (sol panel) — native reklam için kullanılabilir yapı taşları: Simge, Başlık, Reklamveren, Sponsorlu etiketi, Puan, Açıklama, Medya, Fiyat, Mağaza ve CTA düğmesi. Yalnızca tuvale yerleştirilmiş öğeler etkindir (liste sayfasındaki "Öğe" sayısı bunu yansıtır); diğerleri eklenene kadar panelde gri görünür. Bu öğe kümesi, bir native reklam nesnesinin sunabileceği öğelerle birebir örtüşür. Özel alanlar oluşturmak yerine, reklam ağının kendi native reklam öğelerinden hangilerini, nasıl yerleştireceğinizi seçersiniz.
  • Tuval (orta bölüm) — düzenin dp cinsinden gerçek boyutuyla canlı önizlemesidir. Yer tutucu etiketlerini veya gerçekçi örnek içerikleri görüntülemek için Etiketler / Örnek veriler seçeneği, yakınlaştırma kontrolleri, XML İçe Aktar seçeneği (sıfırdan oluşturmak yerine mevcut bir Android düzenini içe aktarır) ve değişiklikleri atıp şablonun son kaydedilen hâline dönmek için Başlangıca dön seçeneği bulunur.
  • Tuval özellikleri (sağ panel) — konum ve boyut (Hazır boyut açılır menüsü ile her biri bağımsız olarak sabit bir değere, match_parent veya wrap_content değerine ayarlanabilen Genişlik / Yükseklik alanları), görünüm (renk örneği ve onaltılık değer olarak Arka plan rengi ile Köşe yarıçapı) ve İç boşluklar (her biri ayrı artırma/azaltma kontrolüne sahip Sol / Üst / Sağ / Alt alanları).

Başlığın yanındaki Taslak / Yayında seçeneği (şablonu yeniden adlandırmak için aynı satırda bir kalem simgesi bulunur), şablonun bir reklam yer tutucusuna atanabilir olup olmadığını belirler. Taslak durumunda bırakılan bir şablon, başka hiçbir yerde kullanılabilir seçenek olarak görünmez. Değişiklikleri kaydet, gerçekten bir değişiklik yapana kadar devre dışı kalır; Portal genelinde olduğu gibi, değişiklik yoksa kaydetme işlemi yapılamaz.

Şablonun Kullanılabilirliğini Yapılandırma

Tuval düzenleyicisinde Yapılandır'a tıklamak, Şablon Kullanılabilirliğini Yapılandır iletişim kutusunu açar. Şablonu tasarlamaktan ayrı olan bu adım, şablonu belirli bir uygulama veya marka için kullanılabilir hâle getirir.

1786548681524-Screenshot_2026-08-12_at_8.30.53_PM.png

İletişim kutusu iki sütunlu bir seçim arayüzüdür. Yapısal olarak Kampanya sihirbazının Yayınlama adımıyla aynı düzeni kullanır (Hedefleme adımının Markalar bölümündeki "Tüm Markalar" seçeneği ile belirli marka/uygulama seçim listesi):

  • Markalar (sol) — Tüm markalar ana onay kutusunu kullanın veya arama yapılabilir listeden belirli markaları seçin. Seçilen markalar, listenin üzerinde kaldırılabilir etiketler olarak da gösterilir.
  • Uygulamalar (sağ) — solda seçilen markalara göre doldurulur ve markaya göre gruplanır. Her marka grubunun kendi Tüm uygulamalar (gelecektekiler dâhil) kısayolu vardır. Bu seçenek, markanın mevcut ve gelecekteki tüm uygulamalarını tek tek seçmeden kapsama alır. İsterseniz belirli uygulamaları tek tek de işaretleyebilirsiniz. Seçilen uygulamalar da etiketler olarak gösterilir.

Kullanılabilirlik kapsamını kaydetmek için Bitti'ye tıklayın. Bir şablon, yalnızca hem Yayında durumundaysa hem de burada ilgili uygulama/marka için kullanılabilir hâle getirilmişse, aşağıda açıklanan uygulama yapılandırmasında bir reklam yer tutucusuna native reklam şablonu atanırken seçilebilir.

Reklam Yer Tutucusuna Şablon Atama

Uygulamanın Uygulama Ayrıntıları → Reklam Yer Tutucuları → Reklam Yer Tutucuları için Reklam Birimleri tablosuna döndüğünüzde (yukarıdaki Uygulama Ayrıntıları bölümünde açıklanmıştır), Native sütunu Geçiş / Banner / Ödüllü sütunlarıyla aynı şekilde çalışır: her yer tutucuya bir veya daha fazla reklam yerleşimi ekleyebilir ve başarısızlık durumunda sıradakine geçilmesi için bunları önceliğe göre sıralayabilirsiniz. Ancak native reklam yerleşimlerine yalnızca bir reklam birimi değil, bir tasarım da atanması gerektiğinden, sütun başlığının yanında bir şablon simgesi de bulunur.

1786549032156-Screenshot_2026-08-12_at_8.36.46_PM.png

Bu simgeye tıklamak, o anda tabloda gösterilen tüm native reklam yer tutucularını kapsayan Native Reklam Şablonunu Yapılandır iletişim kutusunu açar. İletişim kutusunun başlığı kapsamı belirtir; örneğin "Tüm native reklam yer tutucuları (10)".

1786549069198-Screenshot_2026-08-12_at_8.37.30_PM.png

Bu uygulama için kullanılabilir hâle getirilen şablonlar arasından (yukarıdaki Şablonun Kullanılabilirliğini Yapılandırma bölümüne göre) bir şablon arayıp seçin. Ardından her yer tutucunun Native kartını tek tek açmak yerine, şablonu tek işlemle tüm kapsama atamak için Şablonu Uygula'ya tıklayın. Uygulandıktan sonra, bu kapsamdaki herhangi bir yer tutucu çalışma zamanında showTemplatedNative() çağrısıyla gösterildiğinde bu şablonun tasarımını kullanır. Burada tasarladığınız şablon ile uygulamanızda gösterilen gerçek native reklam arasındaki bağlantıyı bu mekanizma kurar. Bu, Çapraz Tanıtım'ın (yukarıdaki Uygulama Ayrıntıları içinde, Reklam Yer Tutucuları için Reklam Birimleri bölümünde açıklanmıştır) bir Kampanyayı yayındaki bir reklam yerleşimine bağlamasıyla aynı mantıktır.