DocumentazioneAudience ManagerGuida utente di Audience Manager

Esempi di macro in uscita outbound-macro-examples

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

Esempi di utilizzo di alcune delle macro comuni per la creazione di modelli di file in uscita.

NOTE
Nelle tabelle, il tipo boldface identifica ogni macro con il relativo output. Per gli esempi di formato, sono stati aggiunti i simboli < > per separare visivamente ogni macro.

Macro nome file file-name-macros

Per un elenco delle macro e delle definizioni disponibili, vedere Macro modello in uscita.

Macro
Esempi di formato e output
DPID

Formato: <SYNC_TYPE>_<ORDER_ID>_ <DPID>_<SYNC_MODE>_<TIMESTAMP>.sync

Output: ftp_215_ 888_iter_1449756724.sync

MASTER_DPID

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

Output: ftp_215_888_ 20915_iter_1449756724.sync

ORDER_ID

Formato: <SYNC_TYPE>_ <ORDER_ID>_<DPID>_<SYNC_MODE>_<TIMESTAMP>.sync

Output: ftp_ 215_888_iter_1449756724.sync

SYNC_MODE

Formato: <SYNC_TYPE>_<ORDER_ID>_<DPID>_ <SYNC_MODE>_<TIMESTAMP>.sync

Output:

  • Completo: ftp_215_888_ full_1449756724.sync
  • Incrementale: ftp_215_888_ iter_1449756724.sync
SYNC_TYPE

Formato: <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

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

Output: ftp_215_888_iter_ 1449756724.sync

Macro righe intestazione header-macros

Per un elenco delle macro e delle definizioni disponibili, vedere Macro modello in uscita.

Macro
Esempi di formato e output
TAB

Formato: <ORDER_ID> <TAB><SYNC_TYPE>

Output: 888 full.sync

Nell'output, il carattere di tabulazione non stampabile separa ciascun elemento.

Macro contenuto file file-content-macros

Per un elenco delle macro e delle definizioni disponibili, vedere Macro modello in uscita.

Macro
Esempi di formato e output
DP_UUID

Formato: <DP_UUID><TAB> <UUID>

Output: 123456 07955261652886032950143702505894272138

DP_UUID_LIST

Formato: <UUID><TAB> <DP_UUID_LIST;separator=TAB>

Output: 07955261652886032950143702505894272138 DP_UUID1 DP_UUID2 DP_UUID3

DPUUIDS
Vedi la sezione separata di seguito.
REMOVED_SEGMENT_LIST

Formato: <DP_UUID> <REMOVED_SEGMENT_LIST;separator=" ">

Output: 123456 105955 101183 101180 101179

SEGMENT_LIST

Formato: <DP_UUID> <SEGMENT_LIST;separator=" ">

Output: 123456 105955 101183 101180 101179

if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif

Formato:

{"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}]}

Nota: nel primo esempio, la macro restituisce solo i dati per SEGMENT_LIST perché REMOVED_SEGMENT_LIST è vuoto. Nel secondo esempio vengono restituiti i dati per entrambe le macro.

SET_ATTRIBUTES

Formato:

<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

Formato: <DP_UUID><TAB><DP_UUID_LIST;separator=TAB>

Output: 123456 UUID1 UUID2 UUID3

Nell'output, il carattere di tabulazione non stampabile separa ciascun elemento.

TRAIT_LIST

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

Output: 1131 12345 1 123|456|789

DPUUID esempi

Per aiutarti a capire in che modo la macro DPUUID restituisce i dati, supponiamo di avere 2 DPID mappati a DPUUID come mostrato di seguito:

  • DPID 1111 è mappato ai DPUUID AAAA (timestamp = 1) e BBBB (timestamp = 2).
  • DPID 2222 è mappato a DPUUID CCCC.

Date queste condizioni, la tabella seguente elenca alcune possibili stringhe di formato e il relativo output.

Condizione di mappatura
Formato macro
Output
Restituisce tutte le mappature per un singolo DPID
<DPUUIDS; format="dpids=1111|maxMappings=0|format=json">
[["1111","AAAA"],["1111","BBBB"]]
Restituisce un massimo di 1 mappatura per tutti i DPID
<DPUUIDS; format="dpids=1111,2222|maxMappings=1|format=json">

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

Per DPID 1111 , la macro viene mappata su DPUUID BBBB solo perché l'ID ha la marca temporale più grande.

Restituisce un massimo di 2 mappature per un singolo DPID
<DPUUIDS; format="dpids=2222|maxMappings=2|format=json">

[["2222","CCCC"]]

Anche se maxMappings=2 , questa macro restituisce solo 1 DPID alla mappatura DPUUID perché il DPID specificato ha un solo DPUUID.

Macro modello in uscita

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