> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Örnek uygulama: uygulama içi mesajlar

> Clean Beans örnek uygulamasının yardım katmanları, bir izin ön istemi ve güncelleme ile değerlendirme istemleri için uygulama içi mesaj tetikleyicilerini ve özel HTML'yi nasıl kullandığı.

Bu sayfa, gerçek bir uygulamayı baştan sona takip eden [Örnek uygulama: eksiksiz bir OneSignal entegrasyonu](https://documentation.onesignal.com/docs/tr/example-full-integration-overview.md) kılavuzunun bir parçasıdır. Uygulama, ortak yaşanan evler için bir temizlik nöbet çizelgesi olan **Clean Beans**'tir ve Expo (React Native) ile bir Supabase backend'i kullanılarak geliştirilmiştir.

Uygulama içi mesajlar, biri uygulamayı kullanırken görünür. İçerikleri, kitleleri ve zamanlamaları OneSignal kontrol panelinde bulunur, bu yüzden yeni sürüm yayınlamadan değişebilirler. Clean Beans bunları beş iş için kullanır.

| Mesaj | Ne zaman gösterilir | Nasıl hedeflenir |
| - | - | - |
| Yardım katmanları | Kullanıcı bir ekrandaki yardım düğmesine dokunduğunda | Uygulamanın ayarladığı bir tetikleyici |
| Tanıtım turları | Kullanıcının bir ekranın rehberli turuna ihtiyacı olduğunda | Aynı tetikleyici |
| Push izni ön istemi | Sistem izin iletişim kutusundan önce | Kontrol panelindeki kitle ve zamanlama |
| Uygulama güncelleme istemi | Kullanıcı eski bir sürümdeyken | Bir segment |
| Değerlendirme istemi | Kullanıcı bir seri dönüm noktasına ulaştığında | Uygulamanın ayarladığı bir tetikleyici |

## Tetikleyiciler: anı uygulamanın belirlemesine izin verin \\

Tetikleyici, uygulamanın ayarladığı bir anahtar ve değerdir. Onunla eşleşecek şekilde yapılandırılmış her uygulama içi mesaj gösterilir. Her Clean Beans ekranının başlığında, değeri ekranın adı olan bir tetikleyici ayarlayan bir yardım düğmesi vardır.

```typescript src/components/HelpButton.tsx theme={null}
export function HelpButton({ triggerValue }: HelpButtonProps) {
  const handlePress = () => {
    OneSignal.InAppMessages.addTrigger('help_topic', triggerValue);
  };

  return (
    <TouchableOpacity onPress={handlePress} style={styles.button} hitSlop={8}>
      <Ionicons name="help-circle-outline" size={26} color={Colors.white} />
    </TouchableOpacity>
  );
}
```

```typescript app/(tabs)/_layout.tsx theme={null}
<Tabs.Screen
  name="index"
  options={{
    title: 'Dashboard',
    headerRight: () => <HeaderRight helpTopic="dashboard" />,
    tabBarIcon: ({ focused }) => <TabIcon name={focused ? 'home' : 'home-outline'} focused={focused} />,
  }}
/>
```

Tek bir tetikleyici anahtarı on üç ekrana hizmet eder. Yeni bir ekran için yardım eklemek, yeni bir değere sahip bir düğme eklemek ve kontrol panelinde bir mesaj oluşturmak demektir.

![Kontrol panelinin üzerinde gösterilen bir yardım katmanı uygulama içi mesajı](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-help.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=521ce92f66d1df24e99790600813523a)

Kontrol panelindeki yardım düğmesine dokunmak bir yardım katmanı gösterir.

**Kontrol paneli kurulumu.** **Messages > In-App** bölümünde, tetikleyicisi `help_topic` **is** `dashboard` olan bir mesaj oluşturun ve bunu her ekran için tekrarlayın. Çok adımlı tanıtım turları aynı tetikleyiciyi bir karusel düzeniyle kullanır.

![Kaydırılabilir kartlardan oluşan bir tanıtım turu uygulama içi mesajı](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-iam-walkthrough.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=c335375ee2bb79060e97aa945dea644e)

Kartlardan oluşan bir karusel olarak hazırlanmış çok adımlı bir tanıtım turu.

## Özel HTML mesajları \\

Yardım katmanları HTML ile yazılmıştır, bu yüzden uygulamanın tasarımıyla tam olarak eşleşir. Bir HTML uygulama içi mesajı, SDK ile `OneSignalIamApi` nesnesi aracılığıyla iletişim kurar. Tıklanabilir her öğe için iki kural geçerlidir:

* Tıklamaların doğru izlenmesi için ona benzersiz bir `data-onesignal-unique-label` verin.
* Bir `OneSignalIamApi` yöntemini çağıran bir dinleyici ekleyin. Düz bağlantılar izlenmez.

```html docs/iam-html/help-dashboard.html theme={null}
<button id="got-it" class="cta-btn" data-onesignal-unique-label="dashboard-got-it">Got it</button>

<script>
  document.addEventListener("DOMContentLoaded", function () {
    document.getElementById("got-it").addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
  });
</script>
```

## Push izni ön istemi \\

Sistem izin iletişim kutusu yalnızca bir kez gösterilebilir. Önce gösterilen bir uygulama içi mesaj, kullanıcının ne alacağını açıklayabilir ve yalnızca **Enable notifications** düğmesine dokunanlar sistem iletişim kutusunu görür.

![Bildirimleri etkinleştirmenin faydalarını açıklayan bir uygulama içi mesaj](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-iam-push-prompt.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=18791e9af52a803d41048eba393109f6)

Bir ön istem, sistem iletişim kutusu görünmeden önce faydayı açıklar.

```html docs/iam-html/push-permission-prompt.html theme={null}
<script>
  document.addEventListener("DOMContentLoaded", function () {
    document.getElementById("enable-btn").addEventListener("click", function (e) {
      OneSignalIamApi.triggerPushPrompt(e);
    });
    document.getElementById("skip-btn").addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
  });
</script>
```

> [!NOTE]
>
> Bir ön istem kullanıyorsanız, uygulama başlangıcındaki `requestPermission()` çağrısını kaldırın. Aksi halde sistem iletişim kutusu önce görünür ve ön istemin soracak bir şeyi kalmaz.

## Uygulama güncelleme istemi \\

Yeni bir sürüm yayınlandığında, eski sürümdeki kişiler güncelleme istemi görür. Bu mesaj uygulamada hiçbir kod gerektirmez. Kitlesi, eski bir uygulama sürümündeki kullanıcılardan oluşan bir segmenttir.

![Kullanıcıdan uygulamayı güncellemesini isteyen bir uygulama içi mesaj](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-iam-app-version.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=f096ce85f566823331171e14312e534d)

Yalnızca eski sürümdeki kişilere gösterilen güncelleme istemi.

Tek bir mesaj her iki platforma da hizmet eder. Komut dosyası mağazayı cihaza göre seçer ve `openUrl` tıklamayı izler, mağazayı açar ve mesajı kapatır.

```html docs/iam-html/app-update-prompt.html theme={null}
<script>
  var IOS_URL = "https://apps.apple.com/app/id" + IOS_APP_STORE_ID;
  var ANDROID_URL = "https://play.google.com/store/apps/details?id=" + ANDROID_PACKAGE;

  // One message serves both platforms: pick the store from the device.
  var isAndroid = /android/i.test(navigator.userAgent);
  var storeUrl = isAndroid ? ANDROID_URL : IOS_URL;

  document.addEventListener("DOMContentLoaded", function () {
    document.getElementById("update-btn").addEventListener("click", function (e) {
      // openUrl tracks the click, opens the store and closes the message
      OneSignalIamApi.openUrl(e, storeUrl);
    });
    document.getElementById("later-btn").addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
  });
</script>
```

Selamlama bir etiket kullanır ve etiketi olmayan kullanıcılar için bir yedek değer içerir.

```html docs/iam-html/app-update-prompt.html theme={null}
<p>Hey {{ user_name | default: "there" }}, you're on an older version</p>
```

**Kontrol paneli kurulumu.** **App version** değeri mevcut sürümünüzden küçük olan bir filtreyle bir segment oluşturun ve bunu mesajın kitlesi olarak kullanın. Her yeni sürümde filtreyi güncelleyin.

> [!NOTE]
>
> Etiket değiştirme, bir HTML uygulama içi mesajının metninde ve özniteliklerinde çalışır, ancak `script` etiketlerinin içinde çalışmaz.

## Değerlendirme istemi: bir tıklamayı uygulamaya geri iletin \\

Uygulama mağazası puanı istemek için iyi bir an, bir şey iyi gittikten hemen sonrasıdır. Clean Beans, bir temizlik oturumu bir seriyi yedi günün katına ulaştırdığında bunu ister.

Bu, bir dokunuşun uygulamada kod çalıştırması gereken tek uygulama içi mesajdır, çünkü yerel puanlama sayfasını yalnızca uygulamanın kendisi açabilir.

**1. Uygulama bir seri dönüm noktasında bir tetikleyici ayarlar**

İstemin temizliği asla bölmemesi için oturum ekranının kapanmasını bekler ve en son hangi dönüm noktasında sorduğunu hatırlar.

```typescript src/lib/reviewPrompt.ts theme={null}
export async function maybeAskForReview(streak: number): Promise<void> {
  try {
    if (streak <= 0 || streak % STREAK_MILESTONE_DAYS !== 0) return;

    // A second session on the same day leaves the streak unchanged —
    // don't ask twice for the same milestone.
    const lastPrompted = await AsyncStorage.getItem(LAST_PROMPTED_STREAK_KEY);
    if (lastPrompted === String(streak)) return;
    await AsyncStorage.setItem(LAST_PROMPTED_STREAK_KEY, String(streak));

    OneSignal.InAppMessages.addTrigger(REVIEW_TRIGGER_KEY, REVIEW_TRIGGER_VALUE);
    console.log('[reviewPrompt] Trigger set at streak', streak);
  } catch (e) {
    console.warn('[reviewPrompt] maybeAskForReview error:', e);
  }
}
```

**2. Mesaj uygulamaya bir tıklama adı gönderir**

`addClickName`, uygulamanın tıklama dinleyicisine bir ad iletir. Mesajı kapatmaz, bu yüzden komut dosyası mesajı hemen ardından kapatır.

```html docs/iam-html/review-prompt.html theme={null}
<script>
  document.addEventListener("DOMContentLoaded", function () {
    var autoCloseBtn = document.getElementById("auto-close-btn");

    document.getElementById("rate-btn").addEventListener("click", function (e) {
      // Passes the click name "review" to the app's In-App Message click
      // listener, which opens the native rating sheet. addClickName does not
      // close the message, so close it straight afterwards.
      OneSignalIamApi.addClickName(e, "review");
      setTimeout(function () { autoCloseBtn.click(); }, 300);
    });
    autoCloseBtn.addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
    document.getElementById("later-btn").addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
  });
</script>
```

**3. Uygulama yerel puanlama sayfasını açar**

Tıklama dinleyicisi adı kontrol eder ve sistemden sayfayı göstermesini ister.

```typescript src/lib/reviewPrompt.ts theme={null}
export function handleReviewClick(event: InAppMessageClickEvent): void {
  if (event.result.actionId !== REVIEW_ACTION_ID) return;

  // Give the In-App Message a moment to close before presenting the sheet
  setTimeout(async () => {
    try {
      // false on TestFlight builds and on the web
      if (await StoreReview.isAvailableAsync()) {
        await StoreReview.requestReview();
      } else {
        console.log('[reviewPrompt] Store review not available on this build');
      }
    } catch (e) {
      console.warn('[reviewPrompt] requestReview error:', e);
    } finally {
      // Clear the trigger so the message is not re-evaluated this app session
      OneSignal.InAppMessages.removeTrigger(REVIEW_TRIGGER_KEY);
    }
  }, 800);
}
```

```typescript app/_layout.tsx theme={null}
OneSignal.InAppMessages.addEventListener('click', handleReviewClick);
```

![Bir değerlendirme istemi uygulama içi mesajı](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-review-prompt.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=90dde058450240f49d42e76402ed28ce)

Değerlendirme istemi uygulama içi mesajı.

**Kontrol paneli kurulumu.** Tetikleyicisi `ask_for_review` **is** `show` olan bir HTML uygulama içi mesajı oluşturun. En fazla 17 haftada bir gösterilecek şekilde zamanlayın.

> [!WARNING]
>
> Apple puanlama sayfasını bir kullanıcıya yılda en fazla üç kez gösterir ve Google'ın da kendi sınırı vardır, bu yüzden düğmeye dokunmak bir şey gösterileceğini garanti etmez. Sayfa TestFlight derlemelerinde asla görünmez. Bu akışı bir App Store derlemesiyle test edin.

> [card] [Uygulama içi tetikleyiciler](https://documentation.onesignal.com/docs/tr/iam-triggers.md)
>
> Tetikleyici türleri ve nasıl birleştikleri.

> [card] [HTML uygulama içi mesajlar](https://documentation.onesignal.com/docs/tr/design-your-in-app-message-with-html.md)
>
> Kendi HTML'nizle mesaj tasarlayın.

> [card] [Uygulama içi JavaScript API'si](https://documentation.onesignal.com/docs/tr/in-app-message-api.md)
>
> Tüm `OneSignalIamApi` yöntemleri.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.