---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.com.tr/dev/metrika/en/logs/fields/visits.md
  - https://yandex.com.tr/dev/metrika/ru/logs/fields/visits.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/metrika/en/llms.txt

# Sessions

{% note info "" %}

Renamed fields with E-commerce event arrays:
- `ym:s:eventsProduct` is now `ym:s:product`;
- `ym:s:products` is now `ym:s:purchasedProduct`.

You can still export the old fields from the `ym:s:eventsProduct` and `ym:s:products` arrays, but they will soon be deprecated.

{% endnote %}

#|
|| **Field** | **Data type** | **Description** ||
|| ym:s:visitID | UInt64 | Session ID, unique within one year ||
|| ym:s:counterID | UInt32 | Tag ID ||
|| ym:s:watchIDs | Array(UInt64) | Pageviews in this session. Array size is limited to 500 page views ||
|| ym:s:date | Date | Session date ||
|| ym:s:dateTime | DateTime | Session date and time (in the tag's time zone) ||
|| ym:s:dateTimeUTC | DateTime | Event date and time (in the UTC+3 time zone) ||
|| ym:s:isNewUser | UInt8 | User's first session ||
|| ym:s:startURL | String | Landing page ||
|| ym:s:endURL | String | Exit page ||
|| ym:s:pageViews | Int32 | Page depth (detailed) ||
|| ym:s:visitDuration | UInt32 | Time on site (detailed) ||
|| ym:s:bounce | UInt8 | Bounce rate ||
|| ym:s:ipAddress | String | IP address ||
|| ym:s:regionCountry | String | Country (ISO) ||
|| ym:s:regionCity | String | City (name in English) ||
|| ym:s:regionCountryID | UInt32 | Country ID ||
|| ym:s:regionCityID | UInt32 | City ID ||
|| ym:s:clientID | UInt64 | Anonymous user ID in the browser (first-party cookies) ||
|| ym:s:counterUserIDHash | UInt64 | User ID (within a single browser) used to count unique site users in the Yandex Metrica interface ||
|| ym:s:isRobotPro | UInt8 | Percentage of robot traffic based on Yandex Direct antifraud data and user behavior on the site. Possible values: 0 — not a robot session, 1 — robot session.

This field's data is valid as of April 19, 2025, and is only available for tags in [Yandex Metrica Pro](https://yandex.com/support/metrica/en/pro/intro). ||
|| ym:s:networkType | String | Connection type. This dimension is outdated and will soon be removed from the API. ||
|| ym:s:goalsID | Array(UInt32) | IDs of the goals completed in this session ||
|| ym:s:goalsSerialNumber | Array(UInt32) | Serial numbers of completed goals with a specific ID ||
|| ym:s:goalsDateTime | Array(DateTime) | Time of each goal completion (in the UTC+3 time zone) ||
|| ym:s:goalsPrice | Array(Int64) | Goal value ||
|| ym:s:goalsOrder | Array(String) | Order ID ||
|| ym:s:goalsCurrency | Array(String) | Currency ID ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>TrafficSource | String | Traffic source ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>AdvEngine | String | Advertising system ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>ReferalSource | String | Referral traffic ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>SearchEngineRoot | String | Search engine ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>SearchEngine | String | Search engine (detailed) ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>SocialNetwork | String | Social network ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>SocialNetworkProfile | String | Social network group ||
|| ym:s:referer | String | Referrer ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>DirectClickOrder | UInt32 | Yandex Direct campaign ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>DirectBannerGroup | UInt64 | Ad group ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>DirectClickBanner | String | Yandex Direct ad ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>DirectClickOrderName | String | Yandex Direct campaign name ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>ClickBannerGroupName | String | Ad group name ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>DirectClickBannerName | String | Yandex Direct ad name ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>DirectPhraseOrCond | String | Ad impression criteria ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>DirectPlatformType | string | Platform type ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>DirectPlatform | String | Platform ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>DirectConditionType | String | Type of ad impression criteria ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>CurrencyID | String | Currency ||
|| ym:s:from | String | "From" tag ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>UTMCampaign | String | UTM Campaign ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>UTMContent | String | UTM Content ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>UTMMedium | String | UTM Medium ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>UTMSource | String | UTM Source ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>UTMTerm | String | UTM Term ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>openstatAd | String | Openstat Ad ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>openstatCampaign | String | Openstat Campaign ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>openstatService | String | Openstat Service ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>openstatSource | String | Openstat Source ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>hasGCLID | UInt8 | GCLID tag present ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>GCLID | String | GCLID tag ||
|| ym:s:browserLanguage | String | Browser language ||
|| ym:s:browserCountry | String | Browser country ||
|| ym:s:clientTimeZone | Int16 | Difference between the user's time zone and UTC (in minutes) ||
|| ym:s:deviceCategory | String | Device type. Possible values: 1 — desktop, 2 — mobile phone, 3 — tablet, 4 — TV ||
|| ym:s:mobilePhone | String | Device manufacturer ||
|| ym:s:mobilePhoneModel | String | Device model ||
|| ym:s:operatingSystemRoot | String | Group of operating systems ||
|| ym:s:operatingSystem | String | Operating system (detailed) ||
|| ym:s:browser | String | Browser ||
|| ym:s:browserMajorVersion | UInt16 | Major version of the browser ||
|| ym:s:browserMinorVersion | UInt16 | Minor version of the browser ||
|| ym:s:browserEngine | String | Browser engine ||
|| ym:s:browserEngineVersion1 | UInt16 | Major version of the browser engine ||
|| ym:s:browserEngineVersion2 | UInt16 | Minor version of the browser engine ||
|| ym:s:browserEngineVersion3 | UInt16 | Build version of the browser engine ||
|| ym:s:browserEngineVersion4 | UInt16 | Revision version of the browser engine ||
|| ym:s:cookieEnabled | UInt8 | Cookies present ||
|| ym:s:javascriptEnabled | UInt8 | JavaScript present ||
|| ym:s:screenFormat | String | Aspect ratio Possible values:
- `undefined`
- `9:21`
- `9:16`
- `3:5`
- `10:16`
- `2:3`
- `3:4`
- `4:5`
- `5:4`
- `4:3`
- `3:2`
- `16:10`
- `5:3`
- `16:9`
- `21:9`. ||
|| ym:s:screenColors | UInt8 | Color depth ||
|| ym:s:screenOrientation | UInt8 | Screen orientation. 1 - portrait, 2 - landscape ||
|| ym:s:screenOrientationName | String | Screen orientation ||
|| ym:s:screenWidth | UInt16 | Logical width ||
|| ym:s:screenHeight | UInt16 | Logical height ||
|| ym:s:physicalScreenWidth | UInt16 | Physical width ||
|| ym:s:physicalScreenHeight | UInt16 | Physical height ||
|| ym:s:windowClientWidth | UInt16 | Window width ||
|| ym:s:windowClientHeight | UInt16 | Window height ||
|| ym:s:purchaseID | Array(String) | Purchase ID. List of all transaction IDs for a specific session. The IDs are unique. ||
|| ym:s:purchaseDateTime | Array(DateTime) | Purchase date and time ||
|| ym:s:purchaseAffiliation | Array(String) | Store or branch where the transaction occurred ||
|| ym:s:purchaseRevenue | Array(Float64) | Total revenue or total value of the transaction ||
|| ym:s:purchaseTax | Array(Float64) | Sum of all taxes for the transaction ||
|| ym:s:purchaseShipping | Array(Float64) | Shipping cost for the transaction ||
|| ym:s:purchaseCoupon | Array(String) | A promo code associated with the entire purchase ||
|| ym:s:purchaseCurrency | Array(String) | Transaction currency ||
|| ym:s:purchaseProductQuantity | Array(Int64) | Number of items in the purchase ||
|| ym:s:productID | Array(String) | Product ID or code ||
|| ym:s:productList | Array(String) | A list that includes the products related to the transaction ||
|| ym:s:productBrand | Array(String) | Brand of the product ||
|| ym:s:productCategory | Array(String) | Product category ||
|| ym:s:productCategoryLevel1 | Array(String) | Product category, level 1 ||
|| ym:s:productCategoryLevel2 | Array(String) | Product category, level 2 ||
|| ym:s:productCategoryLevel3 | Array(String) | Product category, level 3 ||
|| ym:s:productCategoryLevel4 | Array(String) | Product category, level 4 ||
|| ym:s:productCategoryLevel5 | Array(String) | Product category, level 5 ||
|| ym:s:productVariant | Array(String) | Product variant ||
|| ym:s:productPosition | Array(Int32) | Product's position in the list or collection ||
|| ym:s:productPrice | Array(Int64) | Product price ||
|| ym:s:productCurrency | Array(String) | Product currency ||
|| ym:s:productCoupon | Array(String) | Promo code associated with the product ||
|| ym:s:productQuantity | Array(UInt64) | Product quantity ||
|| ym:s:productEventTime | Array(DateTime) | Date and time of the event ||
|| ym:s:productEventType | Array(String) | Event type. Possible values:
- `view_item_list`: Viewing the product list.
- `click`: Clicking the product.
- `detail`: Viewing the product card.
- `add`: Adding the item to the shopping cart.
- `purchase`: Purchasing.
- `remove`: Removing an item from the shopping cart.||
|| ym:s:productDiscount | Array(String) | Discount percentage on the product ||
|| ym:s:productURL | Array(String) | Event page URL ||
|| ym:s:productName | Array(String) | Product name ||
|| ym:s:purchasedProductPurchaseID | Array(String) | Purchase ID. For each purchased product `ym:s:productsID`, the transaction in which it was purchased is specified. Duplicate IDs are allowed. ||
|| ym:s:purchasedProductID | Array(String) | ID or code of the purchased product ||
|| ym:s:purchasedProductName | Array(String) | Name of the purchased product ||
||  ym:s:purchasedProductBrand | Array(String) | Brand of the purchased product ||
|| ym:s:purchasedProductCategory | Array(String) | Category of the purchased product ||
|| ym:s:purchasedProductCategoryLevel1 | Array(String) | Category of the purchased product, level 1 ||
|| ym:s:purchasedProductCategoryLevel2 | Array(String) | Category of the purchased product, level 2 ||
|| ym:s:purchasedProductCategoryLevel3 | Array(String) | Category of the purchased product, level 3 ||
|| ym:s:purchasedProductCategoryLevel4 | Array(String) | Category of the purchased product, level 4 ||
|| ym:s:purchasedProductCategoryLevel5 | Array(String) | Category of the purchased product, level 5 ||
|| ym:s:purchasedProductVariant | Array(String) | Variant of the purchased product ||
|| ym:s:purchasedProductPosition | Array(Int32) | Position of the purchased product in the list or collection ||
|| ym:s:purchasedProductPrice | Array(Float64) | Price of the purchased product ||
|| ym:s:purchasedProductCurrency | Array(String) | Currency of the purchased product ||
|| ym:s:purchasedProductCoupon | Array(String) | Promo code associated with the purchased product ||
|| ym:s:purchasedProductQuantity | Array(Int64) | Quantity of purchased products ||
|| ym:s:purchasedProductList | Array(String) | A list that includes the purchased products related to the transaction ||
|| ym:s:purchasedProductEventTime | Array(DateTime) | Date and time of product purchase ||
|| ym:s:purchasedProductDiscount | Array(String) | Discount percentage on the purchased product ||
|| ym:s:impressionsURL | Array(String) | Product page URL ||
|| ym:s:impressionsDateTime | Array(DateTime) | Date and time of the pageview ||
|| ym:s:impressionsProductID | Array(String) | ID of the viewed product ||
|| ym:s:impressionsProductName | Array(String) | Name of the viewed product ||
|| ym:s:impressionsProductBrand | Array(String) | Brand of the viewed product ||
|| ym:s:impressionsProductCategory | Array(String) | Category of the viewed product ||
|| ym:s:impressionsProductCategory1 | Array(String) | Category of the viewed product, level 1 ||
|| ym:s:impressionsProductCategory2 | Array(String) | Category of the viewed product, level 2 ||
|| ym:s:impressionsProductCategory3 | Array(String) | Category of the viewed product, level 3 ||
|| ym:s:impressionsProductCategory4 | Array(String) | Category of the viewed product, level 4 ||
|| ym:s:impressionsProductCategory5 | Array(String) | Category of the viewed product, level 5 ||
|| ym:s:impressionsProductVariant | Array(String) | Variant of the viewed product ||
|| ym:s:impressionsProductPrice | Array(Int64) | Price of the viewed product ||
|| ym:s:impressionsProductCurrency | Array(String) | Currency of the viewed product ||
|| ym:s:impressionsProductCoupon | Array(String) | Promo code associated with the viewed product ||
|| ym:s:impressionsProductList | Array(String) | A list that includes the viewed products related to the transaction ||
|| ym:s:impressionsProductQuantity | Array(UInt64) | Quantity of viewed products ||
|| ym:s:impressionsProductEventTime | Array(DateTime) | Date and time of product view. Same as `ym:s:impressionsDateTime` ||
|| ym:s:impressionsProductDiscount | Array(String) | Discount percentage on the viewed product ||
|| ym:s:promotionID | Array(String) | Promo campaign ID or code ||
|| ym:s:promotionName | Array(String) | Promo campaign name ||
|| ym:s:promotionCreative | Array(String) | Ad banner name ||
|| ym:s:promotionPosition | Array(String) | Ad banner position ||
|| ym:s:promotionCreativeSlot | Array(String) | Ad banner slot ||
|| ym:s:promotionEventTime | Array(DateTime) | Date and time of the campaign event ||
|| ym:s:promotionType | Array(UInt8) | Type of ad campaign event: `promoView` — viewing an ad, `promoClick` — clicking an ad ||
|| ym:s:offlineCallTalkDuration | Array(UInt32) | Call duration in seconds ||
|| ym:s:offlineCallHoldDuration | Array(UInt32) | Time on hold in seconds ||
|| ym:s:offlineCallMissed | Array(UInt32) | Whether the call was missed ||
|| ym:s:offlineCallTag | Array(String) | Custom tag ||
|| ym:s:offlineCallFirstTimeCaller | Array(Int32) | Whether this is the first call ||
|| ym:s:offlineCallURL | Array(String) | Source URL for the call (page associated with the event) ||
|| ym:s:parsedParamsKey1 | Array(String) | Session parameters, level 1 ||
|| ym:s:parsedParamsKey2 | Array(String) | Session parameters, level 2 ||
|| ym:s:parsedParamsKey3 | Array(String) | Session parameters, level 3 requests ||
|| ym:s:parsedParamsKey4 | Array(String) | Session parameters, level 4 ||
|| ym:s:parsedParamsKey5 | Array(String) | Session parameters, level 5 ||
|| ym:s:parsedParamsKey6 | Array(String) | Session parameters, level 6 ||
|| ym:s:parsedParamsKey7 | Array(String) | Session parameters, level 7 ||
|| ym:s:parsedParamsKey8 | Array(String) | Session parameters, level 8 ||
|| ym:s:parsedParamsKey9 | Array(String) | Session parameters, level 9 ||
|| ym:s:parsedParamsKey10 | Array(String) | Session parameters, level 10 ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>RecommendationSystem | String | Click from recommendation systems. [Learn more about this parameter](https://yandex.com.tr/dev/metrika/en/logs/openapi/getLogRequests.md) ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>Messenger | String | Click from a messenger. [Learn more about this parameter](https://yandex.com.tr/dev/metrika/en/logs/openapi/getLogRequests.md) ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>hasSBCLID | UInt8 | SBCLID tag present. ||
|| ym:s:<[attribution](https://yandex.com.tr/dev/metrika/en/logs/param.md)>SBCLID | String |  SBCLID tag ||
|#