Solución de problemas del seguimiento de clics con SSL

Usa esta página para identificar problemas comunes de seguimiento de clics con SSL. Ten en cuenta que las siguientes indicaciones son genéricas porque cada CDN es único. Para problemas de configuración de CDN, certificados o proxy, ponte en contacto con el equipo de soporte de tu CDN, ya que estas configuraciones se realizan fuera de Braze.

Empieza aquí: identifica tu síntoma

Ruta de investigación estándar

1. Confirma que tu subdominio de seguimiento de clics apunta a tu red de entrega de contenido (CDN), no directamente a tu proveedor de servicios de correo electrónico (SendGrid, SparkPost o Amazon SES). Pide a tu equipo de TI o web que verifique que la configuración de tu dominio coincida con tu configuración de Braze. Para los requisitos de Braze, consulta Adquirir un certificado SSL.
2. Confirma que tu certificado SSL está activo para el dominio de seguimiento. Pide a tu equipo de TI o web que confirme que el certificado está vigente y cubre tu subdominio de seguimiento de clics. Para los pasos de configuración y guías específicas de CDN, consulta Adquirir un certificado SSL y Recursos adicionales.
3. Envía un correo electrónico de prueba usando la plantilla de solución de problemas de seguimiento de clics. Compara las URL con seguimiento frente a las que no tienen seguimiento.
4. Si los enlaces con seguimiento fallan con un error 403, revisa las reglas de CDN y WAF (agentes de usuario, cadenas de consulta, patrones de redirección).
5. Si la configuración está completa pero los enlaces siguen siendo HTTP, contacta a tu administrador de éxito de cliente de Braze para confirmar que Braze habilitó SSL.
6. Para problemas persistentes, coordina con tu CDN o equipo de TI y contacta a soporte de Braze con los códigos de error y cualquier detalle de tu CDN o proveedor de dominios.

Conceptos clave

• Dominio de seguimiento de clics (CTD): El subdominio de marca que Braze utiliza para envolver enlaces con fines de seguimiento de clics (por ejemplo, clicks.mail.yourbrand.com).
• URL con seguimiento: Envuelve el enlace HTTPS original en tu dominio de seguimiento. Cuando un usuario hace clic en él, el dominio de seguimiento resuelve la solicitud y redirige al destino final. Un CDN te permite hacer seguimiento de URL seguras (HTTPS). Sin él, los usuarios pueden encontrar un error de privacidad de “la conexión no es segura”.
• URL sin seguimiento: Mantiene la URL original intacta, omitiendo el CDN para servir como un entorno de control.
• Enrutamiento de fase 1 y fase 2: La fase 1 apunta el CNAME de tu dominio de seguimiento de clics directamente a tu proveedor de servicios de correo electrónico (ESP) para la verificación HTTP inicial. La fase 2 apunta el CNAME a tu CDN o firewall de aplicaciones web (WAF), que termina SSL y envía las solicitudes como proxy al ESP con los encabezados requeridos. Para destinos CNAME específicos de cada ESP, consulta Enrutamiento de fase 1 y fase 2 del ESP.

Dominios de seguimiento de clics y fases de DNS

El seguimiento de clics con SSL requiere una configuración de DNS en dos fases porque Braze no aprovisiona ni renueva certificados de seguridad externos en tu nombre.

1. Fase 1 (configuración inicial): El CNAME de tu dominio de seguimiento de clics apunta directamente al endpoint de tu ESP para la verificación HTTP sin cifrar.
2. Fase 2 (implementación de SSL): Actualizas el CNAME para que apunte a tu CDN o WAF edge, que contiene tu certificado SSL personalizado y redirige las solicitudes al ESP con los encabezados requeridos. El ESP registra el clic y redirige al destinatario al destino final.

Importante

Braze habilita el seguimiento de clics con SSL solo después de que se complete la verificación de la Fase 1. Si SSL está habilitado pero tu DNS aún apunta al ESP (Fase 1), los destinatarios pueden ver errores de discrepancia de nombre SSL.

Enrutamiento ESP Fase 1 y Fase 2

