アクション名

このドキュメントでは、ウェブサイトで reCAPTCHA を統合するときにユーザーが開始したイベントの記述に使用されるアクション名について説明します。

reCAPTCHA を統合するときに、grecaptcha.enterprise.execute() の action パラメータでアクション名を指定します。アクション名は、一意で意味があり、ユーザーに固有ではないものを使用することをおすすめします。アクション名は大文字と小文字を区別しません。使用できるのは英数字、スラッシュ、アンダースコアのみです。該当する複数のアクションが掲載されているページがある場合は、複数のアクション文字列を連結できます（例: cart_view_payment）。

アクション名を使用することで、Google Cloud コンソールの reCAPTCHA ダッシュボードを通じて、ユーザーによるサイトの利用状況を詳細に把握できます。

次の表に、推奨されるアクション名と対応するイベントの例を示します。また、推奨されるアクション名を使用すると、reCAPTCHA がユーザーのアクションをページタイプに関連付けることもできるため、アクションの改ざんや複製を試みる攻撃など、さまざまな形式の攻撃をモニタリングする機能が向上します。

アクション名	ユーザーが開始したイベント
signup	ウェブサイトでの登録。
login	ウェブサイトへのログイン。
password_reset	パスワード再設定のリクエスト。
get_price	アイテムの価格を取得する。
cart_add	カートにアイテムを追加する。
cart_view	カートの内容を表示する。
payment_add	お支払い情報（カード情報や住所など）を追加または更新する。
checkout	ウェブサイトから購入手続きを行う。
transaction_confirmed	トランザクションが処理されたことの確認。
play_song	リストから曲を再生する。

次のステップ

• ウェブサイトでのアクション名の使用方法については、以下をご覧ください。
  • スコアベースのキーをウェブサイトにインストールする
  • ウェブサイトにチェックボックス キー（チェックボックス チャレンジ）をインストールする