文件Audience ManagerAudience Manager 使用手冊

輸出範本巨集 outbound-template-macros

Last update: Tue Jun 28 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

列出可用於建立出站模板的宏。 這些宏包括檔案名宏、標題宏和內容宏。

檔案名和檔案頭宏 file-name-header-macros

該表列出並說明了可在檔案名中使用的宏以及定義標題欄位。 有關代碼示例，請參見 出站宏示例。

宏
說明
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時間戳。

也可以將其格式化為 <TIMESTAMP; format="YYYYMMDDhhmmss"> 遵循Java日期/時間戳格式設定規則。

內容宏 content-macros

用於格式化資料檔案內容的宏。 有關代碼示例，請參見 出站宏示例。

宏
說明
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 :段ID。 不再提倡。使用 sid 。
  • csegid :客戶段ID。 不再提倡。使用 sid 。
  • sid :段ID
  • 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標識特徵類型。 傳回:

    • 10 標識DPM特性（離線，由入站作業掛接）。
    • 3 它標識基於規則的特性（即時，通過DCS連接）。

  • traitId :特徵ID

  • lastRealized :上次這個特徵被發現。 Unix時間戳。

將這些變數放在宏後面的大括弧中。 例如，此代碼用管道「|」字元分隔結果： <TRAIT_LIST:{trait|<trait.Id>,<trait.lastRealized>};separator=","

UUID
Audience Manager 用戶ID。
Related Articles
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695