Shopify Markets

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

統合の仕組み

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

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

• マーケットに対応したプロファイル: 統合により、各ユーザーのShopifyロケールが、Brazeの標準の国属性および言語属性とともに取得されます。そのため、カスタム設定なしでマーケットごとにセグメント化やトリガー設定を行えます。
• ローカライズされたカタログ: 価格や通貨などのマーケット固有の商品データが、翻訳されたタイトル、説明、商品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で価格が変更された時点ではなく、毎日検出されます。
• 在庫復活: 在庫復活は、デフォルトのストアカタログ内の商品でサポートされています。マーケット行は在庫復活通知をトリガーしません。在庫復活では、すべてのShopifyロケーションにおける商品バリアントの利用可能な在庫の合計が参照されるため、小売店舗で追加された在庫によって通知がトリガーされる場合があります。

Shopify Markets の設定

すでに有効な Shopify 統合がある場合

Markets は現在の統合に追加されます。統合を切断したり、設定を作り直したりする必要はありません。

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

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

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

1. Shopify 標準統合またはShopify カスタム統合のいずれかの方法でストアを接続します。ストアの接続後、セットアップコンポーザーで Shopify Markets を設定します。
2. OAuth フローを完了し、OAuth で Braze がマーケットのスコープをリクエストしていることを確認します。
   • 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、WhatsApp のオプトインをオンにすると、Braze は Shopify からメール、SMS、WhatsApp の購読ステータスを同期できるようになります。次の2つのオプションがあります。
   • 統合を使用: Braze がメール、SMS、WhatsApp のステータスを同期します。同期先の購読グループを選択します。WhatsApp グループは、ワークスペースに接続済みの WhatsApp Businessアカウントがある場合にのみ利用できます。
   • 独自に構築: ステータス管理をより細かく制御するには、Braze の購読グループエンドポイントを使用してカスタム統合を構築します。
3. Shopify の同意を同期する購読グループを選択します。
   • ストア全体のグループ (必須): オンにする各チャネルについて、少なくとも1つのグループを選択します。Braze が Shopify から受け取るすべてのオプトインがここに記録されます。
   • 国別グループ (オプション): 同期済みマーケット内の任意の国に1つ以上のグループを割り当てます。Braze が顧客の国を判別できる場合、オプトインはここにも記録されます。

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

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

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

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

Braze による国の判別方法

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

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

オプトイン時の動作

購読グループのメンバーシップは、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 かどうかを確認してください。確認しないと、顧客に取り消し線付きの価格 0 が表示されてしまいます。

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

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

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

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

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

マーケットレポート

重要

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

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

国別の収益

収益レポートには、全期間と選択した期間の両方について、アプリ別の内訳に加えて国別の内訳が含まれます。

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

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

国別のパフォーマンス

キャンペーンとキャンバスの分析には、各国でのメッセージのパフォーマンスを示す国別のパフォーマンスの表が含まれます。各行は国と通貨の組み合わせを表します。通貨と総収益は、注文の presentment_currency に基づきます。

合計行では総購入数のみが合計されます。行ごとに異なる通貨が使われている場合があり、それらは合算されないため、合計行の総収益は空欄になります。

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

マーケットを削除する

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

購読グループ

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

設定で変わること

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

変わらないこと

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

今後の同意の同期

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

ユーザーデータ

• shopify_locale や country など、ユーザープロファイルにすでに存在する属性は変更されません。
• 新しい注文イベント内の market_handle は使用できなくなります。
• 削除したマーケットの Shopify Market セグメントフィルターは使用できなくなります。
• 削除したマーケットを参照する 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」かどうかをチェックしてください。比較価格がないマーケットでは、価格がゼロと表示されたり、誤った割引が算出されたりします。

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