API usersplit

Öneri

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.

Usersplit API’si Varioqub’ı web sitenize bağlamak için kullanılır.

İstek biçimi

GET https://uaas.yandex.ru/v1/exps
  ? [client_id=<String>]
  & [url=<String>]
  & [i=<String>]
  & [client_features=<String>]
  & [cuid=<String>]

`client_id`	Yandex Metrica kullanıcısı kimlik belirleyicisi. Biçim: `metrika.{counter_id}`. Buradaki `{counter_id}` Yandex Metrica sayaç numarasıdır. Sayaç numarası nasıl bulunur?
`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 *. Örnek: `{"param2": "value2", "param1": "value1"}`.
`cuid`	Deneylerde kendi özel kimlik tanımlayıcılarınızı kullanmanıza olanak tanıyan kendi özel tanımlayıcınız. 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.

Not

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.

HEADERS:
Referer: {url}
User-Agent: {user-agent}
X-Forwarded-For: {user_ip}

Burada:

url – Ziyaretçinin bulunduğu GET parametreli sayfanın adresi.
user-agent – Site ziyaretçisi User Agent.
user_ip – Site ziyaretçisinin IP adresi.

Yanıt biçimi

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. Kopyalandı
`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.
`testids`	Sorgunun içine dahil olduğu varyantların tanımlayıcılarından oluşan bir dizi. Değer, Varioqub genişletilmiş versiyon kullanıldığında görüntülenir. Temel sürümde bu dizi boştur.
`flags`	Deneysel değişiklikleri tanımlayan bayraklar dizesi. `{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).

Not

Yanıt biçimi ek alanlar içerebilir. Bir yanıtı işlerken yalnızca API ile çalışmak için gerekenleri kullanın.

Yanıt örneği:

{
    "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ı

Teknik verileri aktarmak için experiments yöntemini kullanın. Yöntem, sayacı başlatırken veya ayrı olarak çağrılabilir.

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

Yazı yararlı oldu mu?

Etkinleştirme

Deney başlamadan önce sayfayı gizleme