# Gizli alanlar

URL parametreleri aracılığıyla formlara görünmez veri ekleyin.

## Gizli alanlar

Her gönderime trafik kaynakları, CRM kimlikleri, yönlendirme kodları veya yanıtlayan hakkında önceden bildiğiniz herhangi bir bağlamı görünmez meta veri olarak ekleyin. Gizli alanlar, formda hiçbir şey göstermeden URL parametreleri aracılığıyla veri yakalar.

<h2 id="why">Neden gizli alan kullanılır?</h2>

<p>
  Formlar çoğu zaman yanıtlayanın sağlayamayacağı (ya da sağlamaması gereken) bağlam bilgisine ihtiyaç duyar. Gizli alanlar, URL üzerinden
  her gönderime meta veri eklemenizi sağlayarak bu sorunu çözer. Yanıtlayan formu açmadan önce hakkında bir şeyler bildiğinizde — nereden
  geldiği, kimin yönlendirdiği veya sisteminizdeki hangi kayda ait olduğu gibi — bu özellik işe yarar.
</p>

<ul>
  <li>
    <strong>Trafik kaynaklarını takip edin</strong> — bir gönderimin e-posta kampanyasından mı, sosyal medya gönderisinden mi yoksa web
    sitenizden mi geldiğini öğrenin
  </li>
  <li>
    <strong>CRM’inize bağlanın</strong> — gönderimin doğru kayda bağlanması için bir kişi kimliği, fırsat kimliği veya hesap kimliği iletin
  </li>
  <li>
    <strong>Takip mesajlarını kişiselleştirin</strong> — zaten sahip olduğunuz bir ad veya e-postayı yakalayın, ardından koşullu mantıkta
    veya e-posta bildirimlerinde kullanın
  </li>
  <li>
    <strong>Çoklu form süreçleri</strong> — bir formdaki veriyi bir sonrakine aktararak yanıtlayanların aynı bilgiyi tekrar girmesini
    önleyin
  </li>
  <li>
    <strong>A/B testi</strong> — her gönderiyi yanıtlayanın gördüğü varyant veya deney ile etiketleyin
  </li>
</ul>

<h2 id="adding">Gizli alan ekleme</h2>

<p>
  Boş bir satırda <code>/</code> yazın ve Düzen kategorisinden <strong>Gizli Alan</strong>’ı seçin. Yalnızca formun en üst düzeyinde çalışır
  — bir sütun veya yinelenen grup içinde çalışmaz. Her gizli alanın iki ayarı vardır:
</p>

<ul>
  <li>
    <strong>Alan türü</strong> — bir <strong>sayı</strong> veya <strong>metin</strong> değeri saklayın (varsayılan olarak metin)
  </li>
  <li>
    <strong>Parametre adı</strong> — bu alanı dolduracak URL parametresi (örn. <code>utm_source</code>, <code>contact_id</code>). Bu, aynı
    zamanda bu alanın anahtarıdır; yani bir çağıranın gönderdiği ve yanıtın altında geri geldiği isim budur. Bkz.{' '}
    <a href="/tr/requests/field-keys">Alan anahtarları</a>
  </li>
</ul>

<h2 id="url-parameters">URL parametresiyle ön doldurma</h2>

<p>
  Bir parametre adı, yazıldığı haliyle URL-güvenli olmalıdır: harfler, rakamlar ve <code>- _ . ~ ! * ' ( )</code> güvenlidir. Boşlukları ve
  diğer özel karakterleri percent-encoded olarak yazın, örneğin <code>recipient%20name</code>. Boş, geçersiz veya yinelenen bir parametre
  adı bir yayınlama hatasıdır — araç çubuğundaki sorun göstergesi bunu işaretler ve siz düzeltene kadar yayınlama durur.
</p>

<p>
  Bir yanıtlayan formunuzu URL’de eşleşen bir parametre ile açtığında, gizli alan o değeri otomatik olarak yakalar. Örneğin, gizli
  alanınızın parametre adı <strong>utm_source</strong> ise aşağıdaki URL alanı <strong>newsletter</strong> olarak ayarlar.
</p>

```
https://form.formstep.io/abc123?utm_source=newsletter
```

<p>Birden fazla gizli alanı aynı anda iletebilirsiniz:</p>

```
https://form.formstep.io/abc123?utm_source=newsletter&utm_medium=email&contact_id=12345
```

