Nesta página: saiba como configurar a atividade de espera para pausar um caminho por uma duração relativa ou até uma data calculada personalizada antes da execução da próxima atividade.
Você pode usar uma atividade Wait para definir uma duração antes de executar a próxima atividade. A duração máxima de espera é de 90 dias.
Você pode definir dois tipos de atividade Aguardar:
- Uma espera com base em uma duração relativa. Saiba mais
- Uma data personalizada, usando funções para calculá-la. Saiba mais
Recomendações wait-recommendations
Use essas recomendações para manter as esperas previsíveis e seguras.
Várias atividades de espera multiple-wait-activities
Ao usar várias atividades Wait em uma jornada, esteja ciente de que o tempo limite global para jornada é de 91 dias, o que significa que os perfis estão sempre saindo do máximo da jornada 91 dias após terem inserido. Saiba mais nesta página.
Um indivíduo só poderá inserir uma atividade Aguardar se tiver tempo suficiente na jornada para concluir a duração da espera antes do tempo limite de jornada de 91 dias.
Espera e reentrada wait-reentrance
Uma prática recomendada para não usar as atividades Aguardar para bloquear a reentrada. Em vez disso, use a opção Permitir reentrada no nível de propriedades da jornada. Saiba mais nesta página.
Modo de espera e teste wait-test-mode
No modo de teste, o parâmetro Tempo de espera em teste permite definir o tempo que cada atividade de Espera durará. O tempo padrão é de 10 segundos. Isso garantirá que você obtenha os resultados do teste rapidamente. Saiba mais nesta página.
Canais de espera e móveis wait-mobile-channels
Se você quiser mostrar uma mensagem no aplicativo logo após enviar uma notificação por push, use uma atividade Aguardar para permitir que o tempo de carga da mensagem no aplicativo seja propagado. Normalmente, recomenda-se uma espera de 5 a 15 minutos, mas os tempos exatos podem variar dependendo da complexidade da carga útil e das necessidades de personalização.
Configuração wait-configuration
Configure a duração e o tempo de espera aqui.
Espera de duração duration
Selecione o tipo Duration para definir a duração relativa da espera antes da execução da próxima atividade. A duração máxima é de 90 dias.
Espera personalizada custom
Selecione o tipo Personalizado para definir uma data personalizada, usando uma expressão avançada com base em um campo proveniente de um evento ou uma resposta de ação personalizada. Não é possível definir uma duração relativa diretamente, por exemplo, 7 dias, mas você pode usar funções para calculá-la se necessário (por exemplo: 2 dias após a compra).
A expressão no editor deve fornecer um formato dateTimeOnly. Consulte esta página. Para obter mais informações sobre o formato dateTimeOnly, consulte esta página.
A prática recomendada é usar datas personalizadas específicas para seus perfis e evitar o uso da mesma data para todos. Por exemplo, não defina toDateTimeOnly('2024-01-01T01:11:00Z'), mas sim toDateTimeOnly(@event{Event.productDeliveryDate}), que é específico para cada perfil. Esteja ciente de que o uso de datas fixas pode causar problemas na execução da jornada. Saiba mais sobre o impacto das atividades de espera na taxa de processamento da jornada em esta seção.
dateTimeOnly, lembre-se do seguinte:- Você pode usar uma expressão
dateTimeOnlydiretamente ou convertê-la usando uma função — por exemplo:toDateTimeOnly(@event{Event.offerOpened.activity.endTime})onde o valor do campo está no formato2023-08-12T09:46:06Z. - O fuso horário está definido nas propriedades da jornada. Como resultado, não é possível que a interface aponte para um carimbo de data e hora ISO-8601 completo que mescla deslocamento de hora e fuso horário, como
2023-08-12T09:46:06.982-05. Saiba mais - Ao criar uma expressão de espera personalizada com
toDateTimeOnly(), não anexeZou um deslocamento de fuso horário (por exemplo,-05:00). A expressão deve fazer referência ao fuso horário configurado pela jornada sem designadores de fuso horário explícitos; caso contrário, os perfis podem ficar presos na atividade de espera.
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Exemplo | |
| Correto | toDateTimeOnly(concat(toString(toDateOnly(nowWithDelta(2, "days"))),"T10:00:00")) |
| Incorreto | toDateTimeOnly(concat(toString(toDateOnly(nowWithDelta(2, "days"))),"T10:00:00Z")) ❌ (contém Z) |
Para validar se a atividade de espera funciona como esperado, você pode usar os eventos da etapa. Saiba mais.
Atualização de perfil após espera profile-refresh
Quando um perfil é estacionado em uma atividade Wait em uma jornada que começa com uma atividade Read Audience, a jornada atualiza automaticamente os atributos do perfil no UPS (Serviço de Perfil Unificado) para buscar os dados mais recentes disponíveis.
- Na entrada da jornada: os perfis usam valores de atributo do instantâneo de público-alvo que foi avaliado quando a jornada foi iniciada.
- Após um nó de espera: a jornada executa uma pesquisa para recuperar os dados de perfil mais recentes do UPS, não os dados de instantâneo mais antigos. Isso significa que os atributos de perfil podem ter sido alterados desde o início da jornada.
Esse comportamento garante que as atividades downstream usem informações atuais do perfil após um período de espera. No entanto, poderá produzir resultados inesperados se você esperar que a jornada use apenas os dados do instantâneo original durante toda a execução.
Exemplo: se um perfil se qualificar para um público-alvo de “cliente Silver” no início da jornada, mas atualizar para “cliente Gold” durante uma espera de 3 dias, as atividades após a espera verão o status atualizado de “cliente Gold”.
Nó de espera automático auto-wait-node
Cada atividade de experiência de entrada (mensagem no aplicativo, experiência baseada em código ou Cartão) vem com uma atividade de Aguardar de 3 dias. Como as mensagens de entrada terminam automaticamente quando um perfil atinge o final da jornada, pressupomos que você deseje que seus usuários a vejam pelo menos por 3 dias. Você pode remover esta atividade Aguardar ou alterar sua configuração, se necessário.
Esta seção contém conhecimento estruturado destinado a oferecer suporte à interpretação, recuperação e resposta a perguntas relacionadas a este tópico.
Para uma compreensão completa, essas informações devem ser combinadas com a documentação desta página. Nenhuma das origens deve ser independente; a página descreve o recurso, enquanto esta seção fornece um contexto adicional que ajuda a desfazer a ambiguidade da terminologia, intenção, aplicabilidade e restrições.
- TL;DR: Esta página explica como configurar a atividade de espera em uma jornada para pausar a progressão do perfil por uma duração relativa ou até uma data calculada personalizada antes de executar a próxima etapa.
Intenções:
- Adicione uma atividade Wait para pausar uma jornada por uma duração relativa fixa (até 90 dias)
- Configure um Wait personalizado usando uma expressão avançada para atrasar até uma data calculada específica do perfil
- Entenda como as atividades de espera interagem com o tempo limite global do jornada (91 dias)
- Use o parâmetro Tempo de espera no teste para acelerar a validação do modo de teste
- Entenda como os atributos de perfil são atualizados após um nó de espera em Ler jornadas de público-alvo
Glossário:
- Atividade de espera: uma atividade de orquestração de jornadas que pausa a progressão do perfil por uma duração especificada ou até uma data calculada antes que a próxima atividade seja executada (específico do produto)
- Duração da espera: um tipo de espera que define um período de tempo relativo para pausa, com um máximo de 90 dias (específico do produto)
- Espera personalizada: um tipo de espera que usa uma expressão
dateTimeOnlyderivada de dados de perfil ou evento para definir uma data/hora futura específica para retomada (específica do produto) - Nó de espera automático: uma atividade de espera de 3 dias é inserida automaticamente após as atividades de experiência de entrada (no aplicativo, com base em código, Cartão) para manter o perfil na jornada por tempo suficiente para exibir o conteúdo (específico do produto)
- Tempo de espera no teste: um parâmetro de modo de teste de jornada que substitui as durações de espera reais (padrão de 10 segundos) para que os resultados do teste sejam retornados rapidamente (específico do produto)
Medidas de Proteção:
- A duração máxima de espera é de 90 dias.
- Os perfis são descartados de uma jornada após 91 dias (tempo limite global), independentemente das atividades de espera pendentes.
- Um perfil só poderá inserir uma atividade Wait se houver tempo suficiente na jornada para concluir a espera antes do tempo limite de 91 dias.
- Não use as atividades Wait para bloquear a reentrada; em vez disso, use a opção Allow reentry nas propriedades do jornada.
- As expressões de espera personalizadas devem usar o formato
dateTimeOnlye não devem incluir um sufixoZou deslocamento de fuso horário explícito. - Usar uma data estática fixa (por exemplo,
toDateTimeOnly('2024-01-01T01:11:00Z')) em uma espera personalizada pode causar problemas. Em vez disso, use datas dinâmicas específicas do perfil. - Os atributos de perfil são atualizados a partir do Unified Profile Service após um nó de espera em Ler jornadas de público-alvo, o que pode produzir resultados inesperados se a consistência do instantâneo for esperada.
Terminologia:
- Nome canônico: Atividade de espera — Acrônimo: none — variantes: nó de espera, etapa de espera
- Sinônimos: “Espera de duração” = “espera relativa”; “Espera personalizada” = “espera baseada em expressão”
- Não confunda: “Duration wait” (relativo, por exemplo, daqui a 3 dias) ≠ “Custom wait” (data calculada absoluta a partir dos dados do perfil)
Perguntas frequentes:
- P: Qual é a duração máxima de uma atividade de espera? — A duração máxima de espera é de 90 dias; os perfis também estão sujeitos ao tempo limite de jornada global de 91 dias.
- P: Como o modo de teste trata as atividades de Espera? — No modo de teste, o parâmetro “Tempo de espera no teste” substitui a duração de espera real; o padrão é 10 segundos para que os testes sejam concluídos rapidamente.
- P: Por que não devo anexar Z a uma expressão de espera personalizada? — Adicionar Z ou um deslocamento de fuso horário a uma expressão
toDateTimeOnly()pode fazer com que os perfis fiquem presos na atividade de espera; a expressão deve depender do fuso horário configurado pela jornada. - P: Os atributos de perfil são atualizados após um nó de Espera? — Sim, em jornadas que começam com Read Audience, a jornada atualiza os atributos do perfil do Unified Profile Service após a espera, portanto, as atividades downstream podem ver valores atualizados em vez dos dados de instantâneo do público original.
- P: Qual é o nó de espera automático? — Uma atividade de espera de três dias é inserida automaticamente após as atividades de experiência de entrada (no aplicativo, com base em código, cartão) para garantir que os perfis permaneçam na jornada por tempo suficiente para ver a mensagem. Ela pode ser removida ou reconfigurada conforme necessário.