Shopify標準統合セットアップ

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

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

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

2.Shopifyパートナーページで、セットアップを開始して統合プロセスを開始します。



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

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

5.セットアップ開始を選択します。

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

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

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

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

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

標準データ設定

次に、追跡するShopifyデータを選択します。

標準統合では、次のイベントがデフォルトで有効になります。

統合によって追跡されるデータの詳細については、Shopify Data Featuresを参照してください。

履歴バックフィルの設定

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

この表には、バックフィルによって最初にロードされるデータが含まれています。

Shopifyの顧客レコードがBrazeにロードされると、Shopifyの顧客IDがBrazeの外部IDとして使用されます。

(詳細)カスタムデータトラッキング設定

Braze SDK を使用すると、この統合の標準イベントを超えるカスタムイベントまたはカスタム属性を追跡できます。カスタムイベントは、ストア内に固有のインタラクションをキャプチャーします。

カスタムデータの追跡は、ユーザーの振る舞いに関するより深いインサイトを提供し、追加のパーソナライゼーションをサポートします。カスタムイベントを実装するには、theme.liquid ファイルでstorefront のテーマコード を編集する必要があります。開発者からのヘルプが必要な場合があります。

たとえば、次の 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はメールsをShopifyから小文字に自動的に変換してから、外部IDとして使用します。メールまたはハッシュメールを外部IDとして使用している場合は、メールアドレスも小文字に変換されていることを確認してから、外部IDとして割り当てるか、他のデータソースからハッシュする必要があります。これにより、外部ID の不一致を防ぎ、Braze での重複ユーザープロファイルの作成を回避できます。

ステップ4.1：braze.external_id メタフィールドを作成する

1. Shopifyの管理パネルで、Settings> Meta フィールド s and metaobjects に移動します。
2. Customers> 定義を追加を選択します。
3. Nameにはbraze.external_idと入力します。
4. 自動生成されたネームスペースとキー(custom.braze_external_id) を選択して編集し、braze.external_id に変更します。
5. TypeにはID Typeを選択します。

メタフィールドが作成されたら、顧客s に入力します。次のアプリ侵害をお勧めします。

• 顧客作成webhookを聴く:customer/create events をリッスンするWebhookを設定します。これにより、新しい顧客の作成時にメタフィールドを書き込むことができます。
• 顧客を埋め戻す:Admin APIまたは顧客 APIを使用して、以前に作成した顧客sのメタフィールドを埋め戻します。

ステップ4.2：外部ID を取得するエンドポイントを作成する

外部ID を取得するためにBraze が呼び出すことができる公開エンドポイントを作成する必要があります。これは、Shopify がbraze.external_id メタフィールドを提供できない場合に必須です。

エンドポイント仕様

方法: GET

サンプルエンドポイント

1
2
GET 
https://mystore.com/custom_id?shopify_customer_id=1234&email_address=bob@braze.com&shopify_storefront=dev-store.myshopify.com

期待される反応

Braze は 200 ステータスコードを待ち受けます。それ以外のコードは障害とみなされます。

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

ステップ4.3：外部IDを入力

手順4を繰り返し、Brazeの外部ID 種別としてカスタム外部ID を選択した後、エンドポイント URL を入力します。

考慮事項

• Braze がエンドポイントにリクエストを送信したときに外部ID が生成されない場合、changeUser 関数が呼び出されると、インテグレーションはShopify 顧客 ID の使用をデフォルトします。このステップは、特定されたユーザープロファイルと匿名ユーザープロファイルをマージするために重要です。そのため、一時的にワークスペース内にさまざまなタイプの外部ID が存在する場合があります。
• 外部ID がbraze.external_id メタフィールドで使用可能な場合、この外部ID が優先され、割り当てられます。
  • 以前にShopify 顧客 ID がBraze 外部ID として設定されていた場合は、braze.external_id メタフィールドに置き換えられます。

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

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

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

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

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

ステップ 6: チャンネルを有効にする(オプション)

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

追加 SDK チャネルのサポート

Braze SDK を使用すると、コンテンツカードなど、さまざまなメッセージングチャネルを使用できます。

コンテンツカードとフィーチャーフラグ

コンテンツカードまたは機能フラグを追加するには、開発者と協力して、必要なSDK コードをtheme.liquid ファイルに直接挿入する必要があります。詳細な手順については、Braze SDK の統合を参照してください。

Webプッシュ通知

現在、WebプッシュはShopifyインテグレーションではサポートされていません。サポートをリクエストするには、 Braze プロダクトポータル からプロダクトリクエストを送信します。

ステップ 7:設定完了

1. 設定後、Finish Setupを選択します。
2. Shopify テーマ設定で、Braze アプリの埋め込みを有効にします。ストアのテーマ設定でアプリの埋め込みを有効にするには、[Shopify を開く] を選択して、Shopify アカウントにリダイレクトされるようにします。

3.アプリの埋め込みを有効にすると、セットアップが完了します。 統合設定、初期データ同期のステータス、およびアクティブなShopifyイベントを確認できます。