ヘルプ・よくある質問

ポイントをチェックアウトで利用するには、Shopifyの「新しいお客様アカウント」への切り替えと、ポイントの土台になるShopifyの「ストアクレジット」機能の有効化が必要です。これはPointia独自の制約ではなく、Shopify側の仕組みによる要件です。どちらもShopifyの管理画面で設定でき、アプリ内のセットアップガイドが順番にご案内します。

オンラインストアの表示（ポイント残高・獲得予定ポイント・会員登録の誘導）は、テーマエディターから配置できるアプリブロックとして提供しています。そのためOnline Store 2.0に対応したテーマであれば、コードを編集せずに設置できます。制作会社が組んだ独自テーマなど、アプリブロックを差し込めないテーマ向けには、コピー＆ペーストで設置できるLiquidスニペットもご用意しています。 なお、ポイントの付与・利用そのものはテーマに依存しません。表示を設置しなくても、ポイントは貯まり、チェックアウトで使えます。

プランによる制限はありません。ポイントの土台になるShopifyの「ストアクレジット」機能は、どのストアでも既定で使えるようになっています。条件になるのはプランではなく「新しいお客様アカウント」を使っていることで、従来のクラシックカスタマーアカウントでは利用できません。 ただし、顧客のマイページにポイント残高や会員ランクを表示する機能は、Shopifyのお客様アカウントを拡張する仕組みを使うため、Basicプラン以上が対象です。

基本的には不要です。インストールすると、案内に沿って進めるだけのセットアップガイドが表示され、順番に設定していくだけで運用を始められます。標準的なテーマであればコード編集は発生しません。 独自テーマへの表示の組み込みや、他システムからのポイント移行を伴う場合のみ、追加の作業が必要になります。お気軽にご相談ください。

はい、試せます。ポイントの付与から利用、会員ランクの判定、顧客のマイページへの表示、通知メールまで、開発ストアで一通りご確認いただけます。 開発ストアでは、決済方法を登録しなくてもStarterプランをそのままご契約いただけます。またShopifyで作成したテスト注文は月間注文数に数えません。本番と同じ動きを、費用をかけずに検証していただけます。

はい。Shopifyのテストモード（Bogus Gatewayなど）で作成した注文も、本番の注文と同じように処理します。ポイントの付与から会員ランクの判定、顧客向けの表示、通知メールまで、ひととおり確認していただけます。 テスト注文は月間注文数のカウントと従量課金には含めないので、動作確認をしても料金は増えません。確認後に不要なポイントを消したい場合は、Shopify管理画面の顧客ページからストアクレジットを手動で削除してください。

Shopify管理画面の顧客ページから新しいお客様を作成してください。新規のお客様として一連の動きを確認したい場合は、「プラスアドレス」と呼ばれるメールアドレスの書き方が便利です。@の前に「+test1」のように付け加えたアドレスはご自身の受信箱に届きますが、Shopifyはメールアドレスでお客様を識別するため、別のお客様として扱われます（例：yamada+test1@example.com）。受信箱を増やさずに、会員登録のクーポン、ランクアップの通知、ポイントの失効予告など、お客様に届くメールをそのままご確認いただけます。 この書き方はGmail・Outlook.com・Microsoft 365・iCloudメールなどで使えます。ただしメールの規格上は任意の機能とされており、すべてのメールサービスが対応しているわけではありません（Yahoo!メールのように、別方式のエイリアス機能を提供しているサービスもあります）。ご自身宛てにテスト送信して届かない場合は、別のメールアドレスをご用意ください。 会員ランクの動きを検証される場合は、この方法で新しいお客様を作るか、まだ最上位に達していない既存のお客様で試すことをおすすめします。手動でのランク設定を使って検証しようとすると、期限を短くしても、期限が切れたあとの判定で自動的に元のランクへ戻ってしまうためです。

はい。Shopify Marketsで外貨決済されたご注文では、顧客が支払った通貨でポイントを付与します。Shopifyのストアクレジットは「決済通貨と一致する残高しか使えない」仕様のため、外貨で購入された顧客に日本円で付与すると、その残高を使えなくなってしまうからです。 一方、会員ランクの判定はストアの基準通貨（日本円）に換算して行います。通貨をまたいで購入される顧客も、同じ基準で判定されます。顧客のマイページでは、保有している通貨ごとに残高を表示します。 なお、外貨でポイントを保有している顧客には、マイページで「次のランクまであと◯◯円」といった日本円の金額は表示せず、進捗バーと次のランク名でご案内します。外貨で買われた顧客にとって日本円の金額は直感的でないためです。

同時にインストールして動かすこと自体はできますが、移行期間の一時的な措置とお考えください。 両方のアプリが同じご注文を見てポイントを付けるため、そのままでは二重に付与されます。移行期間は、どちらか一方の付与を止めて「貯まるのは新しい方だけ、古い方は使い切っていただくだけ」という状態にするのが現実的です。また顧客から見ると残高の表示が2か所に出ることになるため、期間はできるだけ短く区切ることをおすすめします。 移行の進め方はストアの状況によって変わりますので、お気軽にご相談ください。

いいえ。Pointia専用の会員登録は、顧客もストアも必要ありません。顧客はShopifyのお客様アカウントにログインするだけで、ポイントや会員ランクをご利用いただけます。新しいIDやパスワードを別に作る必要がないため、顧客も使い始めやすく、導入のハードルも下がります。

料金は、ストアの月間注文数に応じたプラン制です（注文が多いほど上位プラン）。Starterプランがあり、期間の区切りなくずっと基本料金無料でお使いいただけます。 有料プラン（Basic / Pro / Scale）は月額制で、月の途中からでも始められ、いつでも変更・解約できます。初めてご契約いただくときに限り、14日間の無料体験が付きます（無料になるのは月額の基本料金です）。

はい。有料プラン（Basic / Pro / Scale）を初めてご契約いただくときに限り、14日間の無料体験をご用意しています。期間中はそのプランの機能をそのままお使いいただけます。 無料になるのは月額の基本料金です。体験期間中でも、プランに含まれる月間注文数を超えたご注文には従量課金が発生しますので、ご注文の多いストアではご注意ください。含まれる注文数の範囲でお試しいただくかぎり、費用はかかりません。 体験期間が終わると、同じプランのまま自動で課金が始まります。プランが勝手に上位へ切り替わることはありません。費用をかけずに終えたい場合は、期間中にStarterプランへ変更してください。このとき、残りの日数を取っておくことはできません。体験期間は最初にご契約いただいた日から数えた14日間で、途中で止めても日数は進みます。 無料体験が付くのは初回の1回だけです。いちど有料プランをご契約いただいたあとのプラン変更では付きません。なおStarterプランは基本料金が無料のプランなので、体験の対象ではありません（期間の区切りなくお使いいただけます）。

残りの体験日数が、変更後のプランにそのまま引き継がれます。たとえばProで始めて5日目にBasicへ変更した場合、Basicのまま残り9日間の体験を続けていただけます。体験期間は最初にご契約いただいた日から数えた14日間で、プランを変更しても延びることも、リセットされることもありません。 体験期間中は月額の基本料金が発生していないため、上位プランから下位プランへ変更しても、返金や日割りの精算は生じません。 ご注意いただきたいのは月間注文数の数え方です。プランを変更しても、その月にすでに数えたご注文の件数は引き継がれます。たとえばPro（月2,000注文まで）で700件を数えた月の途中でBasic（月500注文まで）へ変更すると、その後のご注文は1件目から従量課金の対象になります。ただし、すでに数えた700件にさかのぼって請求されることはありません。

お支払いが完了したご注文を1件として数えます。ポイントが付いたかどうかとは別に数えるため、ゲスト（会員登録なし）のご注文はポイントが付かなくても注文数に含まれ、キャンセル・返金したご注文も支払い完了の時点で数えているため後から件数は戻りません。 一方、Shopifyのテストモードで作成したテスト注文は含まれません。動作確認をしても料金は増えません。また、同じご注文が二重に数えられることはありません。

はい。Starterプラン（月100注文まで）でもポイントの付与・利用は制限なくお使いいただけます。 ただし会員ランクは2段階まで、クーポンの自動発行・失効通知メール・会員の手動管理はBasicプラン以上の機能です。StarterプランではオンラインストアにPointiaのロゴが表示されます。100注文を超えても顧客へのポイント付与は止まらず、超過分が従量課金になります。

機能は止まりません。顧客へのポイント付与も会員ランクの判定も、これまでどおり続きます。 上限を超えた分は1注文あたりの従量課金になります（Starterは$0.20、Basicは$0.15、Proは$0.10、Scaleは$0.05）。「上限を超えたのでポイントが付かなくなった」という状態にはならないので、キャンペーンでご注文が急増しても、顧客に不利益は生じません。上限の80%に達した時点で管理画面にお知らせが出ます。 無料体験の期間中も同じです。無料になるのは月額の基本料金なので、上限を超えたご注文には体験中でも従量課金が発生します。

自動では変わりません。プランの変更はストア運営者ご自身で行っていただきます。勝手に上位プランへ切り替わって請求額が増える、ということはありません。 ただし有料プランの無料体験だけは例外で、14日間が終わると同じプランのまま自動で課金が始まります（このときもプランが上位に変わるわけではありません）。 管理画面の課金ページには、今月のご注文数と「あと何件でひとつ上のプランの方が安くなるか」という目安を表示しています。従量課金が積み上がってきたら、この目安を見て切り替えをご判断ください。

Shopifyの課金の仕組みを利用しているため、Shopifyからの請求にまとめて計上されます。Pointiaに直接クレジットカードを登録していただく必要はありません。 金額は米ドル建てで、実際の請求はShopify側で換算されます。請求のタイミングと内訳は、Shopify管理画面からご確認いただけます。

従量課金の上限額です。Shopifyの仕組み上、従量課金のあるアプリは「1か月にこの金額までは請求してよい」という上限を承認していただく必要があり、その承認画面に表示される金額です。 「毎月この金額を請求します」という意味ではありません。実際の請求は、基本料金と実際に発生した超過分の合計です。想定外の請求が発生しないための歯止めとお考えください。

従量課金は止まります。ポイント機能を停止すると注文の処理そのものを行わなくなるため、注文数のカウントも進みません。 一方、プランの基本料金は契約が続くかぎり発生します。基本料金も止めたい場合は、プランをStarterに変更するか、アプリをアンインストールしてください。

設定画面からご自身で行っていただける過去注文の取り込みは、追加料金なくお使いいただけます。 他のポイントアプリからの残高の引き継ぎなど、個別の調整が必要なケースは有償の移行サポートとなる場合がございます。ストアの状況をうかがったうえで金額をご提示し、ご承認いただいてから作業に着手します。請求はShopifyの一回課金として行われ、月額プランとは別建てです。

顧客がお買い物をされると、お支払い金額に応じてポイントが自動でたまります。付与のタイミングは、Shopify上でご注文が「支払い完了」になった時点です。 顧客がご自分でポイントを申請したり、難しい操作をしたりする必要はありません。ストア運営者側でも、日々の操作は不要です。

税抜の商品代金に対して付与します。送料と消費税は対象外です。 消費税を対象から外しているのは、国に納める税額にポイントを付けると、その分がそのままストアの負担になるためです。日本の主要なポイントサービスも、2022年以降は税抜基準に揃っています。

割引後の金額が対象です。10,000円の商品を1,000円のクーポンでご購入いただいた場合、9,000円（から消費税を除いた額）に対してポイントが付きます。実際にお支払いいただいた金額を基準にする、という考え方です。

いいえ。ポイントでお支払いいただいた金額は、付与の対象から差し引きます。 たとえば10,000円のご注文のうち3,000円をポイントでお支払いいただいた場合、残りの7,000円分（から消費税を除いた額）に対してポイントが付きます。ポイントで払った分にポイントを付けると、ポイントがポイントを生み続けてしまうためです。

いいえ。ポイントは顧客のアカウントに紐づけて保管されるため、アカウントをお持ちでないゲストのご注文には付与できません。これはPointiaの制限ではなく、ポイントの実体であるストアクレジットの仕組みによるものです。 日本のECではゲスト購入の比率が高いストアも多いため、「会員登録するとポイントが貯まります」という誘導バナーをオンラインストアに表示できるようにしています。なお、ゲストでご購入いただいた顧客に、後からさかのぼって付与することはできません。

決済方法による違いはありません。いずれもShopify上でご注文が「支払い完了」になった時点で付与されます。 そのため、コンビニ後払いや代引きのように入金の確認が後になる決済では、入金が確認されたタイミングでの付与になります。ご注文いただいた瞬間ではないので、顧客へご案内される際はご注意ください。

ストアの損失を防ぐため、ポイントの付与も会員ランクの判定も、Shopify上でご注文が「支払い完了」になった時点を対象にしています。そのため、代金引換や銀行振込のように入金の確認が後になるご注文では、ご注文が入った時点では付与もランクの判定も行われません。 これらの決済方法を採用されているストアでは、入金を確認でき次第、Shopify管理画面でご注文のステータスを「支払い完了」に更新してください。更新された時点でポイントが付与され、会員ランクの判定にも反映されます。

付きます。ご注文の作成方法にかかわらず、支払い完了になったご注文が対象です（顧客が紐づいている必要があります）。 なお下書き注文の操作手順によっては、Shopifyから支払い完了の通知が届かないことがあります。その場合も毎日の自動チェックが付け漏れを検出して補完しますので、最大1日ほど遅れて付与されます。

付きます。初回のご注文も、2回目以降の定期課金分も、通常のご注文と同じように毎回付与されます。 ポイントの「利用」については条件が異なりますので、「ポイントの利用」の項目もあわせてご覧ください。

はい。商品タグ・商品タイプ・コレクション・商品名のいずれかを条件にして、その商品群だけ還元率を変えるルールを作れます。「一致する」だけでなく「〜を含む」「〜と一致しない」という条件も指定できます。 対象種別には「購入タイプ」も選べます。「通常購入」か「定期購入」かで還元率を変えられるので、「定期購入だけ+1%」のような設定ができます。2つのうちどちらかを指定する形のため、購入タイプの対象条件は「一致する」のみです。定期購入かどうかは、ご注文の各商品に販売プラン（定期購入プラン）が付いているかで自動的に判定されます。予約販売など、販売プランを使う他の購入方法も「定期購入」として扱われますのでご注意ください。回避したい場合は、タグや在庫ポリシーで管理するタイプの予約販売アプリ等をご利用ください。 還元率の指定方法は「固定値」「増減（＋/−）」「倍率（×）」の3つから選べます。「固定値」はその率で置き換えるので「セール品は0.5%、それ以外は1%」といった使い分けができます。「増減（＋/−）」は会員ランクごとの還元率に足し引きし、「倍率（×）」は掛け算します。どちらもランクごとの還元率の関係を保ったまま調整できます。 たとえばランクごとの還元率が 1%・1.5%・2% のストアでは、「+1%」なら 2%・2.5%・3%（差が同じ）、「×2」なら 2%・3%・4%（比率が同じ）になります。ランク間の差額をそろえたいときは増減、上位ランクほど恩恵を大きくしたいときは倍率が向いています。 ルールは複数登録でき、優先度設定の高いものから順に見て、最初に一致したルールが適用されます。1つのルールで指定できるのは3つのうちどれか1つだけです。

はい。上記のルールで還元率の指定方法を「固定値」にして0%にすると、その商品群はポイント付与の対象外になります。ギフトカードや利益率の低い商品を除外する、といった運用にお使いください。 対象外にできるのは「固定値」の0%だけです。「増減（＋/−）」の0は「増減なし」という意味で、対象外にはなりません。「倍率（×）」には0を指定できません（還元を減らしたい場合は0.5などの1未満の値をお使いください）。 ポイントを付けなかった商品も、会員ランクの集計では「購入金額」「購入回数」に通常どおりカウントされます（「獲得ポイント」を基準にランクを判定している場合のみ、ポイントが付いていない分はカウントされません）。対象外の商品と通常商品が混ざったご注文でも、商品ごとに正しく判定されます。「この商品はポイント対象外だけれど、購入実績としてはランクに反映したい」という運用にも対応できます。

はい。商品ごとの還元率のルールには、開始日時と終了日時を設定できます。「今週末だけ、このコレクションは還元率5倍」といったキャンペーンをあらかじめ登録しておけば、自動で開始・終了します。 開始日だけ、終了日だけ、という片側だけの指定も可能です。期間中に手動で切り替える作業は不要です。

はい。ランクごとに還元率を設定できます。上位ランクほど還元率を上げていく構成が一般的ですが、全ランクを同じ還元率にして、ランクの肩書きとランクアップ特典だけで差をつける構成も可能です。

はい。会員管理の画面から、顧客を選んで手動でポイントを付与できます。お詫びや個別のキャンペーンにお使いいただけます（Basicプラン以上）。 過去のご注文をまとめてポイントに反映したい場合は、期間を指定して一括で取り込む機能をご用意しています。「導入時のデータ移行」の項目をご覧ください。

はい。ポイントの残高はShopifyのストアクレジットとして管理されているため、Shopify管理画面の顧客ページから直接調整できます。 返品にともなうポイントの回収はPointiaが自動で行います（確認してから手動で行う設定にも変更できます）。

はい。PointiaはポイントをShopify標準の「ストアクレジット」として付与します。割引コード（クーポン）は「値引き」、ストアクレジットは「支払い手段」と別物として扱われるため、チェックアウトで両方を同時に適用できます。 チェックアウトなどでの「ストアクレジット」という表示名は、Shopify純正の機能で「ポイント」などお好きな名称に変更できます。Pointiaでも設定時に手順をご案内します。

特別な操作は必要ありません。顧客がログインした状態でチェックアウトに進むと、お支払いの欄に保有ポイントが表示され、適用するだけでお使いいただけます。 ポイントをクーポンコードに変換したり、事前に申請したりする必要はありません。日本の顧客が一般的にイメージする「ポイントで払う」体験を、そのまま提供できます。

いいえ。金額を指定してポイントを使うことはできません。これはShopifyのストアクレジットの仕様によるもので、チェックアウトでポイントを使う場合は残高の全額が充当されます。 充当されるのは支払合計額までです。残高が支払合計額を上回る場合は、超えた分がそのまま残高として残り、次回以降のお買い物にお使いいただけます。なお、ポイントを使わずに注文することは可能です。

ポイントを使えるのはチェックアウトです。カートページには「このカートの内容だと何ポイント貯まるか」という獲得予定ポイントを表示できますが、ポイントを充当する操作はチェックアウトで行います。 これはPointiaがポイントを支払い手段（ストアクレジット）として扱っているためで、支払い手段は支払いの画面で選ぶ、という構造になっています。クーポンと同時に使えるのも同じ構造によるもので、切り離せない一対の性質です。

はい。ポイントは支払い手段なので、送料を含めた支払合計に充当されます。 一方、ポイントが「貯まる」対象は、送料と消費税を除いた小計です。貯まるときは商品代金のみ、使うときは送料も含めて、という違いがあるのでご注意ください。

いいえ。ポイントは支払い手段なので、商品ごとに「この商品にはポイントを使えない」という制限はかけられません。これもShopifyのストアクレジットの仕様によるものです。 一方で、ポイントが「貯まらない」商品は設定できます。セール品や特定のカテゴリーを還元の対象外にしたい、といった運用はこちらで対応できます。

有効期限が早く来るポイントから使われます。 たとえば3月10日に期限が来る1,000ポイントと、3月15日に期限が来る1,000ポイントをお持ちの顧客が、3月9日に1,000ポイント分をお使いになった場合、3月10日期限の分から消費され、3月15日期限の1,000ポイントが残ります。顧客が「どのポイントを使うか」を選ぶ必要はありません。 なお有効期限は、ストアのタイムゾーンでその日の終わりに切れます（日本のストアであれば日本時間の23時59分）。

初回のご注文ではお使いいただけます。2回目以降の定期課金分ではお使いいただけません。定期課金は登録済みのお支払い方法で自動的に決済される仕組みのため、都度ポイントを充当する操作が挟まらないからです。 なお、ポイントの付与は初回・2回目以降を問わず、毎回行われます。

どちらも可能です。ポイントの実体がShopify標準のストアクレジットなので、Shopify POSのチェックアウトで支払い方法として「ストアクレジット」を有効にすれば、そのまま店頭でお使いいただけます（オンラインストア側でも有効になっている必要があります。また、操作するスタッフにストアクレジットを利用する権限が必要です）。 POSでのご購入にもポイントは自動で付与されます（レジで顧客を紐づけている場合）。Pointia側に実店舗向けの追加設定や連携作業はありません。ポイントを割引コードに変換する方式では実店舗との連携に個別の対応が必要になりますが、Pointiaは構造上そのまま成立します。

はい。付与から何日で失効するかを日数で設定します（初期値は365日）。0日を設定すると無期限になります。 期限は付与した時点で1件ごとに刻まれます。「3月に付与した分は3月から、4月に付与した分は4月から」というように、付与のたびに個別の期限を持ちます。

現時点ではできません。Pointiaの有効期限は「付与した日から◯日」で固定され、あとから延長されることはありません。 これはPointiaの制限ではなく、ポイントの実体であるストアクレジットの仕様によるものです。いまのShopifyでは、いったん付与した残高の有効期限をあとから変更できません。「残っている分を減算して、新しい期限で付与しなおす」という回避策も考えられますが、この方法では本来の取引と関係のない増減が顧客のポイント履歴に混ざり、返金時のポイント回収などとの突き合わせが難しくなります。 履歴の整合を保ったまま期限を付け替える方法は引き続き検討しています。この課題を解消できる見通しが立てば、実装する予定です。

期限が過ぎると自動的に失効し、残高から差し引かれます。失効の処理はShopify側で行われるため、ストア運営者の操作は不要です。 なお有効期限は、ストアのタイムゾーンでその日の終わりに切れます（日本のストアであれば日本時間の23時59分）。失効した分はアプリの履歴に記録されるので、後から金額を確認できます。

はい。失効の30日前と7日前に、顧客へ自動でメールをお送りします。「30日前だけ」「7日前だけ」のように片方だけにすることも、両方をオフにして通知を送らないことも選べます。 「使わなきゃ損」という気持ちが再訪のきっかけになるため、リピート施策としても効果的です。メールの件名・本文・ロゴ・色は編集でき、顧客ご自身で受信を停止することもできます（Basicプラン以上）。

いいえ。有効期限の日数はストア全体で1つの設定です。ご購入によるポイントも、手動で付与したポイントも、同じ日数で失効します。 例外として、過去のご注文をさかのぼって取り込むときだけ、期限の起算日を「当時の購入日」と「取り込んだ日」から選べます。

返金の金額に応じて、付与したポイントを自動で回収します。 回収する量は、そのご注文で実際に付与したときと同じ還元率で計算します。「付与のときは2%だったのに、回収は1%」といったずれは起きません。もともとポイントを付与していないご注文（ゲスト購入など）では、回収も行われません。

返金した金額の割合に応じて、その分だけを回収します。 たとえば10,000円のご注文で100ポイントを付与し、そのうち4,000円分を返品された場合は、40ポイントを回収します。複数回に分けて返金された場合も、すでに回収した分を差し引いて計算するため、二重に回収されることはありません。

自動では戻りません。返金の方法は、Shopifyの返金画面でストア運営者が選びます。「元のお支払い方法に返金する」「ストアクレジット（ポイント）として返金する」のどちらか、または両方を組み合わせて指定できます。 ポイントでお支払いいただいた分をポイントとしてお返ししたい場合は、返金画面でストアクレジットをお選びください。なお、ポイントで返金したあとに同じ金額を元のお支払い方法にも返金すると二重返金になりますので、ご注意ください。

はい。設定で「手動回収」を選ぶと、返金が発生してもポイントは自動では回収されず、ストア運営者にメールでお知らせします。 回収はShopifyの注文詳細画面からその場で行えます。回収する予定のポイント数があらかじめ表示され、数を調整することもできます。返品の事情に応じて「今回は回収しない」といった判断をしたいストアに向いています。

返金のしかたによって、ポイントの回収額を自動で計算できない場合があるためです。 Shopifyの返金には、商品ごとに「どれを何点返品するか」を指定する方法と、内訳を指定せずに「合計から◯円を返金する」とだけ指定する方法があります。後者では、どの商品がいくら戻ったのかが分からず、ポイントの回収額を正確に計算できません。この場合、自動回収の設定であっても、判断をゆだねるために手動対応のご案内をお送りします。 自動で回収させたい場合は、返金時に商品の数量や送料などの内訳を指定して返金してください。

集計方式によります。「これまでの累計」で判定する方式では、一度上がったランクは下がりません。「直近◯か月」「年度ごと」で判定する方式では、返品によって集計額が基準を下回るとランクが下がることがあります。 ただし、直前の判定で確定したランクを下回るところまでは下がりません。「朝のお買い物で上がったランクが、夕方の返品で元より下に落ちる」といったことは起きない仕組みにしています。

最大5段階です（Starterプランは2段階、Basicプランは3段階まで）。 名称は自由に設定できます。初期値は「ブロンズ／シルバー／ゴールド／プラチナ／VIP」ですが、ストアの世界観に合わせて変更してください。

「購入金額」「獲得ポイント」「購入回数」の3つから選べます。 高単価の商品を扱うストアなら購入金額、来店の頻度を重視するストアなら購入回数、というように運用に合わせてお選びください。購入回数で判定する場合、全額返金されたご注文は回数に含めません。

3つの方式から選べます。 ・直近◯か月（1／3／6／12／24か月）— 常に最近のご購入で判定します。買わなくなるとランクが下がるため、継続的なご利用を促したいストア向けです。 ・年度ごと — 年度の開始月を決め、その期間内の実績で判定します。日本の百貨店やカード会社でおなじみの方式です。 ・これまでの累計 — アカウント作成以降のすべての実績で判定します。一度上がったランクは下がりません。

定期的な判定のタイミングは、毎日／毎月／半年ごと／年1回から選べます。 これに加えて「即時ランクアップ」を有効にすると、顧客がご購入された直後にもランクを判定します。基準に達していればその場でランクが上がり、お祝いのクーポンもすぐに届きます。「買った瞬間に上がる」体験を提供したい場合はこちらをお使いください。

「これまでの累計」で判定する方式を選べば、ランクは下がりません。 「直近◯か月」「年度ごと」の方式では、期間内の実績が基準を下回るとランクが下がります。ランクを下げたくない場合は、累計方式をお選びください。

はい。会員管理の画面から、顧客ごとにランクを手動で設定できます。有効なランクのいずれにも変更でき、主な用途は、通常の判定基準では届かないお客様を意図的に上位ランクへ引き上げることです。長年のお得意様や法人のお客様をご購入金額にかかわらず上位ランクとして扱いたい場合や、クレーム対応・お詫びとして一時的に上位ランクの特典をご提供したい場合にお使いください。 手動でランクを設定したお客様は、設定した期間中は自動判定の対象外になります。手動で引き上げたランクが、自動判定によって元に戻されてしまうのを防ぐためです。たとえばゴールドの条件が50,000円のストアで、購入金額が届いていないお客様を手動でゴールドへ引き上げても、次の定期判定でシルバーへ戻ってしまい、手動で設定する意味がなくなってしまいます。 停止するのは、ランクを動かしうる判定すべてです。定期判定・ご注文時の即時ランクアップ・返金時の再判定のいずれも、期間中は行いません。一部だけを止めると、どの経路で判定されたかによってランクが変わり、結果が予測できなくなるためです。手動で下位のランクに設定した場合も同じく、期間中は自動判定が動きません。 期限は「次回評価まで」「1ヶ月後まで」「3ヶ月後まで」「1年後まで」「日付を指定」「無期限」から選べます。期限を過ぎたお客様は、次回の判定から自動判定に戻ります。無期限を選ばれた場合は自動判定に戻りませんので、一時的な引き上げであれば期限付きをお選びください。変更の理由もメモとして記録でき、「設定・操作履歴」の画面から後で確認できます（Basicプラン以上）。

まずは「対象のお客様に手動でのランク設定が入っていないか」と「ご注文が支払い完了になっているか」の2点をご確認ください。この2つが原因であることがほとんどです。いずれにも当てはまらない場合は、判定のタイミングと、集計の対象になる金額・ご注文の範囲を順にご確認ください。

• 手動でのランク設定が入っていないか — 会員管理の画面で、対象のお客様に手動変更の表示が出ていないかご確認ください。手動で設定されたお客様は、その期間中は自動判定の対象外になります。
• ご注文が「支払い完了」になっているか — 代金引換や銀行振込など、入金の確認が後になるご注文は、ステータスが「支払い完了」になるまでランクの集計に入りません。
• 次の定期判定がいつか — 判定のタイミングは「毎日」「毎月」「半年ごと」「毎年」から選べます。このうち「毎月」「半年ごと」「毎年」では集計が前月末までで締められるため、当月のご購入は次の定期判定まで反映されません。
• 「即時ランクアップ」がオンになっているか — オフの場合、ご購入の直後にランクが上がることはありません。次の定期判定を待つ動きになります（初期設定はオフです）。
• 判定に使う金額の考え方 — 購入金額で判定する場合、対象になるのは税抜・送料を除いた金額から、割引・ポイントでお支払いいただいた分・返金された分を差し引いた額です。ご注文の合計金額とは一致しません。
• 集計期間の外のご注文でないか — 「直近◯か月」「年度ごと」で判定している場合、期間外のご注文は集計に入りません。年度が切り替わると集計もリセットされます。
• ランクの条件を変更した直後でないか — 条件の金額を変更しても、既存のお客様のランクはその場では再計算されません。次の定期判定か、そのお客様の次回のご注文（即時ランクアップがオンの場合）で反映されます。
• 集計の対象外になるご注文でないか — 顧客が紐づいていないご注文（ゲスト購入）と、全額をポイントでお支払いいただいたご注文は集計に入りません。アプリを導入する前のご注文も、過去のご注文の取り込みを行っていなければ集計に入りません。
• プランの段階数の上限に掛かっていないか — Starterプランは2段階、Basicプランは3段階までのため、それを超えるランクには到達しません。

それでも解決しない場合は、対象のお客様のお名前と、期待していたランク・実際のランクを添えてお問い合わせください。操作の履歴とポイント付与の履歴をお調べします。

はい。全ランクの還元率を同じ値に設定すれば、ランクによる還元率の差はなくなります。 その場合でも、ランクの肩書き・顧客のマイページでの表示・ランクアップ時のクーポン発行は通常どおり働きます。「還元率で差をつけると原価が読みにくい」というストアでも、ランク制度による動機づけだけを取り入れられます。

「ポイントだけ使う」は可能です。ランク機能をオフにすると、全員に同じ還元率が適用され、ランクの表示も出なくなります。 ランク制度を主役にした運用も可能です。還元率を低め（あるいは0%）に設定すれば、ポイントの負担を抑えつつ、購入金額や購入回数にもとづくランク判定はそのまま働きます。「ポイントよりランクの特典で差をつけたい」というストアはこの形をご検討ください。 ただし、ポイント機能そのものを完全に停止したうえでランクだけを動かすことはできません。ポイントとランクは同じ仕組みの上で動いているためです。

はい。ランクが変わると、顧客に「loyalty:rank:2」のような顧客タグが自動で付きます。さらに設定を有効にすると、Shopify管理画面に「会員ランク：ゴールド」といった顧客セグメントが自動で作られます。 そのままメール配信の宛先や、限定セールの対象条件としてお使いいただけます。 なお、最下位ランクの顧客にはタグを付けません。ほとんどのストアで顧客の大半が最下位ランクに集中するため、全員にタグを書き込むとShopify側の負荷が大きくなるからです。「タグが付いていない＝最下位ランク」とお考えください。

不具合ではなく、そのような仕様です。最下位ランクは「タグも、ランク名やランク番号といったランク関連のメタフィールドも付けない状態」を既定とし、ランク2以上に昇格したお客様にのみ「loyalty:rank:2」のようなタグを付ける設計としています。上位ランクから最下位ランクに下がった場合は、それまで付いていたタグとランク関連のメタフィールドを削除しますので、古い値が残ることもありません。 これは、多くのストアで顧客の大半が最下位ランクに集中するためです。全員に書き込むとShopify側の負荷が大きくなります。また、ほぼ全顧客に同じタグが付くことになり、Shopify管理画面の顧客タグを不必要に増やしてしまいます。「タグが付いていない＝最下位ランク」とお考えください。 自動で作られる最下位ランクの顧客セグメントは、有効にしているランク2以上のタグ（「loyalty:rank:2」など）をどれも持たない顧客、という条件で集計しています。そのためタグが付いていなくても、セグメントには正しく含まれます。メール配信の宛先や限定セールの対象条件として、そのままお使いいただけます。

そのランク以下で、いちばん上の有効なランクとして扱われます。たとえばゴールドを無効にすると、ゴールドだった顧客はシルバーとして扱われ、還元率も表示もシルバーのものになります。 プランを下げて段階数の上限が減った場合も同じで、上限を超えるランクの顧客は上限のランクに丸められます。実際に付与される還元率と、顧客に見えている表示が食い違うことはありません。

はい。ランクが上がったタイミングで、その顧客だけが使える割引コードを自動で発行し、お知らせのメールをお送りします。 割引の内容は定額（1,000円引きなど）と割合（10% OFFなど）から選べ、ランクごとに金額を変えられます。有効期限と、利用に必要な最低購入金額も設定できます（Basicプラン以上）。

はい。発行のタイミングを「会員登録したとき」と「初めてご購入いただいたとき」から選べます。 会員登録時に配れば登録の動機づけに、初回購入時に配れば2回目のご購入を促す施策になります。ストアの目的に合わせてお選びください（Basicプラン以上）。

はい。割引のタイプ（定額／割合）、割引額または割引率、有効期限の日数、利用に必要な最低購入金額を設定できます。ランクアップ用と新規会員用で、それぞれ別に設定できます。 他の割引との併用可否も設定できます。Shopify標準の「組み合わせ」の考え方にならい、「商品割引と併用」「注文割引と併用」「送料割引と併用」の3つをそれぞれオン／オフで指定します。たとえばセールと重なってもクーポンを使えるようにしたい場合は、該当する併用をオンにしてください。 「購入タイプ」で、クーポンを適用する購入の種類も選べます。「1回限りの通常購入」（既定）・「定期購入」・「両方」の3つから選び、定期購入を含める場合は「定期購入への適用回数」で何回目の請求まで割引するかをあわせて指定します（1〜365回）。 発行されるコードはその顧客専用で、1回限りのご利用です（コードを利用できる回数が1回という意味です。定期購入に利用した場合は、1度の利用で指定した回数まで、同じ契約の請求ごとに割引が続きます）。他の方に共有されて使われることはありません。

設定で選べます。「生涯1回」にすると、同じランクに対してランクアップクーポンは1度しか発行しません。「評価期間ごと」にすると、評価期間が変わったあとに、その顧客が再びそのランクに到達したときにあらためて発行します。 たとえば年度ごとにランクを判定するストアで、毎年ゴールドに到達される顧客に毎年クーポンをお渡ししたい場合は「評価期間ごと」をお選びください。なお「評価期間ごと」でも、単に期間が切り替わっただけでは発行されません。あらためてそのランクに到達したときに発行されます。

対策しています。Shopifyでは、アカウントを削除して同じメールアドレスで登録し直すと別の顧客として扱われますが、Pointiaはメールアドレスの発行履歴も見ているため、退会と再登録を繰り返しても新規クーポンは再発行されません。 メールアドレスを変えてから登録し直す経路にも対応しています。

はい。アプリの画面で、発行したクーポンの一覧と、それぞれが使われたかどうか、どのご注文で使われたかを確認できます。施策の効果測定にお使いください。

Shopifyのお客様アカウント（マイページ）に、ポイント残高・現在の会員ランク・次のランクまでの進捗・ポイントの履歴を表示します。設置はアプリの設定から行え、コードの編集は不要です。 「あと5,000円でゴールド」という進捗が見えることで、次のお買い物の動機づけになります。なお、外貨でポイントを保有している顧客には、日本円での「あと◯◯円」は表示せず、進捗バーと次のランク名でご案内します（外貨で買われた顧客にとって日本円の金額は直感的でないためです）。

はい。商品ページに獲得予定ポイントを表示するブロックをご用意しています。テーマエディターから配置するだけで設置できます。 サイズや色などのバリエーションを切り替えると、獲得予定ポイントも自動で更新されます。通常購入と定期購入の切り替えにも追随し、定期購入プランに割引がある場合は割引後の価格で計算します。いずれもテーマのコードを編集する必要はありません。 なお、切り替えを検知できない作りのテーマでは、ページを開いた時点の表示のままになります（表示が消えたり、誤った数字になったりすることはありません）。 ログイン中の顧客には、その顧客のランクの還元率で計算した数字を表示します。

カートページには表示できます。専用のブロックをテーマエディターから配置してください。カートの中身に応じて、商品ごとの還元率も反映した数字を表示します。 スライド式のカートドロワーには、そのまま配置できるブロックをご用意していません。カートドロワーはテーマによって作りが大きく異なるためです。計算用の仕組みだけをご提供していますので、表示部分はテーマ側での実装が必要になります。制作会社さまにご相談ください。

はい。顧客のマイページに、直近のポイントの増減を履歴として表示します。いつ何ポイント貯まって、いつ使われたかを、顧客ご自身で確認していただけます。

はい。Shopify純正の機能で表示名を変更できます。「ポイント」でも「◯◯コイン」でも、ストアに合わせた名称をお使いいただけます。Pointiaの設定時に手順をご案内します。

テーマエディターから、表示する文言や配置を調整できます。色やフォントは、設置したテーマのデザインに沿った見た目になります。 細かくデザインを作り込みたい場合は、コピー＆ペーストで使えるLiquidスニペットもご用意していますので、制作会社さまにご相談ください。

はい。ログインしていない顧客に、会員登録するとポイントが貯まることを伝えるバナーを表示できます。 日本のECではゲスト購入の比率が高いため、ご購入前に会員登録の価値を伝えることが会員数の増加につながります。

商品ページとカートページの獲得予定ポイントに反映されます。キャンペーンの期間設定も同じように反映されるため、期間外には通常の還元率で表示されます。 カートドロワーだけは、表示に使える情報が限られるため特例ルールが反映されず、お客様の既定／ランク別の還元率で計算されます。なお、実際に付与されるポイントは、どの画面を経由しても設定したルールどおりです。

Pointiaの不具合ではありません。これはShopifyのお客様アカウントの仕様によるもので、オンラインストア側のログイン状態（ストアフロントの顧客セッション）が切れているために起きる表示です。 獲得予定ポイントは、Shopifyがテーマに渡すログイン情報をもとにオンラインストア側で計算します。このセッションが切れていると、Shopifyからは未ログインのお客様と同じ情報しか渡されないため、そのお客様がどのランクかを判別できず、ゲストと同じ最下位ランクの還元率で表示します。同じ理由で、会員登録を促すバナーもログイン前と同じように表示されます。テーマやアプリから見えるログイン状態はShopifyが決めているため、Pointia側からこの状態を元に戻すことはできません。 分かりにくいのは、この状態でもお客様アカウントのページ（注文履歴やポイント残高）は「ログイン済み」に見えることです。またログインページを開いてもすでにログイン済みと判定されて戻されるため、そのままでは解消しません。お客様にご案内いただく場合は、一度ログアウトしてから、あらためてログインしていただくと、どちらの表示も元に戻ります。 表示だけの問題ですので、実際に付与されるポイントには影響しません。ご注文が「支払い完了」になった時点で、そのお客様のランクの還元率で正しく計算されます。

2種類です。 ・ポイントの失効通知 — 有効期限の30日前・7日前にお知らせします ・クーポンの発行通知 — ランクアップ時や新規会員登録時にクーポンを発行したときにお送りします どちらもBasicプラン以上の機能で、送信は個別にオン／オフできます。

はい。件名・見出し・本文・署名を自由に編集でき、顧客のお名前や失効日、残高を差し込むこともできます。ヘッダーの帯とボタンの色を指定し、ストアのロゴをアップロードすれば、ストアのブランドに合わせた見た目になります。 背景の明るさから文字色を自動で決めるため、色の組み合わせによって文字が読めなくなることはありません。

はい（Proプラン以上）。ご自身のドメインを設定すると、notifications@（ストアのドメイン）のようなアドレスから送信できます。設定画面からDNSレコードを登録して検証すれば、使い始められます。 設定されていない場合は、Pointia共通のアドレスから、差出人名をストア名にしてお送りします。

届きません。メールを送ってよい時間帯を設定できます（初期値は8時〜22時）。 深夜にランクアップやクーポンの発行が起きた場合、メールはいったん保留され、翌朝の開始時刻にお送りします。真夜中の通知で顧客の心証を損ねることを防ぎます。

ポイント残高と会員ランクは、Shopifyの顧客メタフィールド（会員ランクは顧客タグでも）として保存されます。そのため、顧客セグメントやShopify Flow、メタフィールドに対応したメール配信ツールなど、これらを参照できる仕組みであれば、ご自身のマーケティングメールに残高やランクを差し込んで活用できます。 なお、ポイントの有効期限は付与ごとに管理しているため、顧客単位の項目としては公開しておりません。失効間近の通知など有効期限が必要なご案内は、Pointiaの失効通知メールをご活用ください。

はい。失効通知メールには必ず配信解除のリンクが付いています。顧客のマイページからも受信のオン／オフを切り替えられます。 GmailやYahoo! メールの「登録解除」ボタンからも解除できるようにしているため、迷惑メール扱いされにくくなっています。

はい。設定画面から期間を指定して過去のご注文をまとめて取り込み、さかのぼってポイント・会員ランクに反映できます。 取り込み方は3通りから選べます。「ランクの判定だけに反映する（ポイントは配らない）」「ポイントだけ配る」「両方」です。導入初日から優良顧客が見える状態にできるので、「ずっと買っているのに新規扱い」という顧客の不満を防げます。

さかのぼれる期間に固定の上限はありません。ストアの開設時までさかのぼることも可能です。 ただし、有効期限の起算日を「当時の購入日」にした場合、計算上すでに期限が過ぎてしまう古いご注文については、ポイントの発行は行わず、ランクの集計にのみ反映します。

はい。「プレビュー → 適用」の2段階になっています。プレビューでは、対象となる顧客の数、想定されるランクの分布、発行されるポイントの総額を確認できます。 内容を見てから適用できるので、意図しない範囲に大量のポイントを配ってしまう事故を防げます。プレビューの段階では、まだ1ポイントも発行されていません。

過去注文の取り込みは、Shopifyに登録されているご注文を対象にします。移行元のシステムを直接読みに行くわけではないため、まず注文データをShopifyへ移していただく必要があります。 Matrixifyなどの移行ツールで、注文の「Processed At」（Shopifyの注文管理画面に「日付」として表示される項目）に当時の注文日を入れて移行できていれば、Pointiaでの取り込みも、移行日ではなく「当時の注文日」を基準として扱われ、取り込みの対象期間指定もそれに従います。 「Processed At」は移行ツールの必須項目ではありませんが、Shopifyでは注文日として扱われます。移行日ではなく実際の注文日にもとづいてポイントの付与・会員ランクの判定を行いたい場合は、必ず設定したうえでデータを移行してください。空のまま移行すると、移行した日がそのまま注文日になります。 「Processed At」が正しく設定されていれば、ポイントの付与も会員ランクの集計も、実際に購入があった時期に沿って反映されます。 対象になるのは、顧客が紐づいていて、明細の金額が入っているご注文です。顧客情報のないご注文や金額が0円のご注文は対象外となり、プレビューの画面に件数が表示されます。

ウェルカムクーポン（新規会員へのクーポン）を発行するストアの場合は、顧客の移行が完了してから設定をオンにしてください。 Shopifyの仕様上、顧客の取り込みが「会員登録された」ものとして扱われるため、「会員登録時」にクーポンを発行する設定をオンのまま移行すると、移行したすべての顧客にクーポンと通知メールが一斉に発行されます。発行後に取り消すことはできません。 移行が終わってからオンに戻していただければ、移行済みの顧客へさかのぼって一斉に発行されることはありません。移行した顧客全員にクーポンをお配りする意図がある場合は、オンのままでも問題ありません。 発行タイミングを「初回購入完了時」にしている場合は、顧客の移行だけでは発行されません。ただしご注文の移行では、注文の「Processed At」（Shopifyの注文管理画面に「日付」として表示される項目）がPointiaを導入したあとの日付になっていると、そのご注文が導入後の初回購入として扱われ、クーポンが発行されます。「Processed At」には当時の注文日を入れて移行してください。 アプリの設定画面でも同様のご案内を表示していますが、意図しない発行を防ぐため、移行の計画時にあわせてご確認ください。

個別の移行サポートで対応しています。他社アプリの残高データをお預かりし、顧客ごとの残高として取り込みます。 ストアの状況によって手順が変わるため、まずはご相談ください。

必要ありません。取り込みの最中も、通常どおりご注文を受け付けられますし、そのご注文へのポイント付与も止まりません。 取り込む期間と当日のご注文が重なった場合も、注文時の自動付与と取り込みのどちらか一方だけが反映されます。二重にポイントが付くことはありません。

「当時の購入日から」と「取り込んだ日から」のどちらかを選べます。 当時の購入日を起点にすると、古いご注文のポイントはすぐに失効してしまいます。導入時に顧客へ実際にお使いいただきたい場合は、取り込んだ日を起点にするのが一般的です。

はい。「全顧客取り込み」を実行すると、購入履歴のない顧客も含めて会員一覧に並びます。 実行後に新しくご登録いただいた顧客も自動で加わるため、会員名簿として一元的に管理できます。

はい。ダッシュボードで、これまでに発行したポイントの総額と、使われた分の合計を確認できます。 ポイントは将来お支払いに使われる「負債」にあたるため、会計処理や引当金のご検討に必要な数字を把握できるようにしています。失効した分を含む1件ごとの明細は、履歴の画面でご確認いただけます。

はい。会員管理の画面で、顧客の一覧をランクや残高とあわせて確認できます。ランク別に絞り込めるため、上位ランクの顧客だけを抽出して施策を検討する、といった使い方ができます。

はい。いつ・どの顧客に・何ポイント付与したか、どのご注文で使われたか、いつ失効したかを1件ずつ記録しています。 顧客から「ポイントが合わない」とお問い合わせをいただいたときに、経緯を確認してご回答いただけます。

はい。設定でポイントシステム全体をオフにすると、ポイントの付与とランクの判定が止まり、顧客向けの表示も出なくなります。 ランク機能だけをオフにして、ポイントの付与は続ける、という切り分けもできます。

はい。還元率を保存するときに、確認の画面が割り込みます。20%を超える値を入力した場合と、前回の設定から3倍以上に跳ね上がる変更をした場合です。 「1%のつもりが10%になっていた」「テストで上げたまま戻し忘れた」といった操作ミスが本番に反映される前に、意図を確認します。

毎日の自動チェックで、付与されるはずのポイントが記録されていないご注文を検出し、自動で補完します。Shopifyからの通知が届かなかった場合の取りこぼしも、この仕組みで拾われます。 また、1回の付与額が異常に大きい場合には運用側にアラートが飛ぶようにしています。設定ミスによる過大な付与を、早い段階で検知するためです。

はい。コピー＆ペーストで設置できるLiquidスニペットをご用意しています。商品ページ・カートページの獲得予定ポイント表示を、テンプレートの狙った位置に直接配置できます。 アプリブロックが使えるテーマでは、そちらの方が堅牢ですのでアプリブロックをおすすめします。 還元率の「増減（＋/−）」「倍率（×）」指定に対応するため、スニペットを更新しました。すでに設置済みの場合は、以下の最新のコードに貼り替えてください。貼り替えるまでは、増減と倍率のルールが表示に反映されません。

手順1： テーマの snippets/ フォルダに pointia-rule-match.liquid を作成します（特例ルール判定の共通部品。商品ページ・カートの両方から使います）。

{%- comment -%} Pointia — 獲得予定ポイントの特例ルール判定（商品ページ・カート用の共通部品） {%- endcomment -%}
{%- assign base_match = false -%}
{%- assign known_types = 'tag,type,collection,title,purchaseType' | split: ',' -%}
{%- assign type_known = false -%}
{%- if known_types contains rule.matchType -%}{%- assign type_known = true -%}{%- endif -%}
{%- assign cond = rule.matchCondition -%}
{%- if cond == blank -%}{%- assign cond = 'equals' -%}{%- endif -%}
{%- assign known_conds = 'equals,contains,not_equals' | split: ',' -%}
{%- assign cond_known = false -%}
{%- if known_conds contains cond -%}{%- assign cond_known = true -%}{%- endif -%}
{%- assign substring_conds = 'contains' | split: ',' -%}
{%- assign exact_conds = 'equals,not_equals' | split: ',' -%}
{%- assign negating_conds = 'not_equals' | split: ',' -%}
{%- assign compare_known = false -%}
{%- if substring_conds contains cond or exact_conds contains cond -%}{%- assign compare_known = true -%}{%- endif -%}
{%- assign needle = rule.matchValue | strip | downcase -%}
{%- if rule.matchType == 'tag' -%}
  {%- if p.tags contains rule.matchValue -%}{%- assign base_match = true -%}{%- endif -%}
{%- endif -%}
{%- if rule.matchType == 'collection' -%}
  {%- for c in p.collections -%}
    {%- if c.handle == rule.matchValue -%}{%- assign base_match = true -%}{%- break -%}{%- endif -%}
  {%- endfor -%}
{%- endif -%}
{%- if rule.matchType == 'type' -%}
  {%- if substring_conds contains cond -%}
    {%- assign hay = p.type | downcase -%}
    {%- if needle != blank and hay contains needle -%}{%- assign base_match = true -%}{%- endif -%}
  {%- elsif exact_conds contains cond -%}
    {%- if p.type == rule.matchValue -%}{%- assign base_match = true -%}{%- endif -%}
  {%- endif -%}
{%- endif -%}
{%- if rule.matchType == 'title' -%}
  {%- if substring_conds contains cond -%}
    {%- assign hay = p.title | downcase -%}
    {%- if needle != blank and hay contains needle -%}{%- assign base_match = true -%}{%- endif -%}
  {%- elsif exact_conds contains cond -%}
    {%- if p.title == rule.matchValue -%}{%- assign base_match = true -%}{%- endif -%}
  {%- endif -%}
{%- endif -%}
{%- if rule.matchType == 'purchaseType' -%}
  {%- if exact_conds contains cond -%}
    {%- if purchase_type == rule.matchValue -%}{%- assign base_match = true -%}{%- endif -%}
  {%- endif -%}
{%- endif -%}
{%- assign is_match = false -%}
{%- if type_known and cond_known and compare_known -%}
  {%- if negating_conds contains cond -%}
    {%- unless base_match -%}{%- assign is_match = true -%}{%- endunless -%}
  {%- else -%}
    {%- assign is_match = base_match -%}
  {%- endif -%}
{%- endif -%}
{%- if is_match -%}PTAPP_MATCH_TRUE{%- else -%}PTAPP_MATCH_FALSE{%- endif -%}

手順2： 商品テンプレート（例：sections/main-product.liquid）の任意の場所に、以下のコードを貼り付けます。

{% comment %} Pointia — 獲得予定ポイント（商品ページ・特例ルール対応） {% endcomment %}
{%- assign pointia_app_id = "app--319212224513" -%}
{%- assign points_prefix = "今購入すると 約" -%}
{%- assign points_suffix = "pt 獲得予定" -%}
{%- assign shop_mf = shop.metafields[pointia_app_id] -%}
{%- assign customer_mf = customer.metafields[pointia_app_id] -%}
{%- if shop_mf.system_active -%}
  {%- assign rate = blank -%}
  {%- if shop_mf.rank_enabled -%}
    {%- assign ladder = shop_mf.reward_rate_ladder.value -%}
    {%- if customer and customer_mf.tier_rank -%}
      {%- assign rank_key = customer_mf.tier_rank.value | append: '' -%}
      {%- assign rate = ladder[rank_key] -%}
    {%- endif -%}
    {%- if rate == blank and ladder != blank -%}
      {%- assign rate = ladder["1"] -%}
    {%- endif -%}
  {%- else -%}
    {%- assign rate = shop_mf.default_reward_rate_percent.value -%}
  {%- endif -%}
  {%- assign now_s = 'now' | date: '%s' | plus: 0 -%}
  {%- assign purchase_type = 'one_time' -%}
  {%- if product.requires_selling_plan -%}{%- assign purchase_type = 'subscription' -%}{%- endif -%}
  {%- if product.selected_selling_plan != nil -%}{%- assign purchase_type = 'subscription' -%}{%- endif -%}
  {%- assign tax_rate = blank -%}
  {%- assign product_reward_rate = blank -%}
  {%- assign reward_found = false -%}
  {%- assign group_rules = shop_mf.product_group_rules.value -%}
  {%- if group_rules != blank -%}
    {%- for rule in group_rules -%}
      {%- assign rule_active = true -%}
      {%- if rule.startEpoch != nil and now_s < rule.startEpoch -%}{%- assign rule_active = false -%}{%- endif -%}
      {%- if rule.endEpochExclusive != nil and now_s >= rule.endEpochExclusive -%}{%- assign rule_active = false -%}{%- endif -%}
      {%- unless rule_active -%}{%- continue -%}{%- endunless -%}
      {%- capture rule_match -%}{%- render 'pointia-rule-match', rule: rule, p: product, purchase_type: purchase_type -%}{%- endcapture -%}
      {%- if rule_match contains 'PTAPP_MATCH_TRUE' -%}
        {%- if tax_rate == blank and rule.taxRatePercent -%}{%- assign tax_rate = rule.taxRatePercent -%}{%- endif -%}
        {%- if reward_found == false -%}
          {%- if rule.rewardRatePercent != nil -%}
            {%- assign product_reward_rate = rule.rewardRatePercent -%}
            {%- assign reward_found = true -%}
          {%- elsif rule.rewardRateDeltaPercent != nil and rate != blank -%}
            {%- assign product_reward_rate = rate | times: 1.0 | plus: rule.rewardRateDeltaPercent | at_least: 0 | at_most: 100 -%}
            {%- assign reward_found = true -%}
          {%- elsif rule.rewardRateMultiplier != nil and rate != blank -%}
            {%- assign product_reward_rate = rate | times: 1.0 | times: rule.rewardRateMultiplier | at_least: 0 | at_most: 100 -%}
            {%- assign reward_found = true -%}
          {%- endif -%}
        {%- endif -%}
      {%- endif -%}
    {%- endfor -%}
  {%- endif -%}
  {%- if product_reward_rate != blank -%}{%- assign rate = product_reward_rate -%}{%- endif -%}
  {%- if tax_rate == blank -%}{%- assign tax_rate = shop_mf.points_tax_rate_percent.value -%}{%- endif -%}
  {%- if tax_rate == blank -%}{%- assign tax_rate = 10 -%}{%- endif -%}
  {%- assign price_cents = product.selected_or_first_available_variant.price -%}
  {%- assign sp_alloc = product.selected_or_first_available_selling_plan_allocation -%}
  {%- if purchase_type == 'subscription' and sp_alloc != nil -%}{%- assign price_cents = sp_alloc.price -%}{%- endif -%}
  {%- assign taxable_cents = price_cents -%}
  {%- if shop.taxes_included -%}
    {%- assign tax_divisor = 100.0 | plus: tax_rate -%}
    {%- assign taxable_cents = price_cents | times: 100 | divided_by: tax_divisor -%}
  {%- endif -%}
  {%- assign get_point = 0 -%}
  {%- if rate != blank and rate > 0 and taxable_cents > 0 -%}
    {%- assign get_point = taxable_cents | times: rate | divided_by: 10000 | floor -%}
  {%- endif -%}
  {%- if get_point > 0 -%}
    <p class="pointia-points">
      {{ points_prefix | escape }}<strong>{{ get_point }}</strong>{{ points_suffix | escape }}
    </p>
    <p class="pointia-points__note">※表示は目安です。割引・ポイント利用・税抜計算により実際の付与は変動する場合があります。</p>
  {%- endif -%}
{%- endif -%}

※初期バリアントの価格を元に表示します。バリアント切替に追随させたい場合は、末尾の window.Pointia.calcPoints をテーマの variant:change イベントに接続してください。

手順3： カートテンプレート（例：sections/main-cart-footer.liquid）に貼り付けます。カート内の各商品に特例ルールを適用してから合算されます。

{% comment %} Pointia — 獲得予定ポイント（カートページ・特例ルール対応/行ごと） {% endcomment %}
{%- assign pointia_app_id = "app--319212224513" -%}
{%- assign points_prefix = "カート内の商品で 約" -%}
{%- assign points_suffix = "pt 獲得予定" -%}
{%- assign shop_mf = shop.metafields[pointia_app_id] -%}
{%- assign customer_mf = customer.metafields[pointia_app_id] -%}
{%- if shop_mf.system_active -%}
  {%- assign rate = blank -%}
  {%- if shop_mf.rank_enabled -%}
    {%- assign ladder = shop_mf.reward_rate_ladder.value -%}
    {%- if customer and customer_mf.tier_rank -%}
      {%- assign rank_key = customer_mf.tier_rank.value | append: '' -%}
      {%- assign rate = ladder[rank_key] -%}
    {%- endif -%}
    {%- if rate == blank and ladder != blank -%}
      {%- assign rate = ladder["1"] -%}
    {%- endif -%}
  {%- else -%}
    {%- assign rate = shop_mf.default_reward_rate_percent.value -%}
  {%- endif -%}
  {%- assign now_s = 'now' | date: '%s' | plus: 0 -%}
  {%- assign group_rules = shop_mf.product_group_rules.value -%}
  {%- assign rep_tax = shop_mf.points_tax_rate_percent.value -%}
  {%- if rep_tax == blank -%}{%- assign rep_tax = 10 -%}{%- endif -%}
  {%- assign get_point = 0 -%}
  {%- for item in cart.items -%}
    {%- assign line_rate = rate -%}
    {%- assign line_tax = blank -%}
    {%- assign line_reward_found = false -%}
    {%- assign line_pt = 'one_time' -%}
    {%- if item.selling_plan_allocation != nil -%}{%- assign line_pt = 'subscription' -%}{%- endif -%}
    {%- if group_rules != blank -%}
      {%- for rule in group_rules -%}
        {%- assign rule_active = true -%}
        {%- if rule.startEpoch != nil and now_s < rule.startEpoch -%}{%- assign rule_active = false -%}{%- endif -%}
        {%- if rule.endEpochExclusive != nil and now_s >= rule.endEpochExclusive -%}{%- assign rule_active = false -%}{%- endif -%}
        {%- unless rule_active -%}{%- continue -%}{%- endunless -%}
        {%- capture rule_match -%}{%- render 'pointia-rule-match', rule: rule, p: item.product, purchase_type: line_pt -%}{%- endcapture -%}
        {%- if rule_match contains 'PTAPP_MATCH_TRUE' -%}
          {%- if line_tax == blank and rule.taxRatePercent -%}{%- assign line_tax = rule.taxRatePercent -%}{%- endif -%}
          {%- if line_reward_found == false -%}
            {%- if rule.rewardRatePercent != nil -%}
              {%- assign line_rate = rule.rewardRatePercent -%}
              {%- assign line_reward_found = true -%}
            {%- elsif rule.rewardRateDeltaPercent != nil and rate != blank -%}
              {%- assign line_rate = rate | times: 1.0 | plus: rule.rewardRateDeltaPercent | at_least: 0 | at_most: 100 -%}
              {%- assign line_reward_found = true -%}
            {%- elsif rule.rewardRateMultiplier != nil and rate != blank -%}
              {%- assign line_rate = rate | times: 1.0 | times: rule.rewardRateMultiplier | at_least: 0 | at_most: 100 -%}
              {%- assign line_reward_found = true -%}
            {%- endif -%}
          {%- endif -%}
        {%- endif -%}
      {%- endfor -%}
    {%- endif -%}
    {%- if line_tax == blank -%}{%- assign line_tax = rep_tax -%}{%- endif -%}
    {%- assign line_cents = item.final_line_price -%}
    {%- if shop.taxes_included -%}
      {%- assign line_divisor = 100.0 | plus: line_tax -%}
      {%- assign line_cents = item.final_line_price | times: 100 | divided_by: line_divisor -%}
    {%- endif -%}
    {%- if line_rate != blank and line_rate > 0 and line_cents > 0 -%}
      {%- assign line_point = line_cents | times: line_rate | divided_by: 10000 | floor -%}
      {%- assign get_point = get_point | plus: line_point -%}
    {%- endif -%}
  {%- endfor -%}
  {%- if get_point > 0 -%}
    <p class="pointia-points">
      {{ points_prefix | escape }}<strong>{{ get_point }}</strong>{{ points_suffix | escape }}
    </p>
    <p class="pointia-points__note">※表示は目安です。割引・ポイント利用・税抜計算により実際の付与は変動する場合があります。</p>
  {%- endif -%}
{%- endif -%}

数量変更をリロードせずリアルタイム反映したい場合は、商品ページのバリアント切替と同じ考え方で、行ごとの率をJSに埋め込みカート更新イベントで再計算します（テーマ依存）。簡易には window.Pointia.calcPoints(カート合計) を使います（代表税率のみ・特例ルール非反映）。

注意点：

• 表示は目安です。割引・ポイント利用・税抜計算により、実際の付与は変動する可能性があります。
• お客様のポイント残高・会員ランクの表示は、PointiaのCustomer Account UI Extension（プロフィールページ内）が担当します。テーマ側のスニペットとしては提供していません。
• このスニペットはページを描画した時点で計算します。バリエーションや通常購入／定期購入の切り替えには追随しません（アプリブロックは追随します）。追随させたい場合はテーマ側での実装が必要です。
• ストアフロントの顧客セッションが切れているお客様には、最下位ランクの還元率で表示されます。アプリブロックも同じ挙動です（「顧客の見え方（オンラインストア表示）」の「ログインしているはずのお客様に、最下位ランクの還元率が表示されます。不具合ですか？」をご覧ください）。

計算用のヘルパーをご提供しています。アプリの「獲得ポイント計算ヘルパー」app embedを有効化すると、全ページで window.Pointia.calcPoints(金額) が使えます（アプリはDOMを触りません。表示位置と更新タイミングはテーマ側で実装してください）。カートドロワーは商品ごとの文脈を持てないため、代表税率とお客様の既定／ランク別の還元率で計算します。

// 金額は Shopify の money 値（最小単位の整数。例: cart.total_price）を渡す
document.addEventListener("pointia:ready", function () {
  var result = window.Pointia.calcPoints(cartTotalPrice); // → { points, rate } または null
  if (result) {
    // result.points を好きな位置に表示する。カート更新イベントのたびに呼び直す。
  }
});

Pointia独自のAPIは公開していません。 外部との連携は、Shopifyの顧客メタフィールドと顧客タグを経由して行っていただく設計です。ポイント残高もランクもShopify側のデータとして保存されているため、Shopify Admin APIや既存のツールからそのまま参照できます。独自のAPIを新たに覚えていただく必要はありません。

Shopify Flow向けのテンプレートを近日公開予定です。 現時点でも、ランクは顧客タグとして付与されるため、Shopify標準の「顧客タグが追加された」トリガーを使ったワークフローは組んでいただけます。

新しいテーマに、表示用のアプリブロックを配置し直していただく必要があります。設定内容・ポイントの残高・会員ランクはテーマとは別に保存されているため、影響を受けません。 アプリ内のセットアップガイドから、表示が設置されているかを確認できます。

はい。コラボレーターアカウントで導入・設定を代行していただけます。 事前にストアオーナーさまの側で、コラボレーターの申請を承認し、「アプリと販売チャネルの管理・インストール」と「アプリ料金の承認」の権限を付与していただく必要があります。料金の請求先はストアのShopifyアカウントです。 制作会社さまからのご相談も歓迎しております。

ポイント（ストアクレジット）を発行・管理する主体は、ストア運営者さまです。Pointiaは、その発行と失効を自動化するツールという位置づけです。 残高のデータはShopifyのストアクレジットとしてShopify上に保管されており、Pointiaがお預かりしているわけではありません。 ポイントの利用規約や表示について、法令上どのような対応が必要かはストアの規模や運用によって変わります。具体的なご判断は専門家にご相談ください。

Shopify標準のストアクレジットとして、Shopify側に保存されています。Pointiaのデータベースに残高を持っているわけではありません。 Pointiaが保持しているのは、いつ・なぜ付与したかという履歴と、会員ランクの判定結果です。残高そのものは、Shopify管理画面の顧客ページからも確認・調整できます。

Pointiaが扱うのは、ポイントとランクの管理に必要な範囲の情報（顧客ID、お名前、メールアドレス、購入金額など）に限られます。 Shopifyが定める個人情報の取り扱い要件に対応しており、顧客からの開示請求や削除請求があった場合には、Shopifyからの通知を受けて対応します。詳細はプライバシーポリシーをご覧ください。

プライバシーポリシー

ポイント残高はShopify標準のストアクレジットとしてShopify側に保存されており、Pointiaアプリ内に保管しているわけではありません。そのため解約（アンインストール）しても顧客の残高はShopifyに残り、引き続きチェックアウトでご利用いただけます。 解約時に削除されるのはPointiaが生成したデータ（付与履歴・ランク等）で、Shopifyからの削除リクエスト受信後30日以内に削除します。解約後は、ポイントの自動付与やランク評価などの自動処理は停止します。

残ります。アンインストールしても設定内容・ポイントの履歴・会員ランクはそのまま保持されるため、再インストールすれば以前の状態から再開できます。 ただし、安全のためポイントシステムは停止した状態で戻ります。動作を確認したうえで、あらためて有効にしてください。なお、Shopifyからデータ削除の要請が届いた場合は、その時点でPointia側のデータを削除します。

日本語で対応しています。導入前のご相談、設定方法のご案内、運用中のお困りごとまで、お問い合わせフォームから承ります。 他システムからのポイント移行など、個別の作業をともなうご依頼は有償のサポートとなる場合がございます。ストアの状況をうかがったうえで、お見積りをご提示します。

Pointiaは絶賛成長中です。前向きに検討できればと存じますので、ぜひShopify App Storeのレビューやサポートを通じてご意見をいただけますと幸いです。 皆様の応援やご要望が集まるほど開発へのリソース投下につながり、Pointiaの改善・成長へと直結します。お手数をおかけしてしまい恐縮ですが、どうぞよろしくお願いいたします！