Al solucionar errores de seguimiento de enlaces, comprueba si tu registro de DNS apunta a la red ESP sin cifrar (Fase 1) o a tu CDN (Fase 2).

Para los pasos de configuración de CDN y la documentación de partners, consulta SSL en Braze.

Errores de discrepancia de nombre SSL

Una discrepancia de nombre SSL es un fallo de autenticación de identidad durante el handshake TLS. Ocurre cuando un navegador establece una conexión cifrada pero el dominio en la barra de direcciones no coincide con ninguna entrada en los campos de nombre común (CN) o nombres alternativos del sujeto (SAN) del certificado.

El DNS aún apunta al ESP (Fase 1)

Si indicas a Braze que habilite el seguimiento de clics SSL pero dejas tu CNAME de DNS apuntando directamente al ESP (por ejemplo, sendgrid.net de SendGrid), el navegador del destinatario abre tu dominio de seguimiento de clics y llega a la infraestructura del ESP. El ESP no tiene registro de tu certificado personalizado y sirve su propio certificado alternativo (por ejemplo, *.sendgrid.net). La discrepancia de nombre hace que la conexión falle y devuelve una advertencia de conexión privada.

El certificado no cubre el subdominio de seguimiento (Fase 2)

Si tu DNS apunta a tu CDN (Cloudflare, CloudFront, etc.) pero tu equipo de seguridad aplicó un certificado que solo cubre los activos web principales (por ejemplo, yourbrand.com y www.yourbrand.com), el subdominio específico de seguimiento de clics (por ejemplo, clicks.mail.yourbrand.com) no está incluido. El CDN sirve un certificado que no coincide con el dominio de seguimiento, y los navegadores muestran un error de privacidad.

Flujo de trabajo de triaje

Paso 1: Ejecuta una búsqueda CNAME autorizada

Abre tu terminal y comprueba el enrutamiento DNS sin procesar de tu dominio de seguimiento de clics:

1
dig CNAME clicks.mail.yourbrand.com

En la sección ANSWER SECTION, revisa a dónde resuelve el CNAME:

Paso 2: Valida el certificado TLS

Fuerza una validación TLS en vivo contra tu dominio de seguimiento de clics para ver exactamente qué certificado reciben los navegadores. Introduce tu dominio de seguimiento de clics en un verificador SSL externo, como SSL Checker de SSL Shopper (reemplaza clicks.mail.yourbrand.com con tu dominio).

Confirma lo siguiente:

• El certificado es válido y no ha expirado
• Tu dominio de seguimiento de clics aparece en el Common Name o en los Subject Alternative Names
• La cadena de certificados está completa, sin advertencias de certificados intermedios no confiables

Consejo

Para un informe TLS más detallado, también puedes usar Qualys SSL Labs SSL Server Test.

Paso 3: Revisa los problemas de configuración del CDN

Si los enlaces en correos electrónicos en vivo fallan durante la configuración, confirma que el DNS no se apuntó a tu CDN antes de que la configuración estuviera completa. Esto puede manifestarse como un enlace incorrecto o un error de conexión. Ponte en contacto con tu proveedor de CDN y revisa su documentación para solucionar problemas de proxy y configuración de origen. Coordínate con el equipo que gestiona tu configuración de SSL y CDN para obtener asistencia adicional.

Tasas bajas de apertura de correo electrónico

Síntoma: Las tasas de apertura de correo electrónico cayeron repentinamente tras cambios en SSL o CDN.

Si de repente experimentas tasas bajas de apertura de correo electrónico, confirma que el certificado SSL esté actualizado. Si ha expirado, debes renovar ese certificado SSL con tu CDN o proveedor de certificados.

HTTP 403 en enlaces de redirección

Síntoma: Los enlaces de correo electrónico con seguimiento devuelven “403 Forbidden”.

Si los enlaces de redirección con seguimiento devuelven 403 Forbidden, el fallo suele ocurrir en tu red de entrega de contenido (CDN) o firewall de aplicaciones web (WAF), por ejemplo, reglas en AWS WAF o Amazon CloudFront que bloquean ciertos agentes de usuario, cadenas de consulta o patrones de redirección. Revisa los registros de solicitudes bloqueadas y las métricas con tu CDN o proveedor de nube. Para AWS, consulta Solución de problemas con CloudFront.

