GA4のチャネルアトリビューションレポートに穴が開いています。先月のプッシュ送信は、メディアもソースもなく表示されるため、レポート上ではダイレクトトラフィックのように見え、収益の回復を逃しています。インストール時にチームが設定したプレースホルダーの先で、決して入力されなかったUTMパラメータにたどり着きます。このPushEngageサイト設定構成ガイドが存在するのは、今日その1つのフィールドを修正するには、ダッシュボードにログインし、正しいタブを見つけ、フォームが1つだけ編集できないため、すべての他のデフォルトフィールドを一度に入力し直す必要があるからです。
それがPushEngageサイト設定の実際のコストです。単一の設定が理解しにくいということではなく、サイトの詳細、キャンペーンのデフォルト設定、サービスワーカーの設定が別々の場所に存在し、誰も場所を覚えていないほどまれにしか触られず、1つのフィールドを修正するために完全なフォームの再入力を必要とすることです。このガイドでは、実際に再確認する3つの設定グループ（サイトの詳細、キャンペーンのデフォルト設定、サービスワーカーの設定）と、ダッシュボードのタブを探す代わりに、PushEngage MCPサーバーに接続されたAIアシスタントへの簡単な言語でのリクエストで、それらをどのように変更できるかについて説明します。
PushEngageサイト設定の構成が、5分間の修正ではなくサポートチケットになる理由
サイト設定は一度設定して忘れるものではありません。ビジネスの形が変わるたびに再確認されます。新しい市場はタイムゾーンの変更を意味し、新しいアトリビューション要件はUTMパラメータの更新を意味し、リブランディングは「Powered By PushEngage」トグルを再確認する必要があることを意味し、プラットフォーム移行はサービスワーカーファイルがPushEngageが期待する場所にまだ存在するかどうかを確認することを意味します。これらはそれぞれダッシュボードの異なるコーナーに存在するため、実際の摩擦は編集そのものではありません。タブを再検索し、意図せずに触ったフィールドを再入力し、3か月後に何か別のものが変更されたときに再び行うタスクを実行することです。
3つの障害モードが十分に頻繁に発生し、問題となりますが、発生時にエラーを発生させるものはありません。
- UTMのデフォルトのギャップ。キャンペーンのデフォルト設定は、プレースホルダーまたは空白のUTMパラメータで出荷されるため、その期間のすべてのプッシュ送信は、メディアまたはソースなしでGA4に表示され、チャネルアトリビューションレポートでは見えなくなります。
- フォールバック通知の欠落。セグメント化されていない購読者、つまりどのオーディエンスルールにも一致しない購読者は、チームが選択した意図的なデフォルトではなく、何も受け取らないか、一般的なコピーを受け取ります。
- サイト移行後のサービスワーカーパスの遅延。これにより、原因となった設定を指し示す明白なエラーメッセージを生成することなく、通知の配信が完全に停止します。
これら3つすべてが、誰かが通常、辻褄の合わないレポートを見ているときに気づくまで、静かにデータ、リーチ、または配信を失わせます。
サイト設定を、一度きりのインストール手順ではなく、定期的なチェック項目として扱う場合や、チェック方法を変更する場合に当てはまります。
はじめに：PushEngage MCPサーバーをアシスタントに接続する
@pushengage/mcp は PushEngage の公式 Model Context Protocol サーバーであり、このガイドのすべてのツールはこれを介して実行されます。Claude Desktop の claude_desktop_config.json、Cursor の ~/.cursor/mcp.json、または Claude Code の MCP 設定に、コマンド npx -y @pushengage/mcp を使用してクライアントの MCP 設定に追加します。グローバルインストールは不要です。
アシスタントにログインを依頼する最初の際、ブラウザタブが開き、接続を承認するため、PushEngage のパスワードがアシスタントに触れることはなく、生成されたトークンはローカルマシンに保存されます。そこから、PushEngage のサイトを表示するように依頼し、作業したいサイトを選択します。以下のすべての設定ツールは、現在選択されているサイトをデフォルトとします。トラブルシューティング接続の問題を含む完全なウォークスルーについては、PushEngage MCP セットアップガイドを参照してください。
サイトの詳細：名前、URL、タイムゾーン、ジオロケーション、ブランディングトグル
pushengage_get_site_details は現在の設定を読み取り、pushengage_update_site_details はそれを変更します。これら 2 つで、PushEngage 独自のオンボーディングドキュメントで「サイト詳細の追加」と呼ばれるフィールドをカバーします。
- サイト名
- サイトURL
- タイムゾーン
- ジオロケーション追跡
- ダッシュボードウィジェットの「Powered By PushEngage」ブランディングトグル
初期インストール後にこれらの pushengage サイトの詳細のいずれかを修正する必要があった場合、これら 5 つのフィールドすべてにアクセスできるのがこのツールのペアであり、何か設定ミスを想定する前にそれらを読み戻す場合も同じツールのペアです。
タイムゾーンは見た目以上に重要です。これは、すべてのスケジュール送信と、購読者のタイムゾーンに基づくスケジューリングの参照点となります。これを間違えると、午前 9 時の送信がリストの一部に対して午前 2 時に配信され、実際の原因は設定ミスのある 1 つのフィールドであるにもかかわらず、ターゲティングの失敗として読み取られます。
ジオロケーションはデフォルトでオフになっており、PushEngage が都市、州、国データを購読者レコードに添付できるようになる前に明示的にオンにする必要があります。これは、ジオロケーションターゲティングが依存する基盤となります。セグメントが場所を参照していて、数値が少ないように見える場合は、購読者ベースが期待する地理的な広がりを持っていないと想定する前に、これを調べる価値があります。
ブランディングトグルはよりシンプルです。ダッシュボードウィジェットに「Powered By PushEngage」が表示されるかどうかを制御します。これは、表示されるすべてのベンダーマークが精査されるホワイトラベルのサポートまたはチャットエクスペリエンスを実行しているチームにとって最も重要です。
これらはどれもサポートチケットや、ネストされた設定メニューの検索を必要としません。READMEの例がそのまま従うべきパターンです。「サイトのタイムゾーンをアジア/コルカタに変更し、ジオロケーションをオンにして」とアシスタントに尋ねれば、両方のフィールドが1つのリクエストで更新されます。ドメイン変更後にサイトURLを修正したり、リブランド後にサイト名を修正したりする場合も、全く同じパターンに従います。
キャンペーンのデフォルト設定：すべての送信の帰属とリーチを静かに制御する設定
pushengage_get_campaign_defaultsとpushengage_update_campaign_defaultsは4つのフィールドをカバーしています。これらのプッシュエンゲージのキャンペーンデフォルトは見た目だけの問題ではありません。これらは、チームの誰もその存在を覚えていなくても、実行するすべての送信の下にある設定であり、そのうちの1つでも間違っていると、すぐに誰も気づかないほど大きな失敗にはなりません。
- UTMパラメータ：GA4またはそれに続く分析スタックでプッシュ通知をUTMパラメータで追跡するためのベースラインです。この設定をスキップすると、すべての送信で帰属が空白になります。ソースやミディアムのない送信、帰属できない収益、月次レポートの合計が合わないまで誰も気づかないギャップが発生します。この記事を開いたチャネル帰属レポートがそれです。
- フォールバック通知：どのオーディエンスルールにも一致しない購読者に対して送信されるものです。これを未設定のままにすると、それらの購読者は何も受け取りません。
- フォールバック属性：同じセグメント化されていないグループのパーソナライゼーション用トークン。これにより、コピーが壊れている、または一般的であるのではなく、意図されたものであるように読まれます。一致する属性がない購読者は、名前に表示されるはずの場所に空白スペースを見るべきではありません。
- デフォルトの通知有効期限：配信されなかった送信がキューに保持される期間。この期間を過ぎるとPushEngageはそれを削除します。7日間の有効期限を持つフラッシュセール送信は、セール終了後数日経ってから届く可能性があり、購読者を誤解させます。単に静かに失敗するのではなく、送信が届かなかったことよりも関係にとって悪いことです。
7日間のデフォルト有効期限の設定は1つのリクエストで完了します。「デフォルトの通知有効期限を7日に設定して」と、READMEの例からそのまま引用できます。同じパターンで、一致しない購読者向けのフォールバック通知、そのグループのパーソナライゼーション用のフォールバック属性、またはUTMパラメータの完全な設定をカバーし、今後すべての送信がGA4に正しく帰属されるようになります。レポートのギャップが明らかになるまでではなく、大きな送信ウィンドウの前に現在のプッシュエンゲージキャンペーンのデフォルト設定を確認することは、構築する価値のある習慣です。
サービスワーカーの設定：登録、サブフォルダのサポート、ワーカーファイルのパス
pushengage_get_service_worker_settings および pushengage_update_service_worker_settings は、登録、サブフォルダーのサポート、ワーカーファイルのパスをカバーしています。これらは、プッシュ通知がそもそもブラウザに届くための仕組みです。これら3つのうちどれか1つでも間違えると、失敗モードは同じになります。通知は、原因となった設定を指し示す明らかなエラーなしに静かに配信されなくなり、最初に気づく症状は、原因不明の送信スルー数の低下です。
サブフォルダーのサポートは、ルートレベルのワーカーファイルを許可しないプラットフォームの制約があるサイト（CMS、サブディレクトリのインストール、1つのドメインを共有するマルチサイト設定など）でつまずく原因となります。ワーカーファイルがルート以外の場所にある場合、パス設定はディレクトリとファイル名の両方でその正確な場所に一致する必要があります。そうでない場合、登録は静かに失敗します。
サイトの移行やプラットフォームの変更後に最初に確認すべきことはこれです。アシスタントに現在のpushengageサービスワーカー設定を取得させ、登録されたパスが実際にファイルが存在する場所と一致していることを確認してください。これは、PushEngage自身のプラットフォーム制約のあるセットアップ用のサービスワーカー設定が解決するために存在するのと同じ種類のチェックです。
登録自体も定期的に確認する価値があります。特に、サイトがスクリプトを読み込む方法に変更があった後は重要です。コンテンツセキュリティポリシーの更新、新しいタグマネージャーコンテナ、またはヘッダーを削除するキャッシングレイヤーは、それぞれ登録に干渉する可能性があり、その影響は配信された通知の静かな低下以外には現れません。配信率のチェックと並行してpushengageサービスワーカー設定を取得することは、問題がレポートサイクル全体にコストをかける前にそれを捉える5分間の習慣です。
すべてを再入力しない部分的な編集：マージ動作が重要な理由
AIアシスタントに依頼することがダッシュボードよりも速い理由（単に違うだけでなく）の詳細はこちらです。pushengage_update_campaign_defaults は、レコード全体を置き換えるのではなく、変更を現在の値の上にマージします。デフォルトの通知有効期限のみを変更するように依頼した場合、UTMパラメータ、フォールバック通知、フォールバック属性はそのまま保持されます。触る意図のないフィールドを再指定する必要はありません。
これは、典型的な設定フォームと比較してください。保存されたブロックの1つのフィールドを変更すると、多くの場合、フォーム全体がすべてのフィールドを編集可能にして再読み込みされ、関係のないフィールドでのミスが、正しく機能していたものを静かに上書きしてしまうことがあります。「デフォルトの通知有効期限を7日に設定して」は、正確に1つのものを変更し、キャンペーンのデフォルトの残りはそのままにします。これは、ターゲットを絞った編集と、単一の設定を微調整する必要があるたびに完全な再保存との違いであり、月次の設定レビューを15分間の雑用から、本来あるべき1文のリクエストに戻す違いです。
正確な設定が実際に保護するもの：整理整頓だけでなく、配信可能性と属性
これらはすべて、整頓に関するものではありません。間違ったタイムゾーンは、リストの一部でスケジュール送信のタイミングを壊します。欠落しているUTMデフォルトは、誰かがそれに気づくまで、すべての送信のアトリビューションを壊します。登録されていないサービスワーカーは、配信を完全に壊し、それを静かに実行します。これらの設定のそれぞれは、チームが実行するすべてのキャンペーンの下にあります。キャンペーンは大きな音で失敗しません。その上のレポートは、静かに現実に合わなくなります。
サイトの詳細、キャンペーンのデフォルト、およびサービスワーカーの構成を、配信率ダッシュボードをチェックするのと同じように、定期的にチェックするAIアシスタントプッシュ通知設定として扱う実際のケースです。一度設定して二度と見直さない一時的なセットアップステップではなく。これらの設定を、埋もれたダッシュボードタブではなく、AIアシスタントプッシュ通知設定として提示することは、チェック自体がリクエストを入力するのにかかる時間と同じくらいかかります。壊れたUTMデフォルトまたは古いワーカーパスを1つのリクエストでキャッチすることは、ITチケットや再オンボーディングコールを待つことなく、保持レポートが依存するのと同じ収益回復数を保護します。これは、声に出して言うのに1文しかかからないものを修正するためです。
PushEngage MCPサーバーが接続されたら、このpushengageサイト設定構成ガイドでカバーされている3つの設定グループを、他の保持監査を実行するのと同じように実行します。レポートが合わない場合にのみ実行するのではなく、迅速に、自分のスケジュールで実行します。これはすべてのPushEngageプランで機能し、無料ティアを含みます。そのため、MCPサーバーが接続されていることと、アトリビューションやリーチを失う前にpushengageサイトの詳細、キャンペーンのデフォルト、およびサービスワーカー設定をチェックするために実際に使用することとの間にゲートはありません。
