Skip to content

Centro de preferencias de correo electrónico con API

Configurar un centro de preferencias proporciona un lugar centralizado para que tus usuarios editen y administren sus preferencias de notificación para tu mensajería de correo electrónico. Este artículo incluye los pasos para crear un centro de preferencias generado por API, pero también puedes crear un centro de preferencias usando el editor de arrastrar y soltar.

En el dashboard de Braze, ve a Audiencia > Centros de preferencias de correo electrónico.

Aquí es donde puedes administrar y ver cada grupo de suscripción. Cada grupo de suscripción que crees se añade a esta lista del centro de preferencias. Puedes crear múltiples centros de preferencias.

Crear un centro de preferencias con API

Usando los puntos de conexión del centro de preferencias de Braze, puedes crear un centro de preferencias, un sitio web alojado por Braze, que puede mostrar el estado de suscripción y los estados de los grupos de suscripción de tus usuarios. Usando HTML y CSS, tu equipo de desarrolladores puede crear el centro de preferencias para que el estilo de la página coincida con tus directrices de marca.

Usar Liquid te permite recuperar los nombres de tus grupos de suscripción y el estado de cada usuario. De esta manera, Braze almacena y recupera estos datos cuando se carga la página.

Requisitos previos

Paso 1: Usa el punto de conexión Crear centro de preferencias

Comencemos a crear un centro de preferencias usando el punto de conexión Crear centro de preferencias. Para personalizar tu centro de preferencias, puedes incluir HTML que se alinee con tu marca en el campo preference_center_page_html y el campo confirmation_page_html.

El punto de conexión Generar URL del centro de preferencias te permite obtener la URL del centro de preferencias para un usuario específico fuera de un correo electrónico enviado a través de Braze.

Paso 2: Incluir en tu campaña de correo electrónico

Para colocar un enlace al centro de preferencias en tus correos electrónicos, usa la siguiente etiqueta de Liquid en el lugar deseado de tu correo electrónico, de manera similar a como insertarías las URL de cancelación de suscripción.

1

{{preference_center.${kitchenerie_preference_center_example}}}

También puedes usar una combinación de HTML que incluya Liquid. Por ejemplo, puedes pegar lo siguiente como la URL en el editor HTML o en el editor de arrastrar y soltar. Esto muestra el diseño básico del centro de preferencias que lista todos los grupos de suscripción de correo electrónico automáticamente. Si usas aliasing de enlaces, añade un signo de interrogación final (?) después de la etiqueta de Liquid para que Braze pueda añadir parámetros de seguimiento.

1

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

El centro de preferencias tiene una casilla de verificación que permite a tus usuarios cancelar la suscripción de todos los correos electrónicos. Ten en cuenta que no puedes guardar estas preferencias si se envían como un mensaje de prueba.

Editar un centro de preferencias

Puedes editar y actualizar tu centro de preferencias usando el punto de conexión Actualizar centro de preferencias.

Identificar centros de preferencias y detalles

Para identificar tus centros de preferencias, usa el punto de conexión Ver detalles del centro de preferencias para devolver información relacionada, como la marca de tiempo de la última actualización, el ID del centro de preferencias y más.

Personalizar un centro de preferencias

Braze administra las actualizaciones del estado de suscripción desde el centro de preferencias, lo que mantiene el centro de preferencias sincronizado. Sin embargo, también puedes crear y alojar tu propio centro de preferencias usando las API de grupos de suscripción con las siguientes opciones.

Usa pares de campo-valor de cadena de consulta en el cuerpo de la URL para pasar el ID de usuario y la categoría de correo electrónico a la página, de modo que los usuarios solo necesiten confirmar su elección para cancelar la suscripción. Esta opción es buena para quienes almacenan un identificador de usuario en un formato hash y no tienen ya un centro de suscripción.

Para esta opción, cada categoría de correo electrónico requiere su propio enlace de cancelación de suscripción específico:
http://mycompany.com/query-string-form-fill?field_id=John&field_category=offers