Para ver si el problema es específico del seguimiento de clics, desactiva el seguimiento de clics para un enlace de prueba (consulta Desactivar el seguimiento de clics enlace por enlace). Si la URL de destino carga cuando el seguimiento de clics está desactivado pero devuelve 403 cuando está activado, concéntrate en la configuración de tu dominio de seguimiento de clics, CDN y WAF. Si tu CNAME aún apunta al ESP mientras SSL está habilitado, es posible que veas un error de discrepancia de nombre SSL en su lugar; comienza con el flujo de trabajo de triaje.

Problemas con el registro de dominio

Síntoma: El DNS o CNAME de tu subdominio de seguimiento apunta a tu ESP en lugar de a tu CDN.

Ejecuta un comando dig para confirmar que apuntas el seguimiento de enlaces al CDN. En tu terminal ejecuta dig CNAME link_tracking_subdomain. En ANSWER SECTION, se indica a dónde apunta tu CNAME. Si apunta al proveedor de servicios de correo electrónico (SendGrid, SparkPost o Amazon SES) y no a tu CDN, reconfigura tu registro de dominio para que apunte a tu CDN.

Problemas con el CDN

Síntoma: Los usuarios ven errores de “la conexión no es privada”, o los enlaces se rompen durante la configuración del CDN.

Si los enlaces de correo electrónico en vivo se rompen durante la configuración, probablemente apuntaste el DNS hacia tu CDN antes de una configuración adecuada. Esto puede aparecer como un error de “enlace incorrecto”. Ponte en contacto con tu proveedor de CDN y revisa su documentación para solucionar la configuración.

Si ves un mensaje de error indicando que tu conexión no es privada, esto puede indicar que tu SSL o CDN no está configurado correctamente. Ejecuta un comando dig en tu terminal (por ejemplo, dig CNAME your_link_tracking_subdomain). En ANSWER SECTION, si el resultado apunta a tu ESP en lugar de a tu CDN, el problema es una mala configuración. Para que el seguimiento de clics SSL de Braze funcione, el CNAME debe apuntar a tu CDN. Coordina con el equipo que administra tu configuración de SSL y CDN para obtener más asistencia.

Estado de habilitación de SSL

Síntoma: La configuración de SSL está completa, pero los enlaces con seguimiento siguen apareciendo como HTTP.

Si completas la configuración de SSL y los enlaces siguen apareciendo como HTTP, ponte en contacto con tu administrador de éxito de cliente de Braze para confirmar que Braze habilitó SSL. Braze habilita SSL solo después de que se completen todos los pasos de configuración.

Amazon SES

Si estás usando Amazon SES como tu proveedor de servicios de correo electrónico, los siguientes problemas de configuración pueden impedir que Braze habilite SSL o causar errores durante la configuración:

• Discrepancia de región: Confirma que el origen de tu CDN apunte al dominio de seguimiento de AWS para tu clúster de Braze. Los clústeres de EE. UU. usan r.us-east-1.awstrack.me. Los clústeres de la UE usan r.eu-central-1.awstrack.me. Usar la región incorrecta puede bloquear la habilitación de SSL.
• Encabezado de host: Amazon SES requiere que tu CDN reenvíe el encabezado de host correcto. Habilita el encabezado X-Forwarded-Host en tu dominio de seguimiento de clics. Para los requisitos de enrutamiento de la fase 1 y la fase 2, consulta Enrutamiento de la fase 1 y la fase 2 del ESP.
• Configuración de proxy: Una configuración de proxy o CDN que sobrescriba o entre en conflicto con el encabezado de host puede causar que la habilitación de SSL falle. Revisa la configuración del proxy con tu proveedor de CDN para confirmar que no interfiera con el reenvío del encabezado de host.
• Registro alias de Route 53: Si usas Route 53 para administrar el DNS de tu dominio, crea un registro alias en Route 53 que apunte a tu distribución de CDN (por ejemplo, d111111abcdef8.cloudfront.net). Usar un CNAME estándar en lugar de un registro alias puede devolver errores HTTP 400.
• Reenvío de encabezados deshabilitado: Si la habilitación de SSL sigue fallando después de configurar X-Forwarded-Host, intenta deshabilitar el reenvío de encabezados en tu CDN o proxy. Algunas configuraciones resuelven el problema cuando el reenvío se desactiva por completo. Trabaja con tu equipo de TI o proveedor de CDN para probar esta configuración.