<ul>
  <li>Değerler yalnızca bir kez, form açıldığında okunur.</li>
  <li>
    Boş bir parametre (<code>?utm_source=</code>) alanı boş bırakır.
  </li>
  <li>
    Sayısal bir gizli alan, sayı olmayan değerleri yok sayar, bu yüzden <code>?score=abc</code> alanı boş bırakır.
  </li>
  <li>
    <a href="/tr/requests/overview">Request</a> bağlantıları URL parametrelerini yok sayar. Buradaki gizli alanlar değerlerini isteğin{' '}
    <a href="/tr/requests/creating-requests#context">context</a>'inden alır.
  </li>
</ul>

<p>
  Bir paylaşım bağlantısında, yanıtlayanın düzenleyebileceği görünür bir alanda bir URL değerini göstermek için — örneğin adını önceden
  doldurmak için — gizli alanı <kbd>@</kbd> yazarak alanın varsayılan değeri yapın. Bkz.{' '}
  <a href="/tr/building-forms/field-configuration#default-values">Alan ayarları → Varsayılan değerler</a>.
</p>

<h2 id="requests-prefill-directly">İstekler önceden doldurmak için gizli alana ihtiyaç duymaz</h2>

<p>
  Yukarıdaki gizli alan + <kbd>@</kbd> tekniğinin nedeni, bir paylaşım bağlantısının içeri girmek için tek bir yola sahip olmasıdır: URL.
  Herkes bir URL'yi düzenleyebilir, bu yüzden bir paylaşım bağlantısı bir değeri yalnızca bir parametre aracılığıyla taşıyabilir ve bunu
  alan şey de bir gizli alandır.
</p>

<p>
  Bir <a href="/tr/requests/overview">isteğin</a> ikinci, özel bir içeri giriş yolu daha vardır. Çağıran, isteği oluştururken yanıtları
  sunucu tarafında belirler; bu yüzden bir istek <strong>görünür bir soruyu doğrudan</strong> önceden doldurabilir — buna ne bir gizli alan
  ne de bir <kbd>@</kbd> varsayılanı karışır. Alıcı formu açtığında, yanıt zaten kutuda hazır olur.
</p>

<ul>
  <li>
    <strong>
      <code>prefill</code>
    </strong>{' '}
    — alan anahtarıyla adreslenen, <strong>görünür sorular</strong> için başlangıç yanıtları. Alıcı bunları görür ve değiştirebilir.
  </li>
  <li>
    <strong>
      <code>readonly</code>
    </strong>{' '}
    — önceden doldurulmuş bu anahtarların, alıcının okuyabilip değiştiremeyeceği alt kümesi.
  </li>
  <li>
    <strong>
      <code>context</code>
    </strong>{' '}
    — alıcının hiçbir zaman görmediği, <strong>gizli alanlar</strong> için değerler.
  </li>
</ul>

<p>
  Bu ayrım zorunlu kılınır: görünür bir sorunun anahtarını <code>context</code> içinde göndermek{' '}
  <em>
    "bu görünür bir soru, gizli alan değil — bunun yerine <code>prefill</code> içinde gönderin"
  </em>{' '}
  mesajıyla reddedilir; tersi de reddedilir. Bu yüzden bir gizli alanı, yalnızca bir şeyi önceden doldurmak için değil,{' '}
  <strong>göstermek istemediğiniz veriyi taşımak istediğinizde</strong> ekleyin.
</p>

> ⚠️ **Bir istek bağlantısı URL parametrelerini tamamen yok sayar**
> <p>
>     Bir istekte, <code>?param=</code> değerleri hiç okunmaz — bunlar bir gizli alanı doldurmaz ve çağıranın belirlediği hiçbir şeyi geçersiz
>     kılmaz. Bu kasıtlıdır: bağlantı alıcının elindedir, bu yüzden URL parametrelerine uymak, alıcının çağıranın kendi context'ini yeniden
>     yazmasına izin verirdi. İstek context'i her zaman kazanır, çünkü bir istekte tek kaynak odur.
>   </p>

<h2 id="common-setups">Yaygın kullanım senaryoları</h2>

