ドキュメントメニュー

Shopify

Shopifyストアを接続すると、その顧客をMailInAppの連絡先リストに同期し、実際のストアイベントでジャーニーをトリガーし、収益をキャンペーンやバリアントに紐付けて確認できるようになります。

英語の動画です

ストアを接続する

ストアを接続するには、自分のShopify管理画面でそのストア用の小さなアプリを作成し、そのアプリの2つのキーをMailInAppに貼り付けます。所要時間は5分ほどです。Shopify Partnerアカウントもコードも不要で、アプリは自分のストア専用のまま公開されません。

Shopifyでストアのオーナー(またはアプリ開発を許可されたスタッフ)であり、かつMailInAppアカウントのオーナーである必要があります。

ステップ1: Dev Dashboardを開く

Shopify管理画面で設定 → アプリに進み、右上のDevelop appsをクリックします。

Shopify管理画面の設定 → アプリのページ。Develop appsボタンが強調表示されている

App developmentページでBuild apps in Dev Dashboardをクリックします。初回は、Shopifyがメールアドレスの確認と再ログインを求めたうえで、ストア名の開発者組織を作成します。Dev DashboardのStoresページに「No stores yet」と表示されても問題ありません。ストアがそこに表示されている必要はありません。

App developmentページ。Build apps in Dev Dashboardボタンが強調表示されている

ステップ2: アプリを作成する

Dev DashboardでAppsを開き、Create appをクリックし、Create app manuallyを選びます。すべて1つのフォームで設定します:

  • App name: 自分でわかる名前なら何でも構いません。例: MailInApp。
  • App URL: https://mailinapp.com/dashboard/settings/integrations。アプリをインストールするとShopifyがこのページを開くため、ストアのアドレスが入力済みの状態でMailInAppの接続フォームに移動します。
  • Embed app in Shopify admin: チェックを外します。このアプリにはShopify内のページがありません。
  • Scopes: read_customers,read_orders,read_products,write_discounts。これにより、MailInAppは顧客・注文・商品を読み取り、以下で説明する使い切りの割引コードを作成できます。MailInAppが商品・注文・顧客を変更することはありません。約60日より前の注文も取得するには、read_all_orders も追加してください。自分のアプリなら Shopify の承認は不要です。
  • Webhooks API version: デフォルトのままにします。

Create an appフォーム。App URL、チェックを外したEmbed app in Shopify adminボックス、スコープ、Create appボタンが強調表示されている

Create appをクリックします。最初のバージョンをリリースするよう求められるので、Releaseをクリックします。

Release versionダイアログ。Releaseボタンが強調表示されている

ステップ3: アプリをストアにインストールする

アプリのOverviewページで、InstallsカードのTest appをクリックし、ストアを選びます。

アプリのOverviewページ。Test appボタンが強調表示されている

Shopifyのインストール画面に、アプリが必要とするアクセスが表示されます。アプリが審査されていないという表示も出ますが、これは想定どおりです。このアプリは自分専用で、App Storeを経由しないためです。Installをクリックします。

ShopifyのInstall app画面。Installボタンが強調表示されている

これで、ストアの設定 → アプリにこのアプリが表示されます。

ステップ4: キーをMailInAppに貼り付ける

Dev DashboardでアプリのOverviewページに戻ると、CredentialsカードにClient IDとClient secretがあります。シークレットは非表示ですが、コピーボタンでコピーできます。

アプリのOverviewページのCredentialsカード。Client IDとClient secretの欄がある

MailInAppで設定 → 連携を開きます。Shopifyカードにストアのアドレス(your-store.myshopify.com)を入力し、Client IDとClient secretを貼り付けて、Shopifyを接続をクリックします。キーはストアのデータへのフルアクセスを与えるため、先に再ログインを求められることがあります。

設定 → 連携のShopifyカード。ストアのアドレスが入力され、「Shopifyを接続」ボタンが強調表示されています

MailInAppはShopifyでキーを確認し、Client secretを暗号化して、以後は二度と表示しません。続いてストア用の連絡先リストを作成し、バックグラウンドで顧客(この初回は最大5,000件。それ以降の顧客は作成され次第届きます)と商品カタログを同期します。

アプリの設定にあるIP allowlistはオフのままにしてください。オンにすると、ShopifyがMailInAppのリクエストを拒否します。

Shopifyの接続は、Freeを含むすべてのプランで無料です。MailInAppのプランは通常どおりMailInAppから、設定 → プラン & 使用量で請求されます。すべてのプランで商品カタログ全体が同期され、各プランにはストアの割引コードの月間の上限が含まれています。

接続に失敗した場合

Shopifyカードに原因が表示されます:

  • ShopifyがこのClient IDとClient secretを受け付けませんでした: Credentialsカードから両方をもう一度コピーしてください。新しいシークレットを生成した場合は、新しいほうを使います。
  • このストアにアプリがインストールされていません: ステップ3をやり直してください(Test app、続いてInstall)。
  • アプリに次のアクセススコープがありません: Dev DashboardでアプリのVersionsを開き、ステップ2のスコープで新しいバージョンを作成してリリースしてから、もう一度接続してください。
  • このアプリは別のShopify組織に属しています: 別のPartnerアカウントや開発者アカウントからではなく、ステップ1のとおり自分のストアの管理画面からアプリを作成してください。
  • Shopifyストアのアドレスではありません: 独自ドメインではなく、設定でストア名の下に表示されるmyshopify.comのアドレスを使ってください。

連携でできること

  • 顧客の同期 — Shopifyの顧客は、この連携専用の連絡先リストに入り、その後はShopify自身のWebhook(customers/create、および以下のトリガー用のcheckouts/createとorders/paid)によって最新の状態に保たれます。定期的な再ポーリングは行いません。
  • ジャーニーのトリガー — 接続済みのストアは、ジャーニーのカート放棄トリガー(チェックアウトを開始したが完了していない)と購入トリガー(注文が支払われた)を発火できるため、ウェルカムシリーズやカート放棄の自動化を、MailInApp自身の商品ブロックのチェックアウトだけでなく、実際のShopifyの活動に基づいて実行できます。ジャーニーを参照してください。
  • 収益の紐付け — 注文自身のキャンペーンやバリアントが特定できる場合、ネイティブチェックアウトの注文がすでに生成しているのと同じ回答およびA/Bテストの収益数値に取り込まれます。
  • 購入履歴セグメントと割引オファー — 注文の明細行が顧客と一緒に同期されるため、オーディエンスフィルターで「日付AからBの間に商品Xを購入した」といった条件にマッチさせられます(購入履歴を参照)。また、プロジェクトはマッチした受信者ごとに使い切りのShopify割引コードを発行でき、自分のストアのチェックアウトで引き換えられます(割引オファーを参照)。新しい注文はorders/paidWebhookから自動的に同期されます。接続前に行われた注文については、設定 → 連携から注文履歴をバックフィルを一度実行してください。Shopifyにより、対象はおおよそ直近60日分に制限されます。カタログからインポートした商品ブロックは、オーディエンスフィルターを必要とせずに、その商品だけに限定した独自の商品ごとの割引を個別に発行できます — ストアネイティブな割引とShopify商品割引コードを参照してください。
  • スタジオ向けの商品カタログ — ストア自身の公開中の商品一覧もMailInAppに同期され、顧客と同じ頻度で自動的に更新されます(専用ボタンは不要です)。商品ブロックのストアからインポートピッカーはこの同期済みカタログを検索し、実際の商品からブロックの名前・説明・画像・価格を入力します。これは一度だけのコピーであり、ライブで連動するリンクではないため、送信済みのメールが確認した内容から後でずれることはありません。各商品自身のページ(Shopifyのハンドルから生成)も同期され、利用可能な場合はブロックを外部ストアのチェックアウトへリンクに設定してそのページへ直接向けます。そのため、インポートした商品はこれ以上何も設定しなくてもShopifyストアで販売できる状態になります。代わりに接続済みのStripeアカウントで決済を受けたい場合は、手動でMailInAppチェックアウトに戻してください。

ストアのレビュー

Shopify 自体にはレビューが保存されないため、MailInApp はストアのレビューアプリ Judge.me からレビューを読み込みます。

  1. Judge.me で Settings → Integrations を開き、View API token をクリックします。プライベートトークンをコピーします。
  2. MailInApp で 設定 → 連携 を開きます。ストアのカードの Judge.me にトークンを貼り付け、Judge.me を接続 をクリックします。

MailInApp は Judge.me でトークンを確認してからレビューを同期し、その後もストアの同期のたびに同期します。保存するのはストアで公開されているレビュー(Judge.me で非表示や承認待ちでないもの)だけで、新しい順に最大 5,000 件です。Judge.me で非表示にしたり削除したりしたレビューは、次の同期で消えます。MailInApp はレビュー投稿者のメールアドレスを保存せず、名前は名と姓の頭文字で表示します。カードには同期済みのレビュー数が表示され、今すぐレビューを同期 ですぐに同期できます。

トークンはレビューの読み取りにだけ使われます。Judge.me の接続を解除 するとトークンと同期済みのレビューが削除されます。ストアの接続を解除した場合も同じです。読み込んだ商品の星評価にトークンは不要です。Judge.me が Shopify の各商品にすでに保存している評価を使います。星評価、メールの中のレビュー、公開についてはストアのレビューを参照してください。

接続状態とキーの更新

MailInAppはアプリのキーを使って短命のShopifyアクセストークン(有効期限は約1日)を取得し、期限が切れる前に自動で新しいトークンを取得します。通常の利用では何もする必要はありません。

キーが使えなくなった場合、MailInAppは同期を停止し、設定 → 連携のShopifyカードに対応が必要と表示して理由を示します:

  • Shopifyアプリのキーが使えなくなりました: シークレットが取り消されたか、アプリが削除されています。キーを更新をクリックし、アプリの現在のClient IDとClient secretを貼り付けてください。
  • Shopifyアプリがストアにインストールされていません: アプリがストアからアンインストールされています。アプリのOverviewページ(Test app)から再インストールしてください。キーは変わらないため、MailInAppは6時間以内に自動で再接続し、Webhookを設定し直します。すぐに再接続するには、キーを更新をクリックしてキーを貼り付けてください。

Client secretを変更する場合は(たとえば定期的なセキュリティ対策として)、ストアの接続が切れないように段階を踏んで行います:

  1. Dev DashboardでアプリのSettingsを開き、Generate new secretをクリックします。古いシークレットを取り消すまでは、両方のシークレットが有効です。
  2. MailInAppでShopifyカードのキーを更新をクリックし、新しいシークレットを貼り付けます。
  3. Dev Dashboardに戻り、古いシークレットを取り消します。

古いシークレットを取り消すまで、ShopifyはWebhookの署名に古いシークレットを使い続け、MailInAppはその間、どれだけ時間がかかってもどちらのシークレットも受け付けます。キーを更新では、ストアを自分の別のアプリに移すこともできます。そのアプリのClient IDとシークレットを貼り付けてください。

連携を解除する

設定 → 連携の接続を解除は、同期と以降のすべてのWebhook処理を即座に停止します。MailInAppはアプリから自身のWebhookを削除し、保存していたキーを消去します。その後、ストアからアプリをアンインストールしたり、Dev Dashboardでアプリを削除したりできます。

先に接続を解除せずにアプリをアンインストールした場合、ストアは一時停止するだけです。カードにはアプリがインストールされていないと表示され、再インストールすると中断したところから再開します。アプリがアンインストールされたまま30日経つと、MailInAppは保存していたキーを消去し、ストアの接続を解除します。接続を解除したストアをもう一度接続するには、Shopifyカードのフォームに入力してください。フォームはストアのアドレスから始まり、ストアの連絡先リストはそのまま残ります。

MailInAppがストアにすでに作成した割引コード(MIA-で始まります)は、アプリをアンインストールしたり接続を解除したりしてもShopifyに残り、有効期限まで使えます。送信済みメールのコードもそのまま使えます。Shopifyのアンインストール画面にはアプリの割引が削除されると表示されますが、これはアプリ自身が実行する割引のことで、MailInAppはその種類を作成しません。コードを早めに無効にするには、Shopify管理画面のDiscountsで削除してください。

すでに同期済みの顧客は連絡先リストに残ります。他のプロジェクトの送信オーディエンスとして既に使われている可能性があるため、連携を解除しても連絡先が削除されることはありません。不要になったリストはご自身で削除してください。

MailInAppは、あなたに代わってストアの顧客を保持しています。自分で作成したアプリは、Shopifyの顧客データ削除リクエストをMailInAppに転送しません。そのため、顧客からデータの削除を求められたら、MailInAppでもその顧客の連絡先プロフィールから消去してください(受信者 1 人分のデータをエクスポート・消去するを参照)。アンインストールの場合も同じです。Shopifyのアンインストール画面には、アプリの開発者に48時間以内の顧客データ削除が求められると表示されます。自分で作成したアプリの場合、その開発者はあなたです。ShopifyはこのリクエストをMailInAppに転送しないため、ストアの連絡先リストを残したくない場合はご自身で削除してください。