> 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/reports-and-analytics/analytics/insight-boards/building-an-insight.md).

# Bir içgörü oluşturma

Insight Builder'da bir içgörü oluşturun: hedef kitleyi seçin, etkinlikleri seçin, ölçümü belirleyin, metrikler ve bir kırılım ekleyin, tarih aralığını ayarlayın, çalıştırın ve kaydedin.

İçgörü Oluşturucu, analiz sorgularının tanımlandığı yerdir. Her panodaki her grafik burada başlar: içgörüye ad verirsiniz, hangi kullanıcıların olaylarının ölçüleceğine karar verirsiniz, hangi olayların ölçüleceğini seçersiniz, her olayın nasıl toplulaştırılacağını belirlersiniz, isteğe bağlı olarak sonuçları bir kırılımla bölersiniz ve sorguyu çalıştırarak sonucu bir panoya eklemeden önce görürsünüz. Bu sayfa, oluşturucuyu boş durumdan kaydedilmiş bir içgörüye kadar, bu kılavuz boyunca kullanılan aynı App Open Analytics örneğini izleyerek adım adım anlatır ve bu süreçte yapılan her seçimin arkasındaki mantığı açıklar.

Oluşturucu iki durumda açılır. Şunu seçmek **Yeni bir içgörü oluştur** bir panonun İçgörü Ekle iletişim kutusundan onu boş olarak, başlığı İçgörü Oluşturucu olacak şekilde açar ve **Panoya Ekle** son eylem olarak sunar. Mevcut bir karttaki düzenle simgesini seçmek, aynı ekranı İçgörü Düzenle başlığıyla açar; kayıtlı tanım önceden doldurulmuştur ve **Değişiklikleri Kaydet** seçeneğini sunar. Aşağıdakilerin hepsi her ikisi için de geçerlidir; kaydetme sırasındaki farklar sayfanın sonunda ele alınır.

### Oluşturucu düzeni

Ekran, birlikte görünümde kalan iki alana bölünmüştür. Soldaki sorgu paneli içgörü adını, hedef kitleyi, metrik listesini ve kırılım bölümünü içerir; tanım burada yer alır. Sağdaki önizleme alanı, her çalıştırmadan sonra sonuçları kendi araç çubuğuyla birlikte grafik türü, ayrıntı düzeyi ve gösterim ayarlarıyla birlikte gösterir. İlk çalıştırmaya kadar önizleme, sonuçları görmek için bir içgörü çalıştırmanız gerektiğini hatırlatan Veri Yok durumunu gösterir. Üst kısımda ortak bir çubuk, solda tarih aralığı kontrollerini ve sağda sorgu eylemlerini, Maliyeti Tahmin Et, Sorguyu Göster, Çalıştır ve kaydetme eylemini taşır.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2Fl9XFyeN8DIbgUQYG5wPl%2FScreenshot%202026-07-07%20at%2000.47.19.png?alt=media&amp;token=7d2db74b-98ce-411a-9c29-e4aead8064ce" alt="Insight Builder with the query panel, empty preview, date range, and query actions"><figcaption></figcaption></figure>

Kullanışlı bir alışkanlık, oluşturucuyu soru ve cevap olarak okumaktır: sol panel, olay verilerinize sorduğunuz sorudur; sağ panel ise mevcut cevaptır. Sağdaki hiçbir şey soruyu değiştirmez; iki taraf yalnızca Çalıştır'ı seçtiğinizde buluşur.

### 1. Adım: İçgörüye ad verin

Şuraya bir ad yazın: **İçgörü** sorgu panelinin üst kısmındaki alan. Örneğin App Open Analytics. Ad, içgörünün daha sonra Add Insight iletişim kutusundaki aramada ve onu gösteren her pano kartında bulunma yoludur; bu nedenle ona ilk oluşturulduğu pano için değil, yanıtladığı soruya göre ad verin. App Open Analytics adlı bir içgörü panolar arasında rahatça taşınır; Finance Chart Left adlı bir içgörü ise taşımaz.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FeA06PYrRlTnlna0GwEXM%2FScreenshot%202026-07-07%20at%2000.48.04.png?alt=media&amp;token=7ebdd25c-cf9a-4568-ad0c-737aec2de654" alt="Insight name field containing App Open Analytics" width="563"><figcaption></figcaption></figure>

### 2. Adım: Hedef kitleyi seçin

