> For the complete documentation index, see [llms.txt](https://user.netmera.com/netmera-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://user.netmera.com/netmera-user-guide/netmera-user-guide-tr/omnichannel-engagement/uygulama-hikayeleri.md).

# Uygulama hikayeleri

Uygulamanızda hikaye alanını bir kez oluşturun, ardından yeni bir uygulama sürümü yayınlamadan Netmera widget'larıyla her hikayeyi oluşturun, güncelleyin ve döndürün.

Uygulama hikayeleri, tanıdık hikaye formatını; yani dokunulabilir, görsel içerik kartlarından oluşan bir satırı mobil uygulamanıza taşır ve içeriğini Netmera Paneli üzerinden sizin kontrolünüze verir. Geliştirme ekibiniz hikaye alanını bir kez oluşturur. Her hikaye bir Netmera widget'ıdır; bu nedenle pazarlama ve CRM ekipleri, uygulama sürümlerinden bağımsız olarak hikayeleri kendi takvimlerine göre başlatabilir, yenileyebilir ve döndürebilir.

Uygulama hikayelerini kampanya lansmanları, yeni ürün öne çıkanlar, onboarding ipuçları, sezonluk teklifler ve kısa, görsel, kaydırılabilir bir deneyim olarak en iyi çalışan tüm mesajlar için kullanın.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FEiFEMspj8g2fODTaBn3N%2Fapp-stories-overview.png?alt=media&amp;token=3b5fb3a7-9699-4fee-b27a-5f021cec6e52" alt=""><figcaption></figcaption></figure>

### Nasıl çalışır

Uygulama hikayeleri, uygulamanızın sahip olduğu bir arayüzü Netmera'nın sunduğu içerikle birleştirir.

<table><thead><tr><th width="180">Katman</th><th width="200">Sahip</th><th>Sorumluluk</th></tr></thead><tbody><tr><td><strong>Hikaye alanı</strong></td><td>Uygulama geliştirme ekibi</td><td>Uygulamada hikaye arayüzünü oluşturur ve widget içeriğini gösteren Netmera SDK metodunu çağırır.</td></tr><tr><td><strong>Hikaye içeriği</strong></td><td>Pazarlama veya CRM ekibi</td><td>Her hikayeyi Netmera Paneli'nde bir widget olarak tasarlar ve içeriğini güncel tutar.</td></tr></tbody></table>

Bir kullanıcı bir hikayeyi açtığında, SDK o hikayeyle bağlantılı widget'ı yükler ve onu hikaye alanında gösterir. İçerik Netmera'da bulunduğu için, yapılan her içerik değişikliği App Store veya Google Play'de yeni bir sürüme ihtiyaç duymadan uygulamaya ulaşır.

### Uygulama hikayelerini kurun

{% stepper %}
{% step %}

#### SDK metodunu uygulayın

Geliştirme ekibiniz, bir widget'ı URL'siyle gösteren SDK metodunu ekler. Uygulamanızın platformuna uygun metodu kullanın.

<table><thead><tr><th width="200">Platform</th><th width="300">Metot</th><th>Şu sürümden itibaren</th></tr></thead><tbody><tr><td><strong>Yerel iOS (Swift)</strong></td><td><code>Netmera.displayContent(forWidgetURL:)</code></td><td>iOS Swift SDK v4.20.0</td></tr><tr><td><strong>Yerel Android</strong></td><td><code>Netmera.displayWidget</code></td><td>Android SDK v4.16.0</td></tr><tr><td><strong>React Native</strong></td><td><code>Netmera.displayWidgetContent</code></td><td>React Native SDK v2.3.0</td></tr></tbody></table>

{% tabs %}
{% tab title="Yerel iOS (Swift)" %}
Widget'ı SDK'nın yerleşik sunumuyla gösterin:

```swift
guard let url = URL(string: widgetUrlString) else { return }
Netmera.displayContent(forWidgetURL: url)
```

Widget'ı kendi hikaye kapsayıcınızın içinde oluşturmak için uygulamanın `WKWebView`.'ini iletin. Kapsayıcıyı `onCloseRequested` kapanış bloğunda kapatın; bu blok widget kapanmak istediğinde veya bir bağlantı ya da deeplink açtığında çalışır:

```swift
Netmera.displayContent(forWidgetURL: url, in: webView) { [weak self] in
    self?.dismiss(animated: true)
}
```

Ayrıntılar için bkz. [Bir widget'ı URL ile gösterme](https://user.netmera.com/netmera-developer-guide/platforms/ios/new-ios-swift/push-notifications/widget-and-in-app-messages#display-a-widget-by-url).
{% endtab %}

{% tab title="Yerel Android" %}
Widget'ı SDK'nın yerleşik sunumuyla gösterin:

```kotlin
Netmera.displayWidget(url)
```

Widget'ı kendi hikaye kapsayıcınızın içinde oluşturmak için uygulamanın `WebView`:

```kotlin
val webView = findViewById<WebView>(R.id.web_view)
Netmera.displayWidget(url, webView, object : NetmeraWebViewCallback {
    override fun shouldOverrideUrlLoading(view: WebView, url: String): Boolean = false
    override fun onPageLoaded(view: WebView, url: String) {}
    override fun onPageCommitVisible(view: WebView, url: String) {}
})
```

Ayrıntılar için Android SDK değişiklik günlüğüne bkz. [Android SDK değişiklik günlüğü](https://user.netmera.com/netmera-developer-guide/platforms/android/changelog#v4.16.0).
{% endtab %}

{% tab title="React Native" %}
Widget'ı SDK'nın yerleşik sunumuyla gösterin:

```javascript
Netmera.displayWidgetContent('https://...');
```

Ayrıntılar için bkz. [Widget'ı URL ile göster](https://user.netmera.com/netmera-developer-guide/platforms/react-native/push-notifications/widget-and-in-app-messages#display-widget-by-url).
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

#### Her hikaye için bir widget oluşturun

Netmera Paneli'nde göstermek istediğiniz her hikaye için ayrı bir widget oluşturun. Her widget'ı uygulamanızdaki hikaye alanının boyutuna ve yönüne göre tasarlayın ve kaydetmeden önce mobilde önizleyin.

Widget adında hikaye sırasını ve konusunu yansıtın. Tutarlı bir adlandırma düzeni, hikayeleri [Widgetlar panosunda](/netmera-user-guide/netmera-user-guide-tr/omnichannel-engagement/widgets/build-a-widget/widgets-dashboard.md) kolayca bulmayı ve bir sonraki adımda kolayca eşlemeyi sağlar. Örneğin:

* Uygulama Hikayesi – 1. Hikaye – Yaz kampanyası
* Uygulama Hikayesi – 2. Hikaye – Yeni gelenler
* Uygulama Hikayesi – 3. Hikaye – Sadakat programı

Düzen ve içerik seçenekleri için bkz. [Widget düzenini tasarlayın](/netmera-user-guide/netmera-user-guide-tr/omnichannel-engagement/widgets/build-a-widget/design-widget-layout.md) ve [Widget öğeleri referansı](/netmera-user-guide/netmera-user-guide-tr/omnichannel-engagement/widgets/build-a-widget/widget-elements-reference.md). Bir hikaye içinde düğmeler, deeplink'ler veya takip aksiyonları eklemek için bkz. [Widget aksiyonlarını ve doğrulamasını yapılandırın](/netmera-user-guide/netmera-user-guide-tr/omnichannel-engagement/widgets/build-a-widget/configure-widget-actions-and-validation.md).
{% endstep %}

{% step %}

#### Her widget'ı uygulamadaki bir hikayeyle eşleştirin

Her hikaye widget'ının URL'sini toplayın ve geliştirme ekibinizle paylaşın:

1. Açın [Widgetlar panosunda](/netmera-user-guide/netmera-user-guide-tr/omnichannel-engagement/widgets/build-a-widget/widgets-dashboard.md).
2. Hikaye widget'ını ... ile bulun **Ara**.
3. Widget'ın işlem menüsünü açın ve **Bağlantıyı kopyala**.

Geliştirme ekibi, her URL'yi karşılık gelen hikaye konumu için SDK metoduna iletir. Bu eşleme bir kez yapılır. Bundan sonra hikaye alanı Netmera widget'larına bağlanmış olur.

<table><thead><tr><th width="160">Hikaye konumu</th><th width="280">Widget</th><th>SDK metoduna iletilen</th></tr></thead><tbody><tr><td>1</td><td>Uygulama Hikayesi – 1. Hikaye</td><td>İlk hikaye widget'ının URL'si</td></tr><tr><td>2</td><td>Uygulama Hikayesi – 2. Hikaye</td><td>İkinci hikaye widget'ının URL'si</td></tr><tr><td>3</td><td>Uygulama Hikayesi – 3. Hikaye</td><td>Üçüncü hikaye widget'ının URL'si</td></tr></tbody></table>

{% hint style="warning" %}
Eşleme, uygulamanın kaç hikaye göstereceğini belirler. İçerik değişiklikleri hiçbir zaman sürüm gerektirmez; ancak geliştirme ekibiniz widget URL'lerini uzak bir kaynaktan yüklemiyorsa yeni bir hikaye konumu eklemek sürüm gerektirir.
{% endhint %}
{% endstep %}

{% step %}

#### Hikayeleri Netmera'dan yönetin

Eşleme yapıldıktan sonra, hikaye alanını Netmera Paneli üzerinden yönetirsiniz. Bir hikayeyle bağlantılı widget'ı açın, içeriğini güncelleyin ve kaydedin. Güncellenen hikaye, kullanıcılar onu bir sonraki açışında onlara ulaşır.

Bir hikayeyi yeni bir kampanya ile değiştirmek için, o konuma zaten eşlenmiş olan widget'ı düzenleyin. **Çoğalt** yeni bir URL'ye sahip yeni bir widget oluşturur ve uygulama buna bağlı değildir. Kopyaları, bir önceki hikayenin kopyasını saklamak için kullanın; bir sonraki hikayeyi yayınlamak için değil.
{% endstep %}
{% endstepper %}

### Hikaye performansını ölçün

Hikaye widget'ları Netmera'nın widget analitiğini kullanır; böylece her hikayenin performansını ve hangi içeriğin aksiyona yol açtığını görebilirsiniz. Gösterimleri ve etkileşimleri [Widget performansını analiz edin](/netmera-user-guide/netmera-user-guide-tr/omnichannel-engagement/widgets/measure-performance/analyze-widget-performance.md)bölümünde inceleyin. Bir hikaye içindeki ürün dokunuşu gibi hikayeye özel etkileşimleri izlemek için bkz. [Özel widget olaylarını izleyin](/netmera-user-guide/netmera-user-guide-tr/omnichannel-engagement/widgets/measure-performance/track-custom-widget-events.md).

### Hikayeleri neden Netmera ile yönetin

<table><thead><tr><th width="220">Fayda</th><th>Bu sizin ekibiniz için ne anlama gelir</th></tr></thead><tbody><tr><td><strong>Sürüme bağlı olmayan içerik</strong></td><td>Hikaye içeriği uygulama sürümlerine veya yayınlama işlemlerine bağlı değildir. Pazarlama ekipleri yayın takvimine göre değil, kampanya takvimine göre yayın yapar.</td></tr><tr><td><strong>Anında güncellemeler</strong></td><td>Bir hikaye widget'ında yapılan değişiklikler, widget kaydedildiği anda uygulamadaki hikayelere ulaşır.</td></tr><tr><td><strong>Performans içgörüsü</strong></td><td>Netmera analitiği, her hikayenin nasıl performans gösterdiğini ortaya koyar; böylece en güçlü içerik şeritte kalabilir, daha zayıf hikayeler hızla değiştirilebilir.</td></tr><tr><td><strong>Tek tasarım araç seti</strong></td><td>Hikayeler, diğer Netmera widget'larıyla aynı widget editörünü, öğeleri ve aksiyonları kullanır.</td></tr></tbody></table>

### İlgili sayfalar

* [Widget'lar](/netmera-user-guide/netmera-user-guide-tr/omnichannel-engagement/widgets.md)
* [Bir widget oluşturun](/netmera-user-guide/netmera-user-guide-tr/omnichannel-engagement/widgets/build-a-widget.md)
* [Widget performansını analiz edin](/netmera-user-guide/netmera-user-guide-tr/omnichannel-engagement/widgets/measure-performance/analyze-widget-performance.md)
* [Netmera geliştirici kılavuzu](https://user.netmera.com/netmera-developer-guide)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://user.netmera.com/netmera-user-guide/netmera-user-guide-tr/omnichannel-engagement/uygulama-hikayeleri.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.