Résolution des problèmes de suivi des clics SSL

Utilisez cette page pour identifier les problèmes courants de suivi des clics SSL. Les recommandations ci-dessous sont génériques, car chaque CDN est unique. Pour les problèmes de configuration, de certificats ou de proxy de votre CDN, contactez l’équipe d’assistance de votre fournisseur, car ces configurations sont effectuées en dehors de Braze.

Commencez ici : identifiez votre symptôme

Parcours d’investigation standard

1. Confirmez que votre sous-domaine de suivi des clics pointe vers votre réseau de diffusion de contenu (CDN), et non directement vers votre fournisseur de services d’e-mailing (SendGrid, SparkPost ou Amazon SES). Demandez à votre équipe informatique ou web de vérifier que les paramètres de votre domaine correspondent à votre configuration Braze. Pour les exigences Braze, consultez Obtenir un certificat SSL.
2. Confirmez que votre certificat SSL est actif pour le domaine de suivi. Demandez à votre équipe informatique ou web de confirmer que le certificat est à jour et couvre votre sous-domaine de suivi des clics. Pour les étapes de configuration et les guides spécifiques aux CDN, consultez Obtenir un certificat SSL et Ressources supplémentaires.
3. Envoyez un e-mail de test à l’aide du modèle de résolution des problèmes de suivi des clics. Comparez les URL suivies et non suivies.
4. Si les liens suivis échouent avec une erreur 403, vérifiez les règles du CDN et du WAF (agents utilisateurs, chaînes de requête, schémas de redirection).
5. Si la configuration est terminée mais que les liens restent en HTTP, contactez votre gestionnaire du succès des clients Braze pour confirmer que Braze a activé le SSL.
6. Pour les problèmes persistants, coordonnez-vous avec votre CDN ou votre équipe informatique et contactez l’Assistance Braze en fournissant les codes d’erreur et tout détail provenant de votre CDN ou de votre fournisseur de domaine.

Concepts clés

• URL suivie : Encapsule le lien HTTPS d’origine dans votre domaine de suivi. Lorsqu’un utilisateur clique dessus, le domaine de suivi résout la requête et redirige vers la destination finale. Un CDN vous permet de suivre les URL sécurisées (HTTPS). Sans celui-ci, les utilisateurs peuvent rencontrer une erreur de confidentialité « la connexion n’est pas sécurisée ».
• URL non suivie : Conserve l’URL d’origine intacte, en contournant le CDN pour servir d’environnement de contrôle.

Faibles taux d’ouverture des e-mails

Symptôme : Les taux d’ouverture des e-mails ont chuté soudainement après des modifications SSL ou CDN.

Si vous constatez soudainement de faibles taux d’ouverture des e-mails, vérifiez que le certificat SSL est à jour. S’il a expiré, vous devez renouveler ce certificat SSL auprès de votre CDN ou de votre fournisseur de certificats.

HTTP 403 sur les liens de redirection

Symptôme : Les liens e-mail suivis renvoient « 403 Forbidden ».

Si les liens de redirection suivis renvoient « 403 Forbidden », l’échec se produit souvent au niveau de votre réseau de diffusion de contenu (CDN) ou de votre pare-feu d’application web (WAF) — par exemple, des règles sur AWS WAF ou Amazon CloudFront qui bloquent certains agents utilisateurs, chaînes de requête ou schémas de redirection. Examinez les journaux et les indicateurs des requêtes bloquées avec votre fournisseur de CDN ou de cloud. Pour AWS, consultez Résolution des problèmes avec CloudFront.

Pour déterminer si le problème est spécifique au suivi des clics, désactivez le suivi des clics pour un lien de test (voir Désactiver le suivi des clics lien par lien). Si l’URL de destination se charge lorsque le suivi des clics est désactivé mais renvoie 403 lorsqu’il est activé, concentrez-vous sur la configuration de votre domaine de suivi des clics, de votre CDN et de votre WAF.

Problèmes de registre de domaine

Symptôme : Le DNS ou le CNAME de votre sous-domaine de suivi pointe vers votre fournisseur de services d’e-mailing au lieu de votre CDN.

Exécutez une commande dig pour confirmer que le suivi des liens pointe vers le CDN. Dans votre terminal, exécutez dig CNAME link_tracking_subdomain. Sous ANSWER SECTION, la réponse indique vers où pointe votre CNAME. S’il pointe vers le fournisseur de services d’e-mailing (SendGrid, SparkPost ou Amazon SES) et non vers votre CDN, reconfigurez votre registre de domaine pour pointer vers votre CDN.

Problèmes de CDN

Symptôme : Les utilisateurs voient des erreurs « la connexion n’est pas privée », ou les liens cessent de fonctionner pendant la configuration du CDN.

Si les liens d’e-mails en production cessent de fonctionner pendant la configuration, vous avez probablement dirigé le DNS vers votre CDN avant que la configuration ne soit correctement effectuée. Cela peut se manifester par une erreur de « mauvais lien ». Contactez votre fournisseur de CDN et consultez sa documentation pour résoudre le problème de configuration.

Si vous voyez un message d’erreur indiquant que votre connexion n’est pas privée, cela peut indiquer que votre SSL ou votre CDN n’est pas correctement configuré. Exécutez une commande dig dans votre terminal (par exemple, dig CNAME your_link_tracking_subdomain). Dans la section ANSWER SECTION, si le résultat pointe vers votre fournisseur de services d’e-mailing au lieu de votre CDN, le problème est une mauvaise configuration. Pour que le suivi des clics SSL de Braze fonctionne, le CNAME doit pointer vers votre CDN. Coordonnez-vous avec l’équipe qui gère votre configuration SSL et CDN pour obtenir de l’aide.

État d’activation du SSL

Symptôme : La configuration SSL est terminée, mais les liens suivis apparaissent toujours en HTTP.

Si vous avez terminé la configuration SSL et que les liens apparaissent toujours en HTTP, contactez votre gestionnaire du succès des clients Braze pour confirmer que Braze a activé le SSL. Braze n’active le SSL qu’une fois toutes les étapes de configuration terminées.

Amazon SES

Si vous utilisez Amazon SES comme fournisseur de services d’e-mailing, les problèmes de configuration suivants peuvent empêcher Braze d’activer le SSL ou provoquer des erreurs pendant la configuration :

• Incompatibilité de région : Vérifiez que l’origine de votre CDN pointe vers le domaine de suivi AWS correspondant à votre cluster Braze. Les clusters US utilisent r.us-east-1.awstrack.me. Les clusters EU utilisent r.eu-central-1.awstrack.me. L’utilisation de la mauvaise région peut bloquer l’activation du SSL.
• En-tête host : Amazon SES exige que votre CDN transmette le bon en-tête host. Activez l’en-tête X-Forwarded-Host sur votre domaine de suivi des clics. Pour plus d’informations, consultez la section Amazon SES.
• Configuration du proxy : Une configuration de proxy ou de CDN qui remplace ou entre en conflit avec l’en-tête host peut entraîner l’échec de l’activation du SSL. Vérifiez les paramètres du proxy avec votre fournisseur de CDN pour confirmer qu’ils n’interfèrent pas avec la transmission de l’en-tête host.
• Enregistrement alias Route 53 : Si vous utilisez Route 53 pour gérer le DNS de votre domaine, créez un enregistrement alias dans Route 53 qui pointe vers votre distribution CDN (par exemple, d111111abcdef8.cloudfront.net). L’utilisation d’un CNAME standard au lieu d’un enregistrement alias peut renvoyer des erreurs HTTP 400.
• Transmission d’en-têtes désactivée : Si l’activation du SSL échoue toujours après avoir configuré X-Forwarded-Host, essayez de désactiver la transmission d’en-têtes sur votre CDN ou votre proxy. Certaines configurations résolvent le problème lorsque la transmission est entièrement désactivée. Travaillez avec votre équipe informatique ou votre fournisseur de CDN pour tester cette configuration.

Problèmes de suivi des clics

Symptôme : les liens d’e-mail suivis échouent alors que les liens non suivis fonctionnent, ou les utilisateurs voient des erreurs de certificat ou de DNS après avoir cliqué.

Les problèmes courants de redirection résultent généralement d’une mauvaise configuration entre le CDN hébergeant le domaine de suivi et ses certificats SSL associés ou ses enregistrements DNS CNAME. Ces mauvaises configurations entraînent souvent une erreur de confidentialité « la connexion n’est pas sécurisée » ou un échec 404 après avoir cliqué sur un lien d’e-mail suivi.

Utilisez le modèle suivant pour tester la configuration du CDN de votre domaine de suivi, qui est le mécanisme prenant en charge l’analyse des liens dans vos e-mails.

1. Copiez et collez le modèle suivant dans une Campaign d’e-mail HTML 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. Configurez votre URL. Remplacez l’URL dans la balise capture en haut du corps du modèle (là où https://example.com est défini). Par exemple, remplacez https://example.com par https://braze.com/docs.
3. Envoyez-vous un e-mail de test et sélectionnez les deux boutons.
4. Vérifiez que le comportement attendu et les critères de réussite correspondent à ce qui est décrit dans le modèle.

Si votre URL non suivie fonctionne mais que votre URL suivie échoue, il se peut qu’il y ait un problème de configuration. Pour résoudre le problème, consultez la documentation de votre ESP et de votre fournisseur de CDN. Vous pouvez également consulter SSL chez Braze pour connaître les exigences détaillées en matière de provisionnement de certificats.

Utilisez le tableau suivant pour diagnostiquer les erreurs courantes lors du test du suivi des clics.