Skip to content

API 이메일 환경설정 센터

환경설정 센터를 설정하면 사용자가 이메일 메시징에 대한 알림 환경설정을 한 곳에서 편집하고 관리할 수 있습니다. 이 문서에서는 API로 생성하는 환경설정 센터를 구축하는 단계를 설명하지만, 드래그 앤 드롭 에디터를 사용하여 환경설정 센터를 구축할 수도 있습니다.

Braze 대시보드에서 오디언스 > 이메일 환경설정 센터로 이동합니다.

여기에서 각 구독 그룹을 관리하고 확인할 수 있습니다. 생성한 각 구독 그룹은 이 환경설정 센터 목록에 추가됩니다. 여러 개의 환경설정 센터를 생성할 수 있습니다.

API로 환경설정 센터 생성하기

환경설정 센터 Braze 엔드포인트를 사용하면 Braze에서 호스팅하는 웹사이트인 환경설정 센터를 생성하여 사용자의 구독 상태와 구독 그룹 상태를 표시할 수 있습니다. HTML과 CSS를 사용하여 개발자 팀이 환경설정 센터를 구축하면 페이지 스타일이 브랜드 가이드라인에 맞게 됩니다.

Liquid를 사용하면 구독 그룹의 이름과 각 사용자의 상태를 가져올 수 있습니다. 이렇게 하면 페이지가 로드될 때 Braze가 이 데이터를 저장하고 검색합니다.

필수 조건

1단계: 환경설정 센터 생성 엔드포인트 사용하기

환경설정 센터 생성 엔드포인트를 사용하여 환경설정 센터를 구축해 보겠습니다. 환경설정 센터를 커스터마이즈하려면 preference_center_page_html 필드와 confirmation_page_html 필드에 브랜딩에 맞는 HTML을 포함할 수 있습니다.

환경설정 센터 URL 생성 엔드포인트를 사용하면 Braze를 통해 발송된 이메일 외부에서 특정 사용자의 환경설정 센터 URL을 가져올 수 있습니다.

2단계: 이메일 Campaign에 포함하기

이메일에 환경설정 센터 링크를 배치하려면 탈퇴 URL을 삽입하는 방식과 유사하게 이메일의 원하는 위치에 다음 Liquid 태그를 사용합니다.

1

{{preference_center.${kitchenerie_preference_center_example}}}

Liquid를 포함하는 HTML 조합을 사용할 수도 있습니다. 예를 들어, HTML 에디터 또는 드래그 앤 드롭 에디터에서 다음을 URL로 붙여넣을 수 있습니다. 이렇게 하면 모든 이메일 구독 그룹을 자동으로 나열하는 기본 환경설정 센터 레이아웃이 표시됩니다. 링크 별칭 지정을 사용하는 경우, Braze가 추적 파라미터를 추가할 수 있도록 Liquid 태그 뒤에 물음표(?)를 추가하세요.

1

<a href="{{preference_center.${kitchenerie_preference_center_example}}}?">Edit your preferences</a>

환경설정 센터에는 사용자가 모든 이메일을 탈퇴할 수 있는 체크박스가 있습니다. 테스트 메시지로 발송된 경우에는 이러한 환경설정을 저장할 수 없습니다.

환경설정 센터 편집하기

환경설정 센터 업데이트 엔드포인트를 사용하여 환경설정 센터를 편집하고 업데이트할 수 있습니다.

환경설정 센터 및 세부 정보 확인하기

환경설정 센터를 확인하려면 환경설정 센터 세부 정보 보기 엔드포인트를 사용하여 마지막 업데이트 타임스탬프, 환경설정 센터 ID 등 관련 정보를 반환합니다.

환경설정 센터 커스터마이즈하기

Braze는 환경설정 센터에서 구독 상태 업데이트를 관리하여 환경설정 센터를 동기화 상태로 유지합니다. 그러나 다음 옵션과 함께 구독 그룹 API를 사용하여 자체 환경설정 센터를 생성하고 호스팅할 수도 있습니다.

URL 본문에 쿼리 문자열 필드-값 쌍을 사용하여 사용자 ID와 이메일 카테고리를 페이지에 전달하면 사용자가 탈퇴 선택을 확인하기만 하면 됩니다. 이 옵션은 사용자 식별자를 해시 형식으로 저장하고 아직 구독 센터가 없는 경우에 적합합니다.

이 옵션의 경우 각 이메일 카테고리에 고유한 탈퇴 링크가 필요합니다:
http://mycompany.com/query-string-form-fill?field_id=John&field_category=offers

옵션 2: JSON 웹 토큰으로 인증하기

JSON 웹 토큰을 사용하여 일반적으로 사용자 이름과 비밀번호 로그인과 같은 인증 계층 뒤에 있는 웹 서버의 일부(예: 계정 환경설정)에 사용자를 인증합니다.

이 접근 방식은 URL에 쿼리 문자열 값 쌍을 삽입할 필요가 없으며, 이러한 값은 JSON 웹 토큰의 페이로드에 전달할 수 있습니다. 예를 들어:

1
2
3
4
5

{
    "user_id": "1234567890",
    "name": "John Doe",
    "category": "offers"
}

자주 묻는 질문

환경설정 센터를 생성하지 않았는데 대시보드에 “PreferenceCenterBrazeDefault”가 표시되는 이유는 무엇인가요?

이는 레거시 Liquid ${preference_center_url}이 사용될 때 환경설정 센터를 렌더링하는 데 사용됩니다. 즉, ${preference_center_url} 또는 preference_center.${PreferenceCenterBrazeDefault}를 참조하는 캔버스 단계나 템플릿은 작동하지 않습니다. 이는 레거시 Liquid 또는 “PreferenceCenterBrazeDefault”를 메시지의 일부로 포함한 이전에 발송된 메시지에도 적용됩니다.

새 메시지에서 ${preference_center_url}을 다시 참조하면 “PreferenceCenterBrazeDefault”라는 이름의 환경설정 센터가 다시 생성됩니다.

환경설정 센터는 여러 언어를 지원하나요?

아니요. 그러나 커스텀 옵트인 및 옵트아웃 페이지의 HTML을 작성할 때 Liquid를 활용할 수 있습니다. 동적 링크를 사용하여 탈퇴를 관리하는 경우 이는 단일 링크입니다.

예를 들어, 스페인어 사용자의 탈퇴율을 추적하는 경우 별도의 Campaign을 사용하거나 Currents 관련 분석(예: 사용자가 탈퇴하는 시점을 확인하고 해당 사용자의 선호 언어를 확인하는 것)을 활용해야 합니다.

또 다른 예로, 스페인어 사용자의 탈퇴율을 추적하려면 사용자의 언어가 스페인어인 경우 탈퇴 URL에 ?Spanish=true와 같은 쿼리 파라미터 문자열을 추가하고, 그렇지 않은 경우 일반 탈퇴 링크를 사용할 수 있습니다:

1
2
3
4

{% if ${language} == 'spanish' %} "${unsubscribe_url}?spanish=true"
{% else %}
${unsubscribe_url}
{% endif %}

그런 다음 Currents를 통해 스페인어를 사용하는 사용자를 식별하고 해당 탈퇴 링크에 대한 클릭 이벤트가 몇 건인지 확인할 수 있습니다.

아니요. 이메일 Campaign을 작성할 때 “이메일 본문에 탈퇴 링크가 포함되어 있지 않습니다”라는 메시지가 표시되는 경우, 탈퇴 링크가 콘텐츠 블록에 있으면 이 경고는 예상되는 동작입니다.

기본 브라우저 아이콘을 어떻게 업데이트하나요?

기본적으로 브라우저 탭 이름 옆의 아이콘(파비콘)은 Braze 로고를 사용합니다. 커스텀 파비콘을 추가하려면 생성 또는 업데이트 환경설정 센터 API 호출의 links-tags 속성을 통해 설정합니다. 그러면 Braze가 호스팅된 페이지에 <link rel="icon" ...> 태그를 삽입합니다.

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

{
  "name": "MyPreferenceCenter",
  "preference_center_title": "Email Preferences",
  "preference_center_page_html": "<!doctype html> ...",
  "confirmation_page_html": "<!doctype html> ...",
  "state": "active",
  "options": {
    "links-tags": [
      {
        "rel": "icon",
        "type": "image/png",
        "sizes": "32x32",
        "href": "https://yourcdn.com/path/to/favicon-32x32.png"
      },
      {
        "rel": "shortcut icon",
        "type": "image/x-icon",
        "href": "https://yourcdn.com/path/to/favicon.ico"
      },
      {
        "rel": "apple-touch-icon",
        "sizes": "180x180",
        "href": "https://yourcdn.com/path/to/apple-touch-icon.png"
      }
    ]
  }
}
New Stuff!