Solução de problemas de rastreamento de cliques SSL

Use esta página para identificar problemas comuns de rastreamento de cliques SSL. As orientações a seguir são genéricas, pois cada CDN é única. Para problemas de configuração de CDN, certificados ou proxy, entre em contato com a equipe de suporte do seu CDN, já que essas configurações ocorrem fora da Braze.

Comece aqui: identifique seu sintoma

Caminho de investigação padrão

1. Confirme se o subdomínio de rastreamento de cliques aponta para a sua rede de distribuição de conteúdo (CDN) — e não diretamente para o seu provedor de serviços de e-mail (SendGrid, SparkPost ou Amazon SES). Peça à sua equipe de TI ou web para verificar se as configurações do domínio correspondem à sua configuração na Braze. Para os requisitos da Braze, consulte Obter um certificado SSL.
2. Confirme se o certificado SSL está ativo para o domínio de rastreamento. Peça à sua equipe de TI ou web para confirmar se o certificado está atualizado e cobre o subdomínio de rastreamento de cliques. Para etapas de configuração e guias específicos de CDN, consulte Obter um certificado SSL e Recursos adicionais.
3. Envie um e-mail de teste usando o modelo de solução de problemas de rastreamento de cliques. Compare as URLs rastreadas com as não rastreadas.
4. Se os links rastreados falharem com erro 403, revise as regras de CDN e WAF (user agents, query strings, padrões de redirecionamento).
5. Se a configuração estiver completa, mas os links permanecerem em HTTP, entre em contato com o seu gerente de sucesso do cliente da Braze para confirmar se a Braze ativou o SSL.
6. Para problemas persistentes, coordene com a sua equipe de CDN ou TI e entre em contato com o suporte da Braze informando os códigos de erro e quaisquer detalhes do seu CDN ou provedor de domínio.

Conceitos-chave

• Domínio de rastreamento de cliques (CTD): O subdomínio personalizado que a Braze usa para encapsular links para rastreamento de cliques (por exemplo, clicks.mail.yourbrand.com).
• URL rastreada: Encapsula o link HTTPS original no seu domínio de rastreamento. Quando um usuário clica nela, o domínio de rastreamento resolve a solicitação e redireciona para o destino final. Uma CDN permite rastrear URLs seguras (HTTPS). Sem ela, os usuários podem encontrar um erro de privacidade informando que “a conexão não é segura”.
• URL não rastreada: Mantém a URL original intacta, ignorando a CDN para servir como um ambiente de controle.
• Roteamento Fase 1 e Fase 2: A Fase 1 aponta o CNAME do seu domínio de rastreamento de cliques diretamente para o seu provedor de serviços de e-mail (ESP) para verificação HTTP inicial. A Fase 2 aponta o CNAME para a sua CDN ou firewall de aplicação web (WAF), que encerra o SSL e encaminha as solicitações por proxy para o ESP com os cabeçalhos necessários. Para destinos CNAME específicos de cada ESP, consulte Roteamento ESP Fase 1 e Fase 2.

Domínios de rastreamento de cliques e fases de DNS

O rastreamento de cliques com SSL requer uma configuração de DNS em duas fases, pois a Braze não provisiona nem renova certificados de segurança externos em seu nome.

1. Fase 1 (configuração inicial): O CNAME do seu domínio de rastreamento de cliques aponta diretamente para o endpoint do seu provedor de serviços de e-mail para verificação HTTP não criptografada.
2. Fase 2 (implantação do SSL): Você atualiza o CNAME para apontar para o edge da sua rede de distribuição de conteúdo (CDN) ou WAF, que mantém seu certificado SSL personalizado e encaminha as solicitações ao provedor de serviços de e-mail com os cabeçalhos necessários. O provedor de serviços de e-mail registra o clique e redireciona o destinatário para o destino final.

Importante

A Braze ativa o rastreamento de cliques com SSL somente após a conclusão da verificação da Fase 1. Se o SSL estiver ativado, mas seu DNS ainda apontar para o provedor de serviços de e-mail (Fase 1), os destinatários poderão ver erros de incompatibilidade de nome SSL.

Roteamento ESP Fase 1 e Fase 2

Ao solucionar problemas de erros de rastreamento de links, verifique se o seu registro DNS aponta para a rede ESP não criptografada (Fase 1) ou para a sua CDN (Fase 2).

Para etapas de configuração de CDN e documentação de parceiros, consulte SSL na Braze.

Erros de incompatibilidade de nome SSL

Uma incompatibilidade de nome SSL é uma falha de autenticação de identidade durante o handshake TLS. Ela ocorre quando um navegador estabelece uma conexão criptografada, mas o domínio na barra de endereços não corresponde a nenhuma entrada nos campos Common Name (CN) ou Subject Alternative Names (SAN) do certificado.

O DNS ainda aponta para o provedor de serviços de e-mail (Fase 1)

Se você instruir a Braze a ativar o rastreamento de cliques SSL, mas deixar seu CNAME de DNS apontando diretamente para o provedor de serviços de e-mail (por exemplo, sendgrid.net do SendGrid), o navegador do destinatário abre seu domínio de rastreamento de cliques e chega à infraestrutura do provedor. O provedor não tem registro do seu certificado personalizado e serve seu próprio certificado de fallback (por exemplo, *.sendgrid.net). A incompatibilidade de nome faz a conexão falhar e retorna um aviso de conexão privada.

O certificado não cobre o subdomínio de rastreamento (Fase 2)

Se o seu DNS aponta para a sua rede de distribuição de conteúdo (CDN) (Cloudflare, CloudFront, entre outros), mas sua equipe de segurança aplicou um certificado que cobre apenas os ativos web principais (por exemplo, yourbrand.com e www.yourbrand.com), o subdomínio específico de rastreamento de cliques (por exemplo, clicks.mail.yourbrand.com) não está incluído. A CDN serve um certificado que não corresponde ao domínio de rastreamento, e os navegadores exibem um erro de privacidade.

Fluxo de trabalho de triagem

Etapa 1: Execute uma consulta CNAME autoritativa

Abra seu terminal e verifique o roteamento DNS bruto do seu domínio de rastreamento de cliques:

1
dig CNAME clicks.mail.yourbrand.com

Na ANSWER SECTION, verifique para onde o CNAME resolve:

Etapa 2: Valide o certificado TLS

Force uma validação TLS ao vivo no seu domínio de rastreamento de cliques para ver exatamente qual certificado os navegadores recebem. Insira seu domínio de rastreamento de cliques em um verificador SSL externo, como o SSL Checker do SSL Shopper (substitua clicks.mail.yourbrand.com pelo seu domínio).

Confirme o seguinte:

• O certificado é válido e não está expirado
• Seu domínio de rastreamento de cliques aparece no Common Name ou nos Subject Alternative Names
• A cadeia de certificados está completa, sem alertas de certificado intermediário não confiável

Dica

Para um relatório TLS mais detalhado, você também pode usar o Qualys SSL Labs SSL Server Test.

Etapa 3: Revise problemas de configuração da CDN

Se os links de e-mails em tempo real quebrarem durante a configuração, confirme que o DNS não foi apontado para sua CDN antes de a configuração estar concluída. Isso pode aparecer como um link incorreto ou erro de conexão. Entre em contato com seu provedor de CDN e revise a documentação dele para solucionar problemas de proxy e configurações de origem. Coordene com a equipe que gerencia sua configuração de SSL e CDN para obter assistência adicional.

Baixas taxas de abertura de e-mail

Sintoma: As taxas de abertura de e-mail caíram repentinamente após alterações no SSL ou CDN.

Se você está enfrentando taxas de abertura de e-mail repentinamente baixas, confirme se o certificado SSL está atualizado. Se estiver expirado, você deve renovar o certificado SSL com seu CDN ou provedor de certificados.

HTTP 403 em links de redirecionamento

Sintoma: Links de e-mail rastreados retornam “403 Forbidden”.

Se links de redirecionamento rastreados retornam 403 Forbidden, a falha geralmente ocorre na sua rede de distribuição de conteúdo (CDN) ou firewall de aplicação web (WAF) — por exemplo, regras no AWS WAF ou Amazon CloudFront que bloqueiam determinados user agents, query strings ou padrões de redirecionamento. Revise os registros e métricas de solicitações bloqueadas com seu CDN ou provedor de nuvem. Para AWS, consulte Solução de problemas com o CloudFront.

Para verificar se o problema é específico do rastreamento de cliques, desative o rastreamento de cliques para um link de teste (consulte Desativando o rastreamento de cliques link a link). Se a URL de destino carrega quando o rastreamento de cliques está desativado, mas retorna 403 quando o rastreamento está ativado, concentre-se na configuração do seu domínio de rastreamento de cliques, CDN e WAF. Se o seu CNAME ainda aponta para o provedor de serviços de e-mail enquanto o SSL está ativado, você pode ver um erro de incompatibilidade de nome SSL — comece pelo fluxo de triagem.

Problemas no registro de domínio

Sintoma: O DNS ou CNAME do seu subdomínio de rastreamento aponta para o seu provedor de serviços de e-mail em vez do seu CDN.

Execute um comando dig para confirmar que o rastreamento de links aponta para o CDN. No seu terminal, execute dig CNAME link_tracking_subdomain. Na seção ANSWER SECTION, é listado para onde seu CNAME aponta. Se ele aponta para o provedor de serviços de e-mail (SendGrid, SparkPost ou Amazon SES) e não para o seu CDN, reconfigure o registro do seu domínio para apontar para o CDN.

Problemas com CDN

Sintoma: Os usuários veem erros de “conexão não é privada”, ou os links quebram durante a configuração do CDN.

Se os links de e-mail em produção quebram durante a configuração, provavelmente você apontou o DNS para o CDN antes da configuração adequada. Isso pode aparecer como um erro de “link incorreto”. Entre em contato com o provedor do seu CDN e revise a documentação para solucionar a configuração.

Se você vir uma mensagem de erro informando que sua conexão não é privada, isso pode indicar que seu SSL ou CDN não está configurado corretamente. Execute um comando dig no seu terminal (por exemplo, dig CNAME your_link_tracking_subdomain). Na seção ANSWER SECTION, se o resultado aponta para o seu provedor de serviços de e-mail em vez do seu CDN, o problema é uma configuração incorreta. Para que o rastreamento de cliques SSL da Braze funcione, o CNAME deve apontar para o seu CDN. Coordene com a equipe que gerencia a configuração do seu SSL e CDN para obter mais assistência.

Status de ativação do SSL

Sintoma: A configuração do SSL está concluída, mas os links rastreados ainda aparecem como HTTP.

Se você concluiu a configuração do SSL e os links ainda aparecem como HTTP, entre em contato com o seu gerente de sucesso do cliente da Braze para confirmar que a Braze ativou o SSL. A Braze ativa o SSL somente após todas as etapas de configuração estarem concluídas.

Amazon SES

Se você está usando o Amazon SES como provedor de serviços de e-mail, os seguintes problemas de configuração podem impedir a Braze de ativar o SSL ou causar erros durante a configuração:

• Incompatibilidade de região: Confirme que a origem do seu CDN aponta para o domínio de rastreamento AWS do seu cluster da Braze. Clusters nos EUA usam r.us-east-1.awstrack.me. Clusters na UE usam r.eu-central-1.awstrack.me. Usar a região errada pode bloquear a ativação do SSL.
• Cabeçalho de host: O Amazon SES exige que seu CDN encaminhe o cabeçalho de host correto. Ative o cabeçalho X-Forwarded-Host no seu domínio de rastreamento de cliques. Para os requisitos de roteamento das Fases 1 e 2, consulte Roteamento das Fases 1 e 2 do ESP.
• Configuração de proxy: Uma configuração de proxy ou CDN que substitui ou conflita com o cabeçalho de host pode causar falha na ativação do SSL. Revise as configurações de proxy com o provedor do seu CDN para confirmar que elas não interferem no encaminhamento do cabeçalho de host.
• Registro alias do Route 53: Se você usa o Route 53 para gerenciar o DNS do seu domínio, crie um registro alias no Route 53 que aponte para a distribuição do seu CDN (por exemplo, d111111abcdef8.cloudfront.net). Usar um CNAME padrão em vez de um registro alias pode retornar erros HTTP 400.
• Encaminhamento de cabeçalho desativado: Se a ativação do SSL ainda falhar após configurar o X-Forwarded-Host, tente desativar o encaminhamento de cabeçalho no seu CDN ou proxy. Algumas configurações resolvem o problema quando o encaminhamento é totalmente desativado. Trabalhe com sua equipe de TI ou provedor de CDN para testar essa configuração.

Problemas de rastreamento de cliques

Sintoma: Links de e-mail rastreados falham, mas links não rastreados funcionam, ou os usuários veem erros de certificado ou DNS após clicar.

Problemas comuns de redirecionamento geralmente resultam de uma configuração inadequada entre a rede de distribuição de conteúdo (CDN) que hospeda o domínio de rastreamento e seus certificados SSL associados ou registros DNS CNAME. Essas configurações incorretas frequentemente fazem com que os usuários recebam um erro de privacidade “a conexão não é segura” ou uma falha 404 após clicar em um link de e-mail rastreado.

Após concluir o fluxo de triagem, use o modelo a seguir para testar a configuração do CDN do seu domínio de rastreamento, que é o mecanismo que suporta a análise de dados dos links nos seus e-mails.

1. Copie e cole o modelo a seguir em uma Campaign de e-mail HTML na 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. Configure sua URL. Substitua a URL na tag capture próxima ao topo do corpo do modelo (onde https://example.com está definido). Por exemplo, substitua https://example.com por https://braze.com/docs.
3. Envie um e-mail de teste para você mesmo e selecione ambos os botões.
4. Verifique se o comportamento esperado e os critérios de sucesso estão conforme descrito no modelo.

Se a URL não rastreada funciona, mas a URL rastreada falha, pode haver uma lacuna na configuração. Para solucionar, consulte a documentação do seu provedor de serviços de e-mail e provedor de CDN específicos. Você também pode revisar o artigo SSL na Braze para requisitos detalhados sobre provisionamento de certificados.

Use a tabela a seguir para diagnosticar erros comuns ao testar o rastreamento de cliques.