Visão geral da Central de Preferências

A configuração de uma central de Preferências oferece um local único para os usuários editarem e gerenciarem suas preferências de notificação para o envio de mensagens por e-mail. Este artigo inclui etapas para a criação de um centro de preferências gerado pela API, mas você também pode criar um centro de preferências usando o editor de arrastar e soltar.

No dashboard do Braze, acesse Público > Inscrições > Central de Preferências de E-mail.

É aqui que você pode gerenciar e visualizar cada grupo de inscrições. Cada grupo de inscrições que você cria é adicionado a essa lista da Central de Preferências. Você pode criar várias Centrais de Preferências.

Criação de uma Central de Preferências com API

Ao usar os endpoints da Central de Preferências do Braze, é possível criar uma central de preferências, um site hospedado pelo Braze, que pode exibir o estado da inscrição do usuário e os status do grupo de inscrições. Usando HTML e CSS, sua equipe de desenvolvedores pode criar a central de preferências usando HTML e CSS para que o estilo da página corresponda às diretrizes da marca.

O uso do Liquid ativa a recuperação dos nomes dos seus grupos de inscrições e o status de cada usuário. Dessa forma, a Braze armazena e recupera esses dados quando a página é carregada.

Pré-requisitos

Etapa 1: Use o ponto de extremidade Criar centro de preferências

Vamos começar a criar um centro de preferências usando o ponto de extremidade Criar centro de preferências. Para personalizar a Central de Preferências, é possível incluir HTML que se alinhe à sua marca nos campos preference_center_page_html e confirmation_page_html.

O endpoint Gerar URL do centro de preferências permite obter o URL do centro de preferências de um usuário específico fora de um e-mail enviado pelo Braze.

Etapa 2: Inclua em sua campanha de e-mail

Para colocar um link para a Central de Preferências em seus e-mails, use a seguinte tag Liquid no local desejado em seu e-mail, da mesma forma que inseriria URLs de cancelamento de inscrição.

1
{{preference_center.${kitchenerie_preference_center_example}}}

Você também pode usar uma combinação de HTML que inclua o Liquid. Por exemplo, você pode colar o seguinte como URL no editor de HTML ou no editor de arrastar e soltar. Isso mostrará o layout básico da Central de Preferências que lista todos os grupos de inscrições para e-mail automaticamente.

1
<a href="{{preference_center.${kitchenerie_preference_center_example}}}">Edit your preferences</a>

A Central de Preferências tem uma caixa de seleção que permitirá que os usuários cancelem a inscrição de todos os e-mails. Observe que não será possível salvar essas preferências se forem enviadas como uma mensagem de teste.

Edição de uma Central de Preferências

Você pode editar e atualizar seu centro de preferências usando o ponto de extremidade Update preference center (Atualizar centro de preferências).

Identificação de centros de preferências e detalhes

Para identificar seus centros de preferência, use o ponto de extremidade Exibir detalhes do centro de preferência para retornar informações relacionadas, como o último registro de data e hora atualizado, a ID do centro de preferência e muito mais.

Personalização

O Braze gerencia as atualizações do estado da inscrição a partir do centro de preferências, o que mantém o centro de preferências sincronizado. No entanto, você também pode criar e hospedar seu próprio centro de preferências usando as APIs de grupos de inscrições com as seguintes opções.

Opção 1: Link com parâmetros de consulta de string

Use pares de campo-valor da string de consulta no corpo do URL para passar o ID do usuário e a categoria de e-mail para a página, de modo que os usuários só precisem confirmar sua opção de cancelar a inscrição. Essa opção é boa para quem armazena um identificador de usuário em formato hash e ainda não tem um centro de inscrição.

Para essa opção, cada categoria de e-mail exigirá seu próprio link específico de cancelamento de inscrição:
http://mycompany.com/query-string-form-fill?field_id=John&field_category=offers

1
2
{% assign my_string = {{${user_id}}} | md5 %}
My encoded string is: {{my_string}}

Opção 2: Autenticação com token da Web JSON

Use um token da Web JSON para autenticar usuários em uma parte do seu servidor da Web (por exemplo, preferências de conta) que normalmente está por trás de uma camada de autenticação, como login de nome de usuário e senha.

Essa abordagem não requer pares de valores de string de consulta incorporados no URL, pois eles podem ser passados na carga útil do token da Web JSON, por exemplo:

1
2
3
4
5
{
    "user_id": "1234567890",
    "name": "John Doe",
    "category": offers
}

Perguntas frequentes

Não criei uma Central de Preferências. Por que estou vendo “PreferenceCenterBrazeDefault” em meu dashboard?

Isso é usado para renderizar a Central de Preferências quando o Liquid ${preference_center_url} legado é usado, o que significa que as etapas do canva ou os modelos que fazem referência a ${preference_center_url} ou preference_center.${PreferenceCenterBrazeDefault} não funcionarão. Isso também se aplica a mensagens enviadas anteriormente que incluíam o Liquid legado ou “PreferenceCenterBrazeDefault” como parte da mensagem.

Se você fizer referência a ${preference_center_url} em uma nova mensagem novamente, uma Central de Preferências chamada “PreferenceCenterBrazeDefault” será criada novamente.