timestamp

針對啟用時間戳記的報表套裝,timestamp 變數能手動設定點擊的時間戳記。

WARNING
如果您的報表套裝未明確設定為接受時間戳記點擊,請勿使用此變數。對於不支援時間戳記點擊的報表套裝,AppMeasurement 會自動設定點擊時間。如果您將包含此變數的點擊傳送到不支援時間戳記的報表套裝,該資料會永久遺失。

使用Web SDK的時間戳記

時間戳記為 已為Adobe Analytics進行對應 在XDM欄位下 xdm.timestamp. 此欄位僅支援Unix時間。

使用Adobe Analytics擴充功能的時間戳記

Adobe Analytics 擴充功能中沒有專用欄位可使用這個變數。請依照 AppMeasurement 語法使用自訂程式碼編輯器。

AppMeasurement和Analytics擴充功能自訂程式碼編輯器中的s.timestamp

s.timestamp 變數是包含點擊日期和時間的字串。有效的時間戳記格式包括 ISO 8601Unix時間 以秒為單位。

// 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 值

ISO 8601 表示的日期和時間,可能會採用數種不同的形式。Adobe 不支援 ISO 8601 的所有功能。

  • 日期與時間都必須提供,使用 T 分隔。
  • 小時和分鐘都是必要值;秒數是選用值,不過建議提供。
  • 不支援週日期和序數日期。
  • 日期可採用標準或延伸格式。例如 2024-01-01T00:00:00Z20240101T000000Z 都有效。
  • 技術上來說,分數形式的分鐘和秒是有效值,不過 Adobe 會忽略分數部分。
  • 支援的標準和延伸格式的時區。

以下是 timestamp 變數中的有效範例 ISO 8601 值:

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