> ## 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: derin bağlantılar ve bildirim tıklamaları

> Clean Beans örnek uygulamasının dokunulan bir push'u doğru ekrana nasıl yönlendirdiği, eylem düğmelerini ve ertelemeyi nasıl işlediği ve Universal Links ile nasıl açıldığı.

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.

Bir bildirim ancak ona dokunmak sizi doğru yere götürüyorsa işe yarar. Clean Beans uygulamaya girmenin dört yolunu işler: dokunulan bir push, bir push üzerinde dokunulan bir düğme, özel şemalı bir bağlantı ve sıradan bir web bağlantısı.

## Dokunulan bir push'u yönlendirin \\

Her push bir `data.type` alanı taşır. Uygulama dokunmaları dinler, türü okur ve eşleşen ekranı açar.

```typescript app/_layout.tsx theme={null}
OneSignal.Notifications.addEventListener('click', (event: NotificationClickEvent) => {
  const data = event.notification.additionalData as Record<string, string> | undefined;
  if (!data?.type) return;

  // Mark inbox message as read (best-effort, fire-and-forget)
  const notificationId = event.notification.notificationId;
  if (notificationId) {
    supabase
      .from('inbox_messages')
      .update({ read: true })
      .eq('onesignal_message_id', notificationId)
      .then();
  }

  // Small delay to let the app finish initialising if cold-launched
  setTimeout(() => {
    // A tap on an action button ("Snooze 1h", "Send kudos", ...) carries an
    // actionId. A tap on the notification itself does not.
    const action = handlePushAction(event.result.actionId, data);
    if (action.handled) {
      if (action.route) router.push(action.route as any);
      return;
    }

    switch (data.type) {
      case 'daily_digest':
      case 'upcoming_cleaning':
      case 'overdue_reminder':
      case 'reengagement':
        router.push('/(tabs)/clean');
        break;
      case 'session_completed':
      case 'kudos':
        router.push('/activity');
        break;
      case 'join_approved':
      case 'member_lapsed':
        router.push('/household');
        break;
      default:
        break;
    }
  }, 500);
});
```

| `data.type` | Açtığı yer |
| - | - |
| `daily_digest`, `overdue_reminder`, `upcoming_cleaning` | Clean sekmesi |
| `session_completed`, `kudos` | Etkinlik akışı |
| `join_approved`, `member_lapsed` | Hane ekranı |
| `reengagement` | Clean sekmesi |

Bu türlerden ikisi, bu kılavuzun ele almadığı Journeys'ten gelir. `reengagement`, kontrol panelinde oluşturulan bir geri kazanma Journey'sinin push'larında ayarlanır. `member_lapsed`, hanenin sahiplerine ve yöneticilerine gönderilen bir push'tur ve bu Journey bir üyenin temizlik yapmayı bıraktığını bildirdiğinde backend tarafından gönderilir. Bunlar da diğer push'lar gibi burada yönlendirilir.

> [!TIP]
>
> Kontrol ettiğiniz bir türe göre yönlendirmek, bir URL'yi ayrıştırmaktan daha sağlamdır. Bir ekran taşınırsa tek bir `switch` ifadesini değiştirirsiniz ve değişiklikten önce gönderilen her push doğru şekilde açılmaya devam eder.

## Eylem düğmeleri: dokunulacak birden fazla şey \\

Bir push düğmeler taşıyabilir. Görev push'ları **Start cleaning** ve **Snooze 1h** sunar, "ev arkadaşı temizliği bitirdi" push'u ise **Send kudos** sunar. Kişiler düğmeleri bildirimi genişleterek görür. iOS'ta bu, uzun basmaktır.

![Start cleaning ve Snooze 1h düğmeleri olan genişletilmiş bir push bildirimi](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-action-buttons.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=0a850d439deea8f483c8dfe532fb8e93)

İki eylem düğmesiyle genişletilmiş bir hatırlatıcı.

Backend düğmeleri isteğe ekler. Her birinin bir `id` değeri ve bir etiketi vardır.

```typescript supabase/functions/_shared/buttons.ts theme={null}
export const TASK_BUTTONS = [
  { id: ACTION_START_CLEANING, text: 'Start cleaning' },
  { id: ACTION_SNOOZE, text: 'Snooze 1h' },
];
```

