文件Audience ManagerAudience Manager 使用手冊

輸出巨集範例 outbound-macro-examples

Last update: Sun May 21 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

一些常用宏用於建立出站檔案模板的示例。

NOTE
在桌子上， 粗臉 type標識每個宏及其相關輸出。 對於格式示例， < > 已添加符號，以幫助直觀地分隔每個宏。

檔案名宏 file-name-macros

有關可用宏和定義的清單，請參見 出站模板宏。

宏
格式和輸出示例
DPID

格式: <SYNC_TYPE>_<ORDER_ID>_ <DPID>_<SYNC_MODE>_<TIMESTAMP>.sync

輸出： ftp_215_ 888_iter_1449756724.sync

MASTER_DPID

格式: <SYNC_TYPE>_<ORDER_ID>_<DPID>_ <MASTER_DPID>_<SYNC_MODE>_<TIMESTAMP>.sync

輸出： ftp_215_888_ 20915_iter_1449756724.sync

ORDER_ID

格式: <SYNC_TYPE>_ <ORDER_ID>_<DPID>_<SYNC_MODE>_<TIMESTAMP>.sync

輸出： ftp_ 215_888_iter_1449756724.sync

SYNC_MODE

格式: <SYNC_TYPE>_<ORDER_ID>_<DPID>_ <SYNC_MODE>_<TIMESTAMP>.sync

輸出：

  • 全螢幕: ftp_215_888_ full_1449756724.sync
  • 增量： ftp_215_888_ iter_1449756724.sync
SYNC_TYPE

格式: <SYNC_TYPE>_<ORDER_ID>_<DPID>_<SYNC_MODE>_<TIMESTAMP>.sync

輸出：

  • FTP: ftp_215_888_iter_1449756724.sync
  • https: http_215_888_iter_1449756724.sync
  • S3: s3_215_888_iter_1449756724.sync
TIMESTAMP

格式: <SYNC_TYPE>_<ORDER_ID>_<DPID>_<SYNC_MODE>_ <TIMESTAMP>_<admin><.sync>

輸出： ftp_215_888_iter_ 1449756724.sync

標題行宏 header-macros

有關可用宏和定義的清單，請參見 出站模板宏。

宏
格式和輸出示例
TAB

格式: <ORDER_ID> <TAB><SYNC_TYPE>

輸出： 888 full.sync

在輸出中，非打印製表符字元分隔每個元素。

檔案內容宏 file-content-macros

有關可用宏和定義的清單，請參見 出站模板宏。

宏
格式和輸出示例
DP_UUID

格式: <DP_UUID><TAB> <UUID>

輸出： 123456 07955261652886032950143702505894272138

DP_UUID_LIST

格式: <UUID><TAB> <DP_UUID_LIST;separator=TAB>

輸出： 07955261652886032950143702505894272138 DP_UUID1 DP_UUID2 DP_UUID3

DPUUIDS
請參閱下面的單獨部分。
REMOVED_SEGMENT_LIST

格式: <DP_UUID> <REMOVED_SEGMENT_LIST;separator=" ">

輸出： 123456 105955 101183 101180 101179

SEGMENT_LIST

格式: <DP_UUID> <SEGMENT_LIST;separator=" ">

輸出： 123456 105955 101183 101180 101179

if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif

格式:

{"AdvertiserId":"<PIDALIAS>", "DataCenterId": 2,"TDID":"<DP_UUID>", "Data":[<SEGMENT_LIST:{seg|<OPEN_CURLY_BRACKET>"Name":"<seg.alias>"<CLOSE_CURLY_BRACKET>}; separator=","><if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)><COMMA><endif> <REMOVED_SEGMENT_LIST:{seg|<OPEN_CURLY_BRACKET>"Name":"<seg.alias>", "TtlInMinutes":0<CLOSE_CURLY_BRACKET>}; separator=",">]}

輸出：

//First example {"AdvertiserId":"12345", "DataCenterId": 2, "TDID":"dfd215e4-8d6b-4fdb-90b9-fab4456f2c9d","Data":[{"Name":"4321"}]} //Second example {"AdvertiserId":"12345", "DataCenterId": 2,"TDID":"9099e8fe-abab-5114-abaa-28bdaa0539ca","Data":[{"Name":"4321"},{"Name":"987","TtlInMinutes":0}, {"Name":"654","TtlInMinutes":0}]}

注：在第一個示例中，宏僅返回 SEGMENT_LIST 因為 REMOVED_SEGMENT_LIST 為空。 第二個示例返回兩個宏的資料。

SET_ATTRIBUTES

格式:

<PID><TAB><UUID><TAB><DP_UUID><TAB> <SET_ATTRIBUTES><TAB><OPT_OUT><TAB><SEGMENT_LIST:{seg|<seg.type>,<seg.alias>,<OUTPUT_ATTRIBUTE_VALUE>,<seg.lastUpdateTime>&}>

輸出：

1159 00088008579683653741516297509717335000 17t0aj01b120hp 1 0 5,103714,1,1344114661000&5,103713,1,1343250661000

TAB

格式: <DP_UUID><TAB><DP_UUID_LIST;separator=TAB>

輸出： 123456 UUID1 UUID2 UUID3

在輸出中，非打印製表符字元分隔每個元素。

TRAIT_LIST

格式: <PID><TAB><DP_UUID><TAB><SET_ATTRIBUTES><TAB> <TRAIT_LIST;separator="|">

輸出： 1131 12345 1 123|456|789

DPUUID 範例

幫助您瞭解 DPUUID 宏輸出資料，假設我們有2 DPID映射到 DPUUID如下所示：

  • DPID 1111 映射到DPUUID AAAA (時間戳= 1和 BBBB （時間戳= 2）。
  • DPID 2222 映射到DPUUID CCCC。

在這些情況下，下表列舉了一些可能的格式字串及其輸出。

映射條件
宏格式
輸出
返回單個DPID的所有映射
<DPUUIDS; format="dpids=1111|maxMappings=0|format=json">
[["1111","AAAA"],["1111","BBBB"]]
為所有DPID返回最大1個映射
<DPUUIDS; format="dpids=1111,2222|maxMappings=1|format=json">

[["1111","BBBB"],["2222","CCCC"]]

對於DPID 1111 ，宏映射到DPUUID BBBB 只是因為該ID的時間戳較大。

為單個DPID返回最多2個映射
<DPUUIDS; format="dpids=2222|maxMappings=2|format=json">

[["2222","CCCC"]]

即使 maxMappings=2 ，此宏僅返回1個DPID到DPUUID映射，因為指定的DPID只有一個DPUUID。

輸出範本巨集

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695