Şu **Hedef Kitle** alanı, içgörü adının altında içgörünün hangi kullanıcıların olaylarını ölçtüğüne karar verir. Varsayılan olarak **Tüm kullanıcılar**ile başlar ve uygulamanın tüm kullanıcı tabanı üzerindeki her metriği değerlendirir. Listeyi açmak için alanı seçin ya da içinde yazarak arama yapın ve bunun yerine bir segment veya etiket seçin.

Bir hedef kitle seçildikten sonra, içgörüdeki her metrik yalnızca o segment ya da etiketteki kullanıcıların olaylarından hesaplanır; bunun dışındaki kullanıcıların olayları sonuçtan çıkarılır. Hedef kitle önce uygulanır ve ardından tanımladığınız her şey, olaylar, öznitelikler, toplulaştırmalar ve kırılım, onun içinde çalışır.

#### Hedef kitle olarak segmentler ve etiketler

Segmentler ve etiketler, bir içgörüyü bir kullanıcı grubuyla sınırlar; ancak bu grubu farklı şekillerde korurlar ve seçim, içgörünün değişen bir kitleyi mi yoksa sabit bir kitleyi mi izleyeceğine karar verir.

<table><thead><tr><th width="120">Hedef Kitle</th><th>Üyelik nasıl korunur</th><th>İçgörünün neyi ölçtüğü</th></tr></thead><tbody><tr><td><strong>Segment</strong></td><td>Segment kurallarına göre her üç saatte bir otomatik olarak yeniden hesaplanır. Kullanıcılar kurallarla eşleşmeye başladıkça katılır, eşleşmeyi bıraktıkça ayrılır.</td><td>Segmentin son hesaplamasına göre içinde yer alan kullanıcılar. Her çalıştırma grubu mevcut haliyle izler.</td></tr><tr><td><strong>Etiket</strong></td><td>Statik bir liste. Hedef kitle, etiket oluşturulduğundaki haliyle aynen kalır.</td><td>Her çalıştırmada aynı kullanıcılar; ancak davranışları sonradan değişebilir.</td></tr></tbody></table>

#### Hedef kitle ne zaman kullanılmalı

Soru tüm kullanıcı tabanı yerine belirli bir grupla ilgiliyse içgörüyü bir hedef kitleyle sınırlandırın: bir kampanyanın hedeflediği segment, yaşam döngüsü etiketi taşıyan kullanıcılar ya da geri kazanmak istediğiniz pasif bir kohort gibi. O grubun davranışını doğrudan oluşturucu içinde ölçmek, analizi ayrı bir dışa aktarma yerine diğer panolarınızın yanında tutar.

### 3. Adım: Bir olay seçin

Her metrik bir olayla başlar. İlk metrikteki **Olay seç** alanını seçin ve uygulamanın olay kataloğunda aramak için gezinin ya da yazarak arayın. Arama, siz yazdıkça eşleşir: "open" yazmak, Renewal Window Open, Email Open, Install(First Open) App, Open App ve Screen Open gibi terimi içeren her olayı gösterir. Ölçmek istediğiniz olayı seçin; bir onay işareti seçimi doğrular ve metrik başlığı olayın adını ve rengini alır.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FxKHT6NAYPgAkfZXt6F94%2FScreenshot%202026-07-07%20at%2000.48.36.png?alt=media&amp;token=4d0dc5f2-cd79-407c-9ada-1258394c6a48" alt="Event picker search results for open" width="563"><figcaption></figcaption></figure>

Katalog hem Netmera'nın standart olaylarını hem de uygulamanızın gönderdiği özel olayları içerir; bu nedenle arama, ölçmek için nelerin mevcut olduğunu doğrulamanın da hızlı bir yoludur. Beklenen bir olay eksikse, bu olay bu uygulama için toplanmamıştır; bu durum oluşturucudan değil, SDK yapılandırmasından kaynaklanır.

**Olay özniteliği ekle**seçilen bir olaydan sonra ölçüm açılır menülerinin üzerinde görünür ve metriği bir öznitelik koşuluyla eşleşen gerçekleşmelere sınırlar. Öznitelik yoksa metrik olayın her gerçekleşmesini sayar; bir öznitelik koşulu varsa yalnızca belirtilen değeri taşıyan gerçekleşmeleri sayar.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FPrBwLdPyt5IZF5uY5UeW%2FScreenshot%202026-07-07%20at%2000.48.59.png?alt=media&amp;token=fe4c1c4c-cf9c-4c49-99b1-46413e9a09f9" alt="Event attribute condition controls in a metric" width="563"><figcaption></figcaption></figure>

