Práticas recomendadas do modelo de dados data-model-best-practices
Este documento descreve as principais recomendações ao projetar o modelo de dados do Adobe Campaign.
O sistema Adobe Campaign é muito flexível e pode ser estendido além da implementação inicial. No entanto, embora as possibilidades sejam infinitas, é essencial tomar decisões sábias e criar bases sólidas para começar a projetar seu modelo de dados.
Para entender melhor as tabelas integradas do Campaign e como elas se relacionam entre si, consulte esta seção.
Leia esta seção para começar a usar esquemas do Campaign.
Saiba como configurar esquemas de extensão para estender o modelo de dados conceituais do banco de dados do Adobe Campaign nesta página.
Arquitetura do modelo de dados data-model-architecture
O Adobe Campaign é um eficiente sistema de gerenciamento de campanhas em vários canais que pode ajudar você a alinhar suas estratégias online e offline para criar experiências personalizadas de clientes.
Abordagem centrada no cliente customer-centric-approach
Embora a maioria dos provedores de serviços de email esteja se comunicando com os clientes por meio de uma abordagem centrada em listas, o Adobe Campaign depende de um banco de dados relacional para aproveitar uma visualização mais ampla dos clientes e seus atributos.
Para acessar a descrição de cada tabela, vá para Admin > Configuration > Data schemas, selecione um recurso na lista e clique na guia Documentation.
Dados para o Adobe Campaign data-for-campaign
Quais dados devem ser enviados para o Adobe Campaign? É essencial 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 se ele se enquadra em uma destas categorias:
- Atributo usado para segmentação
- Atributo usado para processos de gerenciamento de dados (cálculo agregado por exemplo)
- Atributo usado para personalização
Se não estiver se encaixando em nenhum desses, você provavelmente não precisará desse atributo no Adobe Campaign.
Escolha dos tipos de dados data-types
Para garantir uma boa arquitetura e desempenho do sistema, siga as práticas recomendadas abaixo para configurar dados no Adobe Campaign.
- Em uma tabela grande, você pode inserir campos de sequência ou numéricos e adicionar links a tabelas de referência (ao trabalhar com lista de valores).
- O atributo expr permite definir um atributo de esquema 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 campos duplicados. Por exemplo, a tabela Recipient usa uma expressão para o domínio, que já está presente no campo email.
- No entanto, quando o cálculo da expressão é complexo, não é recomendável usar o atributo expr, pois o cálculo instantâneo pode afetar o desempenho das suas consultas.
- O tipo XML é uma boa maneira de evitar a criação de muitos campos. Mas também ocupa espaço em disco, pois usa uma coluna CLOB no banco de dados. Ela também pode levar a consultas SQL complexas e afetar o desempenho.
- O comprimento de um campo cadeia deve ser sempre definido com a coluna. Por padrão, o comprimento máximo no Adobe Campaign é de 16K, mas o Adobe recomenda manter o campo mais curto se você já souber que o tamanho não excederá um comprimento mais curto.
- É aceitável ter um campo mais curto 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 menor ou um inteiro menor no Adobe Campaign.
Escolha de campos choice-of-fields
Um campo deve ser armazenado em uma tabela se tiver um propósito de direcionamento ou personalização. Em outras palavras, se um campo não for usado para enviar um email personalizado ou usado como critério em uma consulta, ele ocupará desnecessariamente espaço em disco.
Escolha de teclas choice-of-keys
Além do autouuid e do autopk definidos por padrão na maioria das tabelas, você deve considerar adicionar algumas chaves lógicas ou de negócios (número de conta, número de cliente e assim por diante). Ele pode ser usado 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. Com o Snowflake, você pode inserir tipos de dados numéricos ou baseados em sequência como chaves para tabelas.
Identificadores identifiers
Os recursos do Adobe Campaign têm três identificadores e é possível adicionar um identificador adicional.
A tabela a seguir descreve esses identificadores e sua finalidade.
- A id é a chave primária física de uma tabela do Adobe Campaign. Para tabelas integradas, é um identificador exclusivo universal (UUID)
- Esse identificador deve ser exclusivo.
- Uma UUID pode ser visível em uma definição de esquema.
- Identificadores gerados automaticamente não devem ser usados como referência em um fluxo de trabalho ou em uma definição de pacote.
- A ID em uma tabela é um UUID e esse tipo não deve ser alterado.
- 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 pelo Adobe Campaign se o objeto deve ser implantado de um ambiente para outro.
- Quando um objeto tiver um atributo de namespace (schema, por exemplo), esse namespace comum será aproveitado em todos os objetos personalizados criados. Alguns namespaces reservados não devem ser usados: nms, xtk, etc. Observe que alguns namespaces são somente internos. Saiba mais.
- Quando um objeto não tem 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 espaço " ", semicuna ":" ou 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.
- O rótulo é o identificador comercial de um objeto ou registro no Adobe Campaign.
- Esse objeto permite espaços e caracteres especiais.
- Isso não garante a exclusividade de um registro.
- É recomendável determinar uma estrutura para seus rótulos de objeto.
- Essa é a solução mais simples para identificar um registro ou objeto para um usuário do Adobe Campaign.
No contexto de uma implantação corporativa (FFDA), a chave primária do Adobe Campaign é um UUID gerado automaticamente para todas as tabelas internas. Uma UUID também pode ser usada para tabelas personalizadas. Saiba mais
Mesmo que o número de IDs seja infinito, você deve cuidar do tamanho do banco de dados para garantir um desempenho ideal. Para evitar qualquer problema, ajuste as configurações de limpeza da instância. Para obter mais informações, consulte esta seção.
Chaves internas personalizadas custom-internal-keys
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 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 sistema externo que alimenta o Adobe Campaign.
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 inteiro. Com Snowflake, números inteiros ou chaves baseadas em string fornecerão desempenhos mais altos em tabelas grandes e juntando-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 sistemas diferentes. Autouuid deve ser desabilitado se o nome da chave for "id" e se espera que seja preenchido com valores externos (não gerado automaticamente).
- Uma autouuid não deve ser usada como referência em fluxos de trabalho.
- O atributo autouuid se aplica somente a implantações corporativas (FFDA).
Links e cardinalidade links-and-cardinality
Links links
Cuidado com a integridade "própria" em tabelas grandes. A exclusão de registros que têm tabelas grandes em integridade "própria" pode interromper a instância. A tabela é bloqueada e as exclusões são feitas uma por uma. Portanto, é melhor usar a integridade "neutra" em tabelas secundárias com grandes volumes.
Declarar um link como uma associação externa não é bom para o desempenho. O registro de id zero emula a funcionalidade de associação externa. No contexto de uma implantação corporativa (FFDA), não é necessário declarar junções externas se o link usar a autouuid.
Embora seja possível unir qualquer tabela em um fluxo de trabalho, o Adobe recomenda definir links comuns entre os recursos diretamente na definição da estrutura de dados.
O link deve ser definido em alinhamento com os dados reais nas tabelas. Uma definição incorreta poderia afetar os dados recuperados por meio de links, por exemplo, registros duplicados inesperadamente.
Nomeie o link de forma consistente 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-o como "transaction" em vez de "transactionId".
Por padrão, o Adobe Campaign criará um link usando a chave primária da tabela externa. Para maior clareza, é preferível definir explicitamente a associação na definição do link.
Cardinalidade cardinality
Ao projetar um link, verifique se o registro do target é exclusivo quando uma relação 1-1 for declarada. Caso contrário, a associação poderá retornar vários registros quando somente um for esperado. Isso resulta em erros durante a preparação do delivery quando "a consulta retorna mais linhas do que o esperado". Defina o nome do link com o mesmo nome do schema de destino.
Defina um link com uma cardinalidade (1-N) no esquema no lado (N). Por exemplo, a relação Destinatário (1) - (N) Transação deve ser definida no schema da transação.
Observe que uma 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 de 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 estar visível na tabela de transações.
Os links que executam uma associação externa (1-0…1) devem ser usados com cuidado, pois afetarão o desempenho do sistema.
Retenção de dados data-retention
O 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.
Quanto à retenção, as tabelas de log integradas no Campaign têm períodos de retenção predefinidos, geralmente limitando o armazenamento dos dados a seis meses ou menos.
A seguir estão os valores de retenção padrão para tabelas integradas. Esteja ciente de que a configuração de retenção é definida pelos administradores técnicos da Adobe durante a implementação e os valores podem variar com base nos requisitos do cliente.
- Rastreamento consolidado: 1 ano
- Registros de entrega: 6 meses
- Logs de rastreamento: 1 ano
- Entregas excluídas: 1 semana
- Importação de rejeitos: 6 meses
- Perfis do visitante: 1 mês
- Apresentações da oferta: 1 ano
- Eventos: 1 mês
- Estatísticas de processamento de evento: 1 ano
- Eventos arquivados: 1 ano
- Eventos de pipeline ignorados: 1 mês
Existem algumas soluções para minimizar a necessidade de registros no Adobe Campaign:
- Exporte os dados em um data warehouse para fora do 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 no Adobe Campaign para rastrear as últimas compras.
Você pode declarar o atributo "deleteStatus" em um esquema. É mais eficiente marcar o registro como excluído e, em seguida, adiar a exclusão na tarefa de limpeza.
Como usuário do Managed Cloud Service, entre em contato com os consultores de Adobe ou administradores técnicos para saber mais sobre retenção ou se é necessário definir a retenção para tabelas personalizadas.
Desempenho performance
Para garantir um melhor desempenho a qualquer momento, siga as práticas recomendadas abaixo.
Recomendações gerais general-recommendations
- Evite usar operações como "CONTAINS" em consultas. Se você souber o que é esperado e quiser ser filtrado, aplique a mesma condição com um "IGUAL A" ou outros operadores de filtro específicos.
- Tente e certifique-se de que processos como importação e exportação ocorram fora do horário comercial.
- Verifique se há uma programação para todas as atividades diárias e siga a programação.
- Se um ou alguns dos processos diários falharem e for obrigatório executá-los no mesmo dia, verifique se não há processos conflitantes em execução quando o processo manual for iniciado, pois isso pode afetar o desempenho do sistema.
- Certifique-se de que nenhuma das campanhas diárias seja executada durante o processo de importação ou quando qualquer processo manual for executado.
- Use uma ou várias tabelas de referência em vez de duplicar um campo em cada linha. Ao usar pares chave/valor, é preferível escolher uma chave numérica.
- Uma sequência curta permanece aceitável. Caso as tabelas de referência já estejam em vigor em um sistema externo, reutilizar o mesmo facilitará a integração de dados com o Adobe Campaign.
Relacionamentos um para muitos one-to-many-relationships
- O design de dados afeta a usabilidade e a funcionalidade. Se você projetar seu modelo de dados com várias relações um para muitos, será mais difícil para os usuários criar uma lógica significativa no aplicativo. A lógica de filtro de um para muitos pode ser difícil para profissionais de marketing não técnicos criarem e compreenderem corretamente.
- É bom ter todos os campos essenciais em uma tabela porque facilita a criação de consultas pelos usuários. Às vezes, também é bom que o desempenho duplique alguns campos em tabelas se puder evitar uma associação.
- Certas funcionalidades integradas não poderão fazer referência a relações um para muitos, por exemplo, fórmula de Ponderação da oferta e Entregas.
Tabelas grandes large-tables
O 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 associações complexas.
- Ao usar tabelas de recipients personalizadas adicionais, verifique se você tem uma tabela de log dedicada para cada mapeamento de delivery.
- Reduza o número de colunas, principalmente identificando aquelas que não são usadas.
- Otimize as relações do modelo de dados evitando associações complexas, como associações em várias condições e/ou colunas.
- Para chaves de junção, você pode usar valores numéricos ou baseados em string.
- Reduza o máximo possível a profundidade da retenção de registros. Se precisar de um histórico mais profundo, você poderá agregar o cálculo e/ou manipular tabelas de log personalizadas para armazenar um histórico maior.
Tamanho das tabelas size-of-tables
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 das consultas.
- Uma tabela small-size é semelhante à tabela Delivery.
- Uma tabela de tamanho médio é igual ao tamanho da tabela Recipient. Ele tem um registro por cliente.
- Uma tabela large-size é semelhante à tabela Broad log. Ele tem muitos registros por cliente.
Por exemplo, se o banco de dados contiver 10 milhões de recipients, a tabela Broad log conterá de 100 a 200 milhões de mensagens e a tabela Delivery conterá alguns milhares de registros.
O número de linhas também afeta o desempenho. O banco de dados do Adobe Campaign não foi projetado para armazenar dados históricos que não são usados ativamente para fins de direcionamento ou personalização. Este é um banco de dados operacional.
Para evitar qualquer problema de desempenho relacionado ao alto número de linhas, mantenha apenas 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 do Adobe Campaign.
Estas são algumas das práticas recomendadas relacionadas ao tamanho das tabelas:
- Crie tabelas grandes com menos campos e mais dados numéricos.
- Não use um tipo de coluna de número grande para armazenar números pequenos como valores booleanos.
- Remover colunas não usadas da definição de tabela.
- Não mantenha dados históricos ou inativos no banco de dados do Adobe Campaign (exportar e limpar).