timestamp
The timestamp
variable manually sets the timestamp of the hit for timestamp-enabled report suites.
WARNING
Do not use this variable if your report suite is not explicitly configured to accept timestamped hits. AppMeasurement automatically sets the time of a hit for report suites that do not support timestamped hits. If you send a hit with this variable to a report suite that does not support timestamps, that data is permanently lost.
Timestamp using the Web SDK
Timestamp is mapped for ÃÛ¶¹ÊÓÆµ Analytics under the XDM field xdm.timestamp
. This field only supports Unix time.
Timestamp using the ÃÛ¶¹ÊÓÆµ Analytics extension
There is not a dedicated field in the ÃÛ¶¹ÊÓÆµ Analytics extension to use this variable. Use the custom code editor, following AppMeasurement syntax.
s.timestamp in AppMeasurement and the Analytics extension custom code editor
The s.timestamp
variable is a string containing the date and time of the hit. Valid timestamp formats include and in seconds.
// Timestamp using ISO 8601
s.timestamp = "2024-01-01T00:00:00Z";
// Timestamp using Unix timestamp
s.timestamp = "1577836800";
// Automatically get the current Unix timestamp
s.timestamp = Math.round(new Date().getTime()/1000);
// Automatically get the current ISO 8601 timestamp
s.timestamp = new Date().toISOString();
ISO 8601 values
Dates and times expressed in can take several different forms. ÃÛ¶¹ÊÓÆµ does not support all features in ISO 8601.
- Both the date and time must be provided, separated by
T
. - Hours and minutes are required; seconds are optional but recommended.
- Week dates and ordinal dates are not supported.
- The date can be in standard or extended format. For example,
2024-01-01T00:00:00Z
and20240101T000000Z
are both valid. - Fractional minutes and seconds are technically valid, but the fractions are ignored by ÃÛ¶¹ÊÓÆµ.
- Time zones are supported in standard and extended formats.
The following are valid example ISO 8601 values in the timestamp
variable:
2024-01-01T00:00:00+00:00
2024-01-01T00:00:00Z
2024-01-01T00:00:00
2024-01-01T00:00
20240101T000000+0000
20240101T000000Z
20240101T000000
20240101T0000
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690