Práticas recomendadas para Dynamic Datastream Configurations
Use essas práticas ao criar e operar regras do Dynamic Datastream Configuration. Eles ajudam você a gerenciar as medidas de proteção do sistema, evitar erros comuns e manter configurações fáceis de entender e solucionar problemas.
Design da regra rule-design
Usar sequências de dados separadas por fonte de evento. Considere a criação de um fluxo de dados para o Web SDK, um para o Mobile SDK e um para a API do servidor. Se os dados vierem de uma fonte diferente ou usarem um esquema XDM diferente, crie um fluxo de dados separado. Um fluxo de dados dedicado com seus próprios conjuntos de dados correspondentes melhora a rastreabilidade e simplifica a solução de problemas. As regras dinâmicas de configuração de sequência de dados lidam com o roteamento em cada sequência de dados.
Manter regras simples e simples. As configurações de sequência de dados dinâmicos não suportam expressões lógicas aninhadas. Se a lógica exigir aninhamento, divida-a em várias regras simples. Regras mais simples são avaliadas mais rapidamente, são mais fáceis de auditar e têm menos probabilidade de produzir correspondências inesperadas.
Use eventType como sua condição primária. eventType é o discriminador mais confiável e eficiente para decisões de roteamento. Ele é preenchido consistentemente em implementações do Web SDK, Mobile SDK e API do servidor e tem um conjunto bem definido de valores. Praticamente todos os casos de uso devem começar com uma condição baseada em eventType, opcionalmente combinada com condições secundárias.
Ordenar regras por prioridade: Dispensável primeiro, Acionável depois Analítico. Como a Edge Network usa a avaliação de primeira correspondência-ganha, a ordem das regras determina o resultado para eventos que podem corresponder a várias condições.
Uma ordem recomendada:
- Tráfego de bot: Dispendível ou quarentena
- Eventos do sistema (
decisioning.propositionFetch,personalization.request): quarentena - Eventos acionáveis: rotear para um conjunto de dados habilitado para perfil
- Eventos Analíticos: rotear para um conjunto de dados que não seja de perfil
Colocar regras Dispendiáveis primeiro garante que o Edge Network capture tráfego prejudicial ou operacional antes de tomar decisões de roteamento caras, como assimilação de perfil ou personalização de entrada.
Crie sua rota padrão de forma conservadora. Configure o conjunto de dados de evento Adobe Experience Platform padrão da sequência de dados para um conjunto de dados não habilitado para perfil. Eventos inesperados ou sem categoria chegam ao data lake em vez de inflar seu armazenamento de perfil. Você sempre pode adicionar uma regra específica para promover um tipo de evento recém-descoberto ao Perfil depois de classificá-lo.
Estratégia do conjunto de dados dataset-strategy
Crie conjuntos de dados antes de configurar as regras. Todos os conjuntos de dados de destino devem existir com o esquema correto antes de você referenciá-los nas configurações de roteamento. Depois de validar suas regras usando o Assurance, habilite o perfil, configure a retenção de dados e atualize a conexão do Customer Journey Analytics.
Para obter orientações sobre a configuração da retenção de dados, consulte o guia de Retenção do Conjunto de Dados do Evento de Experiência.
Usar uma convenção de nomenclatura consistente. Nomes claros dos conjuntos de dados facilitam a identificação da finalidade de cada conjunto de dados ao revisar sua configuração ou monitorar a assimilação. Um padrão recomendado:
[Brand] Web Events - Profile (90d)[Brand] Web Events - Analytics (12mo)[Brand] Bot Traffic - Quarantine (30d)[Brand] System Events - Quarantine (30d)
Alinhe sua conexão Customer Journey Analytics com sua estratégia de conjunto de dados. Depois de configurar a rota de eventos e regras do Dynamic Datastream Configuration para separar conjuntos de dados, atualize sua conexão do Customer Journey Analytics para incluir apenas os conjuntos de dados que devem ser usados nos relatórios. Excluir conjuntos de dados de quarentena para tráfego de bot e eventos do sistema. Para obter detalhes, consulte a documentação de conexões do Customer Journey Analytics.
Práticas operacionais operational
Aguarde 15 minutos para a propagação das alterações. As alterações na configuração da sequência de dados, incluindo regras Dynamic Datastream Configuration novas ou atualizadas, levam até 15 minutos para se propagarem pela Edge Network. Não teste imediatamente após salvar as alterações. Aguarde a janela de propagação completa antes de executar sessões do Assurance ou comparar volumes de assimilação de conjuntos de dados.
Remova substituições do lado do cliente antes de habilitar as regras. As substituições de configuração da sequência de dados têm precedência sobre as regras Dynamic Datastream Configuration. Qualquer evento que carregue uma substituição do lado do cliente ignora suas regras silenciosamente, sem erros ou avisos. Antes de habilitar as regras, faça uma auditoria na implementação do Web SDK ou do Mobile SDK para remover edgeConfigOverrides de sendEvent e chamadas de configure para eventos que o Dynamic Datastream Configurations deve manipular.
Monitorar após implantação. Depois de ativar as regras na produção, monitore o seguinte para confirmar o comportamento correto:
- Volumes de assimilação do conjunto de dados em Adobe Experience Platform > Conjuntos de dados: verifique se os eventos chegam aos conjuntos de dados esperados e se os volumes correspondem às suas projeções.
- Taxa de transferência de assimilação de streaming e Volume total de dados: verifique o impacto nos volumes de assimilação de streaming proporcionais aos eventos agora encaminhados para fora dos conjuntos de dados habilitados por perfil. Verifique a contabilização do impacto total do volume de dados para as janelas de expiração de retenção.
- Customer Journey Analyticsespaço de trabalho: se você excluiu conjuntos de dados ou suprimiu tipos de evento, confirme se esses eventos não aparecem mais em seus relatórios.
Próximas etapas
- Consulte Testar e validar Dynamic Datastream Configurations para obter uma lista de verificação de teste passo a passo.
- Revise Casos de uso da configuração de sequência de dados dinâmica para configurações de regra de referência.
- Consulte as Perguntas frequentes para obter respostas a perguntas comuns sobre o comportamento das regras e as interações do sistema.