Macro sui modelli in uscita

Elenca le macro utilizzabili per creare modelli in uscita. Tra questi sono incluse le macro dei nomi file, le macro di intestazione e le macro di contenuto.

Macro su nome file e intestazione file

Nella tabella sono elencate e descritte le macro utilizzabili nel nome file e per definire i campi di intestazione. Per esempi di codice, vedere Esempi di macro in uscita.

Macro Descrizione

ASCII_SOH

Un carattere ASCII non stampabile. Indica l’inizio di una riga o di una sezione di contenuto. Può essere utilizzato anche per separare le colonne di dati in un file .

DPID

ID provider dati.

MASTER_DPID

ID utente ID provider dati chiave.

NEW_LINE

Consente la creazione di intestazioni su più righe per gli ordini in uscita.

ORDER_ID

ID ordine/destinazione.

PID_ALIAS

Un alias per un ID ordine/destinazione.

L’alias è impostato nell’interfaccia utente di amministrazione.

SPLITNUM

Indica la suddivisione dei file in uscita in più parti. Sostituire la sezione SPLITNUM nel nome del file con il numero di parte preceduto da zeri, garantendo un minimo di tre caratteri per la sezione SPLITNUM.

La macro SPLITNUM non deve essere circondata da caratteri <>.

Esempio: <SYNC_TYPE>_<ORDER_ID>_<DPID>_<SYNC_MODE>_<TIMESTAMP>SPLITNUM.csv

s3_123456_999_full_1566906141001.csv

s3_123456_999_full_1566906141002.csv

s3_123456_999_full_1566906141003.csv

Le ultime tre cifre (001.002.003) negli esempi sopra riportati sono gli identificatori SPLITNUM.

SYNC_MODE

Indica il tipo di sincronizzazione e include:

  • full : Sincronizzazione completa.
  • iter : Sincronizzazione incrementale.

SYNC_TYPE

Indica il metodo di trasferimento dati e include:

  • ftp
  • http
  • s3

TAB

Utilizzata come separatore, questa macro inserisce una scheda tra i campi.

TIMESTAMP

Un timestamp a 10 cifre, UTC, Unix.

Può anche essere formattato come <TIMESTAMP; format="YYYYMMDDhhmmss"> seguendo le regole di formattazione Java date/timestamp .

Macro sui contenuti

Macro utilizzate per formattare il contenuto di un file di dati. Per esempi di codice, vedere Esempi di macro in uscita.

Macro Descrizione

CLOSE_CURLY_BRACKET

Inserisce una parentesi graffa chiusa }.

DP_UUID

Identificatore utente univoco del provider di dati .

Questo è l’ID del partner dati a cui invii i dati in un file in uscita.

DP_UUID_LIST

Restituisce un elenco che contiene più ID per un partner dati. Questa funzione è utile se disponi di un’organizzazione di grandi dimensioni con più sottodivisioni o altri gruppi organizzativi con cui puoi condividere i dati. Questa macro restituisce un elenco degli ID per i gruppi subordinati.

DPID

ID provider dati.

DPUUIDS

L'output di questa macro mappa l'ID del provider di dati (DPID) agli ID utente univoci correlati (DPUUID). Per controllare l'output di questa macro deve essere presente una stringa di formattazione. L'output di esempio sarà simile al seguente:

"dpids=dpid1,dpid2,...dpid n|maxMappings= n|format=json"

L'impostazione maxMappings determina il numero di mappature che dovranno essere restituite dalla macro. Quando maxMappings=0 , questa macro restituisce tutte le mappature per ogni DPID specificato. I dati vengono ordinati per marca temporale (la prima più recente) e restituisce per prime i risultati con la marca temporale più grande.

if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif

Questa combinazione di macro crea un’istruzione condizionale in cui sono elencati i segmenti a cui gli utenti appartengono e da cui sono stati rimossi. Restituisce una stringa vuota se entrambe le condizioni non sono soddisfatte o se non sono presenti dati.

MCID

Adobe Experience Cloud ID.

OPEN_CURLY_BRACKET

Inserisce una parentesi graffa aperta {.

OPT_OUT

Obsoleto. Non usare.

ORDER_ID

ID ordine o destinazione.

OUTPUT_ATTRIBUTE_TYPE

Obsoleto. Non usare.

OUTPUT_ATTRIBUTE_VALUE

Restituisce 1 come valore statico e di codifica fissa.

PID

ID partner.

PIDALIAS

Un alias per un ID ordine/destinazione.

L’alias è impostato nell’interfaccia utente di amministrazione.

REMOVED_SEGMENT_LIST

Restituisce un elenco degli eventuali segmenti rimossi.

SEGMENT_LIST

Restituisce un elenco di segmenti in un elenco. Accetta i seguenti argomenti facoltativi:

  • segmentId : ID segmento. Obsoleto. Utilizza sid .
  • csegid : ID del segmento del cliente. Obsoleto. Utilizza sid .
  • sid : ID segmento
  • type : Restituisce 5 , un valore statico e codificato che identifica i dati come dati del segmento.
  • alias : Obsoleto. Non usare.
  • lastUpdateTime : Timestamp Unix che indica l’ultima volta che un segmento è stato realizzato.

Inserisci queste variabili tra parentesi graffe dopo la macro. Ad esempio, questo codice separa i risultati con un carattere barra verticale "|": <SEGMENT_LIST:{seg|<seg.type>,<seg.sid>}; separator=",">

SET_ATTRIBUTES

Restituisce 1 come valore statico e di codifica fissa.

SYNC_MODE

Indica il tipo di sincronizzazione e include:

  • full : Sincronizzazione completa.
  • iter : Sincronizzazione incrementale.

SYNC_TYPE

Indica il metodo di trasferimento dati e include:

  • ftp
  • http
  • s3

TAB

Utilizzata come separatore, questa macro inserisce una scheda tra i campi.

TRAIT_LIST

Restituisce un elenco di caratteristiche. Accetta i seguenti argomenti facoltativi:

  • type : Identifica i tipi di caratteristiche in base all’ID numerico. Restituisce:
    • 10 che identifica una caratteristica DPM (offline, onboarded da un processo in entrata).
    • 3 che identifica un tratto basato su regole (in tempo reale, integrato attraverso il DCS).
  • traitId : ID caratteristica.
  • lastRealized : L'ultima volta che la caratteristica è stata realizzata. Timestamp Unix.

Inserisci queste variabili tra parentesi graffe dopo la macro. Ad esempio, questo codice separa i risultati con un carattere barra verticale "|": <TRAIT_LIST:{trait|<trait.Id>,<trait.lastRealized>};separator=","

UUID

Audience Manager di ID utente.

In questa pagina