Macros de formato de archivo file-format-macros

Enumera las macros que puede utilizar para crear archivos de datos basados en FTP. Algunas macros se pueden utilizar para todos los campos y filas del archivo de datos. Otras macros son específicas del encabezado y de las filas de datos únicamente.

Macros comunes common-macros

Estas macros se pueden utilizar en cualquier campo de formato. Para ver ejemplos, vea Ejemplos de macros de formato de archivo.

Macro
Descripción
ASCII_SOH
Un carácter ASCII no imprimible. Indica el inicio de una fila o una sección de contenido. También se puede utilizar para separar columnas de datos en un archivo.
DPID
ID del proveedor de datos de destino.
MASTER_DPID
ID de usuario ID de proveedor de datos clave.
ORDER_ID
ID de pedido/destino.
PIDALIAS

Un alias para un ID de pedido/destino.

El valor de este alias se establece en el campo Id. de cuenta externa para un destino (en la sección Configuración básica ).

SYNC_MODE

Indica el tipo de sincronización. Acepta las siguientes variables opcionales:

  • full: sincronización completa.
  • iter: sincronización incremental.
SYNC_TYPE

Indica el método de transferencia de datos. Acepta las siguientes variables opcionales:

  • ftp
  • http
  • s3
TIMESTAMP

Una marca de tiempo Unix, UTC y de 10 dígitos.

También se le puede aplicar el formato YYYYMMDDhhmmss según las reglas de formato de fecha y hora de Java.

Macros de campo de encabezado header-field-macros

Macros utilizadas solo en campos de encabezado. Para ver ejemplos, vea Ejemplos de macros de formato de archivo.

Macro
Descripción
TAB
Utilizada como separador, esta macro inserta una tabulación entre los campos.

Macros de fila de datos data-row-macros

Macros utilizadas solo en filas de datos. Para ver ejemplos, vea Ejemplos de macros de formato de archivo.

Macro
Descripción
CLOSE_CURLY_BRACKET
Inserta un carácter de llave cerrada }.
COMMA
Inserta una coma.
DP_UUID

Identificador De Usuario Único Del Socio De Datos . Devuelve el identificador que asignó a un usuario o visitante del sitio si ese identificador ya se ha sincronizado con un identificador de dispositivo Audience Manager .

Si el DPID es 0, esta macro devolverá el ID de Audience Manager en lugar del ID del usuario.

DP_UUID_LIST
Devuelve una lista que contiene varios ID de un socio de datos. Esto resulta útil si tiene una organización grande con varias subdivisiones u otros grupos organizativos con los que puede compartir datos. Esta macro devuelve una lista de los identificadores de esos grupos subordinados.
DPUUIDS

El resultado de esta macro asigna el ID del proveedor de datos (DPID) a los ID de usuario únicos relacionados (DPUUID). Esta macro debe tener una cadena de formato para controlar su resultado. El resultado de la muestra sería similar al siguiente:

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

La configuración maxMappings determina cuántas asignaciones desea que devuelva la macro. Cuando maxMappings=0, esta macro devuelve todas las asignaciones para cada DPID especificado. Los datos se ordenan por marca de tiempo (más reciente primero) y devuelve los resultados con la marca de tiempo más grande primero.

endif
Requerido al usar las macros condicionales if y SEGMENT_LIST y REMOVED_SEGMENT_LIST.
if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif
Esta combinación de macros crea una declaración condicional que enumera los segmentos a los que pertenecen los usuarios de y de los que se han eliminado . Devuelve una cadena vacía si no se cumplen ambas condiciones o si no hay datos.
MCID
ID. de Adobe Experience Cloud.
OPEN_CURLY_BRACKET
Inserta un carácter de llave { abierto.
OPT_OUT
Obsoleta. No utilice.
OUTPUT_ATTRIBUTE_TYPE
Obsoleta. No utilice.
OUTPUT_ATTRIBUTE_VALUE
Devuelve 1 como un valor estático codificado.
PID
ID de socio (PID). El PID aparece en la ficha del perfil en la interfaz de usuario de administración.
REMOVED_SEGMENT_LIST
Devuelve una lista de los segmentos que se han eliminado, si los hay.
SEGMENT_LIST

Devuelve una lista de segmentos de una lista. Acepta las siguientes variables opcionales:

  • segmentId: ID heredado. Obsoleta. Usar sid (solo minúsculas).
  • csegid: ID heredado. Obsoleta. Usar sid (solo minúsculas).
  • sid: ID de segmento.
  • type: devuelve 5, un valor estático codificado que identifica los datos como datos de segmento.
  • alias: asignación del segmento. Obsoleta. Usar sid (solo minúsculas).
  • lastUpdateTime: una marca de tiempo Unix que indica la última vez que se realizó un segmento.

Coloque estas variables entre llaves después de la macro. Por ejemplo, este código separa los resultados con una barra vertical "|": <SEGMENT_LIST:{seg|<seg.type>,<seg.sid>}; separator="|">

SET_ATTRIBUTES
Devuelve 1 como un valor estático codificado.
TAB
Inserta un separador de tabulaciones.
TRAIT_LIST

Devuelve una lista de características. Acepta los siguientes argumentos opcionales:

  • type: tipos de rasgos identificados por un identificador numérico. Esta variable devuelve:

    • 10 que identifica un rasgo de DPM (sin conexión, incorporado por un trabajo entrante).
    • 3 que identifica un rasgo basado en reglas (en tiempo real,; incorporado a través de DCS ).
  • traitId: ID de rasgo.

  • lastRealized: última vez que se realizó el rasgo. Marca de tiempo Unix.

Coloque estas variables entre llaves después de la macro. Por ejemplo, este código separa los resultados con una barra vertical "|": TRAIT_LIST{type|traitId};separator="|"

UUID
ID de usuario de Audience Manager.
recommendation-more-help
audience-manager-admin-help-admin