[Beta]{class="badge informative"}

(Beta) Usar campos calculados para exportar matrizes em arquivos de esquema simples use-calculated-fields-to-export-arrays-in-flat-schema-files

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:

Matrizes e outros tipos de objetos na Platform arrays-strings-other-objects

No Experience Platform, você pode usar esquemas XDM para gerenciar diferentes tipos de campos. 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 com suporte para 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 extensos de como você pode usar várias funções para acessar elementos de matrizes, unir elementos de matriz em uma cadeia de caracteres e muito mais.

Limitações conhecidas known-limitations

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

Pré-requisitos prerequisites

Conecte a um destino de armazenamento na nuvem desejado. Prossiga pelas etapas de ativação para destinos de armazenamento na nuvem e vá para a etapa mapeamento.

Como exportar campos calculados how-to-export-calculated-fields

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 a função join no campo loyaltyID, como mostrado abaixo, para exportar uma matriz de IDs de fidelidade como uma cadeia de caracteres concatenada com um sublinhado em um arquivo CSV. Exibir mais informações sobre este e outros exemplos mais abaixo.

Selecione 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 de coluna desejado para este campo nos arquivos exportados.

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

Funções compatíveis supported-functions

Todas as funções de Preparo de Dados documentadas têm suporte ao ativar dados para destinos baseados em arquivo.

No entanto, observe que descrições abrangentes de casos de uso e informações de saída de exemplo são fornecidas atualmente apenas para as seguintes funções na versão beta de campos calculados e suporte de matriz para destinos:

Exemplos de funções usadas para exportar matrizes examples

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.

Função join para exportar matrizes join-function-export-arrays

Use a função join para concatenar os elementos de uma matriz em uma sequência, 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 uma sintaxe join('_',loyalty.loyaltyID):

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"

Função iif para exportar matrizes iif-function-export-arrays

Use a função iif para exportar elementos de uma matriz sob determinadas condições. Por exemplo, ao continuar com o objeto de matriz organizations acima, você pode gravar uma função condicional simples 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"

Função add_to_array para exportar matrizes add-to-array-function-export-arrays

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

Continuando com o objeto de matriz organizations acima, você pode gravar uma função como source: join('_', add_to_array(organizations,"2023")), retornando as organizações das quais uma pessoa é membro no ano de 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 caractere _ e 2023 também é anexado ao final da string.

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

Função coalesce para exportar matrizes coalesce-function-export-arrays

Use a função coalesce 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, conforme mostrado na captura de tela de mapeamento, usando uma sintaxe coalesce(subscriptions.hasPromotion) para retornar o primeiro true de valor false na matriz:

Nesse caso, o arquivo de saída é semelhante ao mostrado abaixo. Observe como o primeiro valor true não nulo na matriz é exportado no arquivo.

First_Name,Last_Name,hasPromotion
John,Doe,true

Função size_of para exportar matrizes sizeof-function-export-arrays

Use a função size_of para indicar quantos elementos existem em uma matriz. Por exemplo, se você tiver um objeto de matriz purchaseTime com vários carimbos de data e hora, poderá usar a função size_of 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.

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 index-based-array-access

Você pode acessar um índice de uma matriz para exportar um único item da matriz. Por exemplo, semelhante ao exemplo acima para a função size_of, se você quiser acessar e exportar apenas a primeira vez que um cliente tiver comprado um determinado produto, você poderá 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 e assim por diante.

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 first-and-last-functions-export-arrays

Use as funções first e last para exportar o primeiro ou o último elemento em uma matriz. Por exemplo, continuando com o objeto de matriz purchaseTime com vários carimbos de data e hora dos exemplos anteriores, você pode usá-los para funções a fim de 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 hashing-functions

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.

Você pode hash de valores de cadeias de caracteres diretamente, por exemplo md5(personalEmail.address). Se desejar, você também pode aplicar hash a elementos individuais de campos de matriz, supondo que os elementos na matriz sejam cadeias de caracteres, como esta: md5(purchaseTime[0])

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