Gerenciar versões de modelos de mensagem

Para ajudar a gerenciar o desenvolvimento e o uso de modelos de mensagem individuais, o Amazon Pinpoint oferece suporte ao versionamento de todos os tipos de modelos de mensagem. O versionamento fornece uma maneira de criar um histórico de alterações em um modelo. Cada versão é um snapshot de um modelo em um determinado momento. O versionamento também fornece uma maneira de controlar o conteúdo e as configurações de mensagens que usam um modelo.

Sempre que alterar um modelo, você pode especificar se deseja salvar as alterações como uma nova versão do modelo ou como uma atualização da versão mais recente e existente do modelo. À medida que você cria, desenvolve e refina um modelo, cada uma dessas versões serve como um snapshot que pode ajudar a rastrear o andamento e o status do modelo. Ou seja, você pode usar o versionamento para armazenar, rastrear e gerenciar um modelo conforme ele é alterado ao longo do tempo. É possível:

• Acompanhar o histórico de um modelo: para cada modelo, o Amazon Pinpoint fornece uma lista das versões do modelo. Essa lista exibe o nome de cada versão e indica quando cada versão foi alterada pela última vez. A lista é classificada em ordem cronológica decrescente com a versão mais recente listada primeiro.

• Exibir e comparar versões de um modelo: usando a lista de versões, você pode procurar versões anteriores de um modelo. Se você escolher uma versão na lista, o Amazon Pinpoint exibirá o conteúdo e as configurações armazenadas nessa versão.

• Restaurar uma versão anterior de um modelo: se você encontrar problemas na versão mais recente de um modelo, poderá abrir e editar uma versão anterior que não contenha os problemas. E você pode salvar essa versão anterior como uma nova versão do modelo. A nova versão então se torna a versão mais recente do modelo.

Você também pode usar o versionamento para controlar qual versão de um modelo pode ser usada em mensagens. Você pode fazer isso designando uma versão específica como a versão ativa de um modelo. A versão ativa geralmente é a versão que foi revisada e aprovada mais recentemente para uso em mensagens, dependendo do fluxo de trabalho de sua organização para desenvolvimento e gerenciamento de modelos.

Ao designar uma versão como a versão ativa, você habilita essa versão para uso em mensagens. Conforme um modelo é alterado ao longo do tempo, é possível designar uma versão diferente como a versão ativa e alterar essa designação várias vezes.

Como funciona o versionamento

Em um fluxo de trabalho de desenvolvimento típico, um modelo de mensagem tem muitas versões. Essas versões se estendem desde o início do projeto e desenvolvimento por meio de testes, revisão e, finalmente, aprovação para uso em mensagens. Em alguns casos, você pode criar e aprovar versões adicionais depois da aprovação inicial, à medida que refina e atualiza um modelo. Por exemplo, você pode adicionar links ou alterar o layout de um modelo em resposta aos dados de análise de uma campanha que usa o modelo.

Numeração de versões

Ao criar um modelo, há apenas uma versão do modelo Versão 1. Cada vez que você alterar subsequentemente um modelo, especifique se deseja salvar as alterações como uma nova versão do modelo ou como uma atualização da versão mais recente do modelo.

Se você salvar as alterações como uma nova versão, o Amazon Pinpoint incrementará automaticamente o número da versão em 1 e atribuirá esse número à versão: Versão 1 para a primeira versão, Versão 2 para a segunda versão, Versão 3 para a terceira versão e assim por diante. Os números de versão nunca são reutilizados. Você pode salvar até 5.000 versões de um modelo.

Se você salvar as alterações como uma atualização da versão mais recente, o Amazon Pinpoint substituirá a versão mais recente para incluir suas alterações. Para garantir que você tenha uma exibição precisa do histórico de um modelo, é possível substituir somente a versão mais recente de um modelo usando o console do Amazon Pinpoint. Não é possível substituir nenhuma versão anterior de um modelo usando o console.

Versões atuais e ativas

Para oferecer suporte ao desenvolvimento contínuo de modelos em longo prazo, duas versões de um modelo podem ser atuais ao mesmo tempo. Elas são: a versão mais recente que é a versão que foi alterada mais recentemente; e a versão ativa que é a versão que pode ser usada em mensagens.

Dependendo do fluxo de trabalho da organização, a versão ativa geralmente é a versão que foi revisada e aprovada mais recentemente para uso em mensagens. Não é necessariamente a versão mais recente de um modelo. Além disso, qualquer versão diferente da versão ativa é considerada uma versão de rascunho ou de arquivo de um modelo. Isso significa que você pode usar somente a versão ativa de um modelo em mensagens criadas usando o console do Amazon Pinpoint.

Por exemplo, você pode criar várias versões de um modelo à medida que cria e desenvolve o modelo. Quando a versão mais recente do modelo estiver concluída e aprovada para uso em mensagens, você poderá designá-la como a versão ativa do modelo. E essa versão ativa do modelo pode ser usada em mensagens. Se, posteriormente, você decidir alterar o modelo, poderá criar versões adicionais para essas alterações, sem afetar a versão ativa do modelo ou quaisquer mensagens existentes que o usem.

De todas as versões de um modelo, uma versão deve ser designada como a versão ativa do modelo. Conforme um modelo é alterado ao longo do tempo, é possível designar uma versão diferente como a versão ativa e alterar essa designação várias vezes.

Configurações de versão para mensagens

Para usar uma versão específica de um modelo em uma mensagem, a versão deve ser a versão ativa do modelo quando a mensagem é criada ou quando o Amazon Pinpoint envia a mensagem. Isso depende de como você configura uma mensagem para usar um modelo. Ao criar uma mensagem e escolher um modelo para ela, você tem duas opções:

• Usar a versão ativa no momento: se você escolher essa opção, o Amazon Pinpoint sempre enviará o mesmo conteúdo e configurações da mensagem, conforme especificado na versão do modelo que está ativa quando da criação da mensagem. Isso significa que a mensagem permanece a mesma, independentemente de qualquer alteração feita no modelo posteriormente.

• Usar a versão que está ativa quando a mensagem é enviada: se você escolher essa opção, o Amazon Pinpoint atualizará automaticamente o conteúdo e as configurações da mensagem para que correspondam à versão ativa do modelo no momento do envio da mensagem. Isso significa que a mensagem será alterada, se você designar uma versão diferente como a versão ativa depois de criar a mensagem.

Por exemplo, se você fizer o seguinte:

1. Criar a Versão 1 de um modelo.

2. Designar a Versão 1 como a versão ativa do modelo.

3. Criar uma mensagem que use o modelo e programar essa mensagem para ser enviada posteriormente.

4. Alterar o modelo diversas vezes.

5. Designar uma nova versão (Versão 5) como a versão ativa do modelo.

O Amazon Pinpoint faz o seguinte para cada opção quando envia a mensagem:

• Usar a versão ativa no momento: se você escolher essa opção para a mensagem, o Amazon Pinpoint usará o conteúdo e as configurações especificadas pela Versão 1 do modelo. Ele faz isso porque a Versão 1 era a versão ativa do modelo quando a mensagem foi criada.

• Usar a versão ativa quando a mensagem é enviada: se você escolher essa opção para a mensagem, o Amazon Pinpoint atualizará a mensagem automaticamente para usar o conteúdo e as configurações especificadas pela Versão 5 do modelo. Ele faz isso porque a Versão 5 é a versão ativa do modelo quando a mensagem é enviada.

Se você quiser garantir que as alterações em um modelo não afetem as mensagens existentes que você ainda não enviou, recomendamos configurar suas mensagens para usarem a versão do modelo que está ativa quando as mensagens são criadas, não enviadas. Como alternativa, para continuar a desenvolver um modelo depois de começar a usá-lo em mensagens, é possível criar uma cópia do modelo e editar e usar essa cópia em novas mensagens.

Visualizar as versões de um modelo de mensagem

Usando a página Modelos de mensagem você pode localizar e abrir rapidamente um modelo de mensagem específico. E você pode visualizar uma lista das versões existentes do modelo. Nessa lista, você pode escolher uma versão específica para visualizar o conteúdo e as configurações dessa versão do modelo.

Como visualizar versões de um modelo de mensagem

1. Faça login no console do Amazon Pinpoint em https://console.aws.amazon.com/pinpoint/.

2. No painel de navegação, escolha Modelos de mensagem.

3. Na página Modelos de mensagem escolha o modelo cujas versões você deseja visualizar. A página do modelo é aberta e exibe informações sobre o modelo. Ele também exibe o conteúdo e as configurações da versão ativa do modelo.

4. Em Detalhes do modelo, abra o seletor de versão para exibir uma lista das versões do modelo.

5. Para visualizar o conteúdo e as configurações de uma versão específica, use o seletor de versão para escolher a versão. Depois de escolher uma versão, o Amazon Pinpoint exibe o conteúdo e as configurações dessa versão do modelo.

Visualizar a versão ativa de um modelo de mensagem

É possível visualizar a versão ativa de um modelo de mensagem de duas maneiras: ao criar uma mensagem que usa o modelo e usando a página Modelos de mensagem. Para visualizar a versão ativa de um modelo ao criar uma mensagem, escolha o modelo da mensagem. O Amazon Pinpoint exibe automaticamente uma prévia da versão ativa do modelo.

Para visualizar a versão ativa de um modelo usando a página Modelos de mensagem siga as etapas neste tópico.

Como visualizar a versão ativa de um modelo de mensagem

1. Faça login no console do Amazon Pinpoint em https://console.aws.amazon.com/pinpoint/.

2. No painel de navegação, escolha Modelos de mensagem.

3. Na página Modelos de mensagem escolha o modelo cuja versão ativa você deseja visualizar. A página do modelo é aberta e exibe informações sobre o modelo. Ele também exibe o conteúdo e as configurações da versão ativa do modelo. Em Detalhes do modelo, observe que ACTIVE VERSION (VERSÃO ATIVA) é exibida (em verde) ao lado do nome da versão no seletor de versão.

4. Para visualizar uma versão diferente do modelo, use o seletor de versão em Detalhes do modelo para escolher a versão desejada. Para visualizar a versão ativa novamente, use o seletor de versão para escolher a versão que exibe ACTIVE VERSION (VERSÃO ATIVA) (em verde) ao lado do nome da versão.

Designar a versão ativa de um modelo de mensagem

Ao criar um modelo de mensagem, o Amazon Pinpoint designa automaticamente a primeira versão do modelo como a versão ativa. Ao criar e desenvolver versões subsequentes de um modelo, é possível designar uma versão diferente como a versão ativa do modelo e alterar essa designação várias vezes.

Antes de designar uma versão como a versão ativa de um modelo, é recomendável garantir que todo o conteúdo e as configurações da versão ativa proposta estejam completos e prontos para uso.

Também é recomendável verificar se as diferenças entre as versões ativas atuais e propostas não afetarão as mensagens existentes de maneiras inesperadas ou indesejadas. Se você designar uma versão diferente como a versão ativa, o Amazon Pinpoint poderá aplicar sua alteração às mensagens existentes que usam o modelo e ainda não foram enviadas. Isso depende de como você configurou as mensagens que usam o modelo. Para obter mais informações, consulte Configurações de versão para mensagens.

Se o modelo estiver sendo usado em mensagens que ainda não foram enviadas, compare a versão atualmente ativa com a versão que você deseja tornar ativa. Além disso, revise todas as atividades de jornada e as campanhas que usam o modelo. Depois, edite o modelo conforme necessário para resolver qualquer problema encontrado, antes de designar uma versão diferente como a versão ativa.

Se estiver preocupado com os efeitos de designar uma versão diferente como a versão ativa, você poderá criar uma cópia do modelo. Você pode então editar e usar a cópia do modelo em novas mensagens.

Como designar a versão ativa de um modelo de mensagem

1. Faça login no console do Amazon Pinpoint em https://console.aws.amazon.com/pinpoint/.

2. No painel de navegação, escolha Modelos de mensagem.

3. Na página Modelos de mensagem escolha o modelo para o qual você deseja designar a versão ativa. A página do modelo é aberta e exibe informações sobre o modelo. Ela também exibe o conteúdo e as configurações da versão ativa atual do modelo.

4. Em Detalhes do modelo, use o seletor de versão para escolher a versão que você deseja designar como a versão ativa. Depois de escolher uma versão, o Amazon Pinpoint exibe o conteúdo e as configurações dessa versão do modelo.

5. Escolha Tornar versão ativa.

A nova versão ativa do modelo agora está disponível para uso em novas mensagens. Além disso, ele é usado em todas as mensagens existentes que ainda não foram enviadas e estão configuradas para usar a versão do modelo que está ativa quando a mensagem é enviada.

Editar a versão ativa de um modelo de mensagem

Antes de editar a versão ativa de um modelo, é importante lembrar que somente a versão ativa de um modelo pode ser usada em mensagens criadas usando o console do Amazon Pinpoint. Por esse motivo, é recomendável verificar primeiro se as alterações estão completas e prontas para uso.

Também é bom verificar se suas alterações não afetarão as mensagens existentes de maneiras inesperadas ou indesejadas. O Amazon Pinpoint poderá aplicar sua alteração às mensagens existentes que usam o modelo e ainda não foram enviadas. Isso depende de como você configurou as mensagens que usam o modelo. Para obter mais informações, consulte Configurações de versão para mensagens.

Para determinar como as alterações podem afetar as mensagens existentes, revise o conteúdo e as configurações da versão atualmente ativa do modelo. Além disso, revise todas as atividades de jornada e as campanhas que usam o modelo. Considere as alterações que pretende efetuar e certifique-se de que as alterações se alinham com suas metas para mensagens existentes que usam o modelo.

Finalmente, se estiver preocupado com os efeitos da edição da versão ativa do modelo, você poderá criar uma cópia do modelo. É possível editar e usar a cópia do modelo em mensagens que criar posteriormente.

Como editar a versão ativa de um modelo de mensagem

1. Faça login no console do Amazon Pinpoint em https://console.aws.amazon.com/pinpoint/.

2. No painel de navegação, escolha Modelos de mensagem.

3. Na página Modelos de mensagem escolha o modelo cuja versão ativa você deseja editar. A página do modelo é aberta e exibe informações sobre o modelo. Ela também exibe o conteúdo e as configurações da versão designada atualmente como a versão ativa do modelo.

4. Escolha Editar.

5. Em Detalhes do modelo, use o seletor de versão para garantir que você está editando a versão ativa do modelo. ACTIVE VERSION (VERSÃO ATIVA) aparece (em verde) ao lado do nome da versão ativa.

6. Faça as alterações desejadas e escolha Salvar como nova versão.

7. Em Detalhes do modelo, use o seletor de versão para escolher a versão do modelo que você criou na etapa anterior.

8. Escolha Tornar versão ativa.

A nova versão ativa do modelo agora está disponível para uso em novas mensagens. Além disso, ele é usado em todas as mensagens existentes que ainda não foram enviadas e estão configuradas para usar a versão do modelo que está ativa quando a mensagem é enviada.