Crear una página de cancelación de suscripción de correo electrónico personalizada

Descripción general

OneSignal proporciona una experiencia de cancelación de suscripción predeterminada conforme a correo electrónico que inyecta un enlace en sus plantillas de correo electrónico para que los usuarios puedan cancelar su suscripción con facilidad y sus estados de suscripción se actualicen en tiempo real. Si desea control total sobre la marca, el texto y los campos (como exclusiones por categoría), puede reemplazar el enlace predeterminado con su propia página personalizada y usar la API de OneSignal para cancelar la suscripción o actualizar las preferencias del usuario. Esta guía explica cómo agregar su propia página de cancelación de suscripción personalizada a los correos electrónicos (eliminando el enlace predeterminado de OneSignal) y cuáles de nuestras APIs usar para cancelar la suscripción de correo electrónico del usuario. Si desea agregar más funcionalidad a su página de cancelación de suscripción personalizada (como exclusión de categorías de correo electrónico específicas en lugar de todas), esto se detalla en nuestro tutorial del Centro de preferencias.

Eliminar el enlace de cancelación de suscripción predeterminado de OneSignal

OneSignal inserta automáticamente un enlace especial en el formato [unsubscribe_url] en sus plantillas de correo electrónico. Esta URL cancela la suscripción del usuario de todos los correos electrónicos en OneSignal. Consulte Enlaces de cancelación de suscripción de correo electrónico para más detalles. Para usar su propia página, localice y elimine el enlace predeterminado en su plantilla.

Editor Drag-and-Drop
Editor HTML

En el editor drag-and-drop, el enlace predeterminado puede aparecer anidado como:

Enlace de cancelación de suscripción del editor Drag-and-Drop

<a href="[unsubscribe_url]">Unsubscribe</a>

Agregar su enlace de cancelación de suscripción personalizado

Ahora que ha eliminado nuestro enlace especial, puede reemplazarlo con su propia URL. Muchas veces, estos enlaces requieren que se pasen algunos datos adicionales a su página. Use variables de Liquid para pasar datos de OneSignal a su página. Parámetros comunes:

Parámetro	Descripción
`subscription.email`	Dirección de correo electrónico del suscriptor
`subscription.external_id`	ID externo del usuario
`app.id`	ID de aplicación de OneSignal
`message.id`	ID de la notificación de correo electrónico
`subscription.language`	Idioma preferido (para localización)
`subscription.unsubscribe_token`	Token de seguridad para verificación de API

URL de ejemplo:

https://examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}

HTML

  <div style="text-align: center;">
    <a
      href="https://examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}"
      data-disable-tracking="true"
      style="display: inline; text-decoration: none;"
    >
      Unsubscribe
    </a>
    <p style="display: inline;"> from our emails</p>
  </div>

Agregar enlace de cancelación de suscripción personalizado

Deshabilitar el seguimiento de clics

Los clics de cancelación de suscripción generalmente no se usan para métricas de participación. Si desea deshabilitar el seguimiento de enlaces, puede agregar el atributo data-disable-tracking="true" a su enlace de esta manera:

HTML

  <a
    href="https://www.examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}"
    data-disable-tracking="true"
  >
    Unsubscribe
  </a>

Atributos específicos del proveedor:

Proveedor	Atributo
OneSignal	`data-disable-tracking="true"`
Mailgun	`disable-tracking=true`
SendGrid	`clicktracking=off`
Mandrill	`mc:disable-tracking`

Alojar su página de cancelación de suscripción personalizada

Implemente una página web que:

Lea los parámetros de consulta del enlace de cancelación de suscripción.
Muestre opciones de exclusión o preferencias fáciles de usar.
Envíe la solicitud de cancelación de suscripción o actualización a OneSignal a través de la API.

Proporcionamos un proyecto de muestra de GitHub funcional que puede bifurcar e implementar.

Página de cancelación de suscripción de muestra — UI de página de cancelación de suscripción de muestra

Llamar a la API de OneSignal

Dependiendo de su caso de uso, puede usar las siguientes APIs para cancelar la suscripción o actualizar las preferencias del usuario:

Actualizar suscripción por token
Cancelar suscripción de correo electrónico con token
Actualizar usuario

Esta API se usa más comúnmente cuando tiene la dirección de correo electrónico del usuario y solo desea suscribirlo o cancelar su suscripción de todos los correos electrónicos.Parámetros de consulta requeridos:

app_id
token

Autenticación requerida

Llame a esta API desde su servidor.

Use esta API si desea rastrear qué correo electrónico específico causó la cancelación de suscripción. Esto usa el ID del mensaje de correo electrónico para rastrear la cancelación de suscripción. Consulte la API Cancelar suscripción de correo electrónico con token para más detalles.Parámetros de consulta requeridos:

app_id
notification_id
token

Parámetros opcionales:

email
language

Ejemplo de JavaScript:

JavaScript

const unsubscribeURL = (href) => {
  const unsubscribeURL = new URL(href)
  const appID = unsubscribeURL.searchParams.get("app_id")
  const notificationID = unsubscribeURL.searchParams.get("notification_id")
  const unsubscribeToken = unsubscribeURL.searchParams.get("token")
  const language = unsubscribeURL.searchParams.get("language")
  const email = unsubscribeURL.searchParams.get("email")
  return {
    unsubscribeURL: `https://api.onesignal.com/apps/${appID}/notifications/${notificationID}/unsubscribe?token=${unsubscribeToken}`,
    meta: { language, email },
  }
}

Actualice las preferencias del usuario usando la API Actualizar usuario.Parámetros de consulta requeridos:

app_id
alias_id - Se recomienda el ID externo del usuario.

Autenticación requerida

Llame a esta API desde su servidor.

Ahora debería estar equipado con todo lo que necesita saber sobre cómo crear una página de cancelación de suscripción personalizada.

Primeros pasos & configuraciones

Canales de mensajería

Journeys

Audiencia & eventos personalizados

Analítica & Integraciones

Privacidad & Seguridad

Crear una página de cancelación de suscripción de correo electrónico personalizada

Descripción general

Eliminar el enlace de cancelación de suscripción predeterminado de OneSignal

Agregar su enlace de cancelación de suscripción personalizado

Deshabilitar el seguimiento de clics

Alojar su página de cancelación de suscripción personalizada

Llamar a la API de OneSignal

​Descripción general

​Eliminar el enlace de cancelación de suscripción predeterminado de OneSignal

​Agregar su enlace de cancelación de suscripción personalizado

​Deshabilitar el seguimiento de clics

​Alojar su página de cancelación de suscripción personalizada

​Llamar a la API de OneSignal

Descripción general

Eliminar el enlace de cancelación de suscripción predeterminado de OneSignal

Agregar su enlace de cancelación de suscripción personalizado

Deshabilitar el seguimiento de clics

Alojar su página de cancelación de suscripción personalizada

Llamar a la API de OneSignal