### 4. Adım: Ölçümü seçin

Olayın altındaki iki açılır menü, gerçekleşmelerin nasıl sayıya dönüştüğünü kontrol eder.

Birincisi, ölçüm kaynağı, varsayılan olarak **Olayın kendisi** olarak ayarlanmıştır ve olayın hesaplamaya hangi yönünün beslendiğini belirler.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FRYjuaakFb2b3Aa6MZPwp%2FScreenshot%202026-07-07%20at%2000.49.22.png?alt=media&amp;token=2384a037-fa25-404b-ab12-7429dbb4f3ce" alt="Measurement source dropdown set to Event itself" width="563"><figcaption></figcaption></figure>

İkincisi toplulaştırmadır ve metrikteki en önemli seçimdir:

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FJ73jQJn4wUVnRUcM1GHv%2FScreenshot%202026-07-07%20at%2000.50.08.png?alt=media&amp;token=acb65746-215b-4141-a6e3-c97ffb1a12d4" alt="Aggregation dropdown with Event count and Unique users options" width="563"><figcaption></figcaption></figure>

<table><thead><tr><th width="186.08319091796875">Toplama</th><th>Yanıtladığı soru</th><th>Etiket öneki</th></tr></thead><tbody><tr><td>Olay sayısı</td><td>Bu olay toplamda kaç kez gerçekleşti?</td><td>Sayı</td></tr><tr><td>Benzersiz kullanıcılar</td><td>Bu olayı en az bir kez kaç farklı kullanıcı tetikledi?</td><td>Tekil</td></tr></tbody></table>

Toplama alanını seçmek, her iki seçeneği de içeren küçük bir liste açar; sorunuza uyanı seçin. Fark yalnızca görsel değildir. Aynı 30 günlük aralıkta aynı Open App olayı, olay sayısı olarak 950 ve benzersiz kullanıcılar olarak 143 üretir: uygulama toplamda 950 kez açılmış, bunu 143 farklı kişi yapmıştır. Olay sayısı etkinlik hacmini ölçer ve yoğun kullanıcılarla birlikte yükselir; benzersiz kullanıcılar erişimi ölçer ve her kullanıcıyı bir kez sayar. Tutundurma ve benimseme soruları genellikle benzersiz kullanıcıları isterken, yük ve etkileşim yoğunluğu soruları genellikle olay sayılarını ister. İkisi de önemliyse, her ikisini de tanımlayın; bunu tek bir içgörüde iki metrik olarak ya da iki ayrı içgörü olarak yapabilirsiniz.

Şu **Bu metriğe ad verin (isteğe bağlı)** açılır menülerin altındaki alan, grafik başlıklarında ve lejantlarda varsayılan etiketi değiştirir. Varsayılan etiketler teknik niteliktedir, Count · Open App gibi; bu, analistler için uygundur. App Opens gibi özel bir ad ise daha geniş bir kitleye yönelik panolarda daha iyi okunur. Özel adlar içgörü tanımının bir parçasıdır; bu nedenle içgörüyle birlikte her panoya taşınırlar.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FniEuBPTpFWk4hi9rOOcS%2FScreenshot%202026-07-07%20at%2000.50.37.png?alt=media&amp;token=c2251730-93ad-4401-9148-2dc254a823ad" alt="Optional metric name field below the measurement controls" width="563"><figcaption></figcaption></figure>

### 5. Adım: Daha fazla metrik ekleyin

Bir içgörü birden fazla metrik içerebilir ve aynı içgörüdeki metrikler grafiği, hedef kitleyi ve tarih aralığını paylaşır; bu da onları doğrudan karşılaştırılabilir hale getirir. Başka bir metrik eklemek için ilk metriğin altındaki **Metrik Seç** seçeneğini belirleyin, ardından aynı adımları tekrarlayın: olayı arayın, seçin ve ölçümünü ayarlayın. Örneğin "first" araması, RequestLoanFirstStep ve First Visit Web gibi komşuların arasında Install(First Open) App olayını hızla gösterir.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FKqBHLsKTfbSakxdbi28A%2FScreenshot%202026-07-07%20at%2000.51.56.png?alt=media&amp;token=14e59624-2f66-46c2-8b51-cd531daa1915" alt="Select Metric action below an existing metric" width="375"><figcaption></figcaption></figure>

