Saltar al contenido principal

​
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

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

​
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ámetroDescripción
subscription.emailDirección de correo electrónico del suscriptor
subscription.external_idID externo del usuario
app.idID de aplicación de OneSignal
message.idID de la notificación de correo electrónico
subscription.languageIdioma preferido (para localización)
subscription.unsubscribe_tokenToken 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

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:
ProveedorAtributo
OneSignaldata-disable-tracking="true"
Mailgundisable-tracking=true
SendGridclicktracking=off
Mandrillmc: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.
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.