<ul>
  <li>
    <strong>UTM takibi</strong> — <strong>utm_source</strong>, <strong>utm_medium</strong> ve <strong>utm_campaign</strong> adlarında gizli
    alanlar oluşturun. Form bunları URL’den otomatik olarak yakalar ve her değer bir gönderim sütunu olarak kaydedilir. Analitik Trafik
    Kaynakları grafiği, gizli alanlardan bağımsız olarak utm_source ve utm_medium'u URL'den kendi başına okur. Bağlantı başına
    varsayılanları <a href="/tr/sharing-publishing/sharing-embedding#query-parameters">Paylaş iletişim kutusundan</a> ayarlayın.
  </li>
  <li>
    <strong>CRM entegrasyonu</strong> — HubSpot, ActiveCampaign veya Mailchimp gibi araçlardan bir kişi veya fırsat kimliği iletin.
    Gönderimleri entegrasyonlarınıza ulaştığında kimlik her şeyi birbirine bağlar.
  </li>
  <li>
    <strong>Yönlendirme atıfı</strong> — her iş ortağı, URL’de kendi kodu bulunan benzersiz bir bağlantı alır. Hangi gönderimi kimin
    sağladığını tam olarak görürsünüz.
  </li>
  <li>
    <strong>Ön doldurulmuş bağlam</strong> — bir destek formuna müşteri adı veya plan katmanı iletin. Farklı sorular göstermek için koşullu
    mantıkta kullanın ya da teşekkür sayfasına aktarın.
  </li>
  <li>
    <strong>Önceden doldurulmuş yanıtlar</strong> — e-posta aracınızdan <code>?email=jane@example.com</code> gönderin ve bu gizli alanı
    formun Email sorusunun varsayılanı yapın. Yanıtlayan, adresini zaten doldurulmuş görür ve yalnızca yanlışsa düzeltir.
  </li>
</ul>

> 💡 **Her bağlantı aracıyla çalışır**
> <p>
>     E-posta platformları (Mailchimp, ActiveCampaign, HubSpot), reklam platformları (Google Ads, Meta) ve bağlantı kısaltıcıların tümü URL
>     parametresi eklemenize izin verir. Gizli alanlar bunları form tarafında hiçbir ekstra kurulum gerektirmeden yakalar.
>   </p>

<h2 id="viewing-data">Gizli alan verilerini görüntüleme</h2>

<p>
  Gönderi tablosunda gizli alanlar kendi sütunları olarak görünür — Formstep bunları görünür sorulardan ayırt edebilmeniz için göz-çizgi
  simgesiyle işaretler. Bunlar ayrıca dışa aktarmalarda, entegrasyonlarda (Google Sheets, web kancaları vb.) ve gönderi ayrıntı panelinde de
  yer alır.
</p>

> ℹ️ **Analitikte ve gönderimlerde UTM**
> <p>
>     Formstep, her ziyaretin analitiğiyle birlikte utm_source, utm_medium ve utm_campaign'i kaydeder ve Trafik Kaynakları grafiği
>     gönderimleri kaynağa ve kanala göre gruplar; ancak bunları her yanıtta kaydetmez. Bir parametrenin değerini gönderim başına görmek için
>     o adda (örneğin utm_source) bir gizli alan ekleyin. Böylece hem gönderi tablosunda hem de analitikte görünür.
>   </p>

<h2 id="with-logic">Gizli alanları mantıkla kullanma</h2>

<p>
  Gizli alanlar, <a href="/tr/building-forms/conditional-logic">koşullu mantık</a>ta <strong>koşul kaynağı</strong> olarak çalışır. Bir
  mantık kuralı, gizli alanın değerini okuyarak farklı sorular gösterme, bir sayfaya atlama veya bir{' '}
  <a href="/tr/building-forms/calculated-fields">hesaplanan alan</a> güncelleme gibi dallanma işlemleri yapabilir.
</p>

<p>
  Örnek: URL aracılığıyla <code>?plan=enterprise</code> iletin. Bir mantık kuralı, gizli "plan" alanının "enterprise" olup olmadığını
  kontrol eder ve kurumsal özgü sorular içeren özel bir sayfaya atlar.
</p>

<h2 id="next-steps">Sonraki adımlar</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [Hesaplanan alanlar](/tr/building-forms/calculated-fields) — Yanıtlardan puanlar, toplamlar ve dinamik metinler hesaplayın
  - [Yanıt aktarma](/tr/building-forms/answer-piping) — @ etiketleriyle formdaki herhangi bir yanıta başka bir yerden başvurun
  - [Özel teşekkür sayfası](/tr/building-forms/custom-thank-you) — Gönderi sonrasında hesaplanan değerleri ve kişiselleştirilmiş içeriği gösterin
  - [Gönderi gelen kutusu](/tr/submissions-analytics/submission-inbox) — Gizli alan değerlerini normal yanıtların yanında görün
</div>
