文件Audience Manager管理指南

檔案格式巨集 file-format-macros

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

列出可用來建立FTP型資料檔案的巨集。 有些巨集可用於所有資料檔案欄位和列。 其他巨集僅特定於標題和資料列。

通用巨集 common-macros

這些巨集可用於任何格式欄位。 如需範例，請參閱檔案格式巨集範例。

巨集
說明
ASCII_SOH
非列印ASCII字元。 它表示一列或一節內容的開頭。 它也可以用來分隔檔案中的資料欄。
DPID
目標資料提供者ID。
MASTER_DPID
使用者ID金鑰資料提供者ID。
ORDER_ID
訂單/目的地ID。
PIDALIAS

訂單/目的地ID的別名。

此別名的值設定於目的地的外部帳戶識別碼欄位中（在基本設定區段中）。

SYNC_MODE

指示同步型別。 接受下列可選變數：

  • full：完整同步處理。
  • iter：增量同步處理。
SYNC_TYPE

表示資料傳輸方法。 接受下列可選變數：

  • ftp
  • http
  • s3
TIMESTAMP

10位數、UTC、Unix時間戳記。

也可以依照Java日期/時間戳記格式規則將其格式化為YYYYMMDDhhmmss。

標題欄位巨集 header-field-macros

巨集僅用於標頭欄位。 如需範例，請參閱檔案格式巨集範例。

巨集
說明
TAB
此巨集會當作分隔符號使用，在欄位之間插入定位字元。

資料列巨集 data-row-macros

巨集僅用於資料列。 如需範例，請參閱檔案格式巨集範例。

巨集
說明
CLOSE_CURLY_BRACKET
插入右大括弧}字元。
COMMA
插入逗號。
DP_UUID

資料合作夥伴唯一使用者識別碼。 如果指派給使用者/網站訪客的ID已與Audience Manager裝置ID同步，則傳回該ID。

如果DPID為0，此巨集會傳回Audience Manager ID，而不是您使用者的識別碼。

DP_UUID_LIST
傳回包含資料合作夥伴多個ID的清單。 如果您的大型組織擁有多個子部門或您可與其共用資料的其他組織群組，這會很有用。 這個巨集會傳回這些從屬群組的ID清單。
DPUUIDS

這個巨集的輸出會將資料提供者ID (DPID)對應到相關的不重複使用者ID (DPUUID)。 此巨集必須有格式字串才能控制其輸出。 範例輸出如下所示：

"dpids=dpid1,dpid2,...dpid n|maxMappings= n|format=json"

maxMappings設定決定您想要巨集傳回多少對應。 當maxMappings=0時，此巨集會傳回每個指定DPID的所有對應。 資料會依時間戳記排序（最近的時間在前），並會先傳回時間戳記最大的結果。

endif
使用條件式if以及SEGMENT_LIST和REMOVED_SEGMENT_LIST巨集時需要。
if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif
這個巨集組合會建立條件陳述式，列出使用者屬於 和 的區段。 如果不符合兩個條件或沒有資料，則會傳回空字串。
MCID
Adobe Experience Cloud ID。
OPEN_CURLY_BRACKET
插入左大括弧{字元。
OPT_OUT
不再提倡。請勿使用。
OUTPUT_ATTRIBUTE_TYPE
不再提倡。請勿使用。
OUTPUT_ATTRIBUTE_VALUE
傳回1為靜態的硬式編碼值。
PID
合作夥伴ID (PID)。 PID出現在管理UI中的設定檔標籤下。
REMOVED_SEGMENT_LIST
傳回已移除的區段清單（若有）。
SEGMENT_LIST

傳回清單中的區段清單。 接受下列可選變數：

  • segmentId：舊版識別碼。 不再提倡。使用sid （僅限小寫）。
  • csegid：舊版識別碼。 不再提倡。使用sid （僅限小寫）。
  • sid：區段識別碼。
  • type：傳回5，這個靜態的硬式編碼值會將資料識別為區段資料。
  • alias：區段的對應。 不再提倡。使用sid （僅限小寫）。
  • lastUpdateTime：表示上次實現區段時間的Unix時間戳記。

將這些變數放在巨集後面的大括弧中。 例如，此程式碼會以垂直號「|」字元分隔結果： <SEGMENT_LIST:{seg|<seg.type>,<seg.sid>}; separator="|">

SET_ATTRIBUTES
傳回1為靜態的硬式編碼值。
TAB
插入定位字元分隔符號。
TRAIT_LIST

傳回特徵清單。 接受下列選用引數：

  • type：以數值ID識別的特徵型別。 此變數會傳回：

    • 識別DPM特徵的10 （離線、由輸入工作上線）。
    • 識別規則型特徵的3 （即時，；透過 DCS 上線）。

  • traitId：特徵識別碼。

  • lastRealized：上次實現此特徵的時間。 Unix時間戳記。

將這些變數放在巨集後面的大括弧中。 例如，此程式碼會以垂直號「|」字元分隔結果： TRAIT_LIST{type|traitId};separator="|"

UUID
Audience Manager使用者識別碼。
recommendation-more-help
3d9f8cff-f6d8-4dcd-966c-cf2ea03db934