콘텐츠로 이동
spacepost문서

열람 및 클릭 추적

추적은 도메인별로 설정하며 기본값은 꺼짐입니다.

설정 동작 웹훅 이벤트
open_tracking HTML 본문에 1x1 추적 픽셀을 삽입합니다. email.opened
click_tracking HTML 본문의 링크를 다시 작성해 리디렉션하기 전에 클릭을 기록합니다. email.clicked
tracking.ts
import { SpacePost } from "@spacepost/node";


const spacepost = new SpacePost(process.env.SPACEPOST_API_KEY);


const { error } = await spacepost.domains.update({
  id: "0192e1c4-0000-7000-8000-000000000001",
  openTracking: true,
  clickTracking: true,
});
if (error) console.error(error);

변경 사항은 이후에 발송하는 이메일부터 적용됩니다. 두 필드 모두 선택 사항이므로 바꾸려는 필드만 보내면 됩니다.

고려 사항

섹션 제목: “고려 사항”
  • 열람은 근사치입니다. Apple Mail 개인정보 보호 기능과 일부 보안 스캐너는 이미지를 자동으로 불러와 열람 수가 부풀려집니다. Gmail은 이미지를 캐시합니다. 열람은 대략적인 신호로만 보고, 사람이 이메일을 읽었다는 증거로 삼지 마세요.
  • 클릭은 더 신뢰할 수 있지만 보안 스캐너가 링크를 미리 클릭할 수도 있습니다.
  • 개인정보. 추적은 이벤트 페이로드에 IP 주소와 사용자 에이전트를 기록합니다. 개인정보 처리방침에 이를 명시하고, 비밀번호 재설정이나 영수증처럼 민감한 트랜잭션 메일에는 열람 추적을 끄는 것을 고려하세요.
  • 일반 텍스트 부분은 추적되지 않습니다. 추적은 HTML에만 영향을 줍니다.
  • 전달률. 링크를 다시 쓰면 수신자에게 보이는 URL이 바뀝니다. 일부 스팸 필터는 트랜잭션 메일에서 이를 좋아하지 않습니다. 전달률이 떨어지면 해당 도메인의 클릭 추적을 끄고 마케팅 메일에는 별도의 서브도메인을 사용하세요.

email.opened나 email.clicked 이벤트는 이메일의 last_event를 설정하지만, bounced처럼 더 심각한 상태에서 뒤로 되돌리지는 않습니다.