Problemas con el seguimiento de clics

Síntoma: Los enlaces de correo electrónico con seguimiento fallan, pero los enlaces sin seguimiento funcionan, o los usuarios ven errores de certificado o DNS después de hacer clic.

Los problemas comunes de redirección suelen ser resultado de una configuración incorrecta entre el CDN que aloja el dominio de seguimiento y sus certificados SSL asociados o registros DNS CNAME. Estas malas configuraciones a menudo causan que los usuarios reciban un error de privacidad de «la conexión no es segura» o un fallo 404 después de hacer clic en un enlace de correo electrónico con seguimiento.

Después de completar el flujo de trabajo de triaje, usa la siguiente plantilla para probar la configuración del CDN de tu dominio de seguimiento, que es el mecanismo que soporta los análisis de los enlaces dentro de tus correos electrónicos.

1. Copia y pega la siguiente plantilla en una Campaign de correo electrónico HTML de Braze.

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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
<!DOCTYPE html>
<html lang="en" xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="color-scheme" content="light dark">
    <meta name="supported-color-schemes" content="light dark">
    <title>Click Tracking Test</title>
    <style>
        /* Base Dark Mode (Default) */
        body {
            margin: 0;
            padding: 0;
            background-color: #2b0562;
            font-family: 'Helvetica Neue', Arial, sans-serif;
            color: #ffd1e9;
        }

        .email-container {
            width: 100%;
            max-width: 600px;
            margin: 40px auto;
            background-color: rgba(255, 255, 255, 0.05);
            border: 1px solid #F3697F;
            border-radius: 16px;
            overflow: hidden;
        }

        .header {
            background: linear-gradient(135deg, #E83F21 0%, #F3697F 100%);
            padding: 40px 20px 50px 20px;
            text-align: center;
        }

        .logo {
            display: block;
            margin: 0 auto 25px auto;
            border: 0;
            outline: none;
            text-decoration: none;
        }

        .header h1 {
            color: #ffffff;
            margin: 0;
            font-size: 26px;
            font-weight: 800;
            letter-spacing: -0.5px;
        }

        .content {
            padding: 40px 40px 20px 40px;
            line-height: 1.8;
            font-size: 15px;
        }

        .troubleshoot {
            margin: 0 40px 40px 40px;
            padding: 25px;
            background-color: rgba(253, 167, 216, 0.1);
            border-radius: 12px;
            font-size: 14px;
            border: 1px dashed #F3697F;
        }

        .troubleshoot h2 {
            margin-top: 0;
            font-size: 18px;
            color: #ffffff;
        }

        .btn-section {
            padding: 0 40px 40px 40px;
            text-align: center;
        }

        .btn {
            display: inline-block;
            padding: 16px 32px;
            border-radius: 12px;
            font-weight: 700;
            text-decoration: none;
            margin: 10px;
            font-size: 14px;
        }

        .btn-tracked {
            background-color: #F3697F;
            color: #ffffff;
        }

        .btn-untracked {
            border: 2px solid #FDA7D8;
            color: #FDA7D8;
            background-color: transparent;
        }

        .footer {
            text-align: center;
            font-size: 12px;
            color: #FDA7D8;
            padding-bottom: 40px;
            opacity: 0.6;
        }

        /* Light Mode Overrides */
        @media (prefers-color-scheme: light) {
            body { background-color: #F7FCFF !important; color: #2b0562 !important; }
            .email-container { background-color: #ffffff !important; border: 1px solid #FDA7D8 !important; box-shadow: 0 4px 20px rgba(43, 5, 98, 0.1); }
            .content { color: #2b0562 !important; }
            .troubleshoot { background-color: #F7FCFF !important; border-color: #F3697F !important; color: #2b0562 !important; }
            .troubleshoot h2 { color: #E83F21 !important; }
            .btn-untracked { color: #F3697F !important; border-color: #F3697F !important; }
            .footer { color: #2b0562 !important; }
            strong { color: #E83F21 !important; }
        }

        /* Mobile Optimization */
        @media only screen and (max-width: 480px) {
            .btn { display: block !important; margin: 10px 0 !important; width: auto !important; }
            .content, .troubleshoot { padding: 25px !important; }
        }
    </style>
</head>
{%- capture url -%}https://example.com{%- endcapture -%}
<body>
    <center>
        <table class="email-container" role="presentation" width="600" border="0" cellpadding="0" cellspacing="0">
            <tr>
                <td class="header">
                    <img src="https://cdn-staging.braze.com/appboy/communication/assets/image_assets/images/60aecba96a93150c749b4d57/original.png?1622068137"
                         width="150"
                         alt="Logo"
                         class="logo">
                    <h1>Testing Click Tracking Functionality</h1>
                </td>
            </tr>
            <tr>
                <td class="content">
                    <p>
                        Use this template to test the <strong>CDN configuration</strong> of your tracking domain—the mechanism supporting analytics for links within your emails.
                    </p>
                    <p>
                        A <strong>Tracked URL</strong> wraps the original HTTPS link in your tracking domain. When a user clicks it, the tracking domain resolves the request and redirects to the final destination. A CDN allows you to track secure (HTTPS) URLs; without it, users may encounter a "connection is not secure" privacy error. An <strong>Untracked URL</strong> maintains the original URL intact, bypassing the CDN to serve as a control environment.
                    </p>
                    <p>
                        Common redirection issues typically result from an improper configuration between the CDN hosting the tracking domain and the <strong>associated SSL certificate or DNS CNAME records.</strong>
                    </p>
                    <p>
                        <i style="font-size: 13px;">This template uses "example.com" as the destination URL. To test your own domain, replace the URL in the <strong>capture</strong> tag located on line 125.</i>
                    </p>
                </td>
            </tr>
            <tr>
                <td class="btn-section">
                    <a href="{{url}}" class="btn btn-tracked">Tracked URL</a>

                    <a href="{{url}}"
                       class="btn btn-untracked"
                       clicktracking="off"
                       data-msys-clicktrack="0"
                       ses:no-track="true">
                       Untracked URL
                    </a>
                </td>
            </tr>
            <tr>
                <td>
                    <div class="troubleshoot">
                        <h2>Troubleshooting the Test</h2>
                        <ul>
                            <li><strong>Tracked URL Fails / Untracked Works:</strong> This indicates a CDN or SSL certificate issue. Verify that your SSL certificate is valid and correctly bound to your tracking domain.</li>
                            <li><strong>Privacy Error (HTTPS):</strong> Ensure your CDN is configured to handle port 443 traffic and that the certificate matches your tracking CNAME.</li>
                            <li><strong>Both URLs Fail:</strong> Check the destination URL or your internal network firewall settings.</li>
                            <li>For more information, visit: <a href="{{ site.homeurl }}{{ site.baseurl }}/user_guide/channels/email/email_setup/ssl">SSL at Braze</a></li>
                        </ul>
                    </div>
                </td>
            </tr>
        </table>
        <div class="footer">
            Braze :: 63 Madison Avenue, 13th Floor :: New York, NY 10016
        </div>
    </center>
</body>
</html>

2. Configura tu URL. Reemplaza la URL en la etiqueta capture cerca de la parte superior del cuerpo de la plantilla (donde se establece https://example.com). Por ejemplo, reemplaza https://example.com con https://braze.com/docs.
3. Envíate un correo electrónico de prueba y selecciona ambos botones.
4. Verifica que el comportamiento esperado y los criterios de éxito sean los descritos en la plantilla.

Si tu URL sin seguimiento funciona pero tu URL con seguimiento falla, es posible que tengas un problema de configuración. Consulta la documentación de tu ESP y proveedor de CDN específicos. Para conocer los requisitos detallados sobre el aprovisionamiento de certificados, consulta SSL en Braze.

Usa la siguiente tabla para diagnosticar errores comunes al probar el seguimiento de clics.