Macros de plantillas de salida

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

Macros de nombre de archivo y encabezado de archivo

La tabla enumera y describe las macros que puede utilizar en el nombre del 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

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 del proveedor de datos clave.

NEW_LINE

Permite la creación de encabezados multilínea 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 IU de administración.

SPLITNUM

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

No es necesario que la macro SPLITNUM esté rodeada de 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) en 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 pestaña entre campos.

TIMESTAMP

Marca de tiempo UTC, Unix de 10 dígitos.

También se puede formatear como <TIMESTAMP; format="YYYYMMDDhhmmss"> siguiendo las 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 carácter } de corchete de cierre.

DP_UUID

Identificador de usuario único 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 para 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 ID para esos grupos subordinados.

DPID

ID del proveedor de datos.

DPUUIDS

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

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

La configuración maxMappings determina cuántos mapeos 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 (el más reciente primero) y devuelven primero los resultados con la marca de tiempo más grande.

if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif

Esta combinación de macros crea una afirmació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 un carácter { de corchete abierto.

OPT_OUT

Obsoleta. No usar.

ORDER_ID

ID de pedido o destino.

OUTPUT_ATTRIBUTE_TYPE

Obsoleta. No usar.

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 IU 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 de segmento. Obsoleta. Utilice sid .
  • csegid : ID de segmento de cliente. Obsoleta. Utilice sid .
  • sid : ID de segmento
  • type : Devuelve 5 , un valor estático codificado de forma rígida que identifica los datos como datos de segmento.
  • alias : Obsoleto. No usar.
  • lastUpdateTime : Marca de hora 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 de forma rígida.

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 pestaña entre campos.

TRAIT_LIST

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

  • type : Identifica los tipos de rasgos por ID numérica. Devuelve:
    • 10 que identifica un rasgo 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

ID de usuario de Audience Manager.

En esta página