Shopify 표준 통합 설정

이 페이지에서는 Shopify 온라인 스토어를 사용하는 사용자를 위한 표준 통합을 사용하여 Braze와 Shopify를 통합하는 방법을 안내합니다. Shopify 헤드리스 사이트를 사용하거나 더 맞춤화된 솔루션을 구현하려는 경우 Shopify 커스텀 통합 설정을 참조하세요.

1단계: Shopify 스토어 연결

1. Braze에서 파트너 통합 > 기술 파트너로 이동한 다음 “Shopify”를 검색합니다.

2. Shopify 파트너 페이지에서 설정 시작을 선택하여 통합 프로세스를 시작합니다.
   
   
   
   
3. Shopify 앱 스토어에서 Braze 애플리케이션을 설치합니다.
   
   

4. Braze 앱을 설치한 후 Shopify에 연결할 워크스페이스를 확인하기 위해 Braze로 리디렉션됩니다. Shopify 스토어는 하나의 워크스페이스에만 연결할 수 있습니다. 전환이 필요한 경우 올바른 워크스페이스를 선택하세요.
   
   

5. 설정 시작을 선택합니다.
   
   

2단계: Braze Web SDK 활성화

Shopify 온라인 스토어의 경우 표준 설정을 선택하여 Braze Web SDK와 JavaScript SDK를 자동으로 구현할 수 있습니다.

표준 설정 온보딩 경로를 선택한 후 Braze가 SDK를 초기화하고 로드할 시점을 다음 옵션 중에서 선택해야 합니다:

• 사이트 방문 시(예: 세션 시작)
  • 식별된 사용자와 익명 사용자 모두 추적
• 계정 가입 시(예: 계정 로그인)
  • 식별된 사용자만 추적
  • 사이트 방문자가 계정에 가입하거나 로그인할 때 데이터 추적 시작

3단계: Shopify 데이터 구성

표준 데이터 설정

이제 추적할 Shopify 데이터를 선택합니다.

다음 이벤트는 표준 통합에서 기본적으로 활성화됩니다.

통합을 통해 추적되는 데이터에 대한 자세한 내용은 Shopify 데이터 기능을 참조하세요.

과거 데이터 백필 설정

표준 설정을 통해 Shopify 통합 연결 이전 최근 90일간의 Shopify 고객 및 주문 데이터를 초기 로드할 수 있는 옵션이 있습니다. 이를 위해 통합의 일부로 초기 데이터 로드를 포함하는 체크박스를 선택하세요.

이 표에는 백필을 통해 초기 로드되는 데이터가 포함되어 있습니다.

Shopify 고객 레코드가 Braze에 로드되면 Shopify 고객 ID가 Braze 외부 ID로 사용됩니다.

(고급) 커스텀 데이터 추적 설정

Braze SDK를 사용하면 이 통합의 표준 이벤트를 넘어서는 커스텀 이벤트 또는 커스텀 속성을 추적할 수 있습니다. 커스텀 이벤트는 스토어에서의 고유한 상호작용을 캡처합니다. 예를 들면 다음과 같습니다:

커스텀 데이터를 추적하면 사용자 행동에 대한 심층적인 인사이트를 확보하고 추가적인 개인화를 지원할 수 있습니다. 커스텀 이벤트를 구현하려면 theme.liquid 파일에서 스토어프론트의 테마 코드를 편집해야 합니다. 개발자의 도움이 필요할 수 있습니다.

예를 들어, 다음 JavaScript 스니펫은 현재 사용자가 뉴스레터를 구독하는지 추적하고 이를 Braze의 프로필에 커스텀 이벤트로 기록합니다:

1
2
3
4
5
6
7
8
9
braze.logCustomEvent(
  “subscribed_to_newsletter”,
  {
    newsletterName: ‘News and Offers’,
    customerEmail: ‘customer_1@gmail.com’,
    sendOffers: true
  }
);

이벤트 또는 커스텀 속성을 기록하려면 사용자의 기기에서 SDK가 초기화(활동 수신 대기)되어 있어야 합니다. 커스텀 데이터 기록에 대해 자세히 알아보려면 User object 및 logCustomEvent object를 참조하세요.

4단계: 사용자 관리 방법 구성하기

드롭다운에서 external_id 유형을 선택합니다.

기본적으로 Braze는 Shopify의 이메일을 외부 ID로 사용하기 전에 소문자로 자동 변환합니다. 이메일 또는 해시된 이메일을 외부 ID로 사용하는 경우, 외부 ID로 할당하기 전이나 다른 데이터 소스에서 해시하기 전에 이메일 주소도 소문자로 변환되었는지 확인하세요. 이렇게 하면 외부 ID의 불일치를 방지하고 Braze에서 중복 고객 프로필이 생성되는 것을 막을 수 있습니다.

4.1단계: braze.external_id 메타필드 만들기

1. Shopify 관리자 패널에서 설정 > 메타필드 및 메타오브젝트로 이동합니다.
2. 고객 > 정의 추가를 선택합니다.
3. 이름에 braze.external_id를 입력합니다.
4. 자동 생성된 네임스페이스와 키(custom.braze_external_id)를 선택하여 편집하고 braze.external_id로 변경합니다.
5. 유형에서 ID 유형을 선택합니다.

메타필드가 생성되면 고객에 대해 메타필드를 채웁니다. 다음과 같은 방법을 권장합니다:

• 고객 생성 웹훅 수신: customer/create 이벤트를 수신하도록 웹훅을 설정합니다. 이를 통해 새 고객이 생성될 때 메타필드를 작성할 수 있습니다.
• 기존 고객 백필: Admin API 또는 Customer API를 사용하여 이전에 생성된 고객의 메타필드를 백필합니다.

4.2단계: 외부 ID를 검색할 엔드포인트 만들기

외부 ID를 검색하기 위해 Braze가 호출할 수 있는 공용 엔드포인트를 만들어야 합니다. 이를 통해 Shopify에서 braze.external_id 메타필드를 직접 제공할 수 없는 시나리오에서 Braze가 ID를 가져올 수 있습니다.

엔드포인트 사양

방법: GET

Braze는 다음 매개변수를 엔드포인트로 전송합니다:

엔드포인트 예시

1
GET https://mystore.com/custom_id?shopify_customer_id=1234&[email protected]&shopify_storefront=dev-store.myshopify.com

예상 응답

Braze는 외부 ID JSON을 반환하는 200 상태 코드를 기대합니다:

1
2
3
{
  "external_id": "my_external_id"
}

유효성 검사

shopify_customer_id 및 email_address(있는 경우)가 Shopify의 고객 값과 일치하는지 검증하는 것이 중요합니다. Shopify Admin API 또는 Customer API를 사용하여 이러한 매개변수의 유효성을 검사하고 올바른 braze.external_id 메타필드를 검색할 수 있습니다.

실패 동작 및 병합

200 이외의 상태 코드는 모두 실패로 간주됩니다.

• 병합 영향: 엔드포인트가 실패하면(200이 아닌 값을 반환하거나 시간 초과), Braze는 외부 ID를 검색할 수 없습니다. 따라서 Shopify 사용자와 Braze 고객 프로필 간의 병합은 해당 시점에 이루어지지 않습니다.
• 재시도 로직: Braze는 표준 즉시 네트워크 재시도를 시도할 수 있지만, 실패가 지속되면 다음 적격 이벤트(예: 사용자가 프로필을 업데이트하거나 결제를 완료할 때)까지 병합이 연기됩니다.
• 지원 가능성: 적시에 사용자 병합을 지원하려면 엔드포인트의 가용성이 높고 선택 사항인 email_address 필드를 원활하게 처리할 수 있는지 확인하세요.

4.3단계: 외부 ID 입력

4단계를 반복하고 Braze 외부 ID 유형으로 커스텀 외부 ID를 선택한 후 엔드포인트 URL을 입력합니다.

고려 사항

• Braze가 엔드포인트에 요청을 보낼 때 외부 ID가 생성되지 않은 경우, 통합은 changeUser 함수가 호출될 때 기본적으로 Shopify 고객 ID를 사용합니다. 이 단계는 익명 사용자 프로필을 식별된 고객 프로필과 병합하는 데 매우 중요합니다. 따라서 일시적으로 워크스페이스 내에 여러 유형의 외부 ID가 존재할 수 있습니다.
• braze.external_id 메타필드에서 외부 ID를 사용할 수 있으면 통합에서 이 외부 ID에 우선순위를 지정하여 할당합니다.
  • 이전에 Shopify 고객 ID가 Braze 외부 ID로 설정된 경우 braze.external_id 메타필드 값으로 대체됩니다.

4.4단계: Shopify에서 이메일 또는 SMS 옵트인 수집(선택 사항)

Shopify에서 이메일 또는 SMS 마케팅 옵트인을 수집하는 옵션이 있습니다.

이메일 또는 SMS 채널을 사용하는 경우 이메일 및 SMS 마케팅 옵트인 상태를 Braze에 동기화할 수 있습니다. Shopify에서 이메일 마케팅 옵트인을 동기화하면 Braze는 해당 특정 스토어와 연결된 모든 사용자에 대해 이메일 구독 그룹을 자동으로 생성합니다. 이 구독 그룹에 고유한 이름을 지정해야 합니다.

5단계: 제품 동기화(선택 사항)

Shopify 스토어의 모든 제품을 Braze 카탈로그에 동기화하여 더 깊은 메시징 개인화를 구현할 수 있습니다. 자동 업데이트가 거의 실시간으로 이루어지므로 카탈로그에 최신 제품 세부 정보가 반영됩니다. 자세한 내용은 Shopify 제품 동기화를 확인하세요.

6단계: 채널 활성화(선택 사항)

설정에서 구성하여 개발자 없이 인앱 메시지를 활성화할 수 있습니다.

추가 SDK 채널 지원

Braze SDK는 콘텐츠 카드를 포함한 다양한 메시징 채널을 지원합니다.

콘텐츠 카드 및 기능 플래그

콘텐츠 카드 또는 기능 플래그를 추가하려면 개발자와 협력하여 필요한 SDK 코드를 theme.liquid 파일에 직접 삽입해야 합니다. 자세한 지침은 Braze SDK 통합을 참조하세요.

웹 푸시 알림

현재 웹 푸시는 Shopify 통합에서 지원되지 않습니다. 지원을 요청하려면 Braze 제품 포털을 통해 제품 요청을 제출하세요.

7단계: 설정 완료

1. 설정을 구성한 후 설정 완료를 선택합니다.
2. Shopify 테마 설정에서 Braze 앱 임베드를 활성화합니다. Shopify 열기를 선택하면 Shopify 계정으로 리디렉션되어 스토어의 테마 설정에서 앱 임베드를 활성화할 수 있습니다.

3. 앱 임베드를 활성화하면 설정이 완료됩니다! 통합 설정, 초기 데이터 동기화 상태 및 활성 Shopify 이벤트를 확인할 수 있는지 확인하세요.