Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

Résolution des problèmes

Utilisez ces conseils pour identifier les problèmes courants de suivi des clics SSL. Les recommandations de résolution des problèmes sont génériques, car chaque réseau de diffusion de contenu est unique. Pour les problèmes de configuration, de certificats ou de proxy de votre réseau de diffusion de contenu, contactez l’équipe d’assistance de votre fournisseur, car ces configurations sont effectuées en dehors de l’écosystème Braze.

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 réseau de diffusion de contenu 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 réseau de diffusion de contenu pour servir d’environnement de contrôle.

Faibles taux d’ouverture des e-mails

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 réseau de diffusion de contenu ou de votre fournisseur de certificats.

HTTP 403 sur les liens de redirection

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 réseau de diffusion de contenu ou de cloud. Pour AWS, consultez Troubleshooting issues with 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 réseau de diffusion de contenu et de votre WAF.

Problèmes de registre de domaine

Exécutez une commande dig pour confirmer que le suivi des liens pointe vers le réseau de diffusion de contenu. 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 réseau de diffusion de contenu, reconfigurez votre registre de domaine pour pointer vers votre réseau de diffusion de contenu.

Problèmes de réseau de diffusion de contenu

Si les liens d’e-mails en production cessent de fonctionner pendant la configuration, vous avez probablement dirigé le DNS vers votre réseau de diffusion de contenu avant que la configuration ne soit correctement effectuée. Cela peut se manifester par une erreur de « mauvais lien ». Contactez votre fournisseur de réseau de diffusion de contenu 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 réseau de diffusion de contenu 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 ESP au lieu de votre réseau de diffusion de contenu, le problème est une mauvaise configuration. Pour que le suivi des clics SSL de Braze fonctionne, le CNAME doit pointer vers votre réseau de diffusion de contenu. Coordonnez-vous avec l’équipe qui gère votre configuration SSL et réseau de diffusion de contenu pour obtenir de l’aide.

État d’activation du SSL

Si vous avez terminé la configuration SSL et que les liens apparaissent toujours en HTTP, contactez votre gestionnaire de la satisfaction client 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 réseau de diffusion de contenu 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 réseau de diffusion de contenu 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 réseau de diffusion de contenu 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 réseau de diffusion de contenu 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 de réseau de diffusion de contenu (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 réseau de diffusion de contenu 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 réseau de diffusion de contenu pour tester cette configuration.

Problèmes de suivi des clics

Les problèmes courants de redirection résultent généralement d’une mauvaise configuration entre le réseau de diffusion de contenu 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 réseau de diffusion de contenu de votre domaine de suivi, qui est le mécanisme prenant en charge l’analyse des liens dans vos e-mails.

Copiez et collez le modèle suivant dans une campagne d’e-mail HTML Braze.

Modèle de résolution des problèmes de suivi des clics

<!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="https://www.braze.com/docs/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>

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.
Envoyez-vous un e-mail de test et sélectionnez les deux boutons.
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 réseau de diffusion de contenu. 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.

Code d’erreur	Résolution des problèmes
`"Your connection is not private" (NET::ERR_CERT_COMMON_NAME_INVALID)`	Vérifiez que votre domaine de suivi dispose d’un certificat SSL valide.
`"This site can't be reached" (DNS_PROBE_FINISHED_NXDOMAIN)`	Vérifiez vos paramètres DNS. Assurez-vous que votre sous-domaine de suivi est configuré conformément aux recommandations de votre réseau de diffusion de contenu et de votre ESP.
`525 / 526 SSL Error`	Vérifiez que le paramètre SSL de votre réseau de diffusion de contenu (comme Cloudflare) correspond aux capacités de votre origine.
`404 Not Found`	Vérifiez que votre réseau de diffusion de contenu est configuré pour transmettre l’intégralité du chemin de l’URL à l’ESP, plutôt que de pointer vers un répertoire racine vide.

New Stuff!