Shopify 標準統合設定

このページでは、Shopify オンラインストアをお持ちのユーザーを対象に、Braze と Shopify の標準的な統合手順を説明します。Shopify ヘッドレスサイトを使用する場合、またはより大きくカスタマイズされたソリューションを実装する場合は、Shopify カスタム統合設定を参照してください。

ステップ 1: Shopify ストアを接続する

Braze で、Partner Integrations> Technology Partners に移動し、”Shopify” を検索します。

note:

古いナビゲーションを使用している場合は、[統合] に [テクノロジーパートナー] が表示されます。

2.Shopify パートナーページで、[Begin setup] を選択して、統合プロセスを開始します。

Shopify の統合ページ。設定を開始するブタンが表示されている。

3.Shopify アプリストアで、Braze アプリケーションをインストールします。

Braze アプリストアページ。アプリケーションをインストールするボタンが表示されている。

note:

Shopify アカウントが複数のストアと関連している場合、ページの右上にあるストアアイコンを選択して、[Switch stores] を選択すると、ログイン先のストアを変更できます。

4.Braze アプリをインストールすると、Braze にリダイレクトされます。そこで Shopify に接続するワークスペースを確認します。Shopify ストアが接続できるワークスペースは 1 つのみです。切り替えが必要な場合は、正しいワークスペースを選択してください。

適切なワークスペースであることを確認するウィンドウ。

5.[Begin setup] を選択します。

ドメインを入力するフィールドと設定を開始するボタンが表示された「統合設定」。

ステップ2: Braze Web SDK を有効にする

Shopify オンラインストアでは、標準設定を選択すると、Braze Web SDK と JavaScript SDK を自動的に実装できます。

標準設定とカスタム設定のどちらで実装するかを選択できるオプションが表示された「Web SDK の有効化」ステップ。

標準設定のオンボーディングパスを選択すると、次のオプションのいずれかから、Braze が SDK を初期化して読み込むタイミングを選択する必要があります。

セッション開始など、サイト訪問の時点
- 識別済みのユーザーと匿名ユーザーの両方を追跡
アカウントログインなどのアカウントの登録時
- 識別されたユーザーのみを追跡
- サイト訪問者がアカウントの登録やアカウントへのログインを行ったときにデータの追跡を開始します。

ステップ 3: Shopify のデータを設定する

標準データ設定

追跡する Shopify のデータを選択します。

「Shopify データ追跡」セクション。行動イベントを追跡するためのチェックボックスとユーザー属性が表示されている。

標準統合のデフォルトでは、以下のイベントが有効化されています。

Braze おすすめイベント

Shopify カスタムイベントs

Shopifyカスタム属性

製品の閲覧
カートの更新
チェックアウト開始
発注

shopify_account_login
shopify_paid_order
shopify_order_canceled
shopify_order_refunded
shopify_order_fulfilled
shopify_order_partially_fulfilled

shopify_tags
shopify_total_spent
shopify_order_count
shopify_last_order_id
shopify_last_order_name
shopify_zipcode
shopify_province

統合を介して追跡されるデータの詳細は、Shopify データの機能を参照してください。

履歴バックフィルの設定

標準設定では、Shopify 統合の接続前の過去 90 日間の Shopify 顧客と注文の初期読み込みを実行するオプションを利用できます。そのためには、統合の一部として初期データの読み込みを含めるチェックボックスを選択します。

履歴データのバックフィルの切り替え。

このテーブルには、バックフィルを通して最初に読み込まれるデータが含まれています。

Braze おすすめイベント

Shopify カスタムイベントs

Braze の標準属性項目

Braze の購読テータス

発注

shopify_tags
shopify_total_spent
shopify_order_count
shopify_last_order_id
shopify_last_order_name
shopify_zipcode

メール
名
姓
電話
市区町村
国

この Shopify ストアに関連するメールマーケティングの購読
この Shopify ストアに関連する SMS マーケティングの購読

Shopify の顧客レコードが Braze に読み込まれるため、Shopify 顧客 ID が Braze external ID として使用されます。

note:

既存の Braze のお客様でアクティブなキャンペーンやキャンバスをご利用の場合は、Shopify データ機能で詳細を確認してください。

(高度) カスタムデータ追跡設定

Braze SDK を使用すると、この統合でサポートされている標準イベント以外にもカスタムイベントやカスタム属性を追跡することができます。カスタムイベントは、ストア内に固有のインタラクションをキャプチャーします。

カスタムイベント	カスタム属性
カスタム割引コードの使用パーソナライズされたおすすめ商品とのインタラクション注文へのギフトメッセージの追加	お気に入りのブランドまたは製品優先ショッピングカテゴリメンバーシップまたはロイヤルティステータス

カスタムデータを追跡することで、ユーザーの行動についてより詳しいインサイトを得ることができ、さらに体験をパーソナライズすることができます。カスタムイベントを実装するには、theme.liquid ファイル内の storefront’s theme code を編集する必要があります。必要に応じて開発者にサポートを依頼してください。

たとえば、次の JavaScript スニペットは、現在のユーザーがニュースレターを購読しているかどうかを追跡し、その情報を Braze のプロファイルにカスタムイベントとして記録します。

braze.logCustomEvent(
  “subscribed_to_newsletter”,
  {
    newsletterName: ‘News and Offers’,
    customerEmail: ‘customer_1@gmail.com’,
    sendOffers: true
  }
);

イベントやカスタム属性をログに記録するには、ユーザーのデバイスで SDK を初期化 (アクティビティのリッスン) する必要があります。カスタムデータのロギングについては、ユーザーオブジェクトと logCustomEvent object を参照してください。

ステップ 4: ユーザーの管理方法を設定する

ドロップダウンから external_id タイプを選択します。

「サブスクライバーの収集セクション。

important:

メールアドレスまたはハッシュ化されたメールアドレスを Braze external ID として使用することで、データソース全体での ID 管理を簡素化できます。ただし、ユーザーのプライバシーとデータセキュリティに対する潜在的なリスクを考慮することが重要です。

推測可能な情報: メールアドレスは推測されやすく、攻撃されやすい。
悪用のリスク: 悪意のあるユーザーがWebブラウザーを改ざんし、他人のメールアドレスを外部IDとして送信した場合、機密メッセージやアカウント情報にアクセスされる可能性がある。

カスタム external ID タイプを選択した場合は、ステップ 4.1 および 4.2 に進んでください。それ以外の場合は、ステップ 4.3 に進みます。

ステップ4.1：カスタム `external_id` を作成する

まず、Shopify に移動し、braze.external_id メタフィールドを作成します。カスタムのメタフィールド記述を作成するのステップを使用することを推奨します。名前空間とキーには braze.external_id と入力します。タイプについては、ID タイプを選択することを推奨します。

メタフィールドを作成したら、customer/create Webhook をリッスンして、新しい顧客が作成されたときにメタフィールドを書き込むことができるようにします。次に、Admin API または Customer API を使用して、すでに作成されているすべての顧客をこのメタフィールドに埋め戻してください。

ステップ4.2：エンドポイントを作成する

外部 ID を取得するには、パブリックの GET エンドポイントが必要です。Shopify がメタフィールドを提供できない場合、Braze はそのエンドポイントを呼び出して external ID を取得します。

エンドポイントの例: https://mystore.com/custom_id?shopify_customer_id=1234&[email protected]&shopify_storefront=dev-store.myshopify.com

応答

Braze は 200 ステータスコードを待ち受けます。それ以外のコードはエンドポイントの失敗とみなされます。想定されるレスポンスは次のようになります。

{ "external_id": "my_external_id" }

Admin API または Customer API を使用して、shopify_customer_id とメールアドレスを調べ、パラメーター値が Shopify の顧客値と一致していることを確認します。確認後、API を使って braze.external_id メタフィールドを取得し、external ID 値を返すこともできます。

ステップ4.3：Shopify からメールや SMS のオプトインを収集する (オプション)

Shopify からメールまたは SMS マーケティングのオプトインを収集する選択もできます。

メールや SMS チャネルを使用している場合、メールや SMS マーケティングのオプトイン状態を Braze に同期させることができます。Shopify からメールマーケティングのオプトインを同期すると、Braze は自動的にその特定のストアに関連するすべてのユーザーのメール購読グループを作成します。この購読グループには一意な名前を付ける必要がある。

「購読者の収集」セクション。メールまたは SMS マーケティングのオプトインを収集するオプションが表示されている。

note:

Shopify の概要に記載されているように、サードパーティのキャプチャーフォームを使用する場合、開発者は Braze SDK コードを統合する必要があります。これにより、フォーム送信からメールアドレスとグローバルメール購読ステータスを取得できます。具体的には、theme.liquid ファイルにこれらのメソッドを実装し、テストする必要があります。

setEmail: ユーザープロファイルのメールアドレスを設定する
setEmailNotificationSubscriptionType: グローバルメールの購読ステータスを更新する

ステップ 5: 商品を同期 (オプション)

Shopify ストアの全商品を Braze カタログに同期し、より詳細なメッセージングのパーソナライゼーションを実現できます。自動更新はほぼリアルタイムで行われるため、カタログには常に最新の商品詳細が反映されます。詳しくは、Shopify product syncs を参照してください。

![設定プロセスのステップ 4。「カタログの商品の識別子」に「Shopify バリアント ID」が設定されている。]/docs/ja/assets/img/Shopify/sync_products_step1.png?5ace9a6e3dfb6a3617ff6b1143c03446{: style=”max-width:80%;”}

ステップ 6: チャネルのアクティブ化

開発者を使用せずにアプリ内メッセージを有効にするには、設定でこの設定を行います。

使用可能なオプションをブラウザ内メッセージングに設定して、チャネルを有効にする設定手順。

note:

Braze は、ブラウザー内メッセージを通じて、メールアドレスや電話番号などの訪問者情報を収集します。この情報は Shopify に送信されます。このデータは、加盟店が来店者を把握し、よりパーソナライズされたショッピング体験を提供するための手がかりとなります。詳細については、Visitor API を参照してください。