Shopify Markets

この記事では、Shopify Marketsインテグレーションについて、対象範囲、仕組み、メッセージングでのマーケットデータの活用方法を説明します。

統合の仕組み

Shopify Markets は、既存の Shopify 統合を拡張する機能です。標準またはカスタム (SDK)の統合パスでデフォルトのストアフロントを接続し、ストアで設定されているマーケットの中から、Braze に同期させたいマーケットを選択します。既存の統合でも、カタログ、購読グループ、イベントに影響を与えることなくマーケットを追加できます。手順の詳細については、Shopify Markets の設定を参照してください。

Shopify Markets には次の機能があります。

• マーケットに対応したプロファイル: 統合により、Braze の標準の国属性と言語属性に加えて、各ユーザーの Shopify ロケールが取得されます。そのため、カスタム設定なしでマーケットごとにセグメント化やトリガー設定を行えます。
• ローカライズされたカタログ: マーケット固有の商品データが毎日同期されます。価格や通貨に加え、翻訳されたタイトル、説明、商品 URL も含まれます。
• マーケットに対応したパーソナライゼーション: {% shopify_market %} Liquidタグを使用すると、Shopify の翻訳済みコンテンツを含め、各ユーザーのマーケットのカタログ商品でパーソナライズできます。また、ecommerce.order_placed などのサポートされている Shopify イベントから、表示通貨などのマーケットの詳細を参照することもできます。
• デフォルトストアへのフォールバック: ユーザーが接続済みのマーケットのいずれにも属していない場合、Braze はデフォルトのストア設定と商品を使用します。そのため、すべてのユーザーに完全で正確なメッセージが届きます。

例については、Markets のユーザーデータを使用するとチュートリアル: マーケットごとに商品と価格を表示するを参照してください。

サポートされているShopifyのマーケットタイプ

最大25個のアクティブな単一国または複数国のマーケットを選択できます。各国が属することができるのは、選択したマーケットのうち1つだけです。

サブリージョンマーケット、小売マーケット、B2Bマーケット、チャネルマーケットはサポートされていません。

各マーケットに必要なもの

選択した各マーケットには、アクティブな商品を含むマーケットカタログが必要です。Brazeはそのカタログから以下を読み込みます。

考慮事項

一般

• 接続できるストアは1つ: 1つのBrazeワークスペースに同時に接続できるのは、Marketsが有効なShopifyストア1つだけです。
• ロケールの範囲: ロケールでは、Shopify Translate & Adaptアプリで設定した内容に基づく翻訳済みの商品タイトルと説明、およびロケール固有のURLが取り込まれます。価格、通貨、その他の共有カタログフィールドは、マーケット内のすべてのロケールで同じです。デフォルトでは、Brazeは各マーケットのデフォルト言語 (Shopifyがそのマーケットに割り当てるプライマリーロケール) を使用します。拡張ロケールサポートを有効にすると、Brazeはそのマーケットに設定された追加のロケールも同期します。

マーケットカタログ

• 元のShopifyカタログ内の新しいマーケットビュー: Marketsは個別のカタログを作成しません。代わりに、Brazeはマーケットを元のShopifyカタログの一部として表示します。Marketsのデータは、新しいカタログ行としてShopifyカタログに追加されます。
• カタログセレクション: 最大30個のカタログセレクションを作成できます。
• 更新タイミング: マーケットカタログの商品データは1日1回更新されます。
• マーケット価格とローカライズされたコンテンツ: マーケット行には、マーケットの価格とcompare_at_priceが含まれます。Shopify Translate & Adaptアプリで翻訳が設定されている場合は、ローカライズされた商品タイトル、バリアントタイトル、商品URLも含まれます。
• 値下げ: マーケットカタログでサポートされています。マーケットカタログでの価格変更は、デフォルトのストア価格ではなく、そのマーケットの価格に基づいてトリガーされます。マーケットカタログの商品データは1日1回更新されるため、値下げはShopifyで価格が変更された時点ではなく、1日ごとに検出されます。
• 在庫復活: 在庫復活は、デフォルトのストアカタログ内の商品でサポートされています。マーケット行は在庫復活通知をトリガーしません。在庫復活では、すべてのShopifyロケーションにおける商品バリアントの利用可能な在庫の合計を確認するため、小売店舗のロケーションで追加された在庫によって通知がトリガーされることがあります。

Shopify Markets の設定

Shopify 統合がすでに有効になっている場合

Markets は現在の統合に追加される機能です。統合の接続を解除したり、設定をやり直したりする必要はありません。

• 既存の購読グループはストア全体のグループになり、追加で割り当てたグループを含め、すべてのオプトインを引き続き受け取ります。
• 既存の購読者は、現在所属しているグループにそのまま残ります。後から国別グループを追加しても、Braze は既存の購読者をそのグループに追加しません。
• カタログは引き続き同期されます。マーケット行は新しいカタログではなく既存のカタログに追加され、既存のセレクションはデフォルト行に対して引き続き機能します。
• デフォルトのストアは、選択したマーケットと並んで表示されます。マーケットと同じ方法で、デフォルトのストアにも購読グループを割り当てたり、カタログセレクションを作成したりできます。

ストアがすでに接続されている場合は、ステップ 2 から始めて、各設定とその仕組みを確認してください。

ステップ 1: Shopify Markets が有効なストアを接続する

1. Shopify 標準統合または Shopify カスタム統合のいずれかの方法でストアを接続します。ストアの接続後、セットアップ画面で Shopify Markets を設定します。
2. OAuth フローを完了し、Braze が OAuth で次の Markets スコープを要求していることを確認します。
   • read_markets
   • read_publications
   • read_locales
3. 認証が成功してセットアップ画面が開いたら、セットアップを開始を選択します。
4. Braze SDKをオンにします。

ステップ 2: マーケットのユーザーデータを選択する

1. Shopify データを追跡で、Shopify Markets データを同期を選択します。
2. マーケットを選択を選択してマーケットを指定し、行動イベントとユーザー属性の追跡が選択されていることを確認します。
   • (オプション) 履歴データのバックフィルをオンにします

Markets のユーザーデータ

Shopify Markets をサポートするため、Braze は統合の標準イベントと属性に加えて、追加のデータを同期します。

ユーザープロファイル属性

注文イベントのプロパティ

これらのプロパティは次のイベントに追加されます。

• e コマースの推奨イベント: ecommerce.order_placed、ecommerce.order_cancelled、ecommerce.order_refunded
• カスタムイベント: shopify_paid_order、shopify_fulfilled_order、shopify_partially_fulfilled_order

マーケットイベントプロパティの仕組み

通貨

Shopify Markets のレポートが有効な場合、Shopify ネイティブのチェックアウト、注文、返金の Webhook イベントには 2 種類の値が含まれます。

• 既存の価格フィールドと合計フィールドには、ストアの通貨が変更されずにそのまま含まれます
• presentment_currency オブジェクトには、顧客が実際に目にして支払った金額が含まれます

これらのイベントには、country や market_handle などの関連するマーケットプロパティも含まれる場合があります。

注文確認やチェックアウトのリマインダーなど、顧客が支払った金額を顧客に表示する場合は presentment_currency を使用します。マーケット間で収益を比較する場合は、すでに単一通貨に揃っているストア通貨の値を使用します。

Shopify ピクセルからのカートイベントには presentment_current は含まれません。セグメント などの顧客データプラットフォームを通じて送信するカスタムのチェックアウトイベントや購入イベントにも含まれません。メッセージやレポートでマーケットの通貨を扱うには、カスタムイベントのペイロードに同等のオブジェクトを含めるか、必要なイベントタイプについて Shopify ネイティブのイベントを有効にしたままにしてください。

ローカライズされた商品情報

サポートされている Shopify イベントには、デフォルトのストア言語の商品タイトルとバリアントタイトルが含まれます。Braze はイベントのペイロードを翻訳しません。

翻訳されたタイトル、説明、商品 URL は、マーケットのカタログ行に格納されています。ローカライズされた商品情報をメッセージに表示するには、イベントの商品 ID またはバリアント ID を使用してカタログ内の商品を検索します。

ステップ 3: ユーザーを管理する

1. ドロップダウンから external_id のタイプを選択します。
2. Shopify からのメールと SMS のオプトインをオンにします。これにより、Braze は Shopify からメールと SMS の購読ステータスを同期できます。次の 2 つの方法があります。
   • 統合を使用する: Braze がメールと SMS のステータスを同期します。同期先の購読グループを選択します。
   • 独自に構築する: ステータス管理をより細かく制御するには、Braze の購読グループエンドポイントを使用してカスタム統合を構築します。
3. Shopify の同意を同期する購読グループを選択します。
   • ストア全体のグループ (必須): メールグループと SMS グループをそれぞれ 1 つ以上選択します。Braze が Shopify から受け取るすべてのオプトインがここに記録されます。
   • 国別グループ (オプション): 同期済みのマーケット内の任意の国に、1 つ以上のグループを割り当てます。Braze が顧客の国を判定できる場合、オプトインはここにも記録されます。

オプトインとオプトアウトの仕組み

Shopify では、各顧客がメールの同意ステータスと SMS の同意ステータスをそれぞれ 1 つずつ持っています。顧客がオプトインすると、国やリストではなく、ブランドを購読することになります。

Braze は各オプトインをストア全体のグループに記録します。国別グループを設定していて、Braze が顧客の国を判定できる場合は、そのオプトインがその国のグループにも記録されます。

国別グループを設定していない場合、オプトインはストア全体のグループにのみ記録されます。これは、現在の Shopify における同意の扱いと同じです。

Braze による国の判定方法

ロケールで国を特定できるのは、fr-FR のように地域が含まれている場合のみです。fr だけのロケールでは国を特定できません。

SMS の場合、国は電話番号から判定されます。買い物客は、その番号にメッセージを送信できる購読グループに追加されている必要があります。

オプトイン時の動作

購読グループのメンバーシップは、Shopify からの同意イベントに基づきます。買い物客の国やロケールが変わっても、グループのメンバーシップは変わりません。Braze がメンバーシップを更新するのは、国やロケールの変更後に Shopify で買い物客から改めて同意を取得した場合など、Shopify から新しい同意イベントが送信されたときだけです。

注

国別グループが管理するのは言語ではなく同意です。1 つの国に複数の言語が存在する場合があります。カナダの英語圏とフランス語圏の顧客 (en-CA と fr-CA) は同じ国別グループに属します。メッセージの言語を指定するには、メッセージ内で shopify_locale を使用してください。

オプトアウト時の動作

Shopify でオプトアウトすると、Shopify 統合に割り当てられているすべての購読グループからユーザーが削除されます。これは、マーケットサイトからオプトアウトした場合でも、Shopify のアカウントページからオプトアウトした場合でも同じです。

ワークスペース内の購読グループのうち、統合に割り当てられていないものは影響を受けません。

未設定の国からのオプトイン

設定済みのマーケットに含まれていない国の顧客がオプトインした場合 (その国を一度も追加していない場合も、そのマーケットを削除した場合も含みます)、顧客はストア全体のグループを購読します。国別グループには追加されません。

マーケットを設定しても、メッセージの送信対象が制限されるわけではありません。法的または規制上の理由でメッセージを送信できない国がある場合は、セグメントフィルターでそのユーザーを除外するか、別の購読グループに振り分けてください。

ヒント

そのセグメントは、サービスを提供していない国のブロックリストではなく、サービスを提供している国の許可リストとして作成してください。国を判定できなかったユーザーには国の値がないため、ブロックリストでは除外できません。

SMS の場合、配信は引き続き各購読グループの国の許可設定によって制御されます。グループで許可されていない国のユーザーは、そのグループからメッセージを受信しません。

後から国別グループにユーザーが追加されることはない

オプトイン時に Braze が顧客の国を判定できない場合、顧客はストア全体のグループにのみ追加されます。後で国が判明しても、その国のグループに自動的に追加されることはありません。

統合済みの既存ストアで Markets をオンにすると、既存の購読グループがストア全体のグループになります。既存の購読者はこれらのグループの購読を継続し、新しい国別グループには自動的に追加されません。

これらのユーザーを手動で追加するには、対象ユーザーのセグメントを作成し、キャンバスのユーザー更新ステップを使用して購読させます。

グループ全体の購読者数のカウント

1 回のオプトインで、ユーザーが複数の購読グループに追加される場合があります。そのため、グループの合計数を足し合わせると、同じ人が複数回カウントされます。ユニークな購読者数が必要な場合は、セグメントを使用してください。

仕組み

1. 顧客がチェックアウト時またはフォームから SMS を購読します。
2. Shopify が購読情報を Braze に送信します。
3. Braze がユーザーを保留中に設定し、確認用のテキストメッセージを送信します。
4. 顧客が確認キーワードで返信すると、購読済みになります。
5. 確認期間が終了するまでに返信がない場合、ユーザーは保留中のままになります。

詳細については、ダブルオプトインを参照してください。

ステップ 4: 商品を同期する

1. マーケット内の商品を同期するには、Shopify の商品とバリアントを Braze に同期を選択します。
2. Braze のカタログ ID を割り当て、その他の設定を構成します。

カタログには、ストアのデフォルト商品に対するマーケットごとのビューが含まれます。マーケットに公開されている商品ごとに、Braze は既存のカタログにマーケット行を追加します。これは、すでにサポートされている標準の Shopify カタログフィールドに加えて追加されるものです。既存の統合で Shopify Markets をオンにした場合、これらの同期に数分かかることがあります。

マーケット行では、次のフィールドにマーケット固有の値が設定されます。

重要

inventory_quantity はマーケット行には含まれません。デフォルト行にのみ表示され、すべての Shopify ロケーションにおける商品バリアントの利用可能な在庫の合計を反映します。

Liquid で compare_at_price を使用する場合は、表示したり割引額を計算したりする前に「0」かどうかを確認してください。比較価格のないマーケットでは、価格がゼロと表示されたり、割引額が正しく計算されなかったりします。

ステップ 5: チャネルを有効にする

1. (オプション) ブラウザー内メッセージを有効にするかどうかを選択します。
2. セットアップを完了を選択します。

Marketsのユーザーデータを使用する

これらの属性とプロパティがユーザープロファイルに登録されると、マーケット別にユーザーをターゲットにしたり、メッセージをパーソナライズしたりできます。

セグメンテーションでマーケット別にターゲットを設定する

セグメントや、キャンペーンまたはキャンバスのエントリ条件では、国、ブラウザーの言語、または shopify_locale でフィルターできます。たとえば、フランスのユーザーを対象にしたり、shopify_locale に基づいてキャンバスのパスを分岐させたりできます。

Shopify Marketのセグメントフィルターも使用できます。このフィルターは、買い物客の注文アクティビティに関連付けられたマーケットに基づいてターゲットを設定します。デフォルトのマーケットに関連付けられた買い物客だけにリーチするには、同期しているデフォルト以外の各マーケットのユーザーを除外するセグメントを作成します。たとえば、注文したことがあるすべてのユーザーのうち、マーケットがメキシコのユーザーを除外します。

マーケットハンドルによるカタログ商品のセレクション (デフォルトの商品行で market_handle が default の場合を含む) については、チュートリアル: マーケットごとに商品と価格を表示するを参照してください。

Liquidでトリガーとパーソナライズを行う

これらのLiquid変数を使用して、メッセージ内でマーケットのデータを参照します。

ユーザープロファイルから

注文イベントから

顧客の通貨で価格を表示する

金額には必ず通貨コードを組み合わせてください。金額だけを表示してしまうのは、複数マーケット向けのメッセージングで最もよくある間違いです。「129.95」が意味する内容はマーケットごとに異なるためです。

確認メールなどの注文レベルのメッセージには注文合計を、カートやレコメンデーションなどの商品レベルのコンテンツには商品価格を使用します。

1
2

Thanks for your order! Your total: {{event_properties.${metadata}.presentment_currency.code}}
{{event_properties.${metadata}.presentment_currency.<total field>}}

これらのプロパティはイベントとともに送信されるため、追加の設定なしで、各顧客のマーケットに合わせた正確なメッセージになります。

空の値を確認する

次の2つの値は常に存在するとは限らず、どちらも値がない場合は正しく表示されません。

market_handle は、顧客の国が設定済みのマーケットと一致しない場合に空になります。この値で分岐させる前に確認してください。

1
2
3

{% if event_properties.${market_handle} != blank %}
  ...
{% endif %}

compare_at_price は、そのマーケットで比較価格が決まらない場合に 0 を返します。表示したり割引を計算したりする前に 0 かどうかを確認してください。確認しないと、顧客にゼロの取り消し線価格が表示されます。

ローカライズされた商品情報を表示する

イベント内の商品名は、ストアのデフォルト言語で記載されています。翻訳されたタイトル、説明、または商品URLを表示するには、イベントの商品IDまたはバリアントIDを使用してカタログで商品を検索します。例については、チュートリアル: マーケットごとに商品と価格を表示するを参照してください。

注文アクティビティからメッセージをトリガーする

マーケットのプロパティはサポートされているShopifyイベントに含まれているため、注文によってトリガーされるキャンペーンやキャンバスでは、追加の設定なしでこれらを使用できます。これらのイベントには、country、presentment_currency、market_handle が含まれます。

presentment_currency はサポートされているチェックアウト、注文、返金の各イベントに含まれているため、チェックアウトのリマインダーや注文確認では、顧客に表示された金額を表示できます。カートイベントには presentment_currency、country、market_handle は含まれません。詳細については、通貨を参照してください。

Markets レポート

重要

既存の Shopify 顧客が Markets レポートを表示するには、ecommerce.order_placed の収益を使用する必要があります。新規顧客の場合、この機能はデフォルトで有効になっています。ご不明な点がある場合は、アカウントチームにお問い合わせください。

Markets が有効になっている場合、Braze は収益とメッセージのパフォーマンスを国別に分類します。

国別の収益

収益レポートには、ライフタイムと選択した期間の両方について、アプリ別の内訳とともに国別の内訳が含まれます。

各注文は1つの国に紐づけられ、その注文の収益全額がその国に計上されます。国はまず注文から選択され、次に買い物客のプロファイルから選択されます。どちらも利用できない注文は Unknown に表示されます。

収益は、収益レポートの他の部分と同じく USD で表示されます。買い物客が実際に支払った金額を確認するには、注文イベントの presentment_currency を使用してください。

国別のパフォーマンス

キャンペーンとキャンバスの分析には、各国でのメッセージのパフォーマンスと各国の合計行を示す Performance by country テーブルが含まれます。通貨と合計収益は、注文の presentment_currency から集計されます。

また、レポートビルダーで Countries (Shopify Markets) を行またはドリルダウンとして使用して、キャンペーンとキャンバスのパフォーマンスを国別に分類することもできます。

マーケットを削除する

マーケットを削除すると、Brazeはそのマーケットに含まれる国の新しいデータの同期を停止します。既存のデータは削除されません。

購読グループ

マーケットを削除すると、マーケット設定が更新されます。ワークスペースから購読グループが削除されたり、国別グループをすでに購読しているユーザーが削除されたりすることはありません。

設定で変わること

• 削除したマーケットの国は、マーケットのUIに表示されなくなります。
• Brazeは、それらの国の購読グループの割り当てを統合設定から削除します。

変わらないこと

• 国別の購読グループはワークスペースに残り、引き続きターゲティングに使用できます。ただし、Shopifyからそれらのグループにオプトアウトが同期されなくなります。Shopifyでオプトアウトしたユーザーは、購読グループエンドポイントやBrazeのオプトアウトワークフローなど、別の方法で購読ステータスを更新しない限り、それらの国別グループで購読中と表示される場合があります。
• 削除したマーケットの国別グループをすでに購読しているユーザーは、購読したままになります。

今後の同意の同期

• 削除した国の買い物客からの新しいオプトインは、設定していない国からのオプトインと同様に、ストア全体のグループにのみ同期されます。
• Brazeは、削除した国の国別グループに新しいオプトインやオプトアウトを同期しなくなります。
• ストア全体の購読グループは、引き続き同意の更新を受け取ります。

ユーザーデータ

• shopify_locale や country など、ユーザープロファイルにすでにある属性は変更されません。
• 新しい注文イベント内の market_handle は使用できなくなります。
• 削除したマーケットのShopifyマーケットのセグメントフィルターは使用できなくなります。
• 削除したマーケットを参照するLiquidは使用できなくなります。

カタログ

• そのマーケットのマーケット行は更新が停止され、カタログから削除されます。
• それらのマーケット行に基づいて作成されたカタログセレクションは、商品を返さなくなります。次回の送信前に、セレクションを更新または削除してください。
• デフォルトの行と、それに基づいて作成されたセレクションには影響しません。

チュートリアル：マーケットごとに商品と価格を表示する

マーケット対応のカタログを使用すると、1 つのメッセージで各ユーザーにそのユーザー自身のマーケットの商品と価格を表示できます。

1. マーケットデータを使用するセレクションを作成します。
2. Liquid を使用して、メッセージ内でセレクションを参照します。

メッセージが特定の 1 つのマーケットを対象とする場合は、固定のマーケットを使用することもできます。

ステップ 1: マーケットデータを使用してセレクションを作成する

セレクションは、メッセージ内で参照するキュレートされた商品セットです。マーケットが同期されている Shopify カタログでは、フィルター設定セクションにマーケット範囲エリアが含まれます。ここで、商品データを 1 つのマーケットに限定するか、ユーザーごとにパーソナライズするかを設定できます。

1. Shopify カタログに移動し、セレクションタブを開きます。
2. セレクションを作成を選択し、セレクションに名前を付け、必要に応じて説明を追加して、結果の上限を設定します。
3. フィルター設定のマーケット範囲で、マーケットドロップダウンからセレクションがマーケット固有の商品を解決する方法を選択します。
   • パーソナライズ: 各受信者には、プロファイルの country 属性に一致するマーケットの商品と価格が表示されます。
   • 同期済みのマーケット: マーケットを名前で選択すると、セレクションがそのマーケットの商品と価格に固定されます。メッセージが 1 つのマーケットのみを対象とする場合に使用します。
4. 追加のフィルター条件を設定し、セレクションを保存します。
5. ユーザーのプレビューでユーザーを選択すると、そのプロファイルに対してセレクションが返す内容を確認できます。パーソナライズを使用するセレクションは、ユーザーを選択した後にのみプレビューできます。

注

マーケットを指定しない場合、Braze はデフォルトの商品を使用します。

ステップ 2: マーケット対応のカタログセレクションをメッセージに追加する

1 つのメッセージですべてのユーザーにそれぞれのマーケットの商品を配信するには、次のフィルターを使用してセレクションを作成します。

送信時に、Braze は {{shopify_market.handle}} を各ユーザーのマーケットに置き換えるため、market_products によって全員に適切な商品が表示されます。default_products は、一致するマーケットがないユーザー向けのフォールバックです。

{% shopify_market %} タグを使用して、メッセージ内でセレクションを参照します。

1
2
3
4
5
6
7
8
9
10
11
12

{% shopify_market %}
{% if shopify_market.handle %}
  {% catalog_selection_items <your_catalog_name> <your_market-catalog_selection_name> %}
  {% for item in items %}
    {{ item.product_title }} — {{ item.price }}
  {% endfor %}
{% else %}
  {% catalog_selection_items <your_catalog_name> <your_default-catalog_selection_name> %}
  {% for item in items %}
    {{ item.product_title }} — {{ item.price }}
  {% endfor %}
{% endif %}

• {% shopify_market %} は {% catalog_selection_items %} の前に配置してください。これにより、セレクションの実行前にユーザーのマーケットが設定されます。
• <your_catalog_name> をご自身のカタログに置き換え、セレクション名が異なる場合はご自身のセレクション名を使用してください。
• {{shopify_market.handle}} のチェックにより、一致するマーケットがないユーザーは default_products に振り分けられるため、空のメッセージではなく商品を受け取ることができます。
• Liquid で compare_at_price を使用する場合は、表示や割引の計算を行う前に「0」かどうかを確認してください。比較価格がないマーケットでは、価格がゼロと表示されたり、誤った割引が算出されたりします。

対象のマーケットに属するユーザーとしてプレビューし、そのマーケットの商品、価格、翻訳されたタイトルがメッセージに表示されることを確認してください。