文件 Audience Manager Audience Manager 使用手冊

輸出範本巨集

最後更新： 2024年7月20日

主題：

列出可用來建立輸出範本的巨集。這些包括檔案名稱巨集、標題巨集和內容巨集。

檔案名稱和檔案標題巨集

此表格列出並描述可在檔案名稱中使用的巨集以及定義標頭欄位。如需程式碼範例，請參閱輸出巨集範例。

巨集	說明
`ASCII_SOH`	非列印ASCII字元。它表示一列或一節內容的開頭。它也可以用來分隔檔案中的資料欄。
`DPID`	資料提供者ID。
`MASTER_DPID`	使用者ID金鑰資料提供者ID。
`NEW_LINE`	允許建立出埠訂單的多行表頭。
`ORDER_ID`	訂單/目的地ID。
`PID_ALIAS`	訂單/目的地ID的別名。別名是在管理員UI中設定。
`SPLITNUM`	指示將輸出檔案分割成多個零件。將檔案名稱中的SPLITNUM區段取代為前面加零的零件編號，確保SPLITNUM區段至少有三個字元。 SPLITNUM巨集不需要由<>字元包圍。範例： `<SYNC_TYPE>_<ORDER_ID>_<DPID>_<SYNC_MODE>_<TIMESTAMP>SPLITNUM.csv` s3_123456_9999_full_1566906141001.csv s3_123456_9999_full_1566906141002.csv s3_123456_9999_full_1566906141003.csv 上述範例中的最後三位數(001,002,003)是SPLITNUM識別碼。
`SYNC_MODE`	指示同步化型別並包含： `full` ：完整同步處理。 `iter` ：增量同步處理。
`SYNC_TYPE`	表示資料傳輸方法並包含： `ftp` `http` `s3`
`TAB`	此巨集會當作分隔符號使用，在欄位之間插入定位字元。
`TIMESTAMP`	10位數、UTC、Unix時間戳記。也可以依照Java日期/時間戳記格式規則將其格式化為 `<TIMESTAMP; format="YYYYMMDDhhmmss">` 。

內容巨集

用來格式化資料檔案內容的巨集。如需程式碼範例，請參閱輸出巨集範例。

巨集	說明
`CLOSE_CURLY_BRACKET`	插入右大括弧`}`字元。
`DP_UUID`	資料提供者唯一使用者識別碼。這是您在傳出檔案中傳送資料的目的地資料合作夥伴ID。
`DP_UUID_LIST`	傳回包含資料合作夥伴多個ID的清單。如果您的大型組織擁有多個子部門或您可與其共用資料的其他組織群組，這會很有用。這個巨集會傳回這些從屬群組的ID清單。
`DPID`	資料提供者ID。
`DPUUIDS`	這個巨集的輸出會將資料提供者ID (DPID)對應到相關的不重複使用者ID (DPUUID)。此巨集必須有格式字串才能控制其輸出。範例輸出如下所示： `"dpids=dpid1,dpid2,...dpid n\|maxMappings= n\|format=json"` `maxMappings` 設定決定您想要巨集傳回多少對應。當 `maxMappings=0` 時，此巨集會傳回每個指定DPID的所有對應。資料會依時間戳記排序（最近的時間在前），並會先傳回時間戳記最大的結果。
`if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif`	這個巨集組合會建立條件陳述式，列出使用者所屬及已移除的區段。如果不符合兩個條件或沒有資料，則會傳回空字串。
`MCID`	Adobe Experience Cloud ID。
`OPEN_CURLY_BRACKET`	插入左大括弧`{`字元。
`OPT_OUT`	不再提倡。請勿使用。
`ORDER_ID`	訂單或目的地ID。
`OUTPUT_ATTRIBUTE_TYPE`	不再提倡。請勿使用。
`OUTPUT_ATTRIBUTE_VALUE`	傳回 `1` 為靜態的硬式編碼值。
`PID`	合作夥伴ID。
`PIDALIAS`	訂單/目的地ID的別名。別名是在管理員UI中設定。
`REMOVED_SEGMENT_LIST`	傳回已移除的區段清單（若有）。
`SEGMENT_LIST`	傳回清單中的區段清單。接受下列選用引數： `segmentId` ：區段識別碼。不再提倡。使用 `sid` 。 `csegid` ：客戶區段識別碼。不再提倡。使用 `sid` 。 `sid` ：區段識別碼 `type` ：傳回 `5` ，這個靜態的硬式編碼值會將資料識別為區段資料。 `alias` ：已棄用。請勿使用。 `lastUpdateTime` ：表示上次更新區段會籍狀態的Unix時間戳記。 `lastRealizationTime` ：表示上次實現區段時間的Unix時間戳記。將這些變數放在巨集後面的大括弧中。例如，此程式碼會以垂直號「\|」字元分隔結果： `<SEGMENT_LIST:{seg\|<seg.type>,<seg.sid>}; separator=",">`
`SET_ATTRIBUTES`	傳回 `1` 做為靜態的硬式編碼值。
`SYNC_MODE`	指示同步化型別並包含： `full` ：完整同步處理。 `iter` ：增量同步處理。
`SYNC_TYPE`	表示資料傳輸方法並包含： `ftp` `http` `s3`
`TAB`	此巨集會當作分隔符號使用，在欄位之間插入定位字元。
`TRAIT_LIST`	傳回特徵清單。接受下列選用引數： `type` ：依數值ID識別特徵型別。傳回：識別DPM特徵的 `10` （離線、由輸入工作上線）。 `3` 可識別規則型特徵（即時、透過DCS上線）。 `traitId` ：特徵識別碼。 `lastRealized` ：上次實現此特徵的時間。 Unix時間戳記。將這些變數放在巨集後面的大括弧中。例如，此程式碼會以垂直號「\|」字元分隔結果： `<TRAIT_LIST:{trait\|<trait.Id>,<trait.lastRealized>};separator=","`
`UUID`	Audience Manager使用者識別碼。

recommendation-more-help