---
title: "Özel öğeler"
description: "Bir flow ekranına Lottie / Rive animasyonu, etkileşimli grafik veya kamera önizlemesi gibi yerel bir görünüm ekleyin."
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skills: `npx adapty skills install --yes`

Flow & Paywall Builder'daki özel bir öğe ile bir flow ekranına native view ekleyebilirsiniz. Bu; bir Lottie / Rive animasyonu, etkileşimli bir grafik, bir harita, bir kamera önizlemesi ya da uygulamanızın gösterebildiği herhangi başka bir view olabilir. Kullanıcılar native view'ı yalnızca Adapty iOS SDK 4.4 veya sonrasını kullanan uygulamalarda görebilir. Adapty Android SDK ya da Flutter veya React Native gibi platformlar arası bir framework için SDK kullanan uygulamalar, her özel öğe için yedek paywall'ı gösterir.

Bir flow ekranında yerel görünüm göstermek için:

1. [Ekrana bir özel öğe ekleyin](#add-and-configure) ve **Type** ile **ID** değerlerini girin.
2. Özel öğenin içine [yedek içerik ekleyin](#set-fallback-content). Uygulamanız view'ı göstermediğinde kullanıcılar bunu görür.
3. [Uygulamanızdaki native view'ı ayarlayın](#set-up-your-app-code). Aynı Type ve ID'yi atamak için Adapty SDK'sını kullanın.
4. [Flow'u yayınlayın](#publish-and-test) ve bir cihazda test edin.
5. [Native view ile uygulama güncellemesini yayınlayın](#what-changes-require-an-app-release). Native view içermeyen uygulama sürümlerindeki kullanıcılar yedek içeriği görür.

:::tip
Bir resim veya animasyonlu video görüntülemek için özel bir element yerine [**Image**](custom-media#image) veya [**Video**](custom-media#video) elementini kullanın. Her ikisi de uygulamanızda kod gerektirmez ve dosyayı uygulama güncellemesi olmadan değiştirebilirsiniz.
:::

## 1. Ekrana özel bir öğe ekleyin \{#add-and-configure\}

1. **Add element** panelini açın. **Media** grubunda **Custom element** seçeneğine tıklayın.

2. Eğer native view dokunuşa tepki veriyorsa, özel öğeyi aynı zamanda dokunuşa tepki veren (örneğin carousel gibi) kapsayıcıların içine koymayın. Böylece native view içinde yapılan bir kaydırma carousel'i hareket ettirmez.
3. **Type** alanına, native view türü için bir Type girin; örneğin `lottie_animation`:
   - **Adlandırma kuralları**: Yalnızca küçük harf, rakam ve alt çizgi kullanın.
   - **Tam eşleşme**: Type, uygulamanızdakiyle harf harf aynı olmalıdır. Farklı bir yazımda kullanıcılar yedek içeriği görür.
   - **Öneriler**: Alan, uygulamanızdaki Type'ları değil, bu flow'da zaten kullanılmış olan Type'ları önerir.
4. **ID** alanında, `custom_1` gibi önceden doldurulmuş değeri `welcome_wave` gibi kendi seçtiğiniz bir ID ile değiştirin. ID, aynı Type'taki özel öğeleri birbirinden ayırt eder.

5. Native view için belirli bir alan ayırmak üzere varsayılan **Fixed** yüksekliğini koruyun. Bunu view'ın ihtiyaç duyduğu yüksekliğe ayarlayın.
   - **Paylaşılan alan**: Native view ve yedek içerik aynı alanı paylaşır.
   - **Hizalama**: Native view bu alandan küçükse, varsayılan olarak sol üst köşede görünür. Konumunu değiştirmek için özel öğenin **Layout** bölümündeki hizalama ayarını değiştirin.

   :::important
   **Hug** yüksekliğiyle, harita veya kaydırmalı liste gibi kendi yüksekliği olmayan bir native view neredeyse sıfır yüksekliğe küçülür.
   :::

6. (İsteğe bağlı) Native view'u özel öğenin yuvarlak **Corners** köşelerine göre kesmek için **Layout** bölümünde **Clip content** onay kutusunu seçin.

### Birden fazla özel öğede yerel görünümler kullanma \{#use-native-views-in-several-custom-elements\}

Aşağıdaki kurallar, özel öğelerin Türü ve ID'si için geçerlidir:

- **Type**: Her yerel görünüm türü için bir Type girin; örneğin Lottie oynatıcı için `lottie_animation`, harita için `map`.
- **ID**: Bir Type içinde, her içerik parçasına benzersiz bir ID atayın; örneğin iki Lottie animasyonu için `streak_ring` ve `welcome_wave`. Uygulamanız içeriği seçmek için ID'yi okur. Bir ekrandaki iki özel öğenin aynı Type ve ID'si varsa, **ID** alanında şu uyarı görüntülenir: *Same type and ID as another element on this screen.* Flow'u yine de yayınlayabilirsiniz.
- **Öğe kopyaları**: Bir öğeyi çoğaltır ya da yapıştırırsanız veya bir [sekme](builder-tabs) eklerseniz, builder ekran ya da bileşen içinde zaten kullanılmakta olan kopyalanmış ID'lerin her birini yeniden adlandırır. Örneğin `custom_1`, `custom_2` olur; `hero` ise `hero_2` olur. Uygulamanızın kodunun doğru ID'ye başvurduğundan emin olun.

## 2. Yedek içerik ekle \{#set-fallback-content\}

Kullanıcılar, aşağıdaki durumlarda native view yerine yedek içeriği görür:

- Uygulamanızın yüklü sürümü, ilgili view kodunu içermiyor.
- Uygulamanız Adapty Android SDK, bir cross-platform framework için SDK ya da 4.4'ten eski bir Adapty iOS SDK sürümü kullanıyor.
- Özel öğenin Type ve ID değerleri, uygulama kodunuzdaki hiçbir view ile eşleşmiyor.
- Uygulama kodunuz Type ve ID'yi eşleştiriyor ancak herhangi bir view döndürmüyor. Örneğin, view cihazda bulunmayan bir dosyaya ya da kullanıcının reddettiği bir izne ihtiyaç duyuyor.

Yedeği ayarlamak için özel eleman kapsayıcısına öğeler ekleyin. Native view görünmediğinde, yedeği olmayan bir özel eleman boş kalır.

Flow & Paywall Builder, uygulama kodunuzu çalıştıramaz; bu nedenle canvas yalnızca yedeği gösterir. [Adapty mobil uygulamasındaki önizleme](paywall-device-compatibility-preview#preview-on-devices) de yedeği gösterir. Native view'ı önizlemek için uygulamanızın bir build'inde [flow'u bir cihazda test edin](#publish-and-test).

:::important
Gezinme düğmelerini, satın alma düğmelerini ve diğer temel UI bileşenlerini özel öğenin dışında tutun. Kullanıcılar ya yerel görünümü ya da yedeği görür, ikisini birden değil.
:::

Bir özel öğenin içine **Footer**, **Sliding sheet** veya **Bottom Sheet** ekleyemezsiniz.

## 3. Uygulamanızda native view'ı ayarlayın \{#set-up-your-app-code\}

Özel bir element içeren bir ekran açıldığında, Adapty SDK, elementin Type ve ID değerlerini uygulama kodunuzdaki bir resolver fonksiyonuna iletir. Resolver aşağıdakilerden birini döndürür:

- **Type ve ID ile eşleşen view**: Kullanıcılar native view'ı görür. Kodda, Type ve ID değerlerini builder'da yazdığınız gibi birebir yazın.
- **View yok**: Kullanıcılar yedek içeriği görür. Örneğin, view'ın ihtiyaç duyduğu bir dosya cihazda yoksa view döndürmeyin.

iOS kodu için [iOS SDK ile özel öğeleri görüntüleme](ios-flow-custom-elements) sayfasına bakın. Bu sayfada resolver'ın nasıl yazılacağı ve yerel görünümün cihazda nasıl test edileceği gösterilmektedir.

:::tip
Yerel bir görünüm, daha önce gerçekleştirilen bir flow'dan alınan yanıtlar gibi kullanıcı verilerini görselleştirebilir. Bkz. [Paywall'da interaktif kilo hedefi grafiği gösterme](custom-element-interactive-chart).
:::

## 4. Flow'u yayınlayın ve test edin \{#publish-and-test\}

Flow'u [yayınlamak](builder-save-publish) için her özel öğenin [adlandırma kurallarına](#add-and-configure) uygun bir Tür'e sahip olduğundan emin olun. Uygulamayı yayına almadan önce flow'u yayınlayabilirsiniz. Kullanıcılar uygulamayı güncelleyene kadar yedek paywall'ı görürler.

Native view'daki bir hata uygulamanın çökmesine neden olabilir. Uygulamayı yayınlamadan önce, özel öğe içeren her ekranı native view ile birlikte bir build'de test edin. Gerçek kullanıcıların henüz görmediği bir flow'u test etmek için, bu build'in istediği ancak yayınlanmış uygulamanızın istemediği bir [placement](create-placement)'a ekleyin. Önbelleğe alınmış bir flow yerine en son yayınlanan flow'u görmek için cihazı bir [test cihazı](test-devices) olarak kaydedin. Tam prosedür için [Cihazda test etme](ios-flow-custom-elements#test-on-a-device) sayfasını okuyun.

## Hangi değişiklikler uygulama güncellemesi gerektirir \{#what-changes-require-an-app-release\}

Native view'lar uygulamanızın kod yapısının bir parçasıdır. Native view'ı değiştirmek için uygulama güncellemesi yayınlamanız gerekir. Özel bir öğenin yedek içeriğini veya Tür ve ID dışındaki herhangi bir ayarını değiştirmek için flow'u yayınlayın.

| Değiştirilen içerik | Ne yaparsınız | Uygulamayı güncellememiş kullanıcılar ne görür |
|---|---|---|
| Mevcut özel bir öğenin native görünümü, örneğin farklı bir animasyon | Yeni native görünümle birlikte uygulama güncellemesi yayınlayın | Uygulamalarının sürümünde varsa önceki native görünüm |
| Yeni özel bir öğe için native görünüm | Yeni native görünümle birlikte uygulama güncellemesi yayınlayın. Yeni Tür ve ID ile özel bir öğe ekleyin ve flow'u yayınlayın | Yedek içerik |
| Başka bir ekranda, başka bir flow'da veya A/B testinde mevcut native görünüm | Aynı Tür ve ID ile özel bir öğe ekleyin ve flow'u yayınlayın. [Uygulama genelinde çözümleyiciniz](ios-flow-custom-elements#set-an-app-wide-resolver) görünümü döndürüyorsa uygulama güncellemesi gerekmez | Uygulamalarının sürümünde varsa native görünüm |
| Özel öğenin Türü veya ID'si | Yeni Tür ve ID için native görünümle birlikte uygulama güncellemesi yayınlayın ve flow'u yayınlayın | Yedek içerik |
| Yedek içerik, özel öğenin diğer ayarları | Flow'u yayınlayın. Uygulama güncellemesi gerekmez | Güncellenmiş içerik |

## Örnekler \{#examples\}

Her tarif, builder'daki kurulumu ve uygulamanıza ait kodu gösterir:

- [Lottie animasyonuyla kullanıcı ilerlemesini gösterme](custom-element-lottie-animation): Seri uzadıkça dolup taşan bir halka.
- [Paywall'da interaktif bir kilo hedefi grafiği gösterme](custom-element-interactive-chart): Onboarding flow'unu takip eden paywall flow'undaki bir kilo hedefi grafiği.
- [Flow'da yakındaki yerleri haritada gösterme](custom-element-map): Her kullanıcının yakınındaki fitness merkezlerinin haritası.

## Sorun Giderme \{#troubleshooting\}

- **Kullanıcılar native view yerine yedek içeriği görüyor**: Type ve ID'nin uygulamanızdakiyle birebir eşleştiğinden emin olun. View'ı içermeyen uygulama sürümlerindeki kullanıcılar, uygulamayı güncelleyene kadar yedek içeriği görmeye devam eder. Kod tarafındaki nedeni bulmak için iOS kılavuzundaki [Cihazda test etme](ios-flow-custom-elements#test-on-a-device) bölümünü takip edin.
- **Kullanıcılar boş bir alan görüyor**: [Yedek içerik ekleyin](#set-fallback-content) ve flow'u yayımlayın. [Test cihazında](test-devices) hâlâ boş alan görüyorsanız native view, içeriği olmadan görünüyor demektir. Resolver'ın içerik eksikken `nil` döndürdüğünden emin olun; örneği [Yedek içerik için koşulları ayarlama](ios-flow-custom-elements#set-conditions-for-fallback-content) bölümünde bulabilirsiniz.
- **Native view özel öğeye sığmıyor**: Uygulamanızın view'ı özel öğenin alanına göre ayarladığından emin olun. View'ı yuvarlatılmış **Corners**'a kesmek için **Layout** bölümünde **Clip content** onay kutusunu seçin.