> ## 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.

# URL'ler, bağlantılar ve derin bağlantılar

> Push, e-posta, uygulama içi, SMS ve RCS mesajlarında başlatma URL'leri, derin bağlantılar, dinamik URL'ler, UTM takibi ve tıklama takibini ayarlayın.

## Bağlantılar nasıl çalışır

Her OneSignal mesajı — push, e-posta, uygulama içi, SMS veya RCS — tıklandığında Kullanıcıyı bir hedefe götüren bir URL içerebilir. Bu hedef, tarayıcıda açılan bir web sayfası veya doğrudan uygulamanızda açılan bir [derin bağlantı](#deep-links) olabilir.

URL'yi ayarlama şekliniz kanala göre değişir:

* **Push**: Panodaki **Launch URL** alanını veya API'deki `url` parametresini kullanın.
* **E-posta**: E-posta düzenleyicisini veya HTML'yi kullanarak bağlantı ekleyin. OneSignal tıklamaları otomatik olarak izler.
* **Uygulama içi**: Düğmeler, resimler veya arka planlar üzerindeki [Tıklama İşlemleri](./iam-click-actions)'ni yapılandırın.
* **SMS/RCS**: Bağlantıları satır içine ekleyin. Otomatik kısaltma ve takip için panodaki **Insert Trackable Link** seçeneğini kullanın. Bkz. [SMS/RCS izlenebilir bağlantılar](#sms%2Frcs-trackable-links).

### Derin bağlantılar

Tarayıcı yerine uygulamanızdaki içeriği açmak için derin bağlantı kullanın. Derin bağlantı desteği kanala göre değişir:

* **Push ve uygulama içi**: `your-app://product/123` gibi özel URL şemalarını ve `https://` evrensel bağlantılarını / App Links'i destekler.
* **E-posta ve SMS**: Yalnızca `https://` evrensel bağlantıları / App Links desteklenir. E-posta istemcileri ve SMS uygulamaları bunları işleyemediğinden özel URL şemaları çalışmaz.

<Card title="Deep Linking" icon="link" href="./deep-linking">
  Özel URL şemaları, evrensel bağlantılar ve uygulamaya özgü yönlendirme için tam kurulum kılavuzu.
</Card>

### Push

#### Launch URL

Launch URL, Kullanıcı bir push bildirimine tıkladığında açılır. `https://` ile başlamalıdır.

<Info>
  Apple cihazlarında `http://` URL'leri kullanmak için uygulamanızın `Info.plist` dosyasında [NSAppTransportSecurity](https://developer.apple.com/documentation/bundleresources/information_property_list/nsapptransportsecurity) özelliğini yapılandırmanız gerekir.
</Info>

Hem web hem de mobil Kullanıcılara tek bir mesaj gönderiyorsanız platforma özgü URL alanlarını kullanın:

* `url` — tüm platformları hedefler
* `web_url` — yalnızca web push Aboneliklerini hedefler
* `app_url` — yalnızca mobil Abonelikleri hedefler

<Frame caption="OneSignal panosundaki Launch URL alanı">
  <img src="https://mintcdn.com/onesignal/KudGm9GSZy-rIRO3/images/dashboard/push-launch-url.png?fit=max&auto=format&n=KudGm9GSZy-rIRO3&q=85&s=5b5687b99e1bc2ab8c3afd9e1780c1a5" alt="Push bildirimleri için Launch URL giriş alanını gösteren OneSignal panosu" width="1066" height="440" data-path="images/dashboard/push-launch-url.png" />
</Frame>

<Tip>
  Herhangi bir sayfa açmadan web push bildirimini kapatmak için başlatma URL'sine `?_osp=do_not_open` ekleyin; örn. `https://yoursite.com/page?_osp=do_not_open`. Bu yalnızca web push için geçerlidir.
</Tip>

#### Additional data

Launch URL yerine **Additional Data** alanını (`data` API'de) kullanarak özel anahtar-değer çiftleri gönderebilirsiniz. Uygulamanız bu verileri `additionalData` özelliği aracılığıyla [SDK'nın Bildirim Tıklama Dinleyicisi](./mobile-sdk-reference#push-notification-events) üzerinden okur — tek bir URL'den daha fazla esnekliğe ihtiyaç duyduğunuzda kullanışlıdır.

<Frame caption="Uygulamanızın işlemesi için Additional Data alanı aracılığıyla URL gönderin">
  <img src="https://mintcdn.com/onesignal/KudGm9GSZy-rIRO3/images/dashboard/push-additional-data.png?fit=max&auto=format&n=KudGm9GSZy-rIRO3&q=85&s=9c00048fd23586de1e3e70a82fcd1db7" alt="Özel anahtar-değer çiftiyle Additional Data alanını gösteren OneSignal panosu" width="1034" height="378" data-path="images/dashboard/push-additional-data.png" />
</Frame>

### Email link tracking

OneSignal, **Track link clicks** etkin olduğunda (varsayılan olarak açık) e-postalardaki bağlantı tıklamalarını otomatik olarak izler. OneSignal, e-posta başına ve her bağlantı başına toplam ve benzersiz tıklamaları izler (e-posta başına en fazla 30 bağlantı). Bu istatistikleri [E-posta Mesaj Raporları](./email-message-reports)'nda görüntüleyin.

<Note>
  Abonelikten çıkma bağlantıları için bkz. [Abonelikten Çıkma Bağlantıları ve E-posta Abonelikleri](./unsubscribe-links-email-subscriptions).
</Note>

<Frame caption="Bağlantı başına takip istatistiklerini gösteren Click Activity tablosu">
  <img src="https://mintcdn.com/onesignal/3PUtCumasMeFG2p0/images/docs/link_tracking.png?fit=max&auto=format&n=3PUtCumasMeFG2p0&q=85&s=318dab483003dac8e1203ab75b5c2756" alt="Bağlantı başına toplam ve benzersiz tıklama sayılarını içeren tıklama etkinliğini gösteren OneSignal e-posta mesaj raporu" width="957" height="312" data-path="images/docs/link_tracking.png" />
</Frame>

<Accordion title="E-posta tıklama takibi URL'leri nasıl yeniden yazar">
  Takip, tıklama olayını yakalamak için URL'leri yeniden yazarak çalışır, ardından Kullanıcıyı orijinal hedefe yönlendirir. Bu neredeyse anında gerçekleşir ancak [derin bağlantılar](./deep-linking) ile beklenmeyen davranışlara neden olabilir. Örneğin:

  `https://some-domain.com/the-page`

  şuna benzer bir şeye dönüşür:

  `https://some-domain/c/eJxU0D2uGzEMBODTrDoZJPW3...`

  Kullanıcı hemen hedeflenen URL'ye yönlendirilir.
</Accordion>

Bağlantıları Liquid sözdizimi ile oluşturuyorsanız OneSignal bunları otomatik olarak algılamayabilir. Bir bağlantıyı izlenebilir olarak açıkça işaretleyin:

```liquid theme={null}
{{ 'https://some-domain.com/the-page' | track_link }}
```

Tüm e-posta için takibi devre dışı bırakmak üzere pano e-posta düzenleyicisinde **Track link clicks** seçeneğinin işaretini kaldırın ya da API'de `disable_email_click_tracking: true` olarak ayarlayın.

<Frame caption="Takibi devre dışı bırakmak için Track link clicks onay kutusu işaretsiz">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/onesignal/images/docs/8d3292a5cb0b24a4b5bc8f9ae1074f513c3fed310045a6b6c534b94e344a401b-Screenshot_2025-02-14_at_11.50.38_AM.png" alt="Track link clicks seçeneği işaretsiz olan OneSignal panosu e-posta ayarları" />
</Frame>

Geri kalan bağlantılarda takip etkin kalırken belirli bir bağlantı için devre dışı bırakmak üzere, bağlantının çapa etiketine `disable-tracking=true` özniteliğini ekleyin:

```html theme={null}
<a href="https://some-domain.com/the-page" disable-tracking=true>Sayfayı görüntüle</a>
```

<Warning>
  Tüm e-posta için takibi devre dışı bırakmak, hiçbir tıklama verisinin toplanmayacağı anlamına gelir — CTR, [E-posta Mesaj Raporları](./email-message-reports)'nda "N/A" olarak görünür.
</Warning>

### SMS/RCS trackable links

OneSignal, `1sgnl.co` etki alanını kullanan SMS/RCS mesajları için izlenebilir kısaltılmış bağlantılar sağlar. URL'nizi `{{ "https://your-url.com" | track_link }}` içine sarmanız yeterlidir; mesaj gönderildiğinde bağlantı izlenebilir bir bağlantıyla değiştirilir. API kullanımı için bkz. [SMS/RCS mesaj oluşturma API referansı](/reference/sms).

SMS/RCS mesajı başına yalnızca 1 izlenebilir bağlantıya izin verilir.

Panoyu kullanırken mesaj giriş kutusunun altındaki **Insert Trackable Link** düğmesine tıklayıp URL'nizi girebilirsiniz:

<Frame caption="İzlenebilir SMS bağlantısı girmek için modal">
  <img src="https://mintcdn.com/onesignal/bUViEhbP9-TaIZwH/images/docs/trackable_sms_1.png?fit=max&auto=format&n=bUViEhbP9-TaIZwH&q=85&s=c1cd72dbf1cd7e3be05460bd4958ecff" alt="SMS mesajına izlenebilir kısaltılmış bağlantı eklemek için OneSignal panosu modali" width="2570" height="1232" data-path="images/docs/trackable_sms_1.png" />
</Frame>

Kısa bağlantıyı mesajınıza eklemek için **Insert trackable link** düğmesine tıklayın:

```liquid theme={null}
Your order is on its way!
Track it here: {{ "https://your-url.com" | track_link }}
```

Mesaj gönderildiğinde çift süslü parantezler ve içindeki her şey izlenebilir bir `1sgnl.co/XXXX` bağlantısıyla değiştirilir:

<Frame caption="Bir cihazda göründüğü gibi izlenebilir bağlantı">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/trackable_sms_3.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=627e22caedd413d193a403aef6070b68" alt="İzlenebilir kısaltılmış bağlantı gösteren mobil cihazda SMS bildirimi" width="1242" height="1044" data-path="images/docs/trackable_sms_3.png" />
</Frame>

***

## Dinamik URL'ler

[Liquid sözdizimi](./using-liquid-syntax) ile kişiselleştirilmiş, kullanıcıya özgü URL'ler oluşturabilirsiniz. Örneğin, her kişinin kendi profil sayfasına gitmesi için URL'ye Kullanıcı kimliği ekleyin ya da doğrudan ilgili bir öğeye bağlantı vermek için son bir etkinlikten ürün kimliği ekleyin.

Dinamik URL'ler şu kaynaklardan veri çekebilir:

* Kullanıcı özellikleri (örn. `external_id`, `email`)
* OneSignal'de saklanan Etiketler
* API aracılığıyla gönderilen `custom_data`
* Özel Etkinlikler (Yolculuklarda)

<Tabs>
  <Tab title="User properties">
    `external_id` veya `email` gibi değerleri doğrudan URL'lere ekleyin.

    ```text theme={null}
    https://yourdomain.com/profile/user={{subscription.external_id}}
    ```

    Kullanıcının `external_id`'si `12345` ise son URL şöyle olur:

    ```text theme={null}
    https://yourdomain.com/profile/user=12345
    ```

    Benzer şekilde:

    ```text theme={null}
    https://yourdomain.com/profile/email={{subscription.email}}
    ```

    Kullanıcının e-postası `john@example.com` ise son URL şöyle olur:

    ```text theme={null}
    https://yourdomain.com/profile/email=john@example.com
    ```
  </Tab>

  <Tab title="Tags">
    OneSignal'de saklanan kullanıcı etiketlerine referans verin.

    ```text theme={null}
    https://yourdomain.com/topic/{{tag_key}}
    ```

    Kullanıcının `technology` değerine sahip bir `tag_key` etiketi varsa son URL şöyle olur:

    ```text theme={null}
    https://yourdomain.com/topic/technology
    ```

    `tag_key` ayarlanmamışsa URL şöyle olur:

    ```text theme={null}
    https://yourdomain.com/topic/
    ```

    Varsayılan bir geri dönüş değeri ayarlamak için `default` filtresini kullanın:

    ```text theme={null}
    https://yourdomain.com/topic/{{tag_key | default: 'unknown'}}
    ```
  </Tab>

  <Tab title="custom_data">
    Şablonlar ile Mesaj Oluşturma API'sini kullanın. `custom_data` nesnesine referans veren Liquid sözdizimi ile şablondaki URL'yi ayarlayın.

    Şablon URL'si:

    ```text theme={null}
    https://yourdomain.com/invoice={{message.custom_data.invoice_number}}
    ```

    `custom_data` ile API isteği:

    ```json theme={null}
    {
        "template_id": "YOUR_TEMPLATE_ID",
        "custom_data": {
            "invoice_number": "12345"
        }
    }
    ```

    Son URL:

    ```text theme={null}
    https://yourdomain.com/invoice=12345
    ```
  </Tab>

  <Tab title="Custom Events">
    Yolculuklarda yakalanan Özel Etkinlikleri kullanarak URL'leri kişiselleştirin. Etkinlik özelliklerine doğrudan referans verin veya daha temiz sözdizimi için etkinliği bir değişkene atayın.

    **Etkinlik özelliklerine doğrudan referans verme:**

    ```text theme={null}
    https://yourdomain.com/order/{{ journey.event.purchase.properties.order_id }}
    ```

    En son `purchase` etkinliği `"order_id": "98765"` içeriyorsa son URL şöyle olur:

    ```text theme={null}
    https://yourdomain.com/order/98765
    ```

    **Okunabilirlik için etkinliği atama:**

    ```liquid theme={null}
    {% assign event = journey.event.purchase %}
    https://yourdomain.com/order/{{ event.properties.order_id }}
    ```

    **En son saklanan etkinliğe erişim:**

    ```text theme={null}
    https://yourdomain.com/product/{{ journey.last_event.properties.product_id | default: 'unknown' }}
    ```

    **Boşluk veya özel karakter içeren etkinlik adları (hash gösterimi):**

    ```text theme={null}
    https://yourdomain.com/status/{{ journey.event["order status"].properties.current_status }}
    ```

    <Note>
      Özel Etkinlikler yalnızca Yolculuklarda kullanılan Şablonlarda referans alınabilir. Liquid'de etkinlik verilerine erişmek için `journey.first_event`, `journey.last_event` veya `journey.event.<name>` kullanın.
    </Note>
  </Tab>
</Tabs>

<Tip>
  Yalnızca URL'nin belirli bölümlerine veri ekleyin — protokolü (`https://`) ve etki alanını statik metin olarak koruyun. Bir değer mevcut değilse geri dönüş ayarlamak için `default` filtresini kullanın.
</Tip>

***

## UTM parametreleri

UTM parametreleri, URL'lere `source`, `medium` ve `campaign` ayrıntıları ekleyerek kampanya performansını izler. UTM parametrelerini doğrudan mesajlarınızdaki URL'lere ekleyin.

Panodan gönderilen push bildirimleri için OneSignal UTM'leri otomatik olarak ekleyebilir.

<Accordion title="Push bildirimleri için otomatik UTM'ler" icon="circle-chevron-down">
  **Settings > Push & In-app > UTM Settings**'e gidin ve **Turn on automated UTM tagging** seçeneğini etkinleştirin.

  Etkinleştirildikten sonra OneSignal şu değerleri (düzenlenebilir) ekler:

  * **Source** = `utm_source` — varsayılan olarak `onesignal`
  * **Medium** = `utm_medium` — varsayılan olarak `push`
  * **Campaign** = `utm_campaign` — varsayılan olarak `{{ sendDate }}-{{ title }}`
    * `sendDate`: Gönderilme tarihi
    * `title`: Mesaj başlığından ilk 15 alfanümerik karakter, alt çizgi veya tire

  Örnek:

  ```text theme={null}
  https://test.com?utm_source=onesignal&utm_medium=push&utm_campaign=2020-06-03-sale-today
  ```

  <Warning>
    Otomatik UTM etiketleme yalnızca panodan gönderilen push bildirimleri için geçerlidir. Şunlarla çalışmaz:

    * E-postalar, SMS veya uygulama içi mesajlar
    * Yolculuklar, Şablonlar veya otomatik mesajlar
    * API istekleri
    * "Test Mesajı Gönder" düğmesi
    * Ek veri alanları

    Bu durumlar için şablonlarınıza veya API yüklerinize UTM parametrelerini manuel olarak ekleyin.
  </Warning>

  #### URL işleme ve geçersiz kılmalar

  Otomatik etiketleme etkinken bir başlatma URL'sine manuel olarak UTM parametreleri eklerseniz, manuel UTM'leriniz otomatik değerleri geçersiz kılar.
</Accordion>

***

## SSS

### Uygulama mağazasına nasıl bağlantı veririm?

Mağaza URL'sini başlatma URL'si olarak kullanın:

* **Android**: Google Play bağlantısını kullanın, örn. `https://play.google.com/store/apps/details?id=com.example.app`. Bkz. [Google Play'e Bağlantı Verme](https://developer.android.com/distribute/marketing-tools/linking-to-google-play.html).
* **iOS**: App Store bağlantısını kullanın ancak App Store uygulamasını doğrudan açmak için `https://` yerine `itms-apps://` kullanın, örn. `itms-apps://apps.apple.com/app/id123456789`.

### Başka bir uygulamaya bağlantı verebilir miyim?

Push ve uygulama içi mesajlar için başka bir uygulamaya derin bağlantı vermek amacıyla URL şeması kullanabilirsiniz. Örneğin, [WhatsApp'a derin bağlantı](https://faq.whatsapp.com/425247423114725) vermek için: `whatsapp://wa.me/15551234567`.

E-posta ve SMS için özel URL şemaları desteklenmediğinden bunun yerine `https://` bağlantıları kullanın.

### Başlatma URL'im neden çalışmıyor?

Yaygın nedenler:

* **URL uyuşmazlığı**: URL `https://` ile başlamalıdır. Apple cihazlarında `http://` kullanıyorsanız [NSAppTransportSecurity](https://developer.apple.com/documentation/bundleresources/information_property_list/nsapptransportsecurity) yapılandırmanız gerekir.
* **Mobilde özel şemalar**: `your-app://path` gibi derin bağlantılar tüm platformlarda başlatma URL'si olarak çalışmayabilir. Güvenilir uygulama yönlendirmesi için **Additional Data** alanını veya [Derin Bağlantı](./deep-linking) sayfasını kullanın.
* **Web push varsayılanı**: Başlatma URL'si ayarlanmazsa web push ana sayfanızı açar. Hedefi kontrol etmek için bir başlatma URL'si açıkça belirtin.
* **Tıklama takibi müdahalesi**: E-postada tıklama takibi için URL yeniden yazma işlemi derin bağlantıları bozabilir. O bağlantı için [tıklama takibini devre dışı bırakmayı](#email-link-tracking) deneyin.

### UTM parametreleri e-posta ve SMS'te çalışır mı?

Hayır. Otomatik UTM etiketleme yalnızca panodan gönderilen push bildirimleri için geçerlidir. E-posta ve SMS için URL'lere şablonlarınızda veya API yüklerinizde UTM parametrelerini manuel olarak ekleyin. Sınırlamaların tam listesi için bkz. [UTM parametreleri](#utm-parameters).

### Push bildiriminin URL açmasını engelleyebilir miyim?

Mobilde, push bildirimine tıklamak her zaman uygulamayı açar.

Web'de, başlatma URL'sine `?_osp=do_not_open` ekleyerek herhangi bir sayfa açmadan bildirimi kapatabilirsiniz. Örnek için [Launch URL ipucuna](#launch-url) bakın.

***

<Columns cols={2}>
  <Card title="Deep Linking" icon="link" href="./deep-linking">
    Push ve uygulama içi mesajlar için özel URL şemaları ve uygulamaya özgü yönlendirme kurulumu.
  </Card>

  <Card title="Personalization" icon="wand-magic-sparkles" href="./message-personalization">
    Liquid sözdizimi ve etiketler kullanarak mesajlara dinamik kullanıcı verisi ekleyin.
  </Card>

  <Card title="Using Liquid syntax" icon="code" href="./using-liquid-syntax">
    OneSignal şablonlarındaki Liquid filtreler, etiketler ve değişkenler için referans kılavuzu.
  </Card>

  <Card title="Email message reports" icon="chart-line" href="./email-message-reports">
    E-posta kampanyaları için teslim, açılma ve tıklama oranı metriklerini görüntüleyin.
  </Card>

  <Card title="Action buttons" icon="hand-pointer" href="./action-buttons">
    Özel URL'ler içeren push bildirimlerine harekete geçirici mesaj düğmeleri ekleyin.
  </Card>
</Columns>