SendGrid 링크 브랜딩 설정 가이드 - Rankly

개요

링크 브랜딩(Link Branding)을 설정하면 이메일 내 모든 추적 링크가 click.rankly.kr로 표시됩니다.

효과: - ✅ 이메일 신뢰도 향상 - ✅ 스팸 점수 감소 - ✅ 클릭률 추적 개선 - ✅ 브랜드 일관성 유지

Before: https://u12345.ct.sendgrid.net/ls/click?...
After: https://click.rankly.kr/ls/click?...

1️⃣ SendGrid에서 링크 브랜딩 시작

Step 1: SendGrid 콘솔 접속

https://app.sendgrid.com 로그인
좌측 메뉴 → Settings → Sender Authentication

Step 2: Link Branding 시작

Brand Your Links 섹션 찾기
Get Started 또는 Brand a new link 클릭

Step 3: 설정 입력

What domain would you like branded links to originate from?
입력: click.rankly.kr
DNS Host 선택
Other Host 선택 (가비아)
Next 클릭

Step 4: DNS 레코드 확인

SendGrid가 제공하는 CNAME 레코드를 메모하세요:

예시 (실제 값은 SendGrid에서 확인):

Host                        Type    Value
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
click.rankly.kr             CNAME   u12345.wl123.sendgrid.net

⚠️ 주의: 위 값은 예시입니다. SendGrid에서 제공하는 실제 값을 사용하세요!

2️⃣ 가비아 DNS 레코드 추가

Step 1: 가비아 DNS 관리

https://www.gabia.com 로그인
My가비아 → 서비스 관리 → 도메인
rankly.kr 클릭
관리도구 → DNS 정보

Step 2: CNAME 레코드 추가

타입: CNAME
호스트: click
값/위치: u12345.wl123.sendgrid.net  (SendGrid에서 제공한 값)
TTL: 3600

주의: - 호스트명에서 .rankly.kr 부분은 제외하고 click만 입력 - 값은 SendGrid에서 제공한 정확한 주소 사용

Step 3: 저장 및 전파 대기

저장 후 DNS 전파 대기 (10분~1시간)

3️⃣ DNS 전파 확인

Windows CMD에서 확인

nslookup -type=CNAME click.rankly.kr

성공 예시:

click.rankly.kr
canonical name = u12345.wl123.sendgrid.net

온라인 도구

https://mxtoolbox.com/SuperTool.aspx
검색: click.rankly.kr → CNAME 조회

4️⃣ SendGrid에서 링크 브랜딩 인증

Step 1: 인증 시작

SendGrid 콘솔 → Sender Authentication
Link Branding 섹션에서 대기 중인 항목 찾기
Verify 버튼 클릭

Step 2: 인증 결과 확인

✅ Verified: 인증 완료!
❌ Not Verified: DNS 전파 대기 또는 레코드 재확인

5️⃣ 링크 브랜딩 활성화

SendGrid 설정 확인

Settings → Tracking
Click Tracking 섹션
Enable Click Tracking ON 확인

이메일 코드 수정 불필요

SendGrid가 자동으로 모든 링크를 click.rankly.kr로 변환
코드 수정 없이 바로 적용

6️⃣ 테스트

테스트 이메일 발송

cd C:\Users\82108\Documents\GitHub\RankLog\mysite
python test_sendgrid_auto.py

이메일에서 링크 확인

받은 이메일 열기
"Rankly 바로가기" 버튼에 마우스 오버
링크 주소 확인:
Before: https://rankly.kr
After (링크 브랜딩 적용 시): https://click.rankly.kr/ls/click?...

7️⃣ 현재 발송 설정 확인

환경변수 (.live1.env)

DEFAULT_FROM_EMAIL=admin@rankly.kr  ✅
REPLY_TO_EMAIL=admin@rankly.kr  ✅
EMAIL_FROM_NAME=Rankly  ✅

Render 환경변수

- key: DEFAULT_FROM_EMAIL
  value: admin@rankly.kr  ✅
- key: REPLY_TO_EMAIL
  value: admin@rankly.kr  ✅
- key: EMAIL_FROM_NAME
  value: Rankly  ✅

이메일 헤더 (실제 발송)

From: Rankly <admin@rankly.kr>  ✅
Reply-To: admin@rankly.kr  ✅
Return-Path: admin@rankly.kr  ✅ (SendGrid 자동)

이메일 본문 링크

<a href="https://rankly.kr">Rankly 바로가기</a>  ✅
<a href="mailto:admin@rankly.kr">파트너 센터</a>  ✅

8️⃣ 링크 브랜딩의 장점

1. 도메인 신뢰도

모든 요소가 rankly.kr 도메인
수신자가 신뢰할 수 있는 일관된 도메인

2. 스팸 필터 회피

외부 도메인 링크 감소
이메일 점수 향상

3. 클릭 추적

SendGrid Activity Feed에서 클릭 통계 확인
사용자 행동 분석 가능

4. 브랜드 일관성

발신: admin@rankly.kr
답장: admin@rankly.kr
링크: click.rankly.kr (추적)
랜딩: rankly.kr

9️⃣ 트러블슈팅

"DNS record not found"

원인: DNS 전파 미완료
해결:
  1. 10분~1시간 대기
  2. nslookup으로 확인
  3. DNS 캐시 클리어: ipconfig /flushdns

"Link branding failed"

원인: CNAME 레코드 값이 잘못됨
해결:
  1. 가비아 DNS에서 CNAME 값 재확인
  2. SendGrid 제공 값과 정확히 일치하는지 확인
  3. 끝에 점(.) 제거 확인

이메일 링크가 여전히 sendgrid.net

원인: Click Tracking이 비활성화됨
해결:
  1. SendGrid → Settings → Tracking
  2. Click Tracking ON 확인
  3. 링크 브랜딩 Verified 확인

🔟 현재 상태 체크리스트

[x] SendGrid Single Sender 인증 (admin@rankly.kr)
[x] From 도메인: admin@rankly.kr ✅
[x] Reply-To: admin@rankly.kr ✅
[x] 이메일 HTML 템플릿: Rankly 브랜딩 ✅
[x] 링크 주소: https://rankly.kr ✅
[ ] 링크 브랜딩: click.rankly.kr (설정 필요)

1️⃣1️⃣ 선택사항: 도메인 인증

Single Sender (현재): - ✅ admin@rankly.kr만 발송 가능 - ✅ 즉시 사용 가능 - ❌ noreply@rankly.kr 사용 불가

도메인 인증 (향후): - ✅ 모든 @rankly.kr 주소 사용 가능 - ✅ noreply@rankly.kr, support@rankly.kr 등 - ⏱️ DNS 설정 필요 (CNAME 3개 + SPF)

도메인 인증 가이드: SENDGRID_SETUP_RANKLY.md 참고

📊 완료 후 테스트

1. 이메일 발송

curl -X POST "https://rankly.kr/api/v1/accounts/otp/send" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

2. 이메일 확인

From: Rankly <admin@rankly.kr> ✅
Reply-To: admin@rankly.kr ✅
링크: 마우스 오버 시 click.rankly.kr 확인

3. SendGrid Activity Feed

https://app.sendgrid.com → Activity
Click 이벤트 확인

💡 참고

링크 브랜딩 vs 도메인 인증

항목	링크 브랜딩	도메인 인증
목적	클릭 링크 도메인 변경	발신 도메인 인증
DNS	CNAME 1개	CNAME 3개 + SPF
효과	click.rankly.kr	noreply@rankly.kr 사용 가능
필수	선택사항	프로덕션 권장

둘 다 설정하는 것이 최상의 구성입니다!

작성: 2025-12-17
프로젝트: Rankly
도메인: rankly.kr
이메일: admin@rankly.kr