文档Audience ManagerAudience Manager 用户指南

出站宏示例 outbound-macro-examples

Last update: Sat May 20 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

如何使用部分通用巨集建立輸出檔案範本的範例。

NOTE
在表格中， 粗體 type會識別每個巨集及其相關輸出。 对于格式示例， < > 添加了符号以帮助直观地分隔每个宏。

文件命名宏 file-name-macros

有关可用宏和定义的列表，请参阅 出站模板宏。

宏观
格式和 Output 示例
DPID

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

Output（输出）: ftp_215_ 888_iter_1449756724.sync

MASTER_DPID

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

Output（输出）: ftp_215_888_ 20915_iter_1449756724.sync

ORDER_ID

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

Output（输出）: ftp_ 215_888_iter_1449756724.sync

SYNC_MODE

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

Output（输出）:

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

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

Output（输出）:

  • 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>

Output（输出）: ftp_215_888_iter_ 1449756724.sync

标题行宏 header-macros

有关可用宏和定义的列表，请参阅 出站模板宏。

宏观
格式和 Output 示例
TAB

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

Output（输出）: 888 full.sync

在输出中，非打印选项卡字符将分隔每个元素。

文件内容宏 file-content-macros

如需可用巨集和定義的清單，請參閱 輸出範本巨集.

巨集
格式和輸出範例
DP_UUID

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

Output（输出）: 123456 07955261652886032950143702505894272138

DP_UUID_LIST

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

Output（输出）: 07955261652886032950143702505894272138 DP_UUID1 DP_UUID2 DP_UUID3

DPUUIDS
请参阅下面的单独部分。
REMOVED_SEGMENT_LIST

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

Output（输出）: 123456 105955 101183 101180 101179

SEGMENT_LIST

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

Output（输出）: 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=",">]}

Output（输出）:

//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>&}>

Output（输出）:

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

TAB

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

Output（输出）: 123456 UUID1 UUID2 UUID3

在输出中，非打印选项卡字符将分隔每个元素。

TRAIT_LIST

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

Output（输出）: 1131 12345 1 123|456|789

DPUUID 示例

为了帮助您了解宏如何 DPUUID 输出数据，我们假定我们有 2 DPID 个映射到 DPUUID s，如下所示：

  • DPID 1111 映射到宏 AAAA （timestamp = 1）和 BBBB （timestamp = 2）。
  • DPID 2222 映射到 DPUUID CCCC 。

鉴于这些条件，下表列举了一些可能的格式字符串及其输出。

對應條件
巨集格式
Output（输出）
返回单个 DPID 的所有映射
<DPUUIDS; format="dpids=1111|maxMappings=0|format=json">
[["1111","AAAA"],["1111","BBBB"]]
为所有 DPIDs 返回最多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 ，此宏只会为 DPUUID 映射返回1个 DPID，因为指定的 DPID 只有一个 DPUUID。

出站模板宏

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