Macros de plantillas de salida

Última actualización: 2023-05-20

Enumera las macros que puede utilizar para crear plantillas salientes. Estas incluyen macros de nombre de archivo, macros de encabezado y macros de contenido.

Nombre de archivo y macros de encabezado de archivo

En la tabla se enumeran y describen las macros que se pueden utilizar en el nombre de archivo y para definir los campos de encabezado. Para ver ejemplos de código, consulte Ejemplos de macros de salida.

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.

MASTER_DPID

ID de usuario ID de proveedor de datos clave.

NEW_LINE

Permite la creación de encabezados de varias líneas para pedidos salientes.

ORDER_ID

ID de pedido/destino.

PID_ALIAS

Un alias para un ID de pedido/destino.

El alias se establece en la interfaz de usuario de administración.

SPLITNUM

Indica la división de los archivos salientes en varias partes. Reemplace la sección SPLITNUM del nombre del fichero por el número de pieza precedido por ceros, asegurándose de un mínimo de tres caracteres para la sección SPLITNUM.

No es necesario que la macro SPLITNUM esté rodeada por caracteres <>.

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

s3_123456_9999_full_1566906141001.csv

s3_123456_9999_full_1566906141002.csv

s3_123456_9999_full_1566906141003.csv

Los tres últimos dígitos (001 002 003) de los ejemplos anteriores son los identificadores SPLITNUM.

SYNC_MODE

Indica el tipo de sincronización e incluye:

  • full : Sincronización completa.
  • iter : Sincronización incremental.

SYNC_TYPE

Indica el método de transferencia de datos e incluye:

  • ftp
  • http
  • s3

TAB

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

TIMESTAMP

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

También se le puede dar el formato <TIMESTAMP; format="YYYYMMDDhhmmss"> siguientes reglas de formato de fecha y hora de Java.

Macros de contenido

Macros utilizadas para dar formato al contenido de un archivo de datos. Para ver ejemplos de código, consulte Ejemplos de macros de salida.

Macro Descripción

CLOSE_CURLY_BRACKET

Inserta un corchete de cierre } carácter.

DP_UUID

Identificador único de usuario del proveedor de datos .

Este es el ID del socio de datos al que envía los datos en un archivo saliente.

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.

DPID

ID del proveedor de datos.

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"

El maxMappings la configuración determina cuántas asignaciones desea que devuelva la macro. Cuándo 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.

if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif

Esta combinación de macros crea una instrucción condicional que enumera los segmentos a los que pertenecen los usuarios y de los que se han eliminado. Devuelve una cadena vacía si no se cumplen ambas condiciones o si no hay datos.

MCID

Adobe Experience Cloud ID.

OPEN_CURLY_BRACKET

Inserta una llave de apertura { carácter.

OPT_OUT

Obsoleta. No utilice.

ORDER_ID

ID de pedido o destino.

OUTPUT_ATTRIBUTE_TYPE

Obsoleta. No utilice.

OUTPUT_ATTRIBUTE_VALUE

Devuelve 1 como un valor estático codificado.

PID

ID de socio.

PIDALIAS

Un alias para un ID de pedido/destino.

El alias se establece 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 los siguientes argumentos opcionales:

  • segmentId : ID del segmento. Obsoleta. Utilice sid .
  • csegid : ID del segmento de cliente. Obsoleta. Utilice sid .
  • sid : ID del segmento
  • type : Devuelve 5 , un valor estático y codificado que identifica los datos como datos de segmento.
  • alias : Obsoleto. No utilice.
  • lastUpdateTime : Una marca de tiempo Unix que indica el último estado de pertenencia de segmento de tiempo que se actualizó.
  • lastRealizationTime : 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 un carácter de barra vertical "|": <SEGMENT_LIST:{seg|<seg.type>,<seg.sid>}; separator=",">

SET_ATTRIBUTES

Devuelve 1 , como un valor estático codificado.

SYNC_MODE

Indica el tipo de sincronización e incluye:

  • full : Sincronización completa.
  • iter : Sincronización incremental.

SYNC_TYPE

Indica el método de transferencia de datos e incluye:

  • ftp
  • http
  • s3

TAB

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

TRAIT_LIST

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

  • type : identifica los tipos de rasgos por ID numérico. 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 del DCS).
  • traitId : ID de rasgo.
  • lastRealized : la ú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 un carácter de barra vertical "|": <TRAIT_LIST:{trait|<trait.Id>,<trait.lastRealized>};separator=","

UUID

Audience Manager ID de usuario.

En esta página