Macros de formato de arquivo file-format-macros

Lista as macros que você pode usar para criar arquivos de dados baseados em FTP. Algumas macros podem ser usadas para todos os campos e linhas do arquivo de dados. Outras macros são específicas apenas para linhas de cabeçalho e dados.

Macros comuns common-macros

Essas macros podem ser usadas em qualquer campo de formato. Para obter exemplos, consulte Exemplos de macro de formato de arquivo.

Macro
Descrição
ASCII_SOH
Um caractere ASCII não imprimível. Ele indica o início de uma linha ou de uma seção de conteúdo. Ele também pode ser usado para separar colunas de dados em um arquivo.
DPID
ID do provedor de dados de destino.
MASTER_DPID
ID do usuário Provedor de dados chave.
ORDER_ID
ID do pedido/destino.
PIDALIAS

Um alias para uma ID de pedido/destino.

O valor deste alias está definido no campo ID da Conta Estrangeira para um destino (na seção Configurações Básicas ).

SYNC_MODE

Indica o tipo de sincronização. Aceita as seguintes variáveis opcionais:

  • full: Sincronização completa.
  • iter: Sincronização incremental.
SYNC_TYPE

Indica o método de transferência de dados. Aceita as seguintes variáveis opcionais:

  • ftp
  • http
  • s3
TIMESTAMP

Um carimbo de data e hora de 10 dígitos, UTC e Unix.

Ele também pode ser formatado como YYYYMMDDhhmmss seguindo as regras de formatação de data/carimbo de data/hora Java.

Macros do campo de cabeçalho header-field-macros

Macros usadas somente em campos de cabeçalho. Para obter exemplos, consulte Exemplos de macro de formato de arquivo.

Macro
Descrição
TAB
Usada como separador, essa macro insere uma guia entre campos.

Macros de linha de dados data-row-macros

Macros usadas somente em linhas de dados. Para obter exemplos, consulte Exemplos de macro de formato de arquivo.

Macro
Descrição
CLOSE_CURLY_BRACKET
Insere uma chave fechada com } caractere.
COMMA
Insere uma vírgula.
DP_UUID

Identificador De Usuário Exclusivo Do Parceiro De Dados . Retorna a ID atribuída a um visitante do usuário/site se essa ID já tiver sido sincronizada com uma ID de dispositivo do Audience Manager .

Se a DPID for 0, essa macro retornará a ID do Audience Manager em vez da ID para o usuário.

DP_UUID_LIST
Retorna uma lista que contém várias IDs para um parceiro de dados. Isso é útil se você tiver uma grande organização com várias subdivisões ou outros grupos organizacionais com os quais poderá compartilhar dados. Esta macro retorna uma lista de IDs para esses grupos subordinados.
DPUUIDS

A saída dessa macro mapeia a ID do provedor de dados (DPID) para IDs de usuário exclusivas relacionadas (DPUUID). Esta macro deve ter uma sequência de formatação para controlar sua saída. O exemplo de saída seria semelhante ao seguinte:

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

A configuração maxMappings determina quantos mapeamentos a macro deverá retornar. Quando maxMappings=0, esta macro retorna todos os mapeamentos para cada DPID especificado. Os dados são classificados por carimbo de data e hora (o mais recente primeiro) e retornam os resultados com o maior carimbo de data e hora primeiro.

endif
Necessário ao usar as macros condicionais if e SEGMENT_LIST e REMOVED_SEGMENT_LIST.
if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif
Esta combinação de macros cria uma declaração condicional que lista os segmentos dos quais os usuários pertencem a e foram removidos. Ele retorna uma string vazia se ambas as condições não forem atendidas ou se não houver dados.
MCID
ID do Adobe Experience Cloud .
OPEN_CURLY_BRACKET
Insere uma chave de abertura { caractere.
OPT_OUT
Obsoleto. Não use.
OUTPUT_ATTRIBUTE_TYPE
Obsoleto. Não use.
OUTPUT_ATTRIBUTE_VALUE
Retorna 1 como um valor estático codificado.
PID
ID de parceiro (PID). O PID aparece na guia Perfil da interface do administrador.
REMOVED_SEGMENT_LIST
Retorna uma lista de segmentos, se houver, que foram removidos.
SEGMENT_LIST

Retorna uma lista de segmentos em uma lista. Aceita as seguintes variáveis opcionais:

  • segmentId: ID herdada. Obsoleto. Usar sid (somente minúsculas).
  • csegid: ID herdada. Obsoleto. Usar sid (somente minúsculas).
  • sid: ID do segmento.
  • type: Retorna 5, um valor estático codificado que identifica dados como dados de segmento.
  • alias: Mapeamento do segmento. Obsoleto. Usar sid (somente minúsculas).
  • lastUpdateTime: um carimbo de data/hora Unix que indica a última vez que um segmento foi realizado.

Coloque essas variáveis entre chaves após a macro. Por exemplo, este código separa os resultados com um caractere de barra vertical "|": <SEGMENT_LIST:{seg|<seg.type>,<seg.sid>}; separator="|">

SET_ATTRIBUTES
Retorna 1 como um valor estático codificado.
TAB
Insere um separador de tabulação.
TRAIT_LIST

Retorna uma lista de características. Aceita os seguintes argumentos opcionais:

  • type: Tipos de características identificados por uma ID numérica. Essa variável retorna:

    • 10 que identifica uma característica do DPM (offline, integrado por um trabalho de entrada).
    • 3 que identifica uma característica baseada em regras (em tempo real; integrado por meio do DCS ).
  • traitId: ID da característica.

  • lastRealized: Última vez que a característica foi realizada. Carimbo de data e hora Unix.

Coloque essas variáveis entre chaves após a macro. Por exemplo, este código separa os resultados com um caractere de barra vertical "|": TRAIT_LIST{type|traitId};separator="|"

UUID
ID de usuário do Audience Manager .
recommendation-more-help
3d9f8cff-f6d8-4dcd-966c-cf2ea03db934