文件Audience Manager管理指南

HTTP 格式巨集 http-format-macros

Last update: Mon Aug 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

列出可用來建立HTTP個資料檔案的巨集。 HTTP以JSON格式傳送資料。

請參閱HTTP格式巨集範例，以取得一些常用巨集組合的清單與範例。

巨集
方法型別
說明
AAM_UUID
GET
Audience Manager ID。
DP_UUID
GET
資料合作夥伴不重複使用者ID。 如果使用者的ID已與 Audience Manager 裝置ID同步，此巨集會傳回您已指派給該使用者的識別碼。
DPID
GET
資料提供者ID。
ECID
GET
資料提供者ID。
GENERATION_TIME
GET, POST
Unix UTC時間戳記。 內部時間戳記，代表AAM收到通知，要將 S2S 目的地發佈給合作夥伴的時間。
IP
GET
使用者的IP位址。
MCID
GET
Experience Cloud ID。(MCID代表Marketing Cloud，這是Experience Cloud的舊稱)
NUM_REMOVED_SEGMENTS
GET
使用者不再屬於的區段數（整數）。
NUM_SEGMENTS
GET
使用者所屬的區段數。
ORDER_ID
GET, POST
訂單或目的地ID。
PID_ALIAS
GET, POST
合作夥伴ID的別名。 也稱為外部帳戶ID。
RANDOM
GET
產生隨機數字。
REGION_ID_LIST
GET
活動來源的 Audience Manager DCS區域。
REMOVED_SEGMENT_LIST
GET
傳回使用者不再符合資格的區段ID清單（若有）。
REMOVED_SEGMENTS
GET

使用者不再符合資格的區段清單。 您也可以傳回包含下列專案的特定區段欄位：

  • traitAlias
  • legacySegmentId (formerly segmentId)
  • newSegmentId
  • status
  • dateTime

在陣列中指定這些欄位，如以下範例所示：

[<REMOVED_SEGMENTS:{seg|<OPEN_BRACKET>"Mapping":<seg.traitAlias>,"Status:"<seg.status>, "Time":<seg.dateTime>,"LegacySegmentId":<seg.LegacySegmentId>, "NewSegmentId":<seg.NewSegmentId><CLOSE_BRACKET>}; "separator=",">]

另請參閱 HTTP格式巨集範例。

REMOVED_TIME_LIST
GET
使用者不再符合資格之區段的上次實現清單。
REMOVED_TRAITALIAS_LIST
GET
使用者不再符合資格之區段的別名名稱清單。
SEGMENT_LIST
GET
傳回區段ID清單。
SEGMENTS
GET

使用者符合資格的區段清單。 您也可以傳回包含下列專案的特定區段欄位：

  • traitAlias
  • legacySegmentId (formerly segmentId)
  • newSegmentId
  • status
  • dateTime

在陣列中指定這些欄位，如以下範例所示：

[<SEGMENTS:{seg|<OPEN_BRACKET>"Mapping":<seg.traitAlias>,"Status:"<seg.status>, "Time":<seg.dateTime>,"LegacySegmentId":<seg.LegacySegmentId>, "NewSegmentId":<seg.NewSegmentId><CLOSE_BRACKET>}; "separator=",">]

另請參閱 HTTP格式巨集範例。

TIME_LIST
GET
上次實現的清單。
TIMESTAMP
GET
Unix、UTC時間戳記。 代表最後實現的區段。
TRAITALIAS_LIST
GET
特定區段的別名名稱清單。
USER_AGENT
GET
初始請求的使用者代理。
USER_LIST
POST

Audience Manager 使用者ID的清單。 您也可以傳回包含以下內容的特定欄位：

  • user.aamUuid
  • user.dpUuid
  • user.segments
  • user.removedSegments
  • user.userAgent
  • user.ip
  • user.dpuuids
  • user.timestamp
  • user.random
  • user.regionIds

指定下列欄位，如下列範例所示：

"AAM_UUID"： "<user.aamUuid>" "DataPartner_UUID"： "<user.dpUuid>"

如需完整範例，另請參閱 HTTP格式巨集範例。

recommendation-more-help
3d9f8cff-f6d8-4dcd-966c-cf2ea03db934