トラブルシューティング
これらのヒントを使用して、SSLクリックトラッキングに関する一般的な問題を特定してください。トラブルシューティングのガイダンスは一般的なものです。CDNはそれぞれ固有であるためです。CDNの設定、証明書、またはプロキシの問題については、CDNのサポートチームにお問い合わせください。これらの設定はBrazeエコシステムの外部で行われます。
主要な概念
- トラッキングURL： 元のHTTPSリンクをトラッキングドメインでラップします。ユーザーがクリックすると、トラッキングドメインがリクエストを解決し、最終的な送信先にリダイレクトします。CDNを使用すると、セキュアな（HTTPS）URLをトラッキングできます。CDNがない場合、ユーザーに「接続が安全ではありません」というプライバシーエラーが表示される可能性があります。
- 非トラッキングURL： 元のURLをそのまま維持し、CDNをバイパスしてコントロール環境として機能します。
メール開封率が低い
メール開封率が突然低下した場合は、SSL証明書が最新であることを確認してください。有効期限が切れている場合は、CDNまたは証明書プロバイダーでSSL証明書を更新する必要があります。
リダイレクトリンクでHTTP 403が発生する
トラッキングされたリダイレクトリンクが403 Forbiddenを返す場合、障害はコンテンツデリバリーネットワーク（CDN）またはWebアプリケーションファイアウォール（WAF）で発生していることが多いです。たとえば、AWS WAFやAmazon CloudFrontのルールが特定のユーザーエージェント、クエリ文字列、またはリダイレクトパターンをブロックしている場合があります。CDNまたはクラウドプロバイダーでブロックされたリクエストのログと指標を確認してください。AWSについては、CloudFrontの問題のトラブルシューティングを参照してください。
問題がクリックトラッキングに固有のものかどうかを確認するには、1つのテストリンクでクリックトラッキングをオフにしてください（リンクごとにクリックトラッキングをオフにするを参照）。クリックトラッキングがオフの場合に送信先URLが読み込まれ、トラッキングがオンの場合に403が返される場合は、クリックトラッキングドメイン、CDN、およびWAFの設定に焦点を当ててください。
ドメインレジストリの問題
digコマンドを実行して、リンクトラッキングがCDNを指していることを確認してください。ターミナルでdig CNAME link_tracking_subdomainを実行します。ANSWER SECTIONに、CNAMEの指す先が表示されます。CDNではなくメールサービスプロバイダー（SendGrid、SparkPost、またはAmazon SES）を指している場合は、ドメインレジストリをCDNを指すように再設定してください。
CDNの問題
セットアップ中にライブメールリンクが壊れた場合、適切な設定が完了する前にDNSをCDNに向けた可能性があります。これは「間違ったリンク」エラーとして表示されることがあります。CDNプロバイダーに連絡し、ドキュメントを確認して設定のトラブルシューティングを行ってください。
接続がプライベートではないというエラーメッセージが表示された場合、SSLまたはCDNが正しく設定されていない可能性があります。ターミナルでdigコマンドを実行してください（例：dig CNAME your_link_tracking_subdomain）。ANSWER SECTIONで、結果がCDNではなくESPを指している場合、設定ミスの問題です。BrazeのSSLクリックトラッキングが機能するには、CNAMEがCDNを指している必要があります。SSLとCDNの設定を管理するチームと連携して、さらなるサポートを受けてください。
SSLの有効化ステータス
SSLのセットアップを完了してもリンクがHTTPのまま表示される場合は、Brazeカスタマーサクセスマネージャーに連絡して、BrazeがSSLを有効にしたことを確認してください。Brazeは、すべてのセットアップステップが完了した後にのみSSLを有効にします。
Amazon SES
メールサービスプロバイダーとしてAmazon SESを使用している場合、以下の設定の問題がBrazeのSSL有効化を妨げたり、セットアップ中にエラーを引き起こしたりする可能性があります。
- リージョンの不一致： CDNのオリジンがBrazeクラスターのAWSトラッキングドメインを指していることを確認してください。USクラスターは
r.us-east-1.awstrack.meを使用します。EUクラスターはr.eu-central-1.awstrack.meを使用します。間違ったリージョンを使用すると、SSLの有効化がブロックされる可能性があります。 - ホストヘッダー： Amazon SESでは、CDNが正しいホストヘッダーを転送する必要があります。クリックトラッキングドメインで
X-Forwarded-Hostヘッダーを有効にしてください。詳細については、Amazon SESセクションを参照してください。 - プロキシ設定： ホストヘッダーを上書きまたは競合するプロキシまたはCDNの設定は、SSLの有効化を失敗させる可能性があります。CDNプロバイダーとプロキシ設定を確認し、ホストヘッダーの転送を妨げていないことを確認してください。
- Route 53エイリアスレコード： Route 53を使用してドメインのDNSを管理している場合は、CDNディストリビューション（例：
d111111abcdef8.cloudfront.net）を指すRoute 53のエイリアスレコードを作成してください。エイリアスレコードの代わりに標準のCNAMEを使用すると、HTTP 400エラーが返される可能性があります。 - ヘッダー転送の無効化：
X-Forwarded-Hostを設定した後もSSLの有効化が失敗する場合は、CDNまたはプロキシでヘッダー転送を無効にしてみてください。一部のセットアップでは、転送を完全にオフにすることで問題が解決します。ITチームまたはCDNプロバイダーと協力して、この設定をテストしてください。
クリックトラッキングの問題
一般的なリダイレクトの問題は、トラッキングドメインをホストするCDNと、関連するSSL証明書またはDNS CNAMEレコードとの間の不適切な設定に起因することが多いです。これらの設定ミスにより、ユーザーがトラッキングされたメールリンクをクリックした後に「接続が安全ではありません」というプライバシーエラーや404エラーが発生することがよくあります。
以下のテンプレートを使用して、トラッキングドメインのCDN設定をテストしてください。これは、メール内のリンクの分析をサポートするメカニズムです。
- 以下のテンプレートをコピーして、BrazeのHTMLメールCampaignに貼り付けてください。
クリックトラッキングのトラブルシューティングテンプレート
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>
- URLを設定します。テンプレート本文の上部付近にある
captureタグ内のURL（https://example.comが設定されている箇所）を置き換えてください。たとえば、https://example.comをhttps://braze.com/docsに置き換えます。 - 自分宛にテストメールを送信し、両方のボタンを選択してください。
- 期待される動作と成功基準がテンプレートに記載されている通りであることを確認してください。
非トラッキングURLは機能するがトラッキングURLが失敗する場合、設定にギャップがある可能性があります。トラブルシューティングするには、お使いのESPとCDNプロバイダーのドキュメントを参照してください。証明書のプロビジョニングに関する詳細な要件については、BrazeのSSLも確認できます。
以下の表を使用して、クリックトラッキングのテスト時に発生する一般的なエラーを診断してください。
| エラーコード | トラブルシューティング |
|---|---|
"Your connection is not private" (NET::ERR_CERT_COMMON_NAME_INVALID) |
トラッキングドメインに有効なSSL証明書があることを確認してください。 |
"This site can't be reached" (DNS_PROBE_FINISHED_NXDOMAIN) |
DNS設定を確認してください。トラッキングサブドメインがCDNとESPの推奨設定に従って構成されていることを確認してください。 |
525 / 526 SSL Error |
CDN（Cloudflareなど）のSSL設定がOriginの機能と一致していることを確認してください。 |
404 Not Found |
CDNが空のルートディレクトリを指すのではなく、URLパス全体をESPに転送するように設定されていることを確認してください。 |