仕組み

このページでは、Sami Product Labels がバッジ、ラベル、トラストバッジ、ハイライト、バナーをストアフロントに表示する仕組みを説明します。コーディングの知識は必要ありません。

アプリの埋め込みブロック

アプリをインストールすると、Shopifyテーマにアプリの埋め込みブロックが追加されます。これは、ストアフロントでアプリの機能を動かすためのShopify標準の仕組みです。

アプリの埋め込みは、Shopifyのテーマエディタの App embeds からいつでもオン/オフを切り替えられます。オフにするとバッジは表示されず、オンにするとアプリがすべて自動で処理します。

ノート

アプリはテーマファイルの編集、上書き、コードの挿入を行いません。すべてアプリの埋め込みブロックを通じて動作し、テーマとは別にShopifyが管理します。

設定の配信方法

作成したバッジ、ラベル、トラストバッジ、ハイライト、バナーはすべて、ストアに紐づく Shopifyメタフィールド(カスタムデータを保存するShopify標準の仕組み)として保存されます。

これにより、次のようなメリットがあります。

• ページ読み込み時に外部APIを呼び出しません — 設定はすでにShopifyに保存されているため、サードパーティのサーバーを待つ必要がありません。
• 高速なパフォーマンス — バッジは、テーマの他の要素と同じ速さで読み込まれます。
• 高い信頼性 — ストアがオンラインである限りバッジを利用でき、外部サーバーの障害の影響を受けません。

ストアフロントでのバッジの表示

お客様がストアにアクセスすると、次の流れで処理されます。

1. アプリの埋め込みスクリプトがテーマの一部として読み込まれます。
2. スクリプトが、保存されているメタフィールドからバッジの設定を読み取ります。
3. ターゲティングルール(各バッジを表示する商品、コレクション、ページ、顧客セグメント)を評価します。
4. 条件に一致したバッジが、設定した位置でページに表示されます。

この処理はすべてお客様のブラウザ内で行われ、数ミリ秒で完了します。

分析のトラッキング

Sami Product Labels は、バッジのパフォーマンスを測定するために2つの主要なイベントを記録します。

• Add to cart — お客様がバッジ付きの商品をカートに追加したときに、どのバッジが表示されていたかを記録します。
• Order placed — お客様がバッジ付きの商品を購入したときに、コンバージョンとして記録します。

これらのイベントは Analytics ダッシュボードに反映され、どのバッジがエンゲージメントや売上につながっているかを確認できます。

ノート

分析のトラッキングは DIAMOND プランで利用できます。アプリが記録するのは集計されたイベントのみで、お客様の個人情報は保存しません。

国の検出

アプリは訪問者の国を検出し、国によるターゲティングを可能にします。これにより、地域ごとに異なるバッジを表示できます。

たとえば、「Free Shipping」バッジを米国のお客様にのみ表示したり、「Local Pickup Available」バッジを自国のお客様に表示したりできます。

アプリが行わないこと

• テーマファイルを変更しません — Liquidコードは挿入されません。
• ストアの速度を低下させません — データは外部サーバーから取得されず、Shopifyのメタフィールドに保存されます。
• お客様の個人データを収集しません — ターゲティングに使うのは顧客タグと注文数のみで、氏名、メールアドレス、支払い情報は一切使用しません。

---

次のステップ

• 権限とデータアクセス — アプリがアクセスするデータと、その取り扱いについて説明します。
• テーマでアプリを有効にする — アプリの埋め込みブロックをオンにして始めましょう。