Fehlerbehebung
Verwenden Sie diese Tipps, um häufige Probleme beim SSL-Klick-Tracking zu identifizieren. Die Hinweise zur Fehlerbehebung sind allgemein gehalten, da jedes CDN einzigartig ist. Bei Problemen mit der CDN-Konfiguration, Zertifikaten oder Proxy-Einstellungen wenden Sie sich an das Support-Team Ihres CDN-Anbieters, da diese Konfigurationen außerhalb des Braze-Ökosystems stattfinden.
Wichtige Konzepte
- Getrackte URL: Umschließt den ursprünglichen HTTPS-Link mit Ihrer Tracking-Domain. Wenn ein:e Nutzer:in darauf klickt, löst die Tracking-Domain die Anfrage auf und leitet zum endgültigen Ziel weiter. Ein CDN ermöglicht es Ihnen, sichere (HTTPS) URLs zu tracken. Ohne CDN kann es bei Nutzer:innen zu einem Datenschutzfehler „Verbindung ist nicht sicher“ kommen.
- Ungetrackte URL: Behält die ursprüngliche URL unverändert bei und umgeht das CDN, um als Kontrollumgebung zu dienen.
Niedrige E-Mail-Öffnungsraten
Wenn Sie plötzlich niedrige E-Mail-Öffnungsraten feststellen, überprüfen Sie, ob das SSL-Zertifikat aktuell ist. Wenn es abgelaufen ist, müssen Sie das SSL-Zertifikat bei Ihrem CDN- oder Zertifikatsanbieter erneuern.
HTTP 403 bei Weiterleitungslinks
Wenn getrackte Weiterleitungslinks 403 Forbidden zurückgeben, tritt der Fehler häufig bei Ihrem Content Delivery Network (CDN) oder Ihrer Web Application Firewall (WAF) auf – beispielsweise durch Regeln in AWS WAF oder Amazon CloudFront, die bestimmte User-Agents, Query-Strings oder Weiterleitungsmuster blockieren. Überprüfen Sie die Protokolle und Metriken blockierter Anfragen bei Ihrem CDN- oder Cloud-Anbieter. Für AWS siehe Troubleshooting issues with CloudFront.
Um festzustellen, ob das Problem spezifisch für das Klick-Tracking ist, deaktivieren Sie das Klick-Tracking für einen Testlink (siehe Klick-Tracking auf Link-Ebene deaktivieren). Wenn die Ziel-URL geladen wird, wenn das Klick-Tracking deaktiviert ist, aber 403 zurückgibt, wenn das Tracking aktiviert ist, konzentrieren Sie sich auf die Konfiguration Ihrer Klick-Tracking-Domain, Ihres CDN und Ihrer WAF.
Probleme mit der Domain-Registrierung
Führen Sie einen dig-Befehl aus, um zu bestätigen, dass Ihr Link-Tracking auf das CDN verweist. Führen Sie in Ihrem Terminal dig CNAME link_tracking_subdomain aus. Unter ANSWER SECTION wird aufgelistet, wohin Ihr CNAME verweist. Wenn er auf den E-Mail-Anbieter (SendGrid, SparkPost oder Amazon SES) und nicht auf Ihr CDN verweist, konfigurieren Sie Ihre Domain-Registrierung so um, dass sie auf Ihr CDN verweist.
CDN-Probleme
Wenn Live-E-Mail-Links während der Einrichtung nicht funktionieren, haben Sie wahrscheinlich DNS vor der ordnungsgemäßen Konfiguration auf Ihr CDN verwiesen. Dies kann als „falscher Link“-Fehler erscheinen. Kontaktieren Sie Ihren CDN-Anbieter und lesen Sie dessen Dokumentation zur Fehlerbehebung bei der Konfiguration.
Wenn eine Fehlermeldung angezeigt wird, dass Ihre Verbindung nicht privat ist, kann dies darauf hindeuten, dass Ihr SSL oder CDN nicht korrekt konfiguriert ist. Führen Sie einen dig-Befehl in Ihrem Terminal aus (z. B. dig CNAME your_link_tracking_subdomain). Wenn das Ergebnis in der ANSWER SECTION auf Ihren ESP statt auf Ihr CDN verweist, liegt eine Fehlkonfiguration vor. Damit das Braze-SSL-Klick-Tracking funktioniert, sollte der CNAME auf Ihr CDN verweisen. Koordinieren Sie sich mit dem Team, das Ihre SSL- und CDN-Konfiguration verwaltet, für weitere Unterstützung.
SSL-Aktivierungsstatus
Wenn Sie die SSL-Einrichtung abgeschlossen haben und Links weiterhin als HTTP erscheinen, kontaktieren Sie Ihren Braze Customer-Success-Manager, um zu bestätigen, dass Braze SSL aktiviert hat. Braze aktiviert SSL erst, nachdem alle Einrichtungsschritte abgeschlossen sind.
Amazon SES
Wenn Sie Amazon SES als E-Mail-Anbieter verwenden, können die folgenden Konfigurationsprobleme verhindern, dass Braze SSL aktiviert, oder Fehler während der Einrichtung verursachen:
- Regionsabweichung: Bestätigen Sie, dass Ihr CDN-Origin auf die AWS-Tracking-Domain für Ihren Braze-Cluster verweist. US-Cluster verwenden
r.us-east-1.awstrack.me. EU-Cluster verwendenr.eu-central-1.awstrack.me. Die Verwendung der falschen Region kann die SSL-Aktivierung blockieren. - Host-Header: Amazon SES erfordert, dass Ihr CDN den korrekten Host-Header weiterleitet. Aktivieren Sie den
X-Forwarded-Host-Header auf Ihrer Klick-Tracking-Domain. Weitere Informationen finden Sie im Abschnitt Amazon SES. - Proxy-Konfiguration: Ein Proxy- oder CDN-Setup, das den Host-Header überschreibt oder damit in Konflikt steht, kann dazu führen, dass die SSL-Aktivierung fehlschlägt. Überprüfen Sie die Proxy-Einstellungen mit Ihrem CDN-Anbieter, um sicherzustellen, dass sie die Host-Header-Weiterleitung nicht beeinträchtigen.
- Route-53-Alias-Eintrag: Wenn Sie Route 53 zur Verwaltung des DNS für Ihre Domain verwenden, erstellen Sie einen Alias-Eintrag in Route 53, der auf Ihre CDN-Distribution verweist (z. B.
d111111abcdef8.cloudfront.net). Die Verwendung eines Standard-CNAME anstelle eines Alias-Eintrags kann HTTP-400-Fehler zurückgeben. - Header-Weiterleitung deaktiviert: Wenn die SSL-Aktivierung nach der Konfiguration von
X-Forwarded-Hostweiterhin fehlschlägt, versuchen Sie, die Header-Weiterleitung auf Ihrem CDN oder Proxy zu deaktivieren. Einige Setups lösen das Problem, wenn die Weiterleitung vollständig deaktiviert wird. Arbeiten Sie mit Ihrem IT-Team oder CDN-Anbieter zusammen, um diese Konfiguration zu testen.
Probleme beim Klick-Tracking
Häufige Weiterleitungsprobleme resultieren typischerweise aus einer fehlerhaften Konfiguration zwischen dem CDN, das die Tracking-Domain hostet, und den zugehörigen SSL-Zertifikaten oder DNS-CNAME-Einträgen. Diese Fehlkonfigurationen führen häufig dazu, dass Nutzer:innen einen Datenschutzfehler „Verbindung ist nicht sicher“ oder einen 404-Fehler erhalten, nachdem sie auf einen getrackten E-Mail-Link geklickt haben.
Verwenden Sie das folgende Template, um die CDN-Konfiguration Ihrer Tracking-Domain zu testen – den Mechanismus, der Analytics für Links in Ihren E-Mails unterstützt.
- Kopieren Sie das folgende Template und fügen Sie es in eine Braze-HTML-E-Mail-Campaign ein.
Template zur Fehlerbehebung beim Klick-Tracking
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="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>
- Konfigurieren Sie Ihre URL. Ersetzen Sie die URL im
capture-Tag am Anfang des Template-Bodys (wohttps://example.comgesetzt ist). Ersetzen Sie beispielsweisehttps://example.comdurchhttps://braze.com/docs. - Senden Sie eine Test-E-Mail an sich selbst und klicken Sie auf beide Buttons.
- Überprüfen Sie, ob das erwartete Verhalten und die Erfolgskriterien den Beschreibungen im Template entsprechen.
Wenn Ihre ungetrackte URL funktioniert, aber Ihre getrackte URL fehlschlägt, liegt möglicherweise eine Konfigurationslücke vor. Zur Fehlerbehebung lesen Sie die Dokumentation Ihres jeweiligen ESP- und CDN-Anbieters. Sie können auch SSL bei Braze für detaillierte Anforderungen zur Zertifikatsbereitstellung lesen.
Verwenden Sie die folgende Tabelle, um häufige Fehler beim Testen des Klick-Trackings zu diagnostizieren.
| Fehlercode | Fehlerbehebung |
|---|---|
"Your connection is not private" (NET::ERR_CERT_COMMON_NAME_INVALID) |
Überprüfen Sie, ob Ihre Tracking-Domain ein gültiges SSL-Zertifikat hat. |
"This site can't be reached" (DNS_PROBE_FINISHED_NXDOMAIN) |
Überprüfen Sie Ihre DNS-Einstellungen. Stellen Sie sicher, dass Ihre Tracking-Subdomain gemäß der empfohlenen Konfiguration Ihres CDN und ESP konfiguriert ist. |
525 / 526 SSL Error |
Überprüfen Sie, ob die SSL-Einstellung in Ihrem CDN (z. B. Cloudflare) mit den Fähigkeiten Ihres Origins übereinstimmt. |
404 Not Found |
Überprüfen Sie, ob Ihr CDN so konfiguriert ist, dass der gesamte URL-Pfad an den ESP weitergeleitet wird, anstatt auf ein leeres Stammverzeichnis zu verweisen. |