Her metrik kendi rengini alır; bu renk metrik başlığında görünür ve tüm lejantlara ve serilere taşınır. Open App ve Install(First Open) App olay sayıları olarak yan yana tanımlandığında, tek içgörü artık genel kullanım ile yeni kullanıcı gelişini birlikte izler ve ondan çizilen her grafik aynı dönem boyunca her iki seriyi de gösterir.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FeG0sV5KWPMJvojjr5Iba%2FScreenshot%202026-07-07%20at%2000.51.23.png?alt=media&amp;token=b6cac66c-8a1d-425c-b6b5-8a738e6b38d2" alt="Insight with Open App and Install First Open App metrics" width="563"><figcaption></figcaption></figure>

Metrikleri, aynı grafikte yer almaları ve tek bir sorunun farklı yönlerini yanıtlamaları durumunda tek bir içgörü altında gruplayın. İki ölçüm ilgisiz soruları yanıtlıyorsa, farklı hedef kitlelere ihtiyaç duyuyorsa ya da bir panoda farklı tarih aralıklarına ihtiyaç duyuyorsa, bunları ayrı içgörüler olarak tutun; çünkü tek bir içgörünün içindeki her şey her zaman aynı hedef kitleyi ve aralığı paylaşır.

Her metriğin üç noktalı başlık menüsü, metriği içgörüden kaldırma gibi metrik düzeyinde eylemler sunar.

### 6. Adım: Kırılım ekleyin

Şu **Kırılım** sorgu panelinin altındaki bölüm, sonuçları bir boyuta göre böler. Şunu seçin **Kırılım ekle** ve boyutu seçin; ardından grafik, her metrik için tek bir toplam yerine segment başına bir seri gösterir. Kırılımlar dağılım sorularını yanıtlar: toplamı hangi segment sürüklüyor, sıçrama nereden geldi ve bunlar içgörünün sonuçlarının tamamına uygulanır. Toplamın sorunun ihtiyaç duyduğu her şey olduğu durumlarda bölümü boş bırakın; çünkü daha az seri grafiklerin okunmasını kolaylaştırır.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FloAVzXxaDczh0utKmTUh%2FScreenshot%202026-07-07%20at%2000.54.17.png?alt=media&amp;token=0bab8636-9962-472a-82b8-1652fcb682ed" alt="Breakdown section with the Add breakdown action" width="563"><figcaption></figcaption></figure>

### 7. Adım: Tarih aralığını ayarlayın

Oluşturucunun üst kısmındaki çubuk, sorgunun kapsadığı dönemi kontrol eder. Bir hazır ayar seçin, **Bugün**, **Dün**, **7G**, **30G**, **3A**, **6A**ya da **12A**ya da şunu seçin **Özel** ve takvim seçiciyi kullanarak tam başlangıç ve bitiş tarihlerini ayarlayın. Aralık, içgörüdeki her metrik için geçerlidir.

Burada seçilen aralık, oluşturma ve önizleme için çalışma aralığıdır. İçgörü bir panoya eklendikten sonra her kart kendi aralığını bağımsız olarak seçer; bu nedenle oluşturucu aralığı bir taahhütten çok bir başlangıç noktasıdır.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2F5mvwX02UlXdQADMUBPDX%2FScreenshot%202026-07-07%20at%2000.53.59.png?alt=media&amp;token=dce910db-68f3-4b19-9862-d40ed9508afe" alt="Date range picker with preset ranges and Custom option" width="563"><figcaption></figcaption></figure>

### 8. Adım: Çalıştırın ve gözden geçirin

Sağ üstteki eylem çubuğu döngüyü kapatır:

**Maliyeti Tahmin Et** onu çalıştırmadan önce sorgunun işlem maliyetini hesaplar. Geniş özel aralıklar veya yüksek hacimli olaylar çalıştırmadan önce kontrol edin ve sorunun gerektirdiğinden çok daha büyük bir sorgu çalıştırmak yerine aralığı veya olayları daraltmayı tercih edin.

**Sorguyu Göster** oluşturucunun tanımınızdan oluşturduğu sorguyu gösterir. Bu, ileri düzey bir kullanıcının tam olarak neyin hesaplanacağını doğrulaması için en hızlı yoldur; özellikle öznitelik koşulları ve kırılımlar birlikte kullanıldığında.

**Çalıştır** sorguyu yürütür ve sonuçları önizlemede gösterir. Önizleme başlığı her metriğin etiketini ve aralık için toplamını tekrarlar, lejant renkleri metriklerle eşler ve geçen sorgu süresi sağ alt köşede görünür; örneğin 250ms. Yineleme yaparken gerektiği kadar sık çalıştırın; her çalıştırma sorgu panelinin mevcut durumunu yansıtır.

Önizlemenin araç çubuğu, çizgi grafikten tabloya kadar tüm görselleştirme denetimlerini, 15 dakikadan 1 aya kadar zaman ayrıntı düzeyini, eksen ölçeğini ve çizgi stilini sunar. Bunlar sunum tercihleridir ve Chart Types ve Display Settings sayfasında ayrıntılı olarak ele alınır; oluşturma sırasında rolleri, kaydetmeden önce sonucu birkaç açıdan sağlama almaya yardımcı olmaktır. Sayı görünümünde hızlı bir kontrol toplamları doğrular, çizgi görünümü trendin şeklini doğrular ve daha ince bir ayrıntı düzeyi, günlük kovalar içinde garip bir şeyin saklanmadığını doğrular. Önizlemenin köşesindeki indirme simgesi, sayıları Netmera dışında incelemek istediğinizde mevcut sonucu dışa aktarır.

<figure><img src="https://1655476697-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX6uilbEAw42gqsudlclY%2Fuploads%2FW0Yyk3NL3ldDb25HdN7j%2FScreenshot%202026-07-07%20at%2000.55.41.png?alt=media&amp;token=52957dde-d8a7-446c-8885-f01c993d15c1" alt="Insight preview showing chart controls, metric totals, legend, and query duration"><figcaption></figcaption></figure>

### 9. Adım: Kaydetme

İşin nasıl kaydedileceği, oluşturucunun nasıl açıldığına bağlıdır.

Yeni bir içgörü oluştururken **Panoya Ekle**şunu seçin. İçgörü uygulamanın içgörü kataloğuna kaydedilir ve başladığınız panoda bir kart olarak yerleştirilir. O andan itibaren diğer panolarda yeniden kullanılmak üzere her İçgörü Ekle iletişim kutusunda da görünür.

Mevcut bir içgörüyü düzenlerken aynı konumda **Değişiklikleri Kaydet**şunu sunar, yanında da **İptal** bulunur ve düzenlemeleri siler. Kaydetmek ortak tanımı günceller ve panolar içgörüleri kopyalamak yerine referans verdiği için değişiklik bu içgörüyü gösteren her panoda görünür. Birden fazla panoda yer alan bir içgörüye yapılan düzenlemeleri kaydetmeden önce değişikliğin her yerde istenip istenmediğini doğrulayın; yalnızca tek bir panonun varyasyona ihtiyacı varsa bunun yerine yeni bir içgörü oluşturun ve ortak olanı olduğu gibi bırakın.

### Uygulamalı örnek

Bu kılavuzun ekran görüntülerindeki App Open Analytics içgörüsü, adımlar tanıdık hale geldiğinde bir dakikadan kısa sürede tamamlanır:

1. Finance panosunda, İçgörü Ekle ve Yeni bir içgörü oluştur seçenekleri oluşturucuyu açar.
2. İçgörüye App Open Analytics adı verilir.
3. Hedef kitle Tüm kullanıcılar olarak kalır; soru tüm kullanıcı tabanını kapsar.
4. İlk metriğin olayı, arama yoluyla Open App olarak ayarlanır; ölçüm olarak Olayın kendisi ve Olay sayısı seçilir.
5. Metrik Seç, ikinci bir metrik ekler; bu metrik de Install(First Open) App olarak ve yine bir olay sayısı olarak ayarlanır.
6. Kırılım eklenmez; soru zaman içindeki toplamlarla ilgilidir.
7. Aralık 30G olarak ayarlanır ve Çalıştır önizlemeyi oluşturur: 950 açılma, 13 ilk açılma, iki günlük seri.
8. Grafik türleri üzerinden yapılan bir geçiş ve 4s ayrıntı düzeyi kontrolü, verinin şeklini doğrular.
9. Panoya Ekle içgörüyü kaydeder ve Finance panosuna yerleştirir.

Sonraki adımda şunu kullanmayı öğrenin [Grafik türleri ve görünüm ayarları](/netmera-user-guide/netmera-user-guide-tr/reports-and-analytics/analytics/insight-boards/chart-types-and-display-settings.md).


---

# 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/reports-and-analytics/analytics/insight-boards/building-an-insight.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.