Bir düğmeye dokunmak uygulamayı açar ve yukarıda gösterilen tıklama dinleyicisi düğmenin `id` değerini `event.result.actionId` olarak alır. Bildirimin kendisine dokunulduğunda `actionId` olmaz. Uygulama önce bir düğme olup olmadığını kontrol eder ve yoksa normal yönlendirmeye geçer.

```typescript src/lib/pushActions.ts theme={null}
export function handlePushAction(actionId: string | undefined, data: PushData): ActionOutcome {
  if (!actionId) return { handled: false };

  // Record which button was tapped. As a custom event it can branch a
  // Journey (Wait Until this event) or feed a Conversion Metric.
  OneSignal.User.trackEvent('push_action_clicked', {
    action_id: actionId,
    notification_type: data?.type ?? 'unknown',
  });

  switch (actionId) {
    case ACTION_START_CLEANING:
      return { handled: true, route: '/(tabs)/clean' };

    case ACTION_SNOOZE:
      snoozeReminder();
      return { handled: true, route: null };

    case ACTION_SEND_KUDOS:
      sendKudosFromPush(data);
      return { handled: true, route: '/activity' };

    default:
      return { handled: false };
  }
}
```

**Erteleme** backend'e ihtiyaç duyar, çünkü uygulama push gönderemez. Uygulama, `send_after` ile başka bir hatırlatıcı zamanlayan bir fonksiyonu çağırır. OneSignal mesajı o zamana kadar bekletir, bu yüzden hiçbir şeyin bir saat boyunca çalışmaya devam etmesi gerekmez.

```typescript supabase/functions/snooze-reminder/index.ts theme={null}
const sendAt = new Date(Date.now() + SNOOZE_MINUTES * 60_000);

const onesignalPayload = {
  app_id: ONESIGNAL_APP_ID,
  include_aliases: { external_id: [user.id] },
  target_channel: 'push',
  // OneSignal holds the message and delivers it at this time
  send_after: sendAt.toISOString(),
  // ...
};
```

> [!NOTE]
>
> Her düğme dokunuşu ayrıca `push_action_clicked` adlı özel bir olay olarak kaydedilir. Bir Journey doğrudan bir düğmeye göre dallanamaz, ancak bu olayı bekleyebilir ve `action_id` özelliğine göre dallanabilir.

> [!NOTE]
>
> Bir düğmeye dokunmak varsayılan olarak uygulamayı açar. Bir dokunmayı uygulamayı açmadan işlemek yerel kod gerektirir: iOS'ta bir bildirim kategorisi, Android'de bir notification service extension.

## Gelen bağlantıları yeniden yazın \\

Uygulamanın dışından gelen bağlantılar `/clean` gibi kısa yollar kullanır. Expo Router'ın native intent kancası, gezinme gerçekleşmeden önce bunları uygulamanın gerçek rotalarına yeniden yazar. Böylece uygulamanın dışındaki hiçbir şeyin ekranların nasıl düzenlendiğini bilmesi gerekmez.

```typescript app/+native-intent.tsx theme={null}
const PATH_REWRITES: Record<string, string> = {
  // Tab screens — simplified path → grouped route
  '/clean': '/(tabs)/clean',
  '/tasks': '/(tabs)/tasks',
  '/rota': '/(tabs)/rota',
  '/settings': '/(tabs)/settings',
  '/dashboard': '/(tabs)',

  // Standalone screens
  '/streaks': '/streaks',
  '/activity': '/activity',

  // Convenience aliases
  '/join': '/join-household',
  '/notifications': '/notification-settings',
};

export function redirectSystemPath({
  path,
  initial,
}: {
  path: string;
  initial: boolean;
}): string {
  try {
    // Parse the incoming URL to extract path and query string
    const url = new URL(path, 'cleaning-rota://app');
    const pathname = url.pathname || '/';
    const search = url.search || '';

    // Check for a rewrite match (exact path without query string)
    const rewritten = PATH_REWRITES[pathname];
    if (rewritten) {
      return rewritten + search;
    }

    // Universal Link / App Link with no rewrite: hand the router just the
    // path, not the full https URL
    if (url.protocol === 'https:' || url.protocol === 'http:') {
      return pathname + search;
    }

    // No rewrite needed — pass through as-is
    return path;
  } catch {
    // Never crash in this function — fall back to home screen
    return '/(tabs)';
  }
}
```

