トリガーの仕組み

トリガーが4つのメカニズムのうちどれを利用しているかを理解すれば、タイミングやセットアップに関するほぼすべての疑問、そしてなぜ発射されたのか、あるいは発射されなかったのかという理由も説明がつきます。

4つのメカニズム

メカニズム トリガー レイテンシ 基準値が必要 配送
Shopify Webhook 26 ほぼリアルタイム いいえ 保証付き
Webhook + 変更検出 52 ほぼリアルタイム はい 保証付き
世論調査 6 1回の調査期間まで はい 保証付き
ストアフロントのピクセル 14 いいえ 最善を尽くす

1. Shopify Webhook

Shopify イベントが発生した瞬間にアプリに通知され、アプリはそれをShopify Flowに直接転送します。「**割引の作成」**と「**場所の削除」**は、この仕組みで動作します。

これらのトリガーは、権限の設定以外に特別な設定は必要なく、それぞれ「**トリガー」**ページに専用のスイッチが用意されています。

2. Webhook と変更検出

これが最大のグループであり、このアプリが役立つ理由でもあります。Shopifyのproducts/updateウェブフックは、商品の編集が行われるたびに発火しますが、何が変更されたかについては通知されません。そこで、このアプリは:

  1. 必要なフィールドのスナップショットを保存し、
  2. 受信する各Webhookをそのスナップショットと照合し、
  3. その特定のフィールドが実際に変更された場合にのみ、その特定のトリガーを実行します。

このようにして、「**Product Title Changed」**は、タイトルの編集時にはトリガーされ、価格の編集時にはトリガーされないようになります。これは、どちらも同じ「Shopify」というWebhookとして送信されるにもかかわらずです。

3. ポーリング

Shopify ブログ、ブログ記事、ページ、注文の表示ステータス、割引の有効期限、および会社の所在地に基づく税設定については、ウェブフックを発行しません。これら6つのトリガーについては、アプリがスケジュールに従って確認を行い、差異が検出された際に通知を発信します。

ポーリングトリガーは、他のトリガーと同様に「**トリガー」**ページから有効にできます。これらは即座に発動するのではなく、1回のポーリングサイクル分のレイテンシを要します。

4. ストアフロント・ピクセル

Shopify 購入者の行動(商品ページの閲覧、カートへの追加、検索結果なし、チェックアウト時のエラー表示など)については、ウェブフックを送信しません。これら14のトリガーについては、アプリがストアフロントにウェブピクセルをインストールし、購入者のブラウザからイベントを報告します。

そこから3つのことが導き出され、それらがこれらのトリガーを他の3つのメカニズムとは一線を画すものとしている:

  • **オプトイン。**これには「**Storefront Behaviour Access」**の権限が必要で、開始時の状態が「オン」に設定されている必要があります。 オフ。これを用いたFlowワークフローを有効にすると、他のトリガーと同様に、そのワークフローが有効になります。その 最初のものがオンになるとpixelがインストールされ、どれもオンになっていない間は何も送信しません。
  • **同意に基づく制限。**分析に関する同意をしていない買い物客は、 ブラウザでは、そのイベントが私たちに届くことはなく、コストもかからず、ワークフローも開始されません。
  • **最善を尽くします。**タブが閉じられたり、接続が切断されたり、広告ブロッカーが作動したりすると、イベントは 決して到着せず、再試行も行われません。これらはシグナルやリアクションにのみ使用し、決して イベントを見逃すことは、正確性の問題となるでしょう。

また、これらのイベントは管理イベントよりも発生頻度がはるかに高いです。有効にする前に、ストアフロントのトリガー を参照してください。

ワークフローに何が届くか

フィールドレベルのトリガーは、新旧両方の値を返すため、追加のルックアップを行わなくても、値の変更そのものを条件として分岐処理を行うことができます:

yaml
Old price: 19.99
New price: 24.99
SKU:       WIDGET-BLUE-M
Flowの「変数を追加」パネルに、oldPrice、newPrice、delta、percentChange、directionを表示する
Shopify Flow に価格変更として渡される値:変更前後の値、差額、パーセンテージ、および方向。

リスト形式の変更内容は、カンマ区切りのテキストではなく構造化されたオブジェクトとして提供されるため、Flow内でそれらに対して反復処理や分岐処理を行うことができます。注文明細の変更、出版物の変更、および企業の拠点ごとの免税措置は、すべてこの方式で処理されます。

注文と重複

  • イベントはShopifyのイベントIDに基づいて重複排除されるため、再配信が行われても、あなたの ワークフローを2回実行する。
  • このアプリでは、店舗ごとのレート制限が短期間に設定されているため、数千件もの商品をまとめて編集することはできません ワークフローに過度な負担をかけることはありません。イベントは破棄されることなく、キューに入れられます。
  • 5,000件の商品を変更する一括処理では、5,000件のイベントが発生し、5,000を消費します。 毎月の割り当て量のうち。詳細は プランと利用方法 をご覧ください。
  • Storefrontイベントでは、短い期間内に同じページビューが繰り返された場合、それらをまとめて集計し、 2つの訪問トリガーにより、顧客または企業ごとの訪問全体が1つのイベントに集約されます。