Opción 2: Autenticar con JSON web token

Usa un JSON web token para autenticar a los usuarios en una parte de tu servidor web (por ejemplo, preferencias de cuenta) que normalmente está detrás de una capa de autenticación como nombre de usuario e inicio de sesión con contraseña.

Este enfoque no requiere pares de valor de cadena de consulta incrustados en la URL, ya que estos pueden pasarse en la carga útil del JSON web token, por ejemplo:

1
2
3
4
5

{
    "user_id": "1234567890",
    "name": "John Doe",
    "category": "offers"
}

Preguntas frecuentes

No he creado un centro de preferencias. ¿Por qué veo “PreferenceCenterBrazeDefault” en mi dashboard?

Esto se usa para renderizar el centro de preferencias cuando se usa el Liquid heredado ${preference_center_url}, lo que significa que los pasos en Canvas o las plantillas que hacen referencia a ${preference_center_url} o preference_center.${PreferenceCenterBrazeDefault} no funcionarán. Esto también se aplica a los mensajes enviados anteriormente que incluían el Liquid heredado o “PreferenceCenterBrazeDefault” como parte del mensaje.

Si haces referencia a ${preference_center_url} en un nuevo mensaje, se creará de nuevo un centro de preferencias llamado “PreferenceCenterBrazeDefault”.

¿Los centros de preferencias admiten múltiples idiomas?

No. Sin embargo, puedes aprovechar Liquid al escribir el HTML para páginas personalizadas de adhesión voluntaria y cancelación de suscripción. Si usas enlaces dinámicos para administrar las cancelaciones de suscripción, este es un enlace único.

Por ejemplo, si estás rastreando la tasa de cancelaciones para usuarios de habla hispana, necesitarías usar Campaigns separadas o aprovechar los análisis de Currents (como verificar cuándo un usuario cancela la suscripción y comprobar el idioma preferido de ese usuario).

Como otro ejemplo, para rastrear las tasas de cancelación de suscripción para usuarios de habla hispana, podrías añadir una cadena de parámetro de consulta como ?Spanish=true a la URL de cancelación de suscripción si el idioma del usuario es español y usar un enlace de cancelación de suscripción regular si no lo es:

1
2
3
4

{% if ${language} == 'spanish' %} "${unsubscribe_url}?spanish=true"
{% else %}
${unsubscribe_url}
{% endif %}

Luego, a través de Currents, podrías identificar qué usuarios hablan español y cuántos eventos de clic hubo para ese enlace de cancelación de suscripción.

No. Si ves el mensaje “Your Email Body does not include an unsubscribe link” al redactar una Campaign de correo electrónico, esta advertencia es esperada si tu enlace de cancelación de suscripción está en un bloque de contenido.

¿Cómo actualizo el icono predeterminado del navegador?

De forma predeterminada, el icono junto al nombre de la pestaña del navegador (favicon) usa el logotipo de Braze. Para añadir un favicon personalizado, lo configuras a través del atributo links-tags en tu llamada a la API de Crear o Actualizar centro de preferencias. Braze luego inyecta la etiqueta <link rel="icon" ...> en la página alojada por ti.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

{
  "name": "MyPreferenceCenter",
  "preference_center_title": "Email Preferences",
  "preference_center_page_html": "<!doctype html> ...",
  "confirmation_page_html": "<!doctype html> ...",
  "state": "active",
  "options": {
    "links-tags": [
      {
        "rel": "icon",
        "type": "image/png",
        "sizes": "32x32",
        "href": "https://yourcdn.com/path/to/favicon-32x32.png"
      },
      {
        "rel": "shortcut icon",
        "type": "image/x-icon",
        "href": "https://yourcdn.com/path/to/favicon.ico"
      },
      {
        "rel": "apple-touch-icon",
        "sizes": "180x180",
        "href": "https://yourcdn.com/path/to/apple-touch-icon.png"
      }
    ]
  }
}
New Stuff!