## Uygulamayı sıradan web bağlantılarından açın \\

`cleaning-rota://` gibi özel bir şema yalnızca uygulama yüklüyse çalışır ve birçok uygulama onu dokunulabilir yapmayı reddeder. iOS'taki Universal Links ve Android'deki App Links bu sorunu çözer. Bunlar, uygulama yüklüyse uygulamayı, değilse web sitesini açan normal `https://` bağlantılarıdır. Bu da onları e-postalardaki, SMS'lerdeki ve paylaşılan mesajlardaki bağlantılar için doğru seçim yapar.

Bunları kurmak her iki tarafta da bir bildirim gerektirir: uygulama hangi alan adına ait olduğunu söyler, web sitesi de bağlantılarını hangi uygulamanın açabileceğini söyler.

**1. Alan adını uygulamada bildirin**

```json app.json theme={null}
{
  "expo": {
    "ios": {
      "associatedDomains": ["applinks:cleanbeansapp.com"]
    },
    "android": {
      "intentFilters": [
        {
          "action": "VIEW",
          "autoVerify": true,
          "data": [
            { "scheme": "https", "host": "cleanbeansapp.com", "pathPrefix": "/join" },
            { "scheme": "https", "host": "cleanbeansapp.com", "pathPrefix": "/clean" }
          ],
          "category": ["BROWSABLE", "DEFAULT"]
        }
      ]
    }
  }
}
```

**2. Apple ilişkilendirme dosyasını yayınlayın**

Dosyayı `/.well-known/apple-app-site-association` konumunda, HTTPS üzerinden ve JSON olarak sunun. Uygulama kimliği, Apple Team ID'nizin ardından gelen bundle identifier'dır.

```json website/.well-known/apple-app-site-association theme={null}
{
  "applinks": {
    "details": [
      {
        "appIDs": ["YOUR_TEAM_ID.com.onesignal.cleaningapp"],
        "components": [
          { "/": "/join", "comment": "Opens /join in the Clean Beans app" },
          { "/": "/clean", "comment": "Opens /clean in the Clean Beans app" }
        ]
      }
    ]
  }
}
```

**3. Android ilişkilendirme dosyasını yayınlayın**

Dosyayı `/.well-known/assetlinks.json` konumunda barındırın. Parmak izi, uygulamanızın imzalama sertifikasından gelir. EAS ile bulmak için `eas credentials -p android` komutunu çalıştırın.

```json website/.well-known/assetlinks.json theme={null}
[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.onesignal.cleaningapp",
      "sha256_cert_fingerprints": ["YOUR_SHA256_FINGERPRINT"]
    }
  }
]
```

**4. Bağlantıyı kullanın**

Hane ekranı bir davet bağlantısı paylaşır. Bağlantıya dokunmak, kodu önceden doldurulmuş olarak katılma ekranını açar.

```typescript app/household.tsx theme={null}
message: `Join my household "${activeHousehold.name}" on Clean Beans! Tap https://cleanbeansapp.com/join?code=${encodeURIComponent(activeHousehold.inviteCode)} or use invite code: ${activeHousehold.inviteCode}`,
```

```typescript app/join-household.tsx theme={null}
const params = useLocalSearchParams<{ code?: string }>();
const [code, setCode] = useState(typeof params.code === 'string' ? params.code : '');
```

> [!NOTE]
>
> Clean Beans yalnızca uygulamanın gösterebileceği yolları sahiplenir. Ana sayfa bunun dışında bırakılır, bu yüzden pazarlama sitesi tarayıcıda açılmaya devam eder. iOS ilişkilendirme dosyasını uygulama yüklendiğinde veya güncellendiğinde okur, bu yüzden derlemeyi yayınlamadan önce dosyayı yayınlayın.

> [card] [Derin bağlantı](https://documentation.onesignal.com/docs/tr/deep-linking.md)
>
> OneSignal'ın her platformda URL'leri nasıl işlediği.

> [card] [Bildirim yükü](https://documentation.onesignal.com/docs/tr/osnotification-payload.md)
>
> Tıklama dinleyicisinde kullanılabilen her alan.

> [card] [Eylem düğmeleri](https://documentation.onesignal.com/docs/tr/action-buttons.md)
>
> Platform sınırları, simgeler ve dokunmaları işleme.


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