From b06e4714a6f4f82c7533af6c69b84bd0ebb5890b Mon Sep 17 00:00:00 2001
From: bretg <bgorsline@gmail.com>
Date: Tue, 7 Nov 2023 14:50:02 -0500
Subject: [PATCH] TID changes

Updates for https://github.com/prebid/prebid-server/issues/2727
---
 .../openrtb2/pbs-endpoint-auction.md          | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md b/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
index a74e81ff03..d97beb8763 100644
--- a/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
+++ b/prebid-server/endpoints/openrtb2/pbs-endpoint-auction.md
@@ -168,6 +168,7 @@ if $.id contains "{{UUID}}", replace that macro with a random value
 
 ##### request.source.tid
 
+PBS-Go - this will change once [issue 2727](https://github.com/prebid/prebid-server/issues/2727) is implemented to link the transmitTid activity.
 ```text
 if source.tid is not set:
    set source.tid to a random UUID
@@ -176,6 +177,15 @@ if host config auto_gen_source_tid (Go) / generate-storedrequest-bidrequest-id (
 if $.source.tid contains "{{UUID}}", replace that macro with a random value
 ```
 
+PBS-Java
+```text
+if source.tid is not set and the transmitTid activity is allowed:
+   set source.tid to a random UUID
+if host config generate-storedrequest-bidrequest-id config is true and the transmitTid activity is allowed
+    if the storedrequest is from AMP or from a top-level stored request (ext.prebid.storedrequest), then replace any existing $.source.tid with a random value
+if $.source.tid contains "{{UUID}}", replace that macro with a random value
+```
+
 ##### request.imp[].id
 
 ```text
@@ -186,6 +196,7 @@ if host config generate-storedrequest-bidrequest-id config is true
 
 ##### request.imp[].ext.tid
 
+PBS-Go - this will change once [issue 2727](https://github.com/prebid/prebid-server/issues/2727) is implemented to link the transmitTid activity.
 ```text
 if imp[n].ext.tid is not set:
        set imp[n].ext.tid to a randomly generated UUID
@@ -194,6 +205,16 @@ if imp[n].ext.tid is not set:
 if $.imp[n].ext.tid contains "{{UUID}}", replace that macro with a random value
 ```
 
+PBS-Java
+```text
+for each imp:
+   if imp[n].ext.tid is not set and the transmitTid activity is allowed:
+       set imp[n].ext.tid to a randomly generated UUID
+   if host config generate-storedrequest-bidrequest-id config is true and the transmitTid activity is allowed
+       if the storedrequest is from AMP or from a top-level stored request (ext.prebid.storedrequest), then replace any existing $.imp[n].ext.tid with a random value
+  if $.imp[n].ext.tid contains "{{UUID}}", replace that macro with a random value
+```
+
 #### Expiration
 
 The `imp[].exp` field is an "Advisory as to the number of seconds that may elapse