Skip to main content
この記事では、MoEngage Shopify 統合のインストール、設定、使用に関するよくある質問（セットアップ、ID、データ同期、カタログ、イベントトラッキング）にお答えします。

​
インストール

アカウント認証のトラブルシューティングについては、次の質問を確認してください。
新しく生成された API キーが有効になるまでには、最大 10 分かかります。キーを生成してから 10 分待ってから、Shopify アプリの認証を再試行してください。エラーが解決しない場合は、キーの先頭や末尾にスペースが含まれておらず、キー全体がコピーされていることを確認してください。
Shopify パブリックアプリをアンインストールすると、MoEngage はデータと設定の削除をスケジュールします。この処理が完了するまでに最大 48 時間かかる場合があります。この期間内にアプリを再インストールすると、Save Configuration ボタンが無効のままになり、設定が停止した状態になるため、Webhook のサブスクリプションが再作成されず、イベントが送信されません。これを解決するには、削除が完了するまで待ってから再インストールするか、次の手順で設定をリセットしてください。
  1. すべてのイベントと属性のチェックを外します。
  2. Save Configuration をクリックします。
  3. すべてのイベントと属性に再度チェックを入れます。
  4. もう一度 Save Configuration をクリックします。

​
ユーザー ID

ユーザープロファイルと識別子の管理については、次の質問を確認してください。
一意のユーザー識別子の設定では、MoEngage ダッシュボードで各ユーザーを識別するためのプライマリキーとして、携帯電話番号とメールアドレスのどちらを使用するかを決定します。同じユーザーが複数のデバイスからストアを訪問した場合、すべてのデバイスとブラウザーで同じ一意の識別子が存在すれば、MoEngage はそのアクティビティを 1 つのプロファイルに統合します。
デフォルトでは、Shopify はメールアドレスを使用してユーザーを識別します。適切な選択はビジネスによって異なります。顧客がチェックアウト時に提供する可能性が最も高い識別子で、かつ他のシステムでのユーザー識別方法と一致するものを使用してください。すでに MoEngage を使用している場合は、現在使用しているものと同じ一意の識別子を選択してください。メールアドレスも携帯電話番号も現在の設定と一致しない場合は、サポートチームまたはアカウントエグゼクティブにお問い合わせください。
いいえ、現在この設定は携帯電話番号またはメールアドレスに限定されています。インストール時にいずれかを選択する必要があります。
インストール後の選択は変更できませんセットアップ時に選択した識別子は、ワークスペースに恒久的に適用されます。後で識別子を変更する場合は、統合を再インストールする必要があり、既存のすべてのユーザープロファイルに影響します。チェックアウト時に顧客が最も確実に提供する識別子を選択してください。
個々の識別子設定のレベルではできません。インストール時にいずれかを選択する必要があります。ただし、ワークスペースで Identity Resolution を有効にすると、MoEngage は複数の識別子を使用して同じユーザーを同時に認識します。詳細については、以下の Identity Resolution セクションを参照してください。
携帯電話番号を UID として選択する前に、Shopify ストアで次の変更を行う必要があります。
  • Shopify のチェックアウトフローでは、デフォルトで携帯電話番号を収集しません。インストール前に、ストアのチェックアウト設定からこれを有効にしてください。
  • デフォルトのユーザー登録およびログインフローでも携帯電話番号は収集されません。これらのタッチポイントでユーザーの携帯電話番号を取得するために、カスタムのログインおよび登録フローを実装してください。
本番稼働前にこれらの変更を行わないと、携帯電話番号を提供していないユーザーに MoEngage が UID を割り当てられないため、匿名プロファイルが大量に発生します。
いいえ。配送先の携帯電話番号を UID として使用すると、データの破損が発生します。1 人のユーザーが異なる配送先の携帯電話番号で複数の注文を行うことができ、それぞれが MoEngage で個別のプロファイルを作成するため、シングルカスタマービューが崩れ、アトリビューションエラーの原因となります。たとえば、ユーザー Bob が配送番号 SM1 で注文すると、MoEngage は UID SM1 のプロファイルを作成します。次に Bob が配送番号 SM2 で別の注文をすると、MoEngage は UID SM2 の 2 つ目のプロファイルを作成します。Shopify では 2 件の注文を持つ 1 人のユーザーとして表示されますが、MoEngage ではそれぞれ 1 件の注文を持つ 2 人のユーザーとして表示されます。SM1 は「Add to Cart」の条件を満たしますが「Order Placed」の条件は満たさないため、カート放棄キャンペーンが誤って配信されます。このような誤ったコミュニケーションやデータの不一致を避けるため、配送先の携帯電話番号を UID として使用しないでください。
MoEngage は、UID の値が一致する場合にのみプロファイルを統合します。同じユーザーが複数のデバイスからストアを訪問しても、各タッチポイントで UID 属性を提供しない場合、MoEngage はそれらのセッションを統合できず、それぞれに個別のプロファイルを作成します。たとえば、メールアドレスが UID として設定されており、ユーザーが異なるデバイスから 2 件の注文を行い、どちらのチェックアウトでもメールアドレスを入力せずに携帯電話番号のみを使用した場合、MoEngage には同じ携帯電話番号を持つ 2 つの個別のプロファイルが表示されますが、統合をトリガーする一致する UID はありません。
これは、トラッキングイベントの発生時に、ユーザーの Shopify プロファイルに携帯電話番号が存在しない場合に発生します。MoEngage は選択された UID を見つけられない場合、次に利用可能な識別子にフォールバックすることがあります。最も一般的な原因は、顧客が電話番号を入力せずにチェックアウトを完了することです。これを一貫して解決するには、カスタマーサクセスマネージャーに連絡するか、Identity Resolution の有効化を依頼するサポートチケットを作成してください。Identity Resolution を有効にすると、MoEngage は複数の識別子で同時にユーザーをトラッキングするため、このフォールバック動作を防止できます。
ユーザーが識別データなしで（メールアドレスや電話番号がない状態で）カートに商品を追加すると、MoEngage はカート放棄イベントのデータを保持するために、Shopify のカートトークンを一時的な識別子として使用します。カートトークンのプロファイルが大量に表示される場合は、Identity Resolution が推奨される解決策です。有効にすると、ユーザーがメールアドレスまたは電話番号を提供した時点で、MoEngage はこれらの匿名プロファイルを識別済みプロファイルと統合できます。有効化を依頼するには、カスタマーサクセスマネージャーに連絡するか、サポートチケットを作成してください。

​
Identity Resolution

複数のソースからのユーザープロファイルを統合する方法については、次の質問を確認してください。
Identity Resolution は、複数のソースからのユーザープロファイルを 1 つの統合プロファイルにリンクする MoEngage の機能です。有効にすると、MoEngage はすべてのタッチポイントで単一の値に依存するのではなく、複数の識別子（たとえばメールアドレスと携帯電話番号の両方）を使用して同じユーザーを認識できます。ワークスペースごとに最大 5 つの識別子を設定できます。Identity Resolution を使用しない場合、各ユーザーは単一の識別子でトラッキングされます。その識別子がない場合、MoEngage は個別の匿名プロファイルを作成します。Identity Resolution は、重複プロファイルを防止し、ゲストチェックアウトによる ID の欠落を解消し、ユーザーベース全体でキャンペーントリガーが正しく実行されるようにします。
Identity Resolution を設定するには、事前に MoEngage チームによる有効化が必要です。Shopify アプリや MoEngage ダッシュボードから有効にすることはできません。有効化を依頼するには、カスタマーサクセスマネージャーに連絡するか、サポートチケットを作成してください。有効化されたら、MoEngage ダッシュボードで Settings > Data > Identity Resolution に移動し、識別子と統合ルールを設定します。
いいえ。プロファイルの統合は元に戻せません。2 つのプロファイルが統合されると、分離することはできません。
有効化する前に確認してくださいIdentity Resolution を有効にする前に、識別子の設定と統合ルールを慎重に確認してください。有効化の前に、サポートチームに統合レポートを依頼できます。このレポートには、すべてのユーザー統合アクションが記録されます。

​
ユーザーと注文のバックフィル

ストアの過去データを同期する方法については、次の質問を確認してください。
過去データの同期では、次の 2 種類のデータを MoEngage に取り込みます。
  • ユーザープロファイル: 同期を実行した時点で Shopify ストアに存在するすべての登録ユーザー（ユーザーの作成日時は問いません）。
  • 注文データ: 選択した期間中に行われた注文。個別の Shopify—Order Placed イベントとして取り込まれます。各イベントには、Shopify の元の注文日がタイムスタンプとして付与されます。
一般的な原因は 2 つあります。
  • ユーザープロファイルに UID が存在しない: UID として携帯電話番号を選択し、Shopify 上の既存のユーザープロファイルの一部に携帯電話番号がない場合、それらのユーザーとその注文データは自動的に同期できません。手動アップロードを手配するには、サポートチームにお問い合わせください。
  • イベント保持期間が同期期間より短い: MoEngage のイベント保持ポリシーが同期しようとしている期間より短い場合、同期は部分的なものになります。まず Shopify—Order Placed イベントの保持期間を延長してから、同期を再試行する必要があります。
60 日を超えて同期する前にイベント保持期間を設定してください同期を開始する前に、カスタマーサクセスマネージャーまたはサポートに連絡して、イベント保持期間を延長してください。これは、すでに実行された同期に遡って適用することはできません。
過去 60 日間の標準的な同期は、通常 24 時間以内に完了します。2 年間の拡張同期には、最大 48 時間かかる場合があります。同期が正しく完了したことを確認するには、開始後少なくとも数時間待ってから、同期期間内に注文したことがわかっているユーザーのプロファイルを MoEngage で開きます。Shopify—Order Placed イベントが正しい元の注文日で表示されていることを確認してください。
同期を実行する前に、次の 2 点を確認してください。
  • MoEngage アカウントに既存の重複データがないことを確認します。ユーザーデータとイベントデータがすでに存在する場合、同期によって重複が作成され、データの破損が発生します。
  • アプリのインストール日より前の期間を使用します。インストール後は、MoEngage が Webhook を介して新しい注文データを自動的にトラッキングするため、アカウントにすでに存在しているはずです。
ワークスペースのイベント保持期間より長い同期期間をリクエストした場合、MoEngage は保持期間内に含まれる注文のみを同期します。システムが Shopify から正常に取得した場合でも、MoEngage はその期間外の注文を保存しません。
60 日を超えて同期する前にイベント保持期間を設定してください同期を開始する前に、カスタマーサクセスマネージャーまたは MoEngage サポートチームに連絡して、イベント保持期間を延長してください。この変更は、すでに実行された同期に遡って適用することはできません。

​
カタログ同期

商品カタログを同期する方法については、次の質問を確認してください。
MoEngage は Shopify の商品カタログ全体を取得し、新しい MoEngage カタログに同期します。このカタログは、アプリ設定でカタログ同期を有効にすると自動的に作成されます。その後、このカタログは商品レコメンデーションブロック、メッセージ内の動的コンテンツ、セグメンテーションフィルターのデータソースとして利用できるようになります。
Basic Recommendations を有効にするカタログ同期により商品データが MoEngage で利用可能になりますが、パーソナライズや商品レコメンデーションに使用するには、アカウントで Basic Recommendations を有効にする必要があります。
最初の同期が完了した後、MoEngage はカタログをリアルタイムで最新の状態に保ちます。Shopify で行われた価格変更、フラッシュセール、在庫の更新は、スケジュールされた更新を待たずに MoEngage に反映されます。
リアルタイムのカタログ同期はアーリーアクセスで提供されています。
MoEngage は、Shopify のステータスが Active の商品のみを同期します。商品のステータスが Active から他の値に変更されると、MoEngage はその商品をカタログから削除します。
カタログのスキーマは、Sync product catalog タブでご自身で定義します。MoEngage は、Variation ID、Product ID、Link、Image Link、Vendor Name、SKU、Variation Title、Currency、Price、Quantity、Description、Created At、Updated At を含むデフォルトのマッピングを事前入力します。事前入力された属性のデータ型や Shopify のソースを変更したり、不要な属性を削除したり、Shopify のメタフィールドを含む独自の属性をマッピングしたりできます。詳細については、商品カタログの同期を参照してください。
一般的な原因は 3 つあります。
  • カタログフィールドのデータ型が商品間で一貫していない。たとえば、バリアント名フィールドが一部の商品では文字列、他の商品では数値の場合、MoEngage はフィールドの型が一致しない商品を拒否します。同期はエラーなしで完了しますが、それらの商品は通知なしに除外されます。
  • 商品が Shopify で Active になっていない。MoEngage は Active の商品のみを同期します。
  • 一意として指定した属性が、複数のアイテムで同じ値を持っている。MoEngage はそれらのアイテムを 1 つとして扱い、その識別子について最後に受信した値のみを保持するため、先のアイテムは表示されません。
これを診断するには、MoEngage の商品総数と Shopify のアクティブな商品数を比較します。表示される商品が大幅に少ない場合は、Shopify の商品データで、データ型が混在しているフィールド（特にバリアント名、SKU、価格）を確認してください。不整合を修正し、同期を再度トリガーします。
最初の同期をリクエストする前に、Sync product catalog タブで属性を追加します。Add custom attributes で名前を入力し、データ型を選択して Add attribute をクリックし、Shopify のソースにマッピングします。Shopify のメタフィールドをソースとして使用できます。
新しいカスタム属性はいつでも追加でき、MoEngage は次回の同期でそれらを含めます。テーブルにすでに存在する属性、そのデータ型、Shopify のソース、一意の識別子、カタログの通貨は、最初の同期が正常に完了すると固定されます。最初の同期をリクエストする前に、マッピングを確認してください。

​
イベントトラッキング

自動イベントを監視する方法については、次の質問を確認してください。
アプリの設定に基づいて、MoEngage は有効にしたイベントを自動的にトラッキングします。イベントは、MoEngage Web SDK（Product Viewed や Add to Cart などのブラウザー側のアクション）と Shopify Webhook（Order Placed や Order Fulfilled などのサーバー側のシグナル）の組み合わせによってキャプチャされます。
キャンペーンで使用するイベントバージョンAdd to Cart や Checkout Started など、Web SDK と Shopify Webhook の両方でトラッキングされるイベントについては、セグメントの作成やキャンペーンのトリガーには常に Webhook バージョンを使用してください。Webhook イベントは Shopify のバックエンドから直接受信されるため、より信頼性の高いシグナルです。1 つのキャンペーンで同じイベントの両方のバージョンを使用すると、競合が発生します。
不一致にはいくつかの原因があることが多いです。
  • MoEngage の件数が少ない場合: Shopify の Webhook 配信は保証されていません。Webhook リクエストが失われることがあります。
  • MoEngage の件数が多い場合: Shopify は同じ注文に対して重複した Webhook イベントを送信することがあります。MoEngage は重複排除を適用しますが、一部の重複がトラッキングされる場合があります。
各プラットフォームは異なるカウント方法を使用しているため、他の分析ツールとの差異は想定されるものです。MoEngage データの信頼できる情報源は Shopify です。
Shopify は、Add to Cart をカートの作成につながったセッション数としてカウントします。MoEngage は、Add to Cart イベントが発火した回数をカウントし、これには 1 つのセッション内での複数回の追加が含まれます。キャンペーンのトリガーには MoEngage の件数を、コンバージョンファネルのベンチマークには Shopify の件数を使用してください。
商品 URL と画像 URL は Shopify の Webhook ペイロードに含まれていないため、Shopify — Add to Cart、Shopify — Checkout Started、Shopify — Order Placed などの Webhook ベースのイベントには含まれません。キャンペーンのパーソナライズで商品画像や URL を使用するには、送信時にカタログによるエンリッチメントを使用します。商品カタログの同期を設定し、メッセージテンプレートでカタログ属性を参照してください。または、カスタム SDK イベントを使用してこれらの属性を直接トラッキングすることもできます。
フルフィルメントイベント（Order Delivered、Out for Delivery）は、デフォルトですべてのユーザーが利用できます。これらのイベントをトラッキングするには、インストール済みの MoEngage Shopify アプリでこれらのイベントのトラッキングを許可する必要があります。
Web SDK ベースのイベントはすべて、Shopify のデフォルトテーマで自動的にトラッキングされます。ストアでカスタムテーマを使用している場合や、デフォルトテーマをカスタマイズしている場合、そのカスタマイズにより、それらのページやストアでデフォルトの Web SDK イベントの自動トラッキングが妨げられることがあります。これらのイベントをトラッキングするには追加のカスタムイベントトラッキングが必要です。または、引き続き Webhook ベースの代替イベントを使用することもできます。
Shopify 顧客メタフィールドは、デフォルトではユーザープロファイルに同期されず、イベント属性にも表示されません。メタフィールドのデータを MoEngage に渡すには、Shopify でメタフィールドを設定します。
  • パブリックストアフロントアクセスあり: メタフィールドでパブリックストアフロントアクセスが有効になっている場合は、Shopify Liquid でサーバーサイドで読み取り、テーマ内でユーザー属性の呼び出しを使用して MoEngage に渡します。
  • ストアフロントアクセスなし: サードパーティアプリがメタフィールドを作成した場合は、サーバーサイドの統合が必要です。Shopify の customers/update Webhook をサブスクライブし、Shopify Admin API を使用してメタフィールドの値を読み取り、MoEngage Data API を呼び出してユーザー属性を更新します。
実装の詳細について両方の方法の手順と Liquid のコード例については、イベントとユーザーデータのトラッキングの記事の「Shopify 顧客メタフィールド」セクションを参照してください。
チェックアウト前のイベントについては、ブラウザーに MoEngage の Chrome プラグインを追加してから、イベントを再度実行します。プラグインでイベントがトラッキング済みと表示される場合は、トラッキングは機能しています。正しいユーザープロファイルを確認しているかどうかを確認してください。チェックアウトおよびチェックアウト後のイベントについては、アプリ設定でイベントの自動トラッキングが有効になっていることを確認してください。注文 ID、メールアドレス、または携帯電話番号でイベント属性をフィルタリングして、イベントが別のプロファイルに対してトラッキングされていないかを確認します。
まず、MoEngage Chrome プラグインを使用して、ストアで MoEngage SDK が読み込まれているかどうかを確認します。SDK が検出されない場合は、次の操作を行います。
  • Shopify 管理画面に移動し、MoEngage のアプリ埋め込み設定を開いて、アプリ埋め込みブロックの保存を解除してから再保存します。これにより SDK の挿入が再トリガーされます。
  • それでも SDK が読み込まれない場合は、ブラウザーのコンソールでページ上の JavaScript エラーを確認してください。
SDK が正しく読み込まれているのにイベントが送信されない場合は、次の手順を実行します。
  1. MoEngage Shopify アプリでイベントトラッキングの設定を開きます。
  2. いくつかのイベントのチェックを外して保存し、その後すべてのイベントに再度チェックを入れて保存します。
  3. 5 分待ってから、ストアでイベントを実行します。

​
複数のストアを 1 つの MoEngage アカウントにリンクする

複数のストアフロントをリンクする際の設定と制限については、次の質問を確認してください。
はい、可能ですが、MoEngage ではこの方法を推奨していません。複数のストアをリンクする場合は、異なるストアのインストール時に同じ認証キーを使用して、同じ MoEngage アカウントにリンクします。続行する前に、次の影響を確認してください。
  • Web Push
    • 同じユーザーに対して、ストアごとに個別の Web プッシュ許可が求められます。
    • 複数のストアで Web プッシュをサブスクライブしたユーザーは、キャンペーンの対象が特定のストアに限定されていない場合、重複した通知を受け取ります。
  • OSM（On-site Messaging）
    • キャンペーンごとにターゲット URL を指定してください。指定しない場合、複数のストアを訪問するユーザーを含め、すべてのストアで同じキャンペーンが表示されます。
  • データとプロファイル
    • シングルカスタマービューを維持するために、すべてのストアで同じユーザー識別子を使用してください。ストアごとに異なる識別子を使用すると、同じユーザーに対して複数のプロファイルが作成されます。
  • セグメンテーション
    • セグメントを作成する際に各ストアのイベントを区別できるよう、イベント属性で URL またはストア ID のフィルターを使用して各ストアのイベントを識別してください。