사용자 지정 이메일 수신 거부 페이지 만들기

개요

OneSignal은 사용자가 쉽게 구독을 취소하고 구독 상태가 실시간으로 업데이트되도록 이메일 템플릿에 링크를 삽입하는 기본 이메일 규정 준수 수신 거부 경험을 제공합니다. 브랜딩, 카피 및 필드(예: 카테고리 옵트아웃)를 완전히 제어하려는 경우 기본 링크를 자체 사용자 지정 페이지로 교체하고 OneSignal API를 사용하여 사용자 기본 설정을 구독 취소하거나 업데이트할 수 있습니다. 이 가이드는 이메일에 자체 사용자 지정 수신 거부 페이지를 추가하는 방법(기본 OneSignal 링크 제거)과 사용자의 이메일 구독을 취소하는 데 사용할 API를 설명합니다. 사용자 지정 수신 거부 페이지에 더 많은 기능(모든 이메일 대신 특정 이메일 카테고리에서 옵트아웃하는 것과 같은)을 추가하려면 기본 설정 센터 튜토리얼에 자세히 설명되어 있습니다.

OneSignal의 기본 수신 거부 링크 제거

OneSignal은 이메일 템플릿에 [unsubscribe_url] 형식의 특수 링크를 자동으로 삽입합니다. 이 URL은 OneSignal의 모든 이메일에서 사용자를 구독 취소합니다. 자세한 내용은 이메일 수신 거부 링크를 참조하세요. 자체 페이지를 사용하려면 템플릿에서 기본 링크를 찾아 제거하세요.

드래그 앤 드롭 편집기
HTML 편집기

드래그 앤 드롭 편집기에서 기본 링크는 다음과 같이 중첩되어 나타날 수 있습니다:

<a href="[unsubscribe_url]">Unsubscribe</a>

사용자 지정 수신 거부 링크 추가

이제 특수 링크를 제거했으므로 자체 URL로 교체할 수 있습니다. 많은 경우 이러한 링크는 페이지에 전달해야 할 추가 데이터가 필요합니다. Liquid 변수를 사용하여 OneSignal 데이터를 페이지에 전달하세요. 일반 매개변수:

매개변수	설명
`subscription.email`	구독자의 이메일 주소
`subscription.external_id`	사용자의 외부 ID
`app.id`	OneSignal 앱 ID
`message.id`	이메일 알림의 ID
`subscription.language`	선호 언어(현지화용)
`subscription.unsubscribe_token`	API 확인을 위한 보안 토큰

예제 URL:

https://examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}

HTML

  <div style="text-align: center;">
    <a
      href="https://examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}"
      data-disable-tracking="true"
      style="display: inline; text-decoration: none;"
    >
      Unsubscribe
    </a>
    <p style="display: inline;"> from our emails</p>
  </div>

클릭 추적 비활성화

수신 거부 클릭은 일반적으로 참여 메트릭에 사용되지 않습니다. 링크 추적을 비활성화하려면 다음과 같이 링크에 data-disable-tracking="true" 속성을 추가할 수 있습니다:

HTML

  <a
    href="https://www.examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}"
    data-disable-tracking="true"
  >
    Unsubscribe
  </a>

공급자별 속성:

공급자	속성
OneSignal	`data-disable-tracking="true"`
Mailgun	`disable-tracking=true`
SendGrid	`clicktracking=off`
Mandrill	`mc:disable-tracking`

사용자 지정 수신 거부 페이지 호스팅

다음을 수행하는 웹 페이지를 배포하세요:

수신 거부 링크에서 쿼리 매개변수를 읽습니다.
사용자 친화적인 옵트아웃 또는 기본 설정 옵션을 표시합니다.
API를 통해 OneSignal에 수신 거부 또는 업데이트 요청을 보냅니다.

포크하고 배포할 수 있는 작동하는 GitHub 샘플 프로젝트를 제공합니다.

OneSignal API 호출

사용 사례에 따라 다음 API를 사용하여 사용자 기본 설정을 구독 취소하거나 업데이트할 수 있습니다:

토큰으로 구독 업데이트
토큰으로 이메일 수신 거부
사용자 업데이트

이 API는 사용자의 이메일 주소가 있고 모든 이메일에서 구독하거나 구독을 취소하려는 경우에 가장 일반적으로 사용됩니다.필수 쿼리 매개변수:

app_id
token

인증 필요

서버에서 이 API를 호출하세요.

특정 이메일이 수신 거부를 유발했는지 추적하려는 경우 이 API를 사용하세요. 이메일 메시지 ID를 사용하여 수신 거부를 추적합니다. 자세한 내용은 Unsubscribe Email with Token API를 참조하세요.필수 쿼리 매개변수:

app_id
notification_id
token

선택적 매개변수:

email
language

JavaScript 예제:

JavaScript

const unsubscribeURL = (href) => {
  const unsubscribeURL = new URL(href)
  const appID = unsubscribeURL.searchParams.get("app_id")
  const notificationID = unsubscribeURL.searchParams.get("notification_id")
  const unsubscribeToken = unsubscribeURL.searchParams.get("token")
  const language = unsubscribeURL.searchParams.get("language")
  const email = unsubscribeURL.searchParams.get("email")
  return {
    unsubscribeURL: `https://api.onesignal.com/apps/${appID}/notifications/${notificationID}/unsubscribe?token=${unsubscribeToken}`,
    meta: { language, email },
  }
}

Update User API를 사용하여 사용자의 기본 설정을 업데이트하세요.필수 쿼리 매개변수:

app_id
alias_id - 사용자의 외부 ID를 권장합니다.

인증 필요

서버에서 이 API를 호출하세요.

이제 사용자 지정 수신 거부 페이지 만들기에 대해 알아야 할 모든 것을 갖추었습니다.

시작하기 & 설정

메시지 채널

Journeys

오디언스 & 사용자 지정 이벤트

분석 & 통합

개인 정보 보호 & 보안

사용자 지정 이메일 수신 거부 페이지 만들기

개요

OneSignal의 기본 수신 거부 링크 제거

사용자 지정 수신 거부 링크 추가

클릭 추적 비활성화

사용자 지정 수신 거부 페이지 호스팅

OneSignal API 호출

​개요

​OneSignal의 기본 수신 거부 링크 제거

​사용자 지정 수신 거부 링크 추가

​클릭 추적 비활성화

​사용자 지정 수신 거부 페이지 호스팅

​OneSignal API 호출

개요

OneSignal의 기본 수신 거부 링크 제거

사용자 지정 수신 거부 링크 추가

클릭 추적 비활성화

사용자 지정 수신 거부 페이지 호스팅

OneSignal API 호출