Práticas recomendadas do modelo de dados

Este documento descreve as principais recomendações ao projetar seu modelo de dados Adobe Campaign.

Para obter uma melhor compreensão das tabelas incorporadas de Campanha e de suas interações, consulte a seção modelo de dados Campaign Classic.

Leia esta documentação para começar a usar schemas Campanhas. Saiba como configurar schemas de extensão para estender o modelo de dados conceituais do banco de dados Adobe Campaign em este documento.

Visão geral

O sistema Adobe Campaign é extremamente flexível e pode ser estendido além da implementação inicial. No entanto, embora as possibilidades sejam infinitas, é fundamental tomar decisões sábias e criar bases fortes para o start do design de seu modelo de dados.

Este documento fornece casos de uso comuns e práticas recomendadas para aprender como arquitetar corretamente sua ferramenta Adobe Campaign.

Arquitetura do modelo de dados

A Adobe Campaign Standard é um poderoso sistema de gestões de campanha entre canais que pode ajudá-lo a alinhar suas estratégias online e offline para criar experiências personalizadas de clientes.

Abordagem centrada no cliente

Enquanto a maioria dos provedores de serviço de e-mail está se comunicando com os clientes por uma abordagem centrada na lista, a Adobe Campaign depende de um banco de dados relacional para aproveitar uma visualização mais ampla dos clientes e seus atributos.

Esta abordagem centrada no cliente é mostrada no gráfico abaixo. A tabela Recipient em cinza representa a tabela principal do cliente em torno da qual tudo está sendo construído:

Para acessar a descrição de cada tabela, vá para Admin > Configuration > Data schemas, selecione um recurso da lista e clique na guia Documentation.

O modelo de dados padrão da Adobe Campaign é apresentado em este documento.

Dados para Adobe Campaign

Que dados devem ser enviados à Adobe Campaign? É importante determinar os dados necessários para suas atividades de marketing.

Para decidir se um atributo seria necessário ou não no Adobe Campaign, pergunte a si mesmo se ele se enquadra em uma dessas categorias:

• Atributo usado para segmentação
• Atributo usado para processos de gestão de dados (cálculo de agregação, por exemplo)
• Atributo usado para personalização

Se você não cair em nenhum desses, provavelmente não precisará desse atributo no Adobe Campaign.

Escolha dos tipos de dados

Para garantir uma boa arquitetura e desempenho do seu sistema, siga as práticas recomendadas abaixo para configurar os dados no Adobe Campaign.

• Uma tabela grande deve ter principalmente campos numéricos e conter links para tabelas de referência (ao trabalhar com lista de valores).
• O atributo expr permite definir um atributo de schema como um campo calculado em vez de um valor de conjunto físico em uma tabela. Isso pode permitir o acesso às informações em um formato diferente (como idade e data de nascimento, por exemplo) sem a necessidade de armazenar ambos os valores. Essa é uma boa maneira de evitar a duplicação de campos. Por exemplo, a tabela do Recipient usa uma expressão para o domínio, que já está presente no campo de email.
• No entanto, quando o cálculo de expressão é complexo, não é recomendável usar o atributo expr, já que o cálculo dinâmico pode afetar o desempenho de seus query.
• O tipo XML é uma boa maneira de evitar a criação de muitos campos. Mas também ocupa espaço em disco à medida que usa uma coluna CLOB no banco de dados. Também pode levar a query SQL complexos e afetar o desempenho.
• O comprimento de um campo string deve ser sempre definido com a coluna. Por padrão, o comprimento máximo no Adobe Campaign é 255, mas o Adobe recomenda manter o campo mais curto se você já souber que o tamanho não excederá um comprimento menor.
• É aceitável ter um campo menor no Adobe Campaign do que no sistema de origem se você tiver certeza de que o tamanho no sistema de origem foi superestimado e não seria atingido. Isso pode significar uma string mais curta ou um número inteiro menor no Adobe Campaign.

Escolha dos campos

Um campo deve ser armazenado em uma tabela se tiver uma finalidade de definição de metas ou personalização. Em outras palavras, se um campo não for usado para enviar um email personalizado ou usado como critério em um query, ele ocupará espaço em disco, ao passo que é inútil.

Para instâncias híbridas e locais, FDA (Federated Data Acces, um recurso opcional que permite acessar dados externos) cobre a necessidade de adicionar um campo "instantaneamente" durante um processo de campanha. Não é necessário importar tudo se tiver FDA. Para obter mais informações, consulte Sobre Federated Data Acces.

Escolha das teclas

Além do autopk definido por padrão na maioria das tabelas, você deve considerar adicionar algumas chaves lógicas ou comerciais (número da conta, número do cliente e assim por diante). Pode ser utilizado posteriormente para importações/reconciliação ou pacotes de dados. Para obter mais informações, consulte Identificadores.

Chaves eficientes são essenciais para o desempenho. Os tipos de dados numéricos devem sempre ser preferidos como chaves para tabelas.

Para o banco de dados SQLServer, você pode considerar o uso de "índice clusterizado" se o desempenho for necessário. Como o Adobe não lida com isso, é necessário criá-lo no SQL.

tablespaces dedicados

O atributo tablespace no schema permite especificar um tablespace dedicado para uma tabela.

O assistente de instalação permite que você armazene objetos por tipo (dados, temporários e índice).

Os tablespaces dedicados são melhores para particionamento, regras de segurança e permitem administração fluida e flexível, melhor otimização e desempenho.

Identificadores

Os recursos da Adobe Campaign têm três identificadores e é possível adicionar um identificador adicional.

A tabela a seguir descreve esses identificadores e sua finalidade.

Identifier	Descrição	Práticas recomendadas
Id	A ID é a chave primária física de uma tabela do Adobe Campaign. Para tabelas predefinidas, é um número gerado de 32 bits de uma sequência Normalmente, esse identificador é exclusivo de uma instância específica do Adobe Campaign. Uma ID gerada automaticamente pode ser visível em uma definição de schema. Pesquise o atributo autopk="true".	Os identificadores gerados automaticamente não devem ser usados como referência em um fluxo de trabalho ou em uma definição de pacote. Não se deve partir do princípio de que a id será sempre um número crescente. A id em uma tabela predefinida é um número de 32 bits e esse tipo não deve ser alterado. Este número é extraído de uma "sequência" coberta na seção com o mesmo nome.
Nome (ou nome interno)	Essas informações são um identificador exclusivo de um registro em uma tabela. Esse valor pode ser atualizado manualmente, geralmente com um nome gerado. Esse identificador mantém seu valor quando implantado em uma instância diferente do Adobe Campaign e não deve estar vazio.	Renomeie o nome do registro gerado pela Adobe Campaign se o objeto for destinado a ser implantado de um ambiente para outro. Quando um objeto tem um atributo de namespace (schema, por exemplo), essa namespace comum será aproveitada em todos os objetos personalizados criados. Algumas namespaces reservadas não devem ser usadas: nms, xtk. Quando um objeto não tem nenhuma namespace (workflow ou delivery por exemplo), essa noção de namespace seria adicionada como um prefixo de um objeto de nome interno: namespaceMyObjectName. Não use caracteres especiais, como o espaço "", a semircoluna ":" ou o hífen "-". Todos esses caracteres seriam substituídos por um sublinhado "_" (caractere permitido). Por exemplo, "abc-def" e "abc:def" seriam armazenados como "abc_def" e se substituiriam.
Rótulo	O rótulo é o identificador comercial de um objeto ou registro no Adobe Campaign. Esse objeto permite espaços e caracteres especiais. Não garante a unicidade de um registro.	É recomendável determinar uma estrutura para seus rótulos de objetos. Essa é a solução mais fácil de usar para identificar um registro ou objeto para um usuário do Adobe Campaign.

Teclas internas personalizadas

As chaves primárias são necessárias para cada tabela criada no Adobe Campaign.

A maioria das organizações está importando registros de sistemas externos. Embora a chave física da tabela do Recipient seja o atributo "id", é possível determinar uma chave personalizada além disso.

Essa chave personalizada é a chave primária de registro real no Adobe Campaign de alimentação do sistema externo.

Quando uma tabela predefinida tiver um autopk e uma chave interna, a chave interna será definida como um índice exclusivo na tabela do banco de dados físico.

Ao criar uma tabela personalizada, você tem duas opções:

• Uma combinação de chave gerada automaticamente (id) e chave interna (personalizada). Essa opção é interessante se a chave do sistema for uma chave composta ou não for um número inteiro. Os inteiros fornecerão desempenho mais alto em tabelas grandes e unirão-se a outras tabelas.
• Usar a chave primária como a chave primária do sistema externo. Essa solução geralmente é preferida, pois simplifica a abordagem de importar e exportar dados, com uma chave consistente entre diferentes sistemas. A opção Autopk deve ser desativada se a chave for chamada de "id" e se espera que seja preenchida com valores externos (não gerado automaticamente).

Sequências

A chave primária do Adobe Campaign é uma ID gerada automaticamente para todas as tabelas predefinidas e pode ser a mesma para tabelas personalizadas. Para obter mais informações, consulte esta seção.

Esse valor é obtido do que é chamado de sequence, que é um objeto de banco de dados usado para gerar uma sequência numérica.

Há dois tipos de sequências:

• Compartilhado: mais de uma tabela escolheria a ID da mesma sequência. Isso significa que se um id 'X' for usado por uma tabela, nenhuma outra tabela que compartilhasse a mesma sequência teria um registro com esse id 'X'. ​​XtkNewIdis é a sequência compartilhada padrão disponível no Adobe Campaign.
• Dedicado: somente uma tabela está escolhendo suas ids da sequência. O nome da sequência geralmente contém o nome da tabela.

Portanto, um cliente enviando 6 bilhões de emails anualmente, com um período de retenção de 180 dias para seus registros, perderia as ids em 4 meses. Para evitar esse desafio, certifique-se de ter configurações de expurgação de acordo com seus volumes. Para obter mais informações, consulte esta seção.

Quando uma tabela personalizada está sendo criada no Adobe Campaign com uma chave primária como um autoPK, uma sequência dedicada personalizada deve ser sistematicamente associada a essa tabela.

Por padrão, uma sequência personalizada terá valores que variam de +1.000 a +2,1BB. Tecnicamente, é possível obter uma faixa completa de 4BB, habilitando ids negativos. Isso deve ser usado com cuidado e um id será perdido ao passar de números negativos para positivos: o registro 0 normalmente é ignorado pela Adobe Campaign Classic em query SQL gerados.

Tópicos relacionados:

• Para obter mais informações sobre o recurso Geração automática de sequência, consulte este documento.
• Para obter mais informações sobre a exaustão das sequências, assista a este vídeo.

Índices

Os índices são essenciais para o desempenho. Ao declarar uma chave no schema, o Adobe criará automaticamente um índice nos campos da chave. Você também pode declarar mais índices para query que não usam a chave.

A Adobe recomenda a definição de índices adicionais, pois pode melhorar o desempenho.

No entanto, lembre-se do seguinte:

• O uso do índice está vinculado ao seu padrão de acesso. A otimização da indexação é, muitas vezes, uma parte essencial no projeto do banco de dados e precisa ser tratada por especialistas. A adição de índices geralmente é um fluxo de trabalho iterativo anexado à manutenção do banco de dados. É feito ao longo do tempo, passo a passo, para resolver problemas de desempenho ao ocorrer.
• Os índices aumentam o tamanho geral da tabela (para armazenar o próprio índice).
• A adição de índice em colunas pode melhorar o desempenho do acesso de leitura de dados (SELECT), mas pode diminuir o desempenho do acesso de gravação de dados (UPDATE).
• Como isso afeta o desempenho durante a inserção dos dados, os índices devem ser limitados em tamanho e número.
• Não adicione índices quando não for necessário. Certifique-se de que seja obrigatório e que aumente o desempenho geral dos seus query (teste e aprenda).
• De modo geral, um índice é eficiente se você sabe que seus query não trazem mais de 10% dos registros.
• Selecione cuidadosamente os índices que precisam ser definidos.
• Não remova índices nativos de tabelas predefinidas.

Exemplo

A gestão dos índices pode tornar-se muito complexa, pelo que é importante compreender como funcionam. Para ilustrar essa complexidade, vamos pegar um exemplo básico como pesquisar recipient filtrando no nome e sobrenome. Para fazer isso:

1. Vá para a pasta que lista todos os recipient no banco de dados. Para obter mais informações, consulte Gerenciar perfis.

2. Clique com o botão direito do mouse no campo First name.

3. Selecione Filter on this field.

   

4. Repita essa operação para o campo Last name.

Os dois filtros correspondentes são adicionados na parte superior da tela.

Agora é possível executar a filtragem de pesquisa nos campos First name e Last name de acordo com as várias condições do filtro.

Agora, para acelerar a pesquisa nesses filtros, você pode adicionar índices. Mas que índices devem ser utilizados?

A tabela a seguir mostra em quais casos os três índices descritos abaixo são usados ou não de acordo com o padrão de acesso exibido na primeira coluna.

Critérios de pesquisa	Índice 1 (Nome + Sobrenome)	Índice 2 (somente nome)	Índice 3 (somente sobrenome)	Comentários
O nome é igual a "Johnny"	Usado	Usado	Não usado	Como o nome está na primeira posição no índice 1, ele será usado assim mesmo: não é necessário adicionar um critério ao sobrenome.
Nome igual a "Johnny" E sobrenome igual a "Smith"	Usado	Não usado	Não usado	Como ambos os atributos são pesquisados no mesmo query, somente o índice que combina ambos os atributos será usado.
O sobrenome é igual a "Smith"	Não usado	Não usado	Usado	A ordem dos atributos no índice é considerada. Se você não corresponder a essa ordem, o índice pode não ser usado.
Start de nome com "Joh"	Usado	Usado	Não usado	"Pesquisa à esquerda" habilitará índices.
O nome termina com "nny"	Não usado	Não usado	Não usado	A "pesquisa correta" desativará os índices e uma verificação completa será realizada. Alguns tipos de índice específicos podem lidar com esse caso de uso, mas não estão disponíveis por padrão no Adobe Campaign.
O nome contém "John"	Não usado	Não usado	Não usado	Esta é uma combinação de pesquisas "esquerda" e "direita". Por causa do último, isso desativará os índices e uma verificação completa será realizada.
O nome é igual a "john"	Não usado	Não usado	Não usado	Os índices fazem distinção entre maiúsculas e minúsculas. Para torná-la não diferencia maiúsculas de minúsculas, você deve criar um índice específico que inclua uma função SQL como "top(firstname)". Você deve fazer o mesmo com outras transformações de dados, como "unaccent(firstname)".

Links e cardinalidade

Links

Cuidado com a integridade "própria" das grandes tabelas. A exclusão de registros com tabelas largas na integridade "própria" pode interromper a instância. A tabela está bloqueada e as exclusões são feitas uma por uma. Portanto, é melhor usar a integridade "neutra" em tabelas-filho que têm grandes volumes.

Declarar um link como uma junção externa não é bom para o desempenho. O registro de id zero emula a funcionalidade de junção externa. Não é necessário declarar joins externos se o link usar o autopk.

Embora seja possível unir qualquer tabela em um fluxo de trabalho, o Adobe recomenda a definição de links comuns entre recursos diretamente na definição da estrutura de dados.

O link deve ser definido de acordo com os dados reais em suas tabelas. Uma definição incorreta poderia afetar os dados recuperados por meio de links, por exemplo, duplicando registros inesperadamente.

Dê um nome consistente ao seu link com o nome da tabela: o nome do link deve ajudar a entender o que é a tabela distante.

Não nomeie um link com "id" como sufixo. Por exemplo, nomeie-a como "transaction" em vez de "transactionId".

Por padrão, a Adobe Campaign criará um link usando a chave primária da tabela externa. Para maior clareza, é preferível definir explicitamente a junção na definição do link.

Um índice será adicionado aos atributos usados em um link.

A variável links criados por e modificados por último estão presentes em muitas tabelas. É possível desativar o índice usando o atributo noDbIndex no link, se essas informações não estiverem sendo usadas pela empresa.

Cardinalidade

Ao projetar um link, verifique se o registro do público alvo é exclusivo quando uma relação 1-1 for declarada. Caso contrário, a junção poderá retornar vários registros quando apenas um for esperado. Isso resulta em erros durante a preparação do delivery quando "o query retorna mais linhas do que o esperado". Defina o nome do link com o mesmo nome do schema do público alvo.

Defina um link com uma cardinalidade (1-N) no schema do lado (1). Por exemplo, o Recipient de relação (1) - (N) A transação deve ser definida no schema de transação.

Observe que a cardinalidade reversa de um link é (N) por padrão. É possível definir um link (1-1) adicionando o atributo revCardinality='single' à definição do link.

Se o link reverso não deve estar visível para o usuário, você pode ocultá-lo com a definição do link revLink='NONE'. Um bom caso de uso para isso é definir um link do recipient para a última transação concluída, por exemplo. Você só precisa ver o link do recipient para a última transação e nenhum link reverso é necessário para ficar visível da tabela de transação.

Os links que executam uma junção externa (1-0.1) devem ser usados com cuidado, pois isso afetará o desempenho do sistema.

Retenção de dados - limpeza e remoção

A Adobe Campaign não é um data warehouse nem uma ferramenta de relatórios. Portanto, para garantir um bom desempenho da solução Adobe Campaign, o crescimento do banco de dados deve permanecer sob controle. Para isso, seguir algumas das práticas recomendadas abaixo pode ajudar.

Por padrão, o delivery Adobe Campaign e os logs de rastreamento têm uma duração de retenção de 180 dias. Um processo de limpeza é executado para remover qualquer log anterior.

• Se desejar manter os registros por mais tempo, essa decisão deve ser tomada cuidadosamente dependendo do tamanho do banco de dados e do volume de mensagens enviadas. Como lembrete, a sequência do Adobe Campaign é um número inteiro de 32 bits.
• Recomenda-se não ter mais de 1 bilhão de registros de cada vez nessas tabelas (cerca de 50% dos 2,14 bilhões de ids disponíveis) para limitar os riscos de consumo de todas as ids disponíveis. Isso exigirá que alguns clientes reduzam a duração da retenção para menos de 180 dias.

Saiba mais sobre a retenção de dados em Diretrizes de privacidade e segurança da Campanha.

Saiba mais sobre o fluxo de trabalho de limpeza da base de dados de Campanha nesta seção…

Existem algumas soluções para minimizar a necessidade de registros no Adobe Campaign:

• Exporte os dados em um data warehouse fora da Adobe Campaign.
• Gere valores agregados que usarão menos espaço enquanto forem suficientes para suas práticas de marketing. Por exemplo, você não precisa do histórico completo de transações do cliente na Adobe Campaign para rastrear as últimas compras.

Você pode declarar o atributo "deleteStatus" em um schema. É mais eficiente marcar o registro como excluído e depois adiar a exclusão na tarefa de limpeza.

Desempenho

Para garantir melhor desempenho a qualquer momento, siga as práticas recomendadas abaixo.

Recomendações gerais

• Evite usar operações como "CONTAINS" em query. Se você sabe o que é esperado e deseja filtrar, aplique a mesma condição com um "EQUAL TO" ou outros operadores de filtro específicos.
• Evite unir a campos não indexados ao criar dados em workflows.
• Tente garantir que processos como importação e exportação ocorram fora do horário comercial.
• Certifique-se de que existe uma programação para todas as atividades diárias e cumpra a programação.
• Se um ou alguns dos processos diários falharem e se for obrigatório executá-lo no mesmo dia, verifique se não há processos conflitantes em execução quando o processo manual é iniciado, pois isso pode afetar o desempenho do sistema.
• Verifique se nenhuma campanha diária é executada durante o processo de importação ou quando qualquer processo manual é executado.
• Use uma ou várias tabelas de referência em vez de duplicar um campo em cada linha. Ao usar pares de chave/valor, é preferível escolher uma chave numérica.
• Uma string curta permanece aceitável. Caso as tabelas de referências já estejam em vigor em um sistema externo, reutilizar o mesmo facilitará a integração de dados com a Adobe Campaign.

Relações de um para muitos

• O design de dados afeta a usabilidade e a funcionalidade. Se você projetar seu modelo de dados com muitas relações um para muitos, isso torna mais difícil para os usuários construírem uma lógica significativa no aplicativo. A lógica de filtro um para muitos pode ser difícil para comerciantes não técnicos construírem e entenderem corretamente.
• É bom ter todos os campos essenciais em uma tabela, pois facilita a criação de query pelos usuários. Às vezes, também é bom para o desempenho duplicado alguns campos nas tabelas se puder evitar uma junção.
• Determinadas funcionalidades incorporadas não poderão fazer referência a relações one-to-many, por exemplo, fórmula de Ponderação Oferta e Delivery.

Tabelas grandes

A Adobe Campaign depende de mecanismos de banco de dados de terceiros. Dependendo do provedor, a otimização do desempenho para tabelas maiores pode exigir um design específico.

Abaixo estão algumas práticas recomendadas comuns que devem ser seguidas ao projetar seu modelo de dados usando tabelas grandes e junções complexas.

• Ao usar tabelas de recipient personalizadas adicionais, verifique se você tem uma tabela de log dedicada para cada mapeamento de delivery.
• Reduza o número de colunas, principalmente identificando as que não são usadas.
• Otimize as relações do modelo de dados evitando junções complexas, como junções em várias condições e/ou em várias colunas.
• Para teclas de junção, sempre use dados numéricos em vez de sequências de caracteres.
• Reduza o máximo possível a profundidade da retenção de registros. Se precisar de um histórico mais profundo, você pode agregação a computação e/ou manipular tabelas de log personalizadas para armazenar um histórico maior.

Tamanho das tabelas

O tamanho da tabela é uma combinação do número de registros e do número de colunas por registro. Ambos podem afetar o desempenho dos query.

• Uma tabela small-size é semelhante à tabela do Delivery.
• Uma tabela de tamanho médio é igual ao tamanho da tabela do Recipient. Ele tem um registro por cliente.
• Uma tabela de tamanho grande é semelhante à tabela de log Amplo. Ele tem muitos registros por cliente.
  Por exemplo, se seu banco de dados contém 10 milhões de recipient, a tabela de log Amplo contém cerca de 100 a 200 milhões de mensagens e a tabela de Delivery contém alguns milhares de registros.

No PostgreSQL, uma linha não deve exceder 8 KB para evitar o mecanismo TOAST. Portanto, tente reduzir ao máximo o número de colunas e o tamanho de cada linha para preservar o desempenho ideal do sistema (memória e CPU).

O número de linhas também afeta o desempenho. O banco de dados da Adobe Campaign não foi projetado para armazenar dados históricos que não são usados ativamente para direcionamento ou personalização - esse é um banco de dados operacional.

Para evitar qualquer problema de desempenho relacionado ao alto número de linhas, mantenha somente os registros necessários no banco de dados. Qualquer outro registro deve ser exportado para um data warehouse de terceiros e removido do banco de dados operacional da Adobe Campaign.

Estas são algumas práticas recomendadas relacionadas ao tamanho das tabelas:

• Projete tabelas grandes com menos campos e mais dados numéricos.
• Não use um grande tipo de coluna (ex: Int64) para armazenar números pequenos como valores booleanos.
• Remova colunas não usadas da definição da tabela.
• Não mantenha dados históricos ou inativos em seu banco de dados Adobe Campaign (exportação e limpeza).

Aqui está um exemplo:

Neste exemplo:

• As tabelas Transaction e Transaction Item são grandes: mais de 10 milhões.
• As tabelas Product e Loja são menores: menos de 10.000.
• O rótulo e a referência do produto foram colocados na tabela Product.
• A tabela Item de Transação só tem um link para a tabela Product, que é numérica.