--- metadata: - name: generator content: Diplodoc Platform v5.54.2 alternate: - https://yandex.com/support/varioqub/en/api-usersplit.md - https://yandex.com/support/varioqub/ru/api-usersplit.md - https://yandex.com/support/varioqub/tr/api-usersplit.md - href: tr/api-usersplit.md type: text/markdown title: Markdown version - href: llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/varioqub/tr/llms.txt # API usersplit {% note tip %} Usersplit API’sini kullanmak için geliştirici becerisine ihtiyaç vardır. Bu konuda tecrübeniz yoksa sitenizin geliştiricisine veya yöneticisine başvurmanızı öneririz. {% endnote %} Usersplit API’si Varioqub’ı web sitenize bağlamak için kullanılır. ## İstek biçimi {#request-format} ```bash GET https://uaas.yandex.ru/v1/exps ? [[client_id](*client_id)=] & [[url](*url)=] & [[i](*i)=] & [[client_features](*client_features)=] & [[cuid](*cuid)=] ``` #| || ##client_id## | Yandex Metrica kullanıcı kimlik belirleyicisi. Biçim: `metrika.{counter_id}`. Burada `{counter_id}` — Yandex Metrica sayaç numarasıdır. [Sayaç numarası nasıl bulunur?](https://yandex.com/support/metrica/tr/general/tag-id.html) || || ##url## | Ziyaretçinin bulunduğu GET parametreli sayfanın adresi. URL iletilmemişse, Varioqub başlıklardan gelen yönlendiriciyi kullanır, ancak yönlendirici iletilmeyebilir veya eksik iletilebilir. Bu nedenle, her zaman URL’yi iletmenizi öneririz. || || ##i## | First-party cookies içinde saklanan web sitesi ziyaretçisinin kimliği. Yanıt alındığında `_ymab_param` çerezinde ayarlanmalıdır. Ziyaretçinin ilk ziyaretinde boş olabilir. Bunu API’ye yapılan her istekte iletmenizi öneririz. İlk istekte alan boş olabilir. || || ##client_features## | Kullanıcı ayarlarının serileştirilmiş JSON nesnesi[*](*parametr). Örnek: `{"param2": "value2", "param1": "value1"}`. || || ##cuid## | Deneylerde kendi kimlik belirleyicilerinizi kullanmanıza olanak tanıyan özel kimlik belirleyici. Bu işlevselliğin çalışması için, sitede kullanıcı kimliğine eşit bir değere sahip `cuid` GET parametresinin iletimini sağlayın. Özel kimlik belirleyici için maksimum uzunluk 30 karakterdir. || |# {% note info %} Ziyaretçileri örneklemlere ayırmak için `Referer`, `User-Agent` ve `X-Forwarded-For` da kullanılır. Onların doğru şekilde iletildiğinden emin olun. {% endnote %} ```bash HEADERS: Referer: {url} User-Agent: {user-agent} X-Forwarded-For: {user_ip} ``` Burada: - `url` – Ziyaretçinin bulunduğu sayfanın GET parametreli adresi. - `user-agent` – Site ziyaretçisinin User Agent’i. - `user_ip` – Site ziyaretçisinin IP adresi. ## Yanıt biçimi {#response-format} #### JSON ```json { "i":"{i}", "experiments":"{experiments}", "testids": [ {testid.1}, ... {testid.n} ], "flags": [ { "n":"{flag.1}", "v":"{value.1}", "t":"{type.1}" }, ... { "n":"{flag.n}", "v":"{value.n}", "t":"{type.n}" } ] } ``` #| || **Alan adı** | **Açıklama** || || ##i## | First-party cookies içinde saklanan web sitesi ziyaretçisinin kimliği. Yanıt alındığında `_ymab_param` çerezinde ayarlanmalıdır. Ziyaretçinin ilk ziyaretinde boş olabilir. || || ##experiments## | Yandex Metrica sayacına ait teknik veriler şifreli biçimde döndürülür. Alındıktan sonra, sayacı başlatırken veya ayrı bir çağrı ile [bunları Yandex Metrica’ya iletin](#experiments). || || ##testids## | Sorgunun içine dahil olduğu varyantların tanımlayıcılarından oluşan bir dizi. Değer, [Varioqub genişletilmiş versiyon](https://yandex.com/support/varioqub/tr/paid-functionality.md) kullanıldığında görüntülenir. Temel sürümde bu dizi boştur. || || ##flags## | deneysel değişiklikleri tanımlayan bayraklar dizisi. `{flag.N}:{value.N}` çiftlerinden oluşur. Dizi içerisindeki bayrakların benzersizliği garanti edilmez ve deneylerin yapılandırmasına bağlıdır. || || ##t## | Bayrak türü (type). `flag` veri türüne sahip olabilir. || || ##n## | Bayrak adı (name). || || ##v## | Bayrak değeri (value). || |# {% note info %} Yanıt biçimi ek alanlar içerebilir. Bir yanıtı işlerken yalnızca API ile çalışmak için gerekenleri kullanın. {% endnote %} Yanıt örneği: ```json { "i":"7ASX7O3PO+SD4f30Y1GqkUEVIgyJ+lqpl9teI7DtiRQTGlsMT8VszxKsrU/2D5+mTTJviiKIv2/2 obmd4t7fGkefkfY=", "experiments":"JjfiHndoV8s", "flags": [ { "n":"flag_name", "v":"value", "t":"flag" } ], "testids": [ 1234, 4567 ], } ``` ## Teknik verilerin Yandex Metrica’ya aktarılması {#experiments} Teknik verileri aktarmak için `experiments` yöntemini kullanın. Yöntem, [sayacı başlatırken](https://yandex.com/support/metrica/tr/code/counter-initialize.html) veya ayrı olarak çağrılabilir. ```javascript ym(XXXXXX, 'experiments', experiments); ``` | **Parametre** | **Türü** | **Açıklama** | |--------------|--------|-----------| | ##experiments## | String | Yandex Metrica için teknik veriler, örneğin deneyde kullanılan varyantlarla ilgili veriler vb. Usersplit API yöntemi çağrıldıktan sonra şifrelenmiş biçimde döndürülür. |
Destek Ekibi'ne yaz
[*requiredParam]: Bu parametre zorunludur [*client_id]: Yandex Metrica kullanıcı kimlik belirleyicisi. Biçim: `metrika.{counter_id}`. Burada `{counter_id}` — Yandex Metrica sayaç numarasıdır. [Sayaç numarası nasıl bulunur?](https://yandex.com/support/metrica/tr/general/tag-id.html) [*url]: Ziyaretçinin bulunduğu GET parametreli sayfanın adresi. URL iletilmemişse, Varioqub başlıklardan gelen yönlendiriciyi kullanır, ancak yönlendirici iletilmeyebilir veya eksik iletilebilir. Bu nedenle, her zaman URL’yi iletmenizi öneririz. [*i]: First-party cookies içinde saklanan web sitesi ziyaretçisinin kimliği. Yanıt alındığında `_ymab_param` çerezinde ayarlanmalıdır. Ziyaretçinin ilk ziyaretinde boş olabilir. Bunu API’ye yapılan her istekte iletmenizi öneririz. İlk istekte alan boş olabilir. [*parametr]: Deneyde kullanmak için [genişletilmiş versiyonu](https://yandex.com/support/varioqub/tr/paid-functionality.md) bağlayın. [*client_features]: Kullanıcı ayarlarının serileştirilmiş JSON nesnesi. Örnek: `{"param2": "value2", "param1": "value1"}`. [*cuid]: Deneylerde kendi kimlik belirleyicilerinizi kullanmanıza olanak tanıyan özel kimlik belirleyici. Bu işlevselliğin çalışması için, sitede kullanıcı kimliğine eşit bir değere sahip `cuid` GET parametresinin iletimini sağlayın.