広告主向けの月次レポートを媒体の管理画面の数値と照らして校正し、転記の誤り・合計と率の計算違い・前月比の向きの取り違えを送付前に拾う

処理の起点を決める

運用担当がチェック用のスプレッドシートのメニューから実行します。 レポートのURLを決まったセルに貼り、「チェックを実行」を押します。時間で動く定時の実行にはしません。 レポートは作っている途中の状態があり、完成した時点を知っているのは運用担当だけだからです。

直した後に、何度でも実行し直せる形にします。 1回目の一覧を見て直し、2回目で一覧が空になることを確かめてから、ダブルチェックに回します。ダブルチェックの担当は、一覧が空になっているかを最初に見ます。

1回の実行は6分までです。 Apps Script の実行時間の上限が1回6分とされているので、1回に1つのレポートだけを見ます。 120件をまとめて流す作りにはしません。

入力データを集める

質を決めるのは、列の対応表と指標の向きの表です。 列の対応表が無いと、媒体の書き出しの「Clicks」「クリック」「クリック数」を同じ指標として扱えません。指標の向きの表が無いと、コメントの「改善」が正しいかを決める根拠がありません。

指標の向きの表は、広告主ごとに上書きできるようにします。 たとえば表示回数は、認知を目的にする広告主では増えれば改善ですが、獲得を目的にする広告主では向きを持たない指標として扱うこともあります。

データの取得方法を決める

Utilities.parseCsv は、CSV の文字列を表の形の2次元の配列にして返します。 区切りの文字を指定する形もあるので、TSV で書き出す媒体にも同じ関数で対応できます。

レポートの表の位置は、ひな形の名前付き範囲で決めておきます。 セルの番地で読むと、運用担当が行を足しただけで読む場所がずれます。ひな形に「媒体別_表」「サマリー_表」「コメント」のような名前を付けた範囲を作り、スクリプトはその名前で読みます。

前月のレポートが見つからないときは、前月比の検算を飛ばして、その旨を一覧に書きます。 新しい広告主の初月はこれに当たります。

AIへ渡す前に整形する

1. 媒体の書き出しの見出しをそろえる … 列の対応表で、媒体ごとの列名を共通の指標名に置き換えます
2. 合計の行を外す … 書き出しの最後にある合計の行を、明細として二重に足さないようにします
3. 数値の形をそろえる … 3桁区切りのカンマ、通貨の記号、「%」を外して数値にします
4. 期間を確かめる … 書き出しの期間が前月の1日から末日になっているかを、ファイルの中の期間の記載で確かめます
5. コメントを文に分ける … コメントの欄を文ごとに分け、文に番号を振ってAIに渡します
6. 計算式が入っているかを確かめる … サマリーの表の合計と率のセルに、値ではなく計算式が入っているかを見ます

4番目を省くと、照合がすべて正しく「合っていない」になります。 書き出しの期間を当月の途中までにしていた、前々月を選んでいた、という誤りは月に数件起きます。期間が違うときは、照合をせずに「期間の誤り」とだけ書きます。 数十行の不一致を並べるより、原因を1行で示すほうが早く直ります。

6番目は、第3章の（b）を拾うためです。 計算式が値で上書きされていても、その月の値が正しければ照合では見つかりません。計算式が消えていること自体を一覧に出します。

AIに処理させる

させるのは、コメントの文から、数値や増減についての主張を抜き出すことだけです。 照合はスクリプトが行います。

指標の名前は、決めた一覧の中から選ばせます。 「獲得単価」「CPA」「コンバージョン単価」は同じ指標です。一覧の名前に寄せさせ、一覧に無い指標は other にします。

照合は、スクリプトの側で3つ行います。

3つ目が、第3章の（c）を拾う照合です。 「CPA・上昇・改善」は、CPAが下がると改善という表に照らして ng_evaluation になります。AIは向きの表を知らなくても、抜き出しさえ正しければ照合は決まります。

指示内容を固定する

あなたは広告運用のレポートの校正担当です。
コメントの文から、数値や増減についての主張を抜き出してください。
主張が正しいかどうかは判断しないでください。抜き出すだけです。

【指標の一覧】この中の名前で書く。無ければ other
impressions（表示回数）, clicks（クリック数）, ctr（クリック率）,
cost（費用）, cpc（クリック単価）, conversions（コンバージョン数）,
cvr（コンバージョン率）, cpa（獲得単価・コンバージョン単価）, roas

【抜き出し方】
- 1つの文に複数の主張があれば、主張ごとに1件にする
- direction は up / down / flat / none のどれか
  「上昇」「増加」「伸びた」は up、「低下」「減少」「抑えた」は down
- evaluation は positive / negative / none のどれか
  「改善」「好調」「効率化」は positive、「悪化」「課題」「伸び悩み」は negative
- 数値は書かれているとおりに value に写し、単位を unit に書く
- 比べる期間は mom（前月比）/ yoy（前年同月比）/ unspecified
- 媒体やキャンペーンの名前が書かれていれば scope に写す

【厳守事項】
- 書かれていない数値を補わないでください。
- 向きの語が無い文から向きを推測しないでください。direction は none です。
- 「改善」と書かれていても、指標が上がったか下がったかは、
  文に書かれている向きの語だけで決めてください。
- 主張が正しいか、表現が適切かの意見を書かないでください。
- 数値や増減の主張の無い文は出力に含めないでください。

【コメント】
{sentences}
（各行は「文番号｜文」です）

「評価の語から向きを推測しない」が、この指示の要です。 書かなければ、「CPAが改善」という向きの語の無い文に、AIが気を利かせて down を入れます。 正しい推測でも、それでは「向きの語が書かれていない」という事実が消え、照合の意味がなくなります。

「正しいかを判断しない」を2か所に書くのは、AIが校正の担当として自分で直そうとするためです。 誤りに気づくと、抜き出しの段で数値を正しい値に直して返すことがあります。直された値では、誤りが一覧に出ません。

出力形式を固定する

Claude API の構造化出力で、次の形のJSONを受け取ります。

{
  "claims": [
    {
      "sentence_no": 3,
      "metric": "cpa",
      "period": "mom",
      "direction": "up",
      "value": "18",
      "unit": "%",
      "evaluation": "positive",
      "scope": "all",
      "quote": "CPAは前月比18％上昇と改善しました"
    }
  ]
}

スキーマでは metric・direction・evaluation・period を enum で値の候補に絞り、オブジェクトに additionalProperties: false を付けます。構造化出力では enum と additionalProperties: false が使え、数値の範囲や文字列の長さの制約は使えないとされているので、value は文字列で受け取り、数値への変換はスクリプトで行います。

1つ目の理由は、照合をスクリプトの比較だけで書けることです。 metric と direction が決まった語で返るので、計算した前月比の符号との比較は1行の条件で済みます。 自由文で返されると、照合の前に文を読み解く段が要ります。

2つ目は、quote で直す場所がすぐ分かることです。 一覧に原文が出るので、運用担当はコメントのどの文を直せばよいかを探さずに済みます。

チェック用のシートに書き出す一覧は、次の列にします。

システムへ連携する

呼び出しの部分は、次のような形になります。 モデル名とスキーマは、利用する時点の公式ページに合わせてください。

function extractClaims(sentences, schema) {
  const key = PropertiesService.getScriptProperties().getProperty('CLAUDE_API_KEY');
  const body = {
    model: MODEL_NAME,            // 利用するモデル名（設定のシートから読む）
    max_tokens: 2000,
    messages: [{ role: 'user', content: PROMPT + sentences }],
    output_config: { format: { type: 'json_schema', schema: schema } }
  };
  const res = UrlFetchApp.fetch('https://api.anthropic.com/v1/messages', {
    method: 'post',
    contentType: 'application/json',
    headers: { 'x-api-key': key, 'anthropic-version': '2023-06-01' },
    payload: JSON.stringify(body),
    muteHttpExceptions: true
  });
  if (res.getResponseCode() !== 200) return null;   // 一覧に「未実施」と書く
  const msg = JSON.parse(res.getContentText());
  const block = msg.content.find(b => b.type === 'text');   // テキストのブロックを探す
  return block ? JSON.parse(block.text) : null;
}

JSONは応答のテキストのブロックに入るとされています。先頭のブロックと決め打ちせず、種類がテキストのブロックを探して読みます。

応答の stop_reason が途中で切れたことを示すときは、スキーマに合わないことがあるとされているので、null と同じ扱いにして「未実施」と書きます。

APIキーはスクリプトのプロパティに置きます。 Properties サービスのスクリプトのプロパティは、スクリプトの利用者全員で共有される設定の置き場とされています。コードの中に直接書かないでください。 チェック用のスプレッドシートをコピーしたときにキーが一緒に広がります。

Apps Script の外部への呼び出しには、1日の回数の上限があります。 URL Fetch の呼び出しは、一般のアカウントで1日20,000回、Workspace のアカウントで1日100,000回とされています。1つのレポートで呼ぶのは1回なので、月120件では上限に届きません。

人が確認する

この構成の出力は、直す箇所の一覧です。 直すのも、直さないと決めるのも運用担当です。

1. missing_formula と「期間の誤り」を先に直す … これが残っていると、他の照合の結果が信用できません
2. ng_value を直す … 転記と計算の誤り。レポートの値を直します
3. ng_direction と ng_evaluation を読む … コメントの文を直します。数値の側が正しいかも、もう一度見ます
4. warn を確かめる … 端数の扱いで許容の幅に近いもの、AIが指標を other にしたもの
5. もう一度実行し、一覧が空になったことを確かめる
6. 別の担当がコメントの中身を読む … 数値と向きは見ずに、説明が伝わるかだけを読みます

3番目で数値の側も見るのは、コメントが正しく数値が誤っていることもあるからです。 「CPAは低下」と書いたのに ng_direction が出たとき、転記の誤りで前月比の符号が逆になっていることがあります。

目標は、120件をならして1件12分です。 一覧が数件で済むレポートは5分程度、媒体の書き出しを取り直すレポートは20分を超えます。

例外に対処する

上から3行は、書き出しの手順の問題です。 手順書を直すほうが、照合の精度を上げるより効きます。

記録を残す

• 実行の日時、実行した運用担当、レポートのURL
• 照合に使った媒体のファイルの名前と更新日時
• 一覧の全件（初回と、直した後の各回）
• AIが返した claims の全件
• 送付した時点の一覧が空だったか

最後の項目は、送付の後に「数字が合わない」と言われたときに使います。 一覧が空のまま送ったのなら照合の漏れ、一覧が残ったまま送ったのなら手順の漏れで、直す場所が違います。