Beta

(Beta) Usar campos calculados para exportar matrizes em arquivos de esquema simples

Saiba como exportar matrizes por meio de campos calculados do Real-Time CDP em arquivos de esquema simples para destinos de armazenamento na nuvem. Leia este documento para entender os casos de uso ativados por essa funcionalidade.

Obtenha informações abrangentes sobre campos calculados - o que são e por que são importantes. Leia as páginas vinculadas abaixo para obter uma introdução aos campos calculados no Preparo de dados e mais informações sobre todas as funções disponíveis:

• Guia e visão geral da interface
• Funções de Preparo de dados

Matrizes e outros tipos de objetos na Platform

No Experience Platform, é possível usar Esquemas XDM para gerenciar diferentes tipos de campo. Anteriormente, era possível exportar campos simples de tipo de par de valor-chave, como cadeias de caracteres de Experience Platform, para os destinos desejados. Um exemplo de um campo compatível com a exportação anterior é personalEmail.address:johndoe@acme.org.

Outros tipos de campo no Experience Platform incluem campos de matriz. Leia mais sobre gerenciamento de campos de matriz na interface do usuário do Experience Platform. Além dos tipos de campo suportados anteriormente, agora é possível exportar objetos de matriz como: organizations:[marketing, sales, engineering]. Veja mais abaixo exemplos abrangentes Saiba como você pode usar várias funções para acessar elementos de matrizes, unir elementos de matriz em uma sequência e muito mais.

Limitações conhecidas

Observe as seguintes limitações conhecidas da versão beta dessa funcionalidade:

• No momento, não há suporte para a exportação para arquivos JSON ou Parquet com esquemas hierárquicos. Você pode exportar matrizes somente para arquivos CSV de esquema simples, JSON e Parquet.
• Nesse momento, você só pode exportar matrizes simples (ou matrizes de valores primitivos) para destinos de armazenamento na nuvem. Isso significa que você pode exportar objetos de matriz que incluem valores de string, int ou booleanos. Não é possível exportar mapas ou matrizes de mapas ou objetos. A janela modal de campos calculados exibe apenas as matrizes que você pode exportar.

Pré-requisitos

Conectar para um destino de armazenamento na nuvem desejado, avance através da etapas de ativação para destinos do cloud storage e acesse o mapeamento etapa.

Como exportar campos calculados

Na etapa de mapeamento do fluxo de trabalho de ativação para destinos de armazenamento na nuvem, selecione (Beta) Adicionar campo calculado.

Essa ação abre uma janela modal onde é possível selecionar atributos que você pode usar para exportar atributos do Experience Platform.

Por exemplo, use o join na loyaltyID como mostrado abaixo para exportar uma matriz de IDs de fidelidade como uma string concatenada com um sublinhado em um arquivo CSV. Exibir mais informações sobre este e outros exemplos abaixo.

Selecionar Salvar para manter o campo calculado e retornar à etapa de mapeamento.

De volta à etapa de mapeamento do fluxo de trabalho, preencha o Campo de destino com um valor do cabeçalho da coluna que você deseja para esse campo nos arquivos exportados.

Quando estiver pronto, selecione Próxima para prosseguir para a próxima etapa do fluxo de trabalho de ativação.

Funções compatíveis

Observe que somente as seguintes funções são compatíveis com a versão beta de campos calculados e com a matriz de suporte para destinos:

• join
• coalesce
• size_of
• iif
• index-based array access
• add_to_array
• to_array
• first
• last
• sha256
• md5

Exemplos de funções usadas para exportar matrizes

Consulte exemplos e informações adicionais nas seções abaixo para algumas das funções listadas acima. Para o restante das funções listadas, consulte a documentação de funções gerais na seção Preparo de dados.

join função para exportar matrizes

Use o join para concatenar os elementos de uma matriz em uma string, usando um separador desejado, como _ ou |.

Por exemplo, você pode combinar os seguintes campos XDM abaixo, como mostrado na captura de tela de mapeamento usando um join('_',loyalty.loyaltyID) sintaxe:

• "organizations": ["Marketing","Sales,"Finance"] matriz
• person.name.firstName string
• person.name.lastName string
• personalEmail.address string

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como os três elementos da matriz são concatenados em uma única string usando o _ caractere.

`First_Name,Last_Name,Personal_Email,Organization
John,Doe,johndoe@acme.org, "Marketing_Sales_Finance"

iif função para exportar matrizes

Use o iif para exportar elementos de uma matriz em determinadas condições. Por exemplo, continuar com a variável organizations do objeto de matriz acima, você pode gravar uma simples função condicional como iif(organizations[0].equals("Marketing"), "isMarketing", "isNotMarketing").

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Nesse caso, o primeiro elemento do array é Marketing, então a pessoa é um membro do departamento de marketing.

`First_Name,Last_Name, Personal_Email, Is_Member_Of_Marketing_Dept
John,Doe, johndoe@acme.org, "isMarketing"

add_to_array função para exportar matrizes

Use o add_to_array para adicionar elementos a uma matriz exportada. É possível combinar essa função com a variável join descrita mais acima.

Continuando com o organizations do objeto de matriz acima, você pode gravar uma função como source: join('_', add_to_array(organizations,"2023")), que devolve as organizações das quais uma pessoa é membro em 2023.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como os três elementos da matriz são concatenados em uma única string usando o _ e 2023 também estão anexados ao final da cadeia de caracteres.

`First_Name,Last_Name,Personal_Email,Organization_Member_2023
John,Doe, johndoe@acme.org,"Marketing_Sales_Finance_2023"

coalesce função para exportar matrizes

Use o coalesce função para acessar e exportar o primeiro elemento não nulo de uma matriz em uma cadeia de caracteres.

Por exemplo, você pode combinar os seguintes campos XDM abaixo, como mostrado na captura de tela de mapeamento usando um coalesce(subscriptions.hasPromotion) sintaxe para retornar o primeiro true de false valor na matriz:

• "subscriptions.hasPromotion": [null, true, null, false, true] matriz
• person.name.firstName string
• person.name.lastName string
• personalEmail.address string

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como a primeira variável não nula true na matriz é exportado no arquivo.

First_Name,Last_Name,hasPromotion
John,Doe,true

size_of função para exportar matrizes

Use o size_of função para indicar quantos elementos existem em uma matriz. Por exemplo, se você tiver uma purchaseTime objeto de matriz com vários carimbos de data e hora, você pode usar o size_of função para indicar quantas compras separadas foram feitas por uma pessoa.

Por exemplo, você pode combinar os seguintes campos XDM abaixo, como mostrado na captura de tela de mapeamento.

• "purchaseTime": ["1538097126","1569633126,"1601255526","1632791526","1664327526"] array indicando cinco tempos de compra separados pelo cliente
• personalEmail.address string

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como a segunda coluna indica o número de elementos na matriz, correspondente ao número de compras separadas feitas pelo cliente.

`Personal_Email,Times_Purchased
johndoe@acme.org,"5"

Acesso ao array baseado em índice

Você pode acessar um índice de uma matriz para exportar um único item da matriz. Por exemplo, semelhante ao exemplo acima para o size_of função, se você quiser acessar e exportar apenas a primeira vez que um cliente comprar um determinado produto, será possível usar purchaseTime[0] para exportar o primeiro elemento do carimbo de data e hora, purchaseTime[1] para exportar o segundo elemento do carimbo de data e hora, purchaseTime[2] para exportar o terceiro elemento do carimbo de data e hora etc.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo, exportando a primeira vez que o cliente fez uma compra:

`Personal_Email,First_Purchase
johndoe@acme.org,"1538097126"

first e last funções para exportar matrizes

Use o first e last funções para exportar o primeiro ou o último elemento em uma matriz. Por exemplo, continuar com a variável purchaseTime objeto de matriz com vários carimbos de data e hora dos exemplos anteriores, você pode usá-los para funções do para exportar a primeira ou a última compra feita por uma pessoa.

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo, exportando a primeira e a última vez que o cliente fez uma compra:

`Personal_Email,First_Purchase, Last_Purchase
johndoe@acme.org,"1538097126","1664327526"

Funções de hash

Além das funções específicas para exportar matrizes ou elementos de uma matriz, você pode usar funções de hash para hash de atributos nos arquivos exportados. Por exemplo, se você tiver informações de identificação pessoal nos atributos, é possível aplicar hash a esses campos ao exportá-los.

Por exemplo, é possível aplicar hash a valores de string diretamente md5(personalEmail.address). Se desejar, também é possível aplicar hash a elementos individuais de campos de matriz, supondo que os elementos na matriz sejam cadeias de caracteres, desta forma: md5(purchaseTime[0])

As funções de hash compatíveis são: