このドキュメントでは、モバイルアプリに reCAPTCHA を統合する際に、ユーザーが開始したイベントを記述するために使用されるアクション名について説明します。
reCAPTCHA を統合する際は、grecaptcha.enterprise.execute() の action パラメータでアクション名を指定します。アクション名は、一意で意味があり、ユーザーに固有ではないものを使用することをおすすめします。アクション名では大文字と小文字は区別されません。また、英数字、スラッシュ、アンダースコアのみを使用できます。該当する複数のアクションが掲載されているページがある場合は、複数のアクション文字列を連結できます（例: cart_view_payment）。
アクション名を使用することで、Google Cloud コンソールの reCAPTCHA ダッシュボードを通じて、ユーザーによるサイトの利用状況を詳細に把握できます。
次の表に、推奨されるアクション名と対応するイベントの例を示します。 また、推奨されるアクション名を使用すると、reCAPTCHA がアクションをページタイプに関連付けることもできるため、アクションの改ざんや複製を試みる攻撃者など、さまざまな形式の攻撃をモニタリングする機能が向上します。
| アクション名 | ユーザーが開始したイベント |
|---|---|
registration または signup |
モバイルアプリで登録またはログインします。 |
login |
モバイルアプリにログインする。 |
password_reset |
パスワード再設定のリクエスト。 |
get_price |
アイテムの価格を取得する。 |
cart_add |
カートにアイテムを追加する。 |
cart_view |
カートの内容を表示する。 |
payment_add |
お支払い情報（カード情報や住所など）を追加または更新する。 |
checkout |
モバイルアプリからチェックアウトする。 |
transaction_confirmed |
トランザクションが処理されたことの確認。 |
play_song |
リストから曲を再生する。 |
次のステップ
- モバイルアプリでアクション名を使用する方法については、以下をご覧ください。