---
metadata:
- name: generator
content: Diplodoc Platform v5.54.1
alternate:
- https://yandex.com/support/metrica/en/data/user-params-data.md
- https://yandex.com/support/metrica/es/data/user-params-data.md
- https://yandex.com/support/metrica/pt/data/user-params-data.md
- https://yandex.com/support/metrica/ru/data/user-params-data.md
- https://yandex.com/support/metrica/tr/data/user-params-data.md
- https://yandex.com/support/metrica/zh/data/user-params-data.md
- href: tr/data/user-params-data.md
type: text/markdown
title: Markdown version
- href: ../llms.txt
type: text/markdown
title: llms.txt
title: Ziyaretçi parametrelerini aktarma
description: Yandex Metrica, ziyaretçi parametreleri denilen ve istediğiniz gibi belirleyebileceğiniz veri setini aktarmanıza olanak verir. Bu parametre setine ziyaretten ziyarete değişmeyen ve isim-soyisim gibi kişisel bilgiler içermeyen kullanıcı bilgilerini dahil etmeniz önerilir.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/metrica/tr/llms.txt
# Ziyaretçi parametrelerini aktarma
{% note warning %}
JavaScript API'siyle çalışmak için HTML ve JavaScript'le çalışma tecrübesine sahip olmak gerekir. Bu konuda tecrübeniz yoksa sitenizin geliştiricisine veya yöneticisine başvurmanızı öneririz.
{% endnote %}
Ziyaretlerle ilgili verilerin çoğunluğunu Yandex Metrica sayacı otomatik toplar. Ayrıca [ziyaret parametreleri](https://yandex.com/support/metrica/tr/data/visit-params-data.md) aktararak bu verileri kendi verilerinizle de tamamlayabilirsiniz. Site ziyaretçilerinin ziyaret istatistiklerinin yanı sıra siteye gelen ziyaretçilerin özellikleri de ilgi konusu olabilir.
Yandex Metrica, _ziyaretçi parametreleri_ denilen ve istediğiniz gibi belirleyebileceğiniz veri setini aktarmanıza olanak verir. Bu parametre setine ziyaretten ziyarete değişmeyen ve isim-soyisim gibi kişisel bilgiler içermeyen kullanıcı bilgilerini dahil etmeniz önerilir. [Ziyaretçi ve ziyaret parametrelerinin farkları](https://yandex.com/support/metrica/tr/general/how-it-works.md#difference)
Sağladığınız parametrelerin raporlarda görünmesi için Yandex Metrica’nın bu parametreleri sitenin ziyaretçileriyle ilişkilendirmesi gerekir. Servis, bunun için özel tanımlayıcılar kullanır: [ClientID](*ClientID) ve [UserID](*UserID). Parametreler, verilerin Yandex Metrica’ya gönderildiği andan önceki 90 günlük sürede siteyi ziyaret etmiş ziyaretçilerin ziyaretlerini içerir.
{% note info %}
ClientID ve UserID'leri içeren ziyaretçi parametreleri aktarılırken Yandex Metrica raporlarında toplam ziyaretçi sayısı, aktarılan kimlik belirleyicilerin sayısından farklı olur. Bu durum, UserID'lerin ClientID'ye ilişkilendirme özelliklerinden kaynaklanır.
{% endnote %}
İletilen bilgiler, birkaç saat içinde raporlarda görüntülenmeye başlar. İstatistikleri görmek için [Ziyaretçi parametreleri](https://yandex.com/support/metrica/tr/reports/user-params.md) raporunu kullanın.
{% note info %}
Metrica’ya gönderilen parametreler, son indirme tarihinden itibaren iki yıl boyunca saklanır. Bu süre dolduktan sonra ilgili veriler rapora dahil edilmez.
{% endnote %}
{% cut "ClientID ne zaman aktarılmalı?" %}
Raporlarda özellikle özel kimlik belirleyicilerin kullanımına gerek olmadığı durumlarda verilerin aktarımı için [ClientID](*ClientID)'yi kullanmanızı öneririz.
{% endcut %}
{% cut "UserID ne zaman aktarılmalı?" %}
Sitede özel bir kullanıcı kimlik belirleme sistemi oluşturulduğu ve raporda bu kimlik belirleyicilerin kullanımına ihtiyaç olduğu durumlarda [UserID](*UserID)'yi aktarmanız önerilir.
{% endcut %}
Ziyaretçi parametreleri Yandex Metrica'ya birden fazla farklı yöntemle aktarılabilir:
- [Site ziyareti sırasında](#online),
- [İstenildiği zaman CSV dosyası kullanılarak](#offline).
## Sitenin ziyareti esnasında verilerin iletimi {#online}
Bu yöntem ziyaretçi sitede bulunduğunda alınan veriler bazında raporların hazırlanması için kullanılabilir.
Ziyaretçi parametreleri JavaScript API'si aracılığıyla Yandex Metrica'ya aktarılır. Bu yöntemle gönderilen bilgiler Yandex Metrica'dan silinemez.
Parametreleri istediğiniz zaman göndermek için [userParams](https://yandex.com/support/metrica/tr/objects/user-params.md) yöntemini kullanın. Parametrelerin sayaç başlatma işlemi sırasında aktarımı için verileri [userParams](https://yandex.com/support/metrica/tr/code/counter-initialize.md) parametresinde belirtin. Bilgiler JavaScript objeleri biçiminde iletilir.
Alan değeri türüne bağlı olarak aşağıda açıklandığı gibi işlenir:
-
Değer **nesne** ise her nesne anahtarı için bir ağaç dalı oluşturulur ve her değer için algoritma yinelemeli olarak çağrılır.
-
Değer **dize** ise her bir farklı dize değeriyle kaç kez karşılaşıldığı hesaplanır.
-
Değer **sayı** ise tüm sayıların toplam ve ortalama değeri hesaplanır.
-
Değer **true**, **false** veya **null** ise bu türde her bir değerle kaç kez karşılaşıldığı hesaplanır.
Verilerin [ClientID](*ClientID)'lerle ilişkilendirilmesi sadece ziyaretleri sırasında `userParams` yönteminin çağrıldığı ziyaretçiler için yapılır. Eksiksiz istatistik toplanması gerekiyorsa Yandex Metrica'ya daha fazla veri toplanması için süre tanıyın.
> ## Örnek
>
> Örnek olarak “normal” ve “VIP” olmak üzere iki kategoride müşterileri olan bir internet mağazası düşünelim. Müşterinin kategori bilgilerinin, sitenin kendi veritabanında muhafaza edildiğini farz edelim. Kullanıcı siteye giriş yaptıktan sonra sitenin sayfalarındaki **Giriş yap** bağlantıları kullanıcının kendi ismi veya kullanıcı adıyla değişerek yanında kullanıcının (varsa) VIP kategorisine ait olduğuna dair bir not görüntülenecek: **Ali / VIP**. Durum verileriyle birlikte veritabanınızda kayıtlı olan ziyaretçi kimlik belirleyicisini de aktarabilirsiniz.
>
> Yandex Metrica'ya veri göndermek için sitenin tüm sayfalarına `userParams` yöntemini çağıracak kodu ekleyin.
>
> VIP kategori bilgilerinin aktarılması gerektiğinde kod şu şekilde görünür:
>
>
> {% list tabs %}
>
> - Herhangi bir zaman
>
>
> ```javascript
> ym(XXXXXXXX, 'userParams', {
> vip_status: true,
> child: 1,
> child_age: 13,
> UserID: 12345
> });
> ```
>
>
> - Sayaç başlatıldığında
>
>
> ```javascript
> ym(XXXXXXXX, 'init', {
> clickmap: true,
> webvisor: true,
> userParams: {
> vip_status: true,
> child: 1,
> child_age: 13,
> UserID: 12345
> }
> });
> ```
>
> {% endlist %}
>
>
> Öte yandan özel kategoriye ait olmayan “normal” bir ziyaretçi hakkında bilgi aktarılırken kod şu şekilde görünür:
>
> {% list tabs %}
>
> - Herhangi bir zaman
>
>
> ```javascript
> ym(XXXXXXXX, 'userParams', {
> vip_status: false,
> child: 1,
> child_age: 13,
> UserID: 12345
> });
> ```
>
>
> - Sayaç başlatıldığında
>
>
> ```javascript
> ym(XXXXXXXX, 'init', {
> clickmap: true,
> webvisor: true,
> userParams: {
> vip_status: false,
> child: 1,
> child_age: 13,
> UserID: 12345
> }
> });
> ```
>
> {% endlist %}
>
> Burada `XXXXXXXX`, sayacınızın numarasıdır.
>
> Özel kategoriye geçen “normal” bir müşteri siteye kullanıcı girişi yaptığında yeni durumla ilgili bilgiler `userParams` yöntemi kullanılarak Yandex Metrica'ya gönderilir. Bu durumda ziyaretçinin yeni statüsü bunun geçmişteki tüm ziyaretleri için (yani bu müşteri ilk baştan bu yana hep VIP kategorisinde olmuş gibi) uygulamayacaktır.
## Verilerin CSV dosyası olarak istenilen zaman aktarımı {#offline}
Bu yöntemle ziyaretçi sitede bulunduğunda toplanan verilerin yanı sıra ziyaretçi siteden ayrıldıktan sonra toplanan verileri de Yandex Metrica'ya aktarmanıza olanak sağlar.
[CSV formatı spesifikasyonu](http://www.rfc-editor.org/rfc/rfc4180.txt)
[CSV formatı açıklaması](https://en.wikipedia.org/wiki/Comma-separated_values)
#|
## Обязательные поля для передачи данных {#offline}
||
**Alan adı**
|
**Açıklama**
|
**Örnek**
||
||
`clientID` \| `userID`
|
Site ziyaretçisinin kimlik belirleyicisi
|
P12345
||
||
`key`
|
Ziyaretçi parametresi. Bir ziyaretçi için maksimum sayı 1000'dir.
|
age \| client.age
||
||
`value`
|
Ziyaretçi parametresi değeri
|
40
||
|#
Hiyerarşik parametre yapısının aktarımı için «.» (nokta) işaretini kullanın. Örneğin `key` alanına birden fazla değer aktarmak gerektiğinde bunları şu şekilde yazın: `client.demography.age`.
Yandex Metrica raporlarında görüntülenen, alanlardaki maksimum karakter sayısı:
- `key` — 255;
- `value` — 50.
Verileri iki şekilde iletebilirsiniz:
{% list tabs %}
- ClientID
1. [getClientID](https://yandex.com/support/metrica/tr/objects/get-client-id.md) yöntemiyle ClientID'yi alın,
1. ClientID'nin belirtildiği bir CSV dosyası oluşturup bunu Yandex Metrica arayüzü üzerinden aktarın.
- UserID
1. [setUserID](https://yandex.com/support/metrica/tr/objects/set-user-id.md) yöntemini kullanarak UserID’nizi iletin.
1. CSV formatında oluşturacağınız UserID bilgisini içeren dosyayı Yandex Metrica arayüzü aracılığıyla iletin.
{% endlist %}
### Dosya ile çalışma şekli {#data-send}
Yandex Metrica kullanıcı arayüzünü verilerin yüklenip silinmesi için kullanabilirsiniz. Dosya ile ilgili tüm işlemler **Ayarlar** bölümündeki **Veri yükleme** sekmesinde, **Ziyaretçi parametreleri** bloğunda yapılır.
{% list tabs %}
- Veri yükleme
Oluşturduğunuz CSV dosyasını Yandex Metrica’da göndermek için:
1. **Veri yükle** butonuna tıklayın.
1. Açılan pencerede yükleyeceğiniz kimlik belirleyicinin türüne ([UserID](*UserID) ya da [ClientID](*ClientID)) uygun dosya türünü seçin.
1. Bilgisayarınızda gerekli dosyayı seçin ve gerektiğinde yükleme açıklaması da ekleyin.
1. **Veri yükle** butonuna tıklayın.
[Veri yükleme için CSV dosyası örneği](https://download.cdn.yandex.net/from/yandex.com/support/en/metrica/files/upload-data-example.csv)
- Veri silme
Daha önce yüklediğiniz verilerin tamamını veya bir kısmını servisten silmek için gereken CSV dosyasını hazırlayın. Bu dosya silmek istediğiniz verilerin sadece `key` alanını içermelidir. Ardından şu eylemleri yapın:
1. **Veri sil** butonuna tıklayın.
2. Açılan pencerede değişiklikleri uygulamak istediğiniz dosyanın türünü kimlik belirleyiciye ([UserID](*Идентификатор-посетителя-сайта,-заданный-владельцем-сайта,-например-при-входе-посетителя-сайта-в-личный-кабинет.) ya da [ClientID](*Идентификатор-уникального-посетителя-сайта,-который-Яндекс-Метрика-задает-автоматически.) olmak üzere) uygun olarak seçin.
3.
Bilgisayarınızda gerekli dosyayı seçin ve gerektiğinde yükleme açıklaması da ekleyin.
4.
**Veri yükle** butonuna tıklayın.
[Veri silme için CSV dosyası örneği](https://download.cdn.yandex.net/from/yandex.com/support/en/metrica/files/delete-data-example.csv)
{% endlist %}
Dosyanın servis tarafından işlenmesi için belirli bir süre tanımanız gerekir. İşlem tamamlandıktan sonra aktarılan verilere Ziyaretçi Parametreleri raporundan ulaşabilirsiniz.
[Sohbete yaz](https://yandex.com.tr/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}
- - -
#|
||
Faydalı bağlantılar
- [Demo sayacı](https://metrica.yandex.com/r/dashboard?)
- [Sayaç ekle](https://metrica.yandex.com/add/)
- [Ücretsiz sayaç ayarları](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&utm_medium=cpc&utm_campaign=1)
- [Yandex Metrica API'si](https://tech.yandex.com/metrika/)
- [Fikir öner](https://yandex.com/support/metrica/troubleshooting/idea.html)
- [Telegram sohbeti](https://t.me/yandexmetrika)
|
Çevrimiçi eğitim
- [Yandex Metrica sertifikası al](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
- [Eğitim kursuna katıl](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
||
|#
[*ClientID]: Yandex Metrica'nın benzersiz site ziyaretçisi için otomatik oluşturduğu kimlik belirleyicisi.
[*UserID]: Site sahibinin belirlediği, örneğin ziyaretçinin kişisel hesabına giriş yaparken belirlenen ziyaretçi kimliği.
[*Идентификатор-посетителя-сайта,-заданный-владельцем-сайта,-например-при-входе-посетителя-сайта-в-личный-кабинет]: Site sahibinin belirlediği, örneğin ziyaretçinin kişisel hesabına giriş yaparken belirlenen ziyaretçi kimliği.
[*Идентификатор-уникального-посетителя-сайта,-который-Яндекс-Метрика-задает-автоматически]: Yandex Metrica'nın benzersiz site ziyaretçisi için otomatik oluşturduğu kimlik belirleyicisi.