Skip to content

Commit 8d45688

Browse files
authored
UID2-7488: clarify opt-out webhook timestamp unit (Unix seconds) (#1045)
The DSP guide's opt-out webhook table did not state the unit of the `timestamp` parameter. It is a Unix timestamp in seconds: the uid2-optout OptOutPartnerEndpoint substitutes ${OPTOUT_EPOCH} directly with the stored OptOutEntry.timestamp (documented as seconds, written via Instant.now().getEpochSecond()), with no conversion. Add the unit and a note distinguishing it from POST /optout/status's opted_out_since, which the operator converts to milliseconds — the likely source of confusion. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Ticket: UID2-7488 Branch: syw-UID2-7488-optout-timestamp-unit
1 parent f4596ac commit 8d45688

1 file changed

Lines changed: 5 additions & 1 deletion

File tree

docs/guides/dsp-guide.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,11 @@ The UID2 service sends the following data within seconds of a user's opt-out, wh
4949
| Parameter | Description |
5050
| :--- | :--- |
5151
| `identity` | The raw UID2 for the user who opted out. |
52-
| `timestamp` | The time when the user opted out (for information only). |
52+
| `timestamp` | The time when the user opted out, as a <a href="../ref-info/glossary-uid#gl-unix-time">Unix</a> timestamp in **seconds** (for information only). |
53+
54+
:::note
55+
The opt-out webhook `timestamp` is in **seconds**. This is different from the `opted_out_since` value returned by the [POST&nbsp;/optout/status](../endpoints/post-optout-status.md) endpoint, which is a Unix timestamp in **milliseconds**.
56+
:::
5357

5458
The DSP must respond to the opt-out data with a 200 response code.
5559

0 commit comments

Comments
 (0)