集計の考え方

利用者がコピー操作を行い、利用集計が許可されている場合に、その時点の構造情報を1件として送ります。

コピーしたコード本文は送信しません。送るのは、使用された項目を数えるための正規化済みデータだけです。

post_type、posts_per_page、orderbyなどのパラメータ名に加え、Tax Query、Meta Query、Date Queryで使われた条件ブロックを数えます。可変条件では、条件の個数を集計用の回数へ反映する場合があります。

プリセット名そのもの、画面の開閉状態、説明表示のON/OFFなど、WP_Queryの利用傾向として公開する必要がない内部UI状態は、公開ランキングから除外します。

post_status=publish、orderby=date、order=descなど、あらかじめBuilderのUIで定義され、集計用の許可リストで正規化できる値を「安全な選択値」として数えます。

利用者が自由に入力したカスタム投稿タイプ名、タクソノミー名、メタキーなどは、安全な選択値へ置き換えず、集計対象から除外します。

たとえば、同じクエリでpost_typeとtax_queryが使われた場合、その組み合わせを1件として数えます。AとB、BとAを別の組み合わせにはせず、並びを正規化してまとめます。

利用者が入力した具体値同士の関係は記録しません。組み合わせとして扱うのは項目名だけです。

コピー操作のたびに回数が増えると利用傾向が偏るため、同じ画面で同じ生成コードを続けてコピーした場合は再送を抑えます。入力を変更して生成コードが変わった後のコピーは、新しい利用として集計対象になります。

この抑制はブラウザ上の現在の操作状態に基づくものです。利用者や端末を長期間追跡して、すべての重複を排除する仕組みではありません。

初期本番設定では、最初のコピー後に非モーダルの案内を表示し、利用者が許可するまで項目別の集計を送りません。許可前に行ったコピーは、あとから許可しても遡って送信しません。

設定は外部送信とプライバシー設定で変更できます。設定は端末とブラウザごとに保存されます。

1. Builderが、許可された正規化済みの項目・選択値・組み合わせを自サイト内APIへ送ります。
2. 一般的なコピー操作と、許可された項目別の利用状況をGA4へ送る場合があります。
3. Google Apps ScriptがGA4の集計値を原則1日1回取得し、日付別に整理します。
4. 保護された取り込みAPIが、トークンを確認して公開用の履歴データを更新します。
5. 利用傾向ページとJSON APIが、保存済みの集計値から割合と順位を計算します。

同じ日のGA4データがある場合はGA4側を優先し、なければ自サイト内で保持したローカル集計を使います。両方を足して二重計上しません。

公開ページでは、当日を含む1日、7日、30日、365日の期間を選べます。「直近1年」は累積の全期間ではなく、常に過去365日を対象とする移動窓です。日付が変わると開始日も1日ずつ進みます。

日付の表示とGAS側の日付整形は日本時間（Asia/Tokyo）を基準にします。集計更新は原則1日1回のため、当日の利用がすぐに反映されない場合があります。

公開割合は、原則として次の式で計算します。

項目の利用割合（%）＝ その項目を使ったクエリ数 ÷ 同じ期間の集計対象クエリ数 × 100

小数点以下は四捨五入し、0〜100%の範囲に収めます。複数項目を同じクエリで使えるため、全項目の割合を合計しても100%にはなりません。順位は割合の高い順、同率の場合は項目名順です。

古いデータなどで全クエリ数が記録されていない場合は、基本項目のうち最も大きい件数を代替の母数として使います。最頻出項目を常に100%へ補正する表示ではありません。

履歴と概要データのどちらにも利用件数がない場合、ページのレイアウトを確認できるよう参考値を表示することがあります。実集計データが1件でも利用可能になれば、参考値ではなく実データから割合を計算します。

参考値は実際の利用傾向を示す統計ではありません。本番では更新日時と集計期間をあわせて確認してください。

• 利用集計を許可した状態でコピーしたクエリだけが対象です。
• コードを生成してもコピーしなかった操作は含まれません。
• 広告ブロッカー、通信障害、ブラウザ設定などにより送信されない場合があります。
• 同一利用者を識別して完全な重複排除を行うものではありません。
• 項目の追加・名称変更・除外方針の変更により、期間同士を単純比較できない場合があります。

公開数値は厳密な市場調査ではなく、Builderの改善や、利用者が設定項目を知るための参考情報です。