From 794aa4767e8274a7d28879e84c5f514186a13b45 Mon Sep 17 00:00:00 2001
From: Jan Wroniszewski <jan@industreal.pl>
Date: Mon, 16 Oct 2023 20:40:31 +0200
Subject: [PATCH] PPTT-4249 New settings for better identifiers management

---
 .../tracker_settings/public_v2.yaml           | 33 +++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/platform/authorized_api/tracker_settings/public_v2.yaml b/platform/authorized_api/tracker_settings/public_v2.yaml
index e2ace789..ac5f5790 100644
--- a/platform/authorized_api/tracker_settings/public_v2.yaml
+++ b/platform/authorized_api/tracker_settings/public_v2.yaml
@@ -169,6 +169,8 @@ components:
           - strip_site_search_query_parameters
           - tracking_fingerprint_disabled
           - trust_visitors_cookies
+          - use_session_hash
+          - use_anonymous_session_hash
           - url_query_parameter_to_exclude_from_url
           - urls
   responses:
@@ -314,6 +316,10 @@ components:
                   $ref: '#/components/schemas/TrackingFingerprintDisabled'
                 trust_visitors_cookies:
                   $ref: '#/components/schemas/TrustVisitorsCookies'
+                use_session_hash:
+                  $ref: '#/components/schemas/UseSessionHash'
+                use_anonymous_session_hash:
+                  $ref: '#/components/schemas/UseAnonymousSessionHash'
                 url_query_parameter_to_exclude_from_url:
                   $ref: '#/components/schemas/UrlQueryParameterToExcludeFromUrl'
                 urls:
@@ -390,6 +396,10 @@ components:
                   $ref: '#/components/schemas/TrackingFingerprintDisabled'
                 trust_visitors_cookies:
                   $ref: '#/components/schemas/TrustVisitorsCookies'
+                use_session_hash:
+                  $ref: '#/components/schemas/UseSessionHash'
+                use_anonymous_session_hash:
+                  $ref: '#/components/schemas/UseAnonymousSessionHash'
                 url_query_parameter_to_exclude_from_url:
                   $ref: '#/components/schemas/UrlQueryParameterToExcludeFromUrl'
                 updated_at:
@@ -616,7 +626,10 @@ components:
 
     TrustVisitorsCookies:
       type: boolean
+      deprecated: true
       description: |
+        DEPRECATED! Use `use_session_hash` / `use_anonymous_session_hash` instead.
+
         When enabled, session events wont be matched by a device fingerprint. Only vistor side generated `_id` paramater will be taken into account.
         ```
         Initial global value:
@@ -624,6 +637,26 @@ components:
         ```
       example: false
 
+    UseSessionHash:
+      type: boolean
+      description: |
+        When enabled, session events that are tracked non-anonymously will be matched by a Session Hash. When disabled only vistor side generated `_id` paramater will be taken into account.
+        ```
+        Initial global value:
+          true
+        ```
+      example: true
+
+    UseAnonymousSessionHash:
+      type: boolean
+      description: |
+        When enabled, session events that are tracked anonymously will be matched by a Session Hash. When disabled only vistor side generated `_id` paramater will be taken into account.
+        ```
+        Initial global value:
+          true
+        ```
+      example: true
+
     CampaignNameParams:
       type: array
       description: |