Skip to content

Central de Preferências de e-mail

post

/preference_center/v1

Use esse endpoint para criar uma central de Preferências para permitir que os usuários gerenciem suas preferências de notificação para suas campanhas de e-mail. Consulte Criar um centro de preferências com API para obter etapas sobre como criar um centro de preferências gerado por API.

Pré-requisitos

Para usar esse endpoint, você precisará de uma chave de API com a permissão preference_center.update.

Limite de taxa

Esse endpoint tem um limite de frequência de 10 solicitações por minuto, por espaço de trabalho.

Corpo da solicitação

Parâmetros de solicitação

Parâmetro Obrigatória Tipo de dados Descrição
name Obrigatória String O nome do centro de preferências que atende aos seguintes requisitos:
- Contém apenas letras, números, hífens e sublinhados
- Não possui espaços
preference_center_title Opcional String O título da central de preferências e das páginas de confirmação. Se um título não for especificado, o título das páginas terá como padrão “Central de Preferências”.
preference_center_page_html Obrigatória String O HTML da página da Central de Preferências.
confirmation_page_html Obrigatória String O HTML da página de confirmação.
state Opcional String Escolha active ou draft. O padrão é active se não for especificado.
options Opcional Objeto Atribuições:
meta-viewport-content: Quando presente, uma meta tag viewport será adicionada à página com content= <value of attribute>.

link-tags: Defina um favicon para a página. Quando definido, uma tag <link> com uma atribuição rel é adicionada à página.

Liquid tags

Consulte as seguintes tags Liquid que podem ser incluídas no HTML para gerar o estado da inscrição de um usuário na página da Central de Preferências.

Estado da inscrição do usuário

Liquid Descrição
{{subscribed_state.${email_global}}} Obtenha o status global de envio de e-mail para o usuário (como “opted_in”, “subscribed” ou “unsubscribed”).
{{subscribed_state.${<subscription_group_id>}}} Obtenha o estado de inscrição do grupo de inscrições especificado para o usuário (como “inscrito” ou “cancelado”).

Entradas e ações do formulário

Liquid Descrição
{% form_field_name :email_global_state %} Indica que um elemento de entrada de formulário específico corresponde ao estado de assinatura de e-mail global do usuário. O estado de seleção do usuário deve ser “opted_in”, “subscribed” ou “unsubscribed” quando o formulário for enviado com dados de seleção para o estado global de envio de e-mail subscrito. Se for uma caixa de seleção, o usuário será “aceitou” ou “cancelado inscrição”. Para uma entrada oculta, o estado “inscrito” também será válido.
{% form_field_name :subscription_group <subscription_group_id> %} Indica que um elemento de entrada de formulário específico corresponde a um determinado grupo de inscrições. O status de seleção do usuário deve ser “inscrito” ou “cancelado inscrição” quando o formulário for enviado com dados de seleção para um grupo de inscrições específico.
{{preference_center_submit_url}} Gera URL para envio de formulário.

Exemplos de respostas

Central de Preferências de e-mail

HTML com entradas de formulário

QUÃO ÚTIL FOI ESTA PÁGINA?
New Stuff!