Shopify standard integration setup

This page walks you through how to integrate Braze with Shopify using our standard integration for users with a Shopify online store. If you use a Shopify headless site or are looking to implement more tailored solutions, refer to Shopify custom integration setup.

Step 1: Connect your Shopify store

1. In Braze, go to Partner Integrations > Technology Partners and then search for “Shopify”.

2. On the Shopify partner page, select Begin setup to start the integration process.



3. In the Shopify app store, install the Braze application.

4. After installing the Braze app, you’ll be redirected to Braze to confirm the workspace you want to connect to Shopify. A Shopify store can connect to only one workspace. If you need to switch, select the correct workspace.

5. Select Begin setup.

2단계: Enable Braze Web SDKs

For Shopify online stores, you can select the standard setup to automatically implement the Braze Web SDK and JavaScript SDK.

After you select the standard setup onboarding path, you’ll need to choose when Braze should initialize and load the SDKs from one of the following options:

• Upon site visit, such as session start
  • Tracks both identified and anonymous users
• Upon account signup, such as account login
  • Track only identified users
  • Starts tracking data when site visitors sign up or log into their accounts

Step 3: Configure your Shopify data

Standard data setup

Now you’ll select the Shopify data you want to track.

The following events will be enabled by default in the standard integration.

For more information on the data tracked through the integration, refer to Shopify Data Features.

Historical backfill setup

Through the standard setup, you have the option to perform an initial load of your Shopify customers and orders from the last 90 days prior to your Shopify integration connection. To do so, select the checkbox to include the initial data load as part of your integration.

This table contains the data that will be initially loaded through the backfill.

As your Shopify customer records are loaded into Braze, the Shopify customer ID will be used as the Braze external ID.

(Advanced) Custom data tracking setup

With the Braze SDKs, you can track custom events or custom attributes that go beyond standard events for this integration. Custom events capture unique interactions in your store, such as:

커스텀 데이터를 추적하면 사용자 행동에 대한 심층적인 인사이트를 확보하고 추가적인 개인화를 지원할 수 있습니다. To implement custom events, you need to edit your storefront’s theme code in the theme.liquid file. You may need help from your developers.

For example, the following JavaScript snippet tracks if the current user subscribes to a newsletter, and logs that as a custom event on their profile in 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
  }
);

The SDK must be initialized (listening for activity) on a user’s device to log events or custom attributes. To learn more about logging custom data, refer to User object and logCustomEvent object.

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

Select your external_id type from the dropdown.

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

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

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

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

• 고객 제작 웹훅을 들어보세요: customer/create 이벤트를 수신하도록 웹훅을 설정합니다. 이를 통해 새 고객이 생성될 때 메타필드를 작성할 수 있습니다.
• 기존 고객을 다시 채우세요: 관리자 API 또는 고객 API를 사용하여 이전에 생성한 고객의 메타필드를 다시 채우세요.

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

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

엔드포인트 사양

Method: 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 관리자 API 또는 고객 API를 사용하여 이러한 매개 변수의 유효성을 검사하고 올바른 braze.external_id 메타필드를 검색할 수 있습니다.

실패 동작 및 병합

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

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

Step 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단계: Collect your email or SMS opt-ins from Shopify (optional)

You have the option to collect your email or SMS marketing opt-ins from Shopify.

If you use the email or SMS channels, you can sync your email and SMS marketing opt-in states into Braze. If you sync email marketing opt-ins from Shopify, Braze will automatically create an email subscription group for all users associated with that specific store. You need to create a unique name for this subscription group.

Step 5: Sync products (optional)

You can sync all products from your Shopify store to a Braze catalog for deeper messaging personalization. 자동 업데이트가 거의 실시간으로 이루어지므로 카탈로그에 최신 제품 세부 정보가 반영됩니다. To learn more, check out Shopify product sync.

6단계: Activate Channels (optional)

You can enable in-app messages without using a developer by configuring them in your setup.

Supporting additional SDK channels

The Braze SDKs enable various messaging channels, including Content Cards.

Content Cards and Feature Flags

To add content cards or feature flags, you will need to collaborate with your developers to insert the necessary SDK code directly into your theme.liquid file. For detailed instructions, refer to Integrating the Braze SDK.

Web push notifications

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

7단계: Finish setup

1. After you configure your setup, select Finish Setup.
2. Enable the Braze app embed within your Shopify theme settings. Select Open Shopify to be redirected to your Shopify account to enable the app embed within your store’s theme settings.

3. After you enable the app embed, your setup is complete! Confirm you can view your integration settings, the status of initial data sync, and your active Shopify events.