ドキュメント
Slack で AutoPSEO を使う
AutoPSEO の Slack メッセージの内容、Send to Slack で任意のレポートテーブルをチャンネルに投稿する方法、そして Slack 上でできること・できないことを説明します。
Slack は AutoPSEO を「読む」ための場所であり、操作する場所ではありません。定期レポートやアラートは、アプリに戻る Open report ボタン付きの整形済みメッセージとして届きます。また、どのレポートページからでも Send to Slack で、表示中のテーブルをチャンネルに送信できます。ルールの作成、一時停止、ミュートは AutoPSEO 上で行います。Incoming Webhook はメッセージを一方向にしか送れないためです。
メッセージの構成
メッセージには Slack の Block Kit レイアウトを使用しています。上から順に次のとおりです。
- ヘッダー: レポートの種類または検知ルールと、プロパティ名（
sc-domain:プレフィックスは付きません）。アラートのヘッダーは、重大度を示すマーカーで始まります。 - サマリー: 対象期間と主な変化を 1 文で示します。
- フィールド: ラベル付きの数値を最大 10 件表示します。レポートではクリック数、表示回数、CTR、平均掲載順位とその変化、アラートでは指標、現在値、ベースライン、期間、変化を表示します。
- テーブル: レポートおよびレポートサマリーでは、等幅ブロックで最大 10 行を表示します。
- フッター: プロパティ、アラートの場合は重大度、そしてメッセージの送信時刻（UTC）を表示します。
- Open report: AutoPSEO 内の該当レポートを開くボタンです。
メッセージ内の数値は、ある時点のスナップショットです。ボタンから開くレポートは通常の日付範囲で表示されるため、合計値がメッセージの対象期間と異なる場合があります。
任意のレポートを Slack に送信する
ほとんどのレポートページには、ツールバーに紙飛行機アイコンの Send to Slack ボタンがあります。名前は Slack ですが、Teams や Webhook を含め、追加済みのどのチャンネルにも投稿できます。
- ページのテーブルの読み込みが完了するまで待ちます。完了前にクリックすると、待つよう促すメッセージが表示されるだけです。
- Send to Slack をクリックします。ダイアログにチャンネルの一覧が表示されます。チャンネルがまだない場合は、Set up a channel が表示されます。
- チャンネルを選び、必要に応じて 300 文字までのメモ（チームに注目してほしい点など）を追加します。
- 先頭の行のプレビューを確認し、Send now をクリックします。
メッセージには、ページのタイトルとプロパティ、ページに表示されている日付範囲、ページのサマリーカード（最大 8 枚）、そしてメインテーブルの先頭 10 行・表示中の先頭 6 列が含まれます。並べ替えとフィルタは、最後に設定した状態のまま反映されます。メッセージ内の Open report リンクからは、同じフィルタと日付でページを開き直せます。Webhook にはイベントタイプ report_summary で送信されます。
各 Slack チャンネルの受信内容を確認する
Slack, Teams & Webhooks ページの Slack - Subscriptions テーブルには、追加したすべての Slack チャンネルについて、そこに投稿される定期レポートとアラート、そのスケジュール、有効か一時停止中かが一覧表示されます。何も紐づいていないチャンネルには Nothing posts here yet と表示されるため、使われていない項目を見つけて削除しやすくなっています。
Slack 上でできること・できないこと
- 返信、リアクション、スレッドは Slack 内で完結します。AutoPSEO がチャンネルの内容を読み取ることはありません。
- Slack でメッセージを削除しても AutoPSEO には影響せず、次回の定期メッセージも通常どおり届きます。
- スラッシュコマンドや、アラートを確認済みにしたりミュートしたりするボタンはありません。ルールの通知を減らすには、ルールに Mute until を設定するか、一時停止してください（アラート）。
- チャンネルへの配信をすべて止めるには、そのチャンネルのルールを一時停止するか、チャンネルの登録を削除してください（Slack の接続）。
- レポートの内容を変更するには、アプリ内でスケジュールを編集してください（定期レポート）。
チャンネル以外への共有
Slack メッセージは、すでにそのチャンネルにいるメンバー向けの手段です。ログインを持たないクライアントや同僚には、共有リンクでレポートのスナップショットを共有できます。また、エクスポートを使えば、テーブルをファイルとして取り出して送ることもできます。