LINE 설정

이 문서에서는 사용자 설정, 사용자 ID 조정, Braze에서 LINE 테스트 사용자 생성 등 Braze에서 LINE 채널을 설정하는 방법에 대해 설명합니다.

필수 조건

LINE과 Braze를 연동하려면 다음이 필요합니다:

• LINE 비즈니스 계정
• 프리미엄 또는 인증된 계정 상태 (기존 팔로워 동기화에 필요)
  • LINE의 계정 가이드라인 보기
• LINE 개발자 계정
• LINE 메시징 API 채널

Braze에서 LINE 메시지를 발송하면 계정의 메시지 크레딧이 차감됩니다.

LINE 계정 유형

필수 계정 유형

팔로워를 Braze에 동기화하려면 LINE 계정을 인증하거나 프리미엄 계정을 사용해야 합니다. 계정을 만들면 기본 상태는 확인되지 않습니다. 계정 인증을 요청해야 합니다.

인증된 LINE 계정 신청하기

1. LINE 공식 계정 페이지에서 설정을 선택합니다.
2. 정보 공개 확인 상태 아래에서 계정 확인 요청을 선택합니다.
3. 필수 정보를 입력합니다.
4. 검토 결과가 담긴 알림을 기다립니다.

LINE 통합

일관된 사용자 업데이트를 설정하고, 기존 사용자의 LINE ID를 가져와 LINE의 구독 상태에 모두 동기화하려면:

1. 기존 알려진 사용자를 가져오거나 업데이트
2. LINE 채널을 통합하세요
3. 사용자 ID 조정
4. 사용자 업데이트 방법 변경
5. 사용자 프로필 병합(선택 사항)

1단계: 기존 LINE 사용자 가져오기 또는 업데이트

기존에 식별된 LINE 사용자가 있는 경우 이 단계가 필요합니다. Braze가 이후 자동으로 해당 사용자의 구독 상태를 불러와 올바른 고객 프로필을 업데이트하기 때문입니다. 사용자를 LINE ID와 이전에 연결하지 않았다면 이 단계를 건너뛰세요.

You can import or update users using any of the methods that Braze supports, including the /users/track endpoint, CSV import, or Cloud Data Ingestion.

사용하는 방법에 관계없이, 사용자의 LINE ID를 제공하도록native_line_id 를 업데이트하십시오. 자세한 내용은 사용자 설정을native_line_id 참조하십시오.

2단계: LINE 채널 통합

통합 프로세스가 완료되면 Braze는 해당 채널의 LINE 팔로워를 자동으로 Braze로 불러옵니다. Braze 고객 프로필에 이미 연결된 LINE ID의 경우, 각 프로필은 “가입자” 상태로 업데이트되며, 남아 있는 LINE ID는 익명 사용자로 생성됩니다. 또한, LINE 채널을 새로 팔로우하는 사용자에게는 채널을 팔로우할 때 미확인 고객 프로필이 생성됩니다.

2.1 단계: 웹훅 설정 편집

1. LINE에서 메시징 API 탭으로 이동하여 웹훅 설정을 편집합니다:
   • 웹훅 URL을 https://anna.braze.com/line/events 으로 설정합니다.
     • Braze는 통합 시 대시보드 클러스터에 따라 자동으로 이 URL을 다른 URL로 변경합니다.
   • 웹훅 사용 및 웹훅 재전송을 켭니다.
     
     
2. 제공업체 탭에서 다음 정보를 참고하세요:

3. 설정 페이지 > 응답 설정으로 이동하여 다음을 수행합니다:

• 인사말 메시지를 끕니다. 이는 팔로우 시 트리거를 통해 Braze에서 처리할 수 있습니다.
• 자동 응답 메시지를 끕니다. 트리거된 모든 메시징은 Braze를 통해 이루어져야 합니다. 그렇다고 해서 LINE 콘솔에서 직접 전송하는 것을 막지는 않습니다.
• 웹훅을 켭니다.

2.2 단계: Braze에서 LINE 구독 그룹 생성

1. LINE의 Braze 기술 파트너 페이지로 이동하여 LINE 제공자 탭에서 확인한 정보를 입력합니다:
   • 공급자 ID
   • 채널 ID
   • 채널 비밀
   • 채널 액세스 토큰

If you want to add IP whitelisting in your LINE account, add all of the IP addresses listed for your cluster in IP allowlisting to your allowlist.

2. 연결 후, Braze는 워크스페이스에 성공적으로 추가된 각 LINE 연동 서비스에 대해 자동으로 Braze 구독 그룹을 생성합니다.

팔로워 목록의 모든 변경 사항(예: 새 팔로워 또는 언팔로워)은 자동으로 Braze에 푸시됩니다.

3단계: 사용자 ID 조정

사용자 ID 조정 단계에 따라 사용자의 LINE ID를 기존 Braze 고객 프로필과 연결하세요.

4단계: 사용자 업데이트 방법을 변경하십시오

사용자 업데이트를 Braze에 제공하는 메서드가 이미 있다고 가정할 때, 해당 메서드를 업데이트하여 새 필드를 포함시켜야native_line_id 합니다. 그래야 이후 Braze로 전송되는 사용자 업데이트에 해당 필드가 포함됩니다.

구독 상태 동기화 프로세스의 일환으로 생성되었거나, 새로운 팔로워가 귀하의 채널을 팔로우했을 때 생성된 미확인 고객 프로필이 Braze에 native_line_id존재할 수 있습니다.

사용자 일치 또는 기타 방법을 통해 애플리케이션에서 LINE 사용자가 식별되면, Braze에서 /users/identify엔드포인트를 사용하여 잠재적 미확인 고객 프로필을 타겟팅할 수 있습니다. 미확인 고객 프로필마다 가 있는 경우, 해당 고객 프로필을 식별하기 위한native_line_id 식별자로 사용할 수 있는 사용자 별칭line_id 도 함께 존재합니다.

다음은 사용자 별칭으로 식별되지 않은 고객 프로필을 /users/identifyline_id타겟팅하는 예시 페이로드입니다:

1
2
3
4
5
6
7
8
9
10
11
{
   "aliases_to_identify": [
       {
           "external_id": "known_external_id_from_your_application",
           "user_alias": {
               "alias_name": "U89f4a626548ccd48482f529a482f138b",
               "alias_label": "line_id"
           }
       }
   ]
}

제공된 고객 프로필이 기존에external_id 존재하지 않을 경우, 해당 프로필은 미확인 고객 프로필에 추가되어 식별자가 부여됩니다. 해당 사용자에 대한 고객 external_id프로필이 존재하는 경우, 미확인 고객 프로필에만 존재하는 모든 속성(예: 및 사용자의 구독native_line_id 상태 포함)이 확인된 고객 프로필로 복사됩니다.

응용 프로그램에서 알려진 LINE 사용자를 외부 식별자와 를 전달하여 해당/users/track엔드포인트를 native_line_id통해 업데이트할 수 있습니다. 사용자에 대해 이미 미확인 고객 프로필이 존재하는 경우, 동일한 고객 프로필이 다른 native_line_id고객 프로필을 통해 추가되면 미확인 고객 프로필의 /users/track모든 구독 상태를 상속받습니다. 그러나 동일한 native_line_id.을 가진 중복 고객 프로필이 존재할 것입니다. 이벤트 업데이트로 인한 이후의 모든 구독 업데이트는 해당 프로필을 모두 업데이트합니다.

다음은 외부 ID를 통해/users/track 고객 프로필을 업데이트하여 다음을 추가하는 예시 native_line_id페이로드입니다:

1
2
3
4
5
6
7
8
9
{
   "attributes": [
       {
           "external_id": "known_external_id_from_your_application",
           "native_line_id": "U89f4a626548ccd48482f529a482f138b",
           "other": "attribute"
       }
   ]
}

5단계: 프로필 병합 (선택 사항)

위에서 설명한 바와 같이, 동일한 native_line_id을 가진 여러 사용자 프로필이 존재할 가능성이 있습니다. 업데이트 메서드가 중복 고객 프로필을 생성하는 경우, /user/merge엔드포인트를 사용하여 미확인 고객 프로필을 식별된 고객 프로필과 병합할 수 있습니다.

다음은 사용자 별칭으로 식별되지 않은 고객 프로필을 /users/mergeline_id타겟팅하는 예시 페이로드입니다:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
 "merge_updates": [
   {
     "identifier_to_merge": {
       "user_alias": {
         "alias_name": "U89f4a626548ccd48482f529a482f138b",
         "alias_label": "line_id"
       }
     },
     "identifier_to_keep": {
       "external_id": "known_external_id_from_your_application"
     }
   }
 ]
}

사용자 설정

LINE은 사용자 구독 상태에 대한 신뢰할 수 있는 정보의 원천입니다. 사용자의 LINE ID를 알고 있더라도,native_line_id 해당 사용자가 메시지를 보내는 LINE 채널을 팔로우하지 않은 경우 LINE은 사용자에게 메시지를 전달하지 않습니다.

이를 관리하기 위해 Braze는 LINE 팔로우 및 언팔로우에 대한 구독 동기화 및 이벤트 업데이트를 포함하여 원활하게 통합된 사용자 기반을 지원하는 도구와 로직을 제공합니다.

구독 동기화 및 이벤트 로직

1. 구독 동기화 도구: 이 도구는 LINE 채널 통합 성공 후 자동으로 배포됩니다. 기존 프로필을 업데이트하고 새 프로필을 생성하는 데 사용하십시오.
   
   LINE 채널을 native_line_id팔로우하는 모든 Braze 고객 프로필은 구독 그룹 상태가 로 subscribed업데이트됩니다. LINE 채널을 팔로우하는 사용자 중 Braze 고객 프로필이 없는 경우 다음이native_line_id적용됩니다:
   
   - 채널을 팔로우한 사용자의 LINE ID로native_line_id설정된 익명 사용자 프로필 생성
   - 채널에 이어지는 사용자 LINE ID로 설정된 사용자line_id 별칭
   - 구독 그룹 상태 subscribed

2. 이벤트 업데이트: 이들은 사용자의 구독 상태를 업데이트하는 데 사용됩니다. Braze가 통합된 LINE 채널에 대한 사용자 이벤트 업데이트를 수신하고 해당 이벤트가 팔로우인 경우, 고객 프로필의 구독 그룹 상태는 subscribed.이 됩니다. 이벤트가 언팔로우인 경우, 고객 프로필의 구독 그룹 상태는 .unsubscribed이 됩니다.

- 일치하는 를 가진 모든 Brazenative_line_id 고객 프로필이 자동으로 업데이트됩니다.
- 이벤트에 대한 일치하는 사용자 프로필이 없으면, Braze는 익명 사용자를 생성합니다.

사용 사례

다음은 위의 설정 단계를 수행한 후 사용자를 업데이트할 수 있는 사용 사례입니다.

기존 Braze 고객 프로필이 이미 LINE 채널을 팔로우 중입니다.

1. Braze 고객 프로필이 속성으로native_line_id 업데이트됩니다. 기본값 구독 상태는 입니다unsubscribed.
2. 구독 동기화 도구가 실행되어 사용자가 LINE 채널을 팔로우 중임을 확인한 후, subscribed구독 상태로 고객 프로필을 업데이트합니다.
3. 구독 상태 변경(예: 사용자가 채널을 차단, 언팔로우 또는 재팔로우하는 경우)이 발생하면, Braze는 LINE으로부터 업데이트를 수신하여 고객 프로필을 해당 변경 사항에native_line_id따라 업데이트합니다.

기존 고객 프로필이 LINE 채널을 차단하거나, 친구 관계를 해제하거나, 팔로우를 취소했습니다.

1. Braze 고객 프로필이 속성으로native_line_id 업데이트됩니다. 기본값 구독 상태는 입니다unsubscribed.
2. 구독 동기화 도구는 사용자가 LINE 채널을 팔로우하고 있지 않다고 인식하며, 사용자의 구독 상태는 그대로 유지됩니다unsubscribed.
3. 사용자가 나중에 해당 채널을 팔로우하면, Braze는 LINE으로부터 업데이트를 수신하여 고객 프로필에 구독 상태를 반영합니다subscribed.

LINE 팔로우 후 고객 프로필 생성

1. 채널에 새로운 LINE 팔로워가 생겼습니다.
2. Braze는 익명 사용자 고객 프로필을 생성하며, 속성은native_line_id 팔로워의 LINE ID로 설정되고, 사용자 별칭 은 팔로워의 LINEline_id ID로 설정됩니다. 프로필의 구독 상태는 입니다subscribed.
3. 사용자 일치 처리를 통해 사용자가 LINE ID를 보유한 것으로 확인됩니다.
   • 익명 사용자 프로필은 /users/identify엔드포인트를 사용하여 식별자로 식별될 수 있습니다. 이 고객 프로필에 대한 후속 업데이트(엔드포인트, CSV 가져오기 또는 /users/track클라우드 데이터 수집을 통해)는 이external_id 알려진 식별자를 통해 사용자를 타겟팅할 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
{
   "aliases_to_identify": [
       {
           "external_id": "known_external_id_from_your_application",
           "user_alias": {
               "alias_name": "U89f4a626548ccd48482f529a482f138b",
               "alias_label": "line_id"
           }
       }
   ]
}

• 새 고객 프로필은 (/users/track엔드포인트, CSV 가져오기 또는 클라우드 데이터 수집을 통해) 를 설정하여 생성할native_line_id 수 있습니다. 이 새 프로필은 기존 익명 사용자 고객 프로필의 구독 상태를 상속받습니다. 이 경우 여러 프로필이 동일한 파일을 공유하게 된다는native_line_id 점에 유의하십시오. 이들은 단계 5에 설명된 절차에 따라 /users/merge엔드포인트를 사용하여 언제든지 병합할 수 있습니다.

고객 프로필 생성은 LINE 팔로우 전에 이루어집니다

1. 새로운 사용자를 확보하고 해당 정보를 Braze로 전송합니다. 새로운 고객 프로필이 생성됩니다(프로필 1).
2. 사용자가 귀하의 LINE 계정을 팔로우합니다.
3. Braze는 팔로우 이벤트를 수신하고 익명 사용자 고객 프로필(프로필 2)을 생성합니다.
4. 사용자 일치 처리를 통해 사용자가 LINE ID를 보유한 것으로 확인됩니다.
5. 프로필 1을 업데이트하여 속성을native_line_id 설정합니다. 이 프로필은 프로필 2의 구독 상태를 상속합니다.
   • 이제 동일한 고객 프로필이 native_line_id두 개 있습니다. 이들은 단계 5에 설명된 절차에 따라 /users/merge엔드포인트를 사용하여 언제든지 병합할 수 있습니다.

사용자 ID 조정

사용자가 채널을 팔로우하거나 일회성 ‘팔로워 동기화’ 워크플로를 사용할 때 Braze는 자동으로 LINE ID를 수신합니다. LINE ID는 사용자가 팔로우하는 채널별로 고유하므로, 사용자가 자신의 LINE ID를 제공할 가능성은 낮습니다.

LINE ID를 기존 Braze 고객 프로필과 결합하는 방법은 두 가지입니다:

• LINE 로그인
• 사용자 계정 연동

LINE 로그인

이 방법은 소셜 미디어 로그인을 통해 계정 연동을 수행합니다. 사용자가 앱에 로그인할 때, LINE 로그인을 통해 사용자 계정을 생성하거나 로그인할 수 있는 옵션이 제공됩니다.

1. LINE 개발자 콘솔에 접속하여 LINE 로그인을 통해 앱에 로그인하는 사용자의 이메일 주소를 획득할 수 있는 권한을 요청하세요.

2. LINE 로그인 구현을 위해 LINE에서 제공하는 적절한 단계를 따르십시오:
   
   

   • 웹 앱 사용 안내
   • 네이티브 앱 길 안내
     
     검증 요청을 위한 범위 설정 시 email반드시 포함하십시오.

3. Verify ID 토큰 호출을 사용하여 사용자의 이메일을 획득하십시오.

1. 사용자의 LINE ID(native_line_id)를 데이터베이스 내 해당 이메일과 연결된 고객 프로필에 저장하거나, 사용자의 이메일과 LINE ID로 새 고객 프로필을 생성하십시오.

2. 새로 생성되거나 업데이트된 사용자 정보를 Braze로 전송하려면 엔드포인트, CSV 가져오기 /user/track또는 클라우드 데이터 수집을 사용하십시오.

워크플로우

기존 팔로워는 LINE 로그인을 사용합니다

시나리오: 익명 사용자는 초기 가입자 동기화 시 또는 ‘팔로우’ 이벤트를 통한 통합 이후 생성되었습니다.

1. 사용자가 LINE 로그인을 통해 앱에 로그인합니다.
2. LINE은 사용자의 이메일을 제공합니다.
3. 업데이트된 사용자(해당 이메일로 LINE ID를 추가할 기존 고객 프로필)를 Braze에 전송하거나, 해당 이메일로 익명 사용자를 업데이트합니다.

새로운 팔로워가 LINE 로그인을 사용합니다

시나리오: Braze에는 해당 사용자의 LINE ID로 등록된 고객 프로필이 존재하지 않습니다.

1. 사용자가 LINE 로그인을 통해 앱에 로그인합니다.
2. LINE은 사용자의 이메일을 제공합니다.
3. 당신은 다음 중 하나를 선택해야 합니다:
   • 해당 이메일로 기존 고객 프로필을 업데이트하여 고객의 LINE ID도 함께 보유하도록 합니다.
   • 이메일과 LINE ID로 새 고객 프로필을 생성하세요.
4. 사용자가 귀하의 LINE 공식 계정을 팔로우하면, Braze는 팔로우 이벤트를 수신하고 사용자의 구독 상태를 으로 subscribed업데이트합니다.

사용자 계정 연동

이 방법을 통해 사용자는 자신의 LINE 계정을 앱의 사용자 계정에 연결할 수 있습니다. 그런 다음, 예를 들어 {{line_id}} 과 같은 Braze의 Liquid를 사용하여 사용자의 LINE ID를 웹사이트나 앱에 전달하는 사용자 맞춤 URL을 생성하고, 이를 알려진 사용자와 연결할 수 있습니다.

1. 구독 상태 변경을 기반으로 하며, 사용자가 LINE 채널에 가입할 때 트리거되는 액션 기반 캔버스를 생성합니다.
   
2. 사용자가 웹사이트나 앱에 로그인하도록 유도하는 메시지를 생성하고, 사용자의 LINE ID를 쿼리 매개변수로 전달하세요(Liquid를 통해). 예를 들어:

1
Thanks for following Flash n' Thread on LINE! For personalized offers and 20% off your next purchase, sign-in to your account: https://flashandthread.com/sign_in?line_user_id=

3. 쿠폰 코드를 전달하는 후속 메시지를 작성하세요. 4. (선택 사항) LINE 사용자가 식별될 때 쿠폰 코드를 발송하도록 트리거되는 액션 기반 캠페인 또는 캔버스를 생성합니다.

작동 방식

사용자가 로그인한 후, 웹사이트나 앱에서 변경 사항이 적용되어 사용자 ID가 Braze로 다시 전송됩니다. 이는 URL의 일부로 전달된 LINE ID와 연결하기 위함입니다. 예시 코드는 다음과 같습니다:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
const currentUrl = new URL(window.location.href)
const queryParams = new URLSearchParams(currentUrl.search);
const lineUserId = queryParams.get("line_user_id")

if (user && isLoggedIn && lineUserId) {
  post(
   "https://rest.iad-03.braze.com	/users/identify",
   {
     "aliases_to_identify": [
       {
   "external_id": user.getUserId(),
   "user_alias": {
     "alias_name": lineUserId,
     "alias_label": "line_id"
   }
 }
      ]
    }
  )
  braze.logCustomEvent("identified_line_user_for_promotion");
}

워크플로우

기존 사용자가 귀하의 LINE 채널을 팔로우합니다

시나리오: Braze의 기존 사용자가 LINE에서 귀하의 채널을 팔로우합니다.

1. LINE이 Braze에 팔로우 이벤트를 전송합니다.
2. Braze는 LINE ID,line_id사용자 별칭 및 LINE 구독 그룹 상태를 사용하여 익명 사용자 고객subscribed 프로필을 생성합니다.
3. 사용자는 귀하의 웹사이트 및 앱 링크가 포함된 LINE 메시지를 수신하고 로그인합니다. 그들의 고객 프로필이 이제 확인되었습니다.
4. 생성된 익명 사용자 프로필이 식별되어 /users/identify 엔드포인트를 통해 사용자의 알려진 고객 프로필과 병합됩니다. 알려진 고객 프로필에는 이제 LINE ID가 포함되어 있으며 구독 상태는 입니다subscribed.
5. (선택 사항) 사용자에게 쿠폰 코드가 포함된 LINE 메시지가 전송되며, Braze는 해당 발송 기록을 Braze 고객 프로필에 저장합니다.

Braze에서 LINE 테스트 사용자 생성

사용자 연결을 설정하기 전에 “내가 누구인가요?” 캔버스 또는 캠페인을 생성하여 LINE 채널을 테스트할 수 있습니다.

1. 특정 트리거 단어에 대해 사용자의 Braze 사용자 ID를 반환하는 캔버스를 설정합니다.
   
   트리거 예시
   
   
   
   메시지 예시
   
   
   
   

2. Braze에서는 Braze ID를 사용하여 특정 사용자를 검색하고 필요에 따라 수정할 수 있습니다.