> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# アプリ内クリックアクション

> アプリ内メッセージの要素にクリックアクションを設定して、URLを開く、プッシュまたは位置情報の権限を求める、Outcomeを追跡する、ユーザーをタグ付けする、またはカスタムロジックをトリガーします。

クリックアクションとは、アプリ内メッセージの要素（ボタン、画像、背景）に付加するインタラクティブなイベントです。ドラッグアンドドロップエディターを使用するか、HTMLエディター内の [In-app JavaScript API](./in-app-message-api) を通じて追加できます。

<Frame caption="iOSでの位置情報とプッシュ権限プロンプトを示すクリックアクションのフロー">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/iam/a800e8b-Click_Action.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=3aa66c522aa9ed079e096e3386c2bff9" alt="アプリ内メッセージのクリックアクションがiOSで位置情報とプッシュ権限プロンプトをトリガーする仕組みを示す図" width="2574" height="1244" data-path="images/iam/a800e8b-Click_Action.png" />
</Frame>

## クリックアクションの種類

### URL

デバイスのデフォルトブラウザで指定したURLを開きます。[In-App JS API](./in-app-message-api) の `openUrl` にマッピングされます。アプリ内でのディープリンクには、**Custom Action ID** を使用してください。

### プッシュ権限プロンプト

ネイティブのiOSまたはAndroidプッシュ権限プロンプトを表示します。デバイスがすでにサブスクライブされている場合、アプリ内メッセージは表示されません。デバイスが以前にプロンプトを表示されて拒否した場合、アプリ設定でプッシュ通知を有効にするようユーザーに求めるネイティブアラートが表示されます。[In-App JS API](./in-app-message-api) の `triggerPushPrompt` にマッピングされます。

### 位置情報権限プロンプト

位置情報追跡の権限を求めるネイティブOSプロンプトを表示します。アプリに[位置情報追跡権限](./mobile-sdk-reference#location)を含める必要があります。セットアップ方法については [Location Opt-In Prompt](./location-opt-in-prompt) を参照してください。[In-App JS API](./in-app-message-api) の `triggerLocationPrompt` にマッピングされます。

### Outcomeを送信

分析目的でユーザーインタラクションを追跡します。アプリ内メッセージを通じて送信されたOutcomesは「Unattributed」として表示され、`outcome_name : true` の形式でユーザーに[タグ](./add-user-data-tags)を設定します。詳細については [Custom Outcomes](./custom-outcomes) を参照してください。[In-App JS API](./in-app-message-api) の `sendOutcome` にマッピングされます。

### ユーザーをタグ付け

ユーザーの回答に基づいて[タグ](./add-user-data-tags)を追加し、よりターゲットを絞ったメッセージングのためにセグメント化できます。[In-App JS API](./in-app-message-api) の `tagUser` にマッピングされます。

### Custom action ID

要素がクリックされたときに、[SDK IAM Click Listener](./mobile-sdk-reference#addclicklistener-in-app) を通じてアプリが読み取るカスタム値を渡します。次の用途に使用します：

* インタラクションデータを独自のサーバーや分析ベンダーに送信する。
* [アプリ内でのディープリンク](./deep-linking)で特定の画面に移動する。

[In-App JS API](./in-app-message-api) の `addClickName` にマッピングされます。

#### Collecting custom click actions

任意の画像またはボタンブロックに **Custom Action ID** を設定して、クリックされた要素を識別します。アプリは [SDK IAM Click Listener](./mobile-sdk-reference#addclicklistener-in-app) を通じてクリックを検出し、サーバー、データベース、または分析ベンダーにデータを送信できます。

<Accordion title="Example: create a poll" icon="square-poll-vertical">
  複数選択アプリ内メッセージの各ボタンに一意のAction IDを設定します。ユーザーがオプションをクリックすると、アプリは [SDK IAM Click Listener](./mobile-sdk-reference#addclicklistener-in-app) を通じてそれを検出し、サーバーに回答を送信して、後でユーザーに集計結果を表示できます。

  Action IDの代わりに **Tag** を使用して、クリックされた要素を識別し、ユーザーの回答に基づいてセグメント化することもできます。
</Accordion>

***

## 関連ガイド

<Columns cols={2}>
  <Card title="ディープリンク" icon="link" href="./deep-linking">
    プッシュおよびアプリ内メッセージ向けにカスタムURLスキームとアプリ固有のルーティングを設定します。
  </Card>

  <Card title="In-app JavaScript API" icon="code" href="./in-app-message-api">
    HTMLアプリ内メッセージエディターでのクリックアクションメソッドのリファレンスです。
  </Card>

  <Card title="App Storeレーティングの例" icon="star" href="./example-app-store-review">
    アプリ内メッセージからApp Storeレビューを促すステップバイステップのチュートリアルです。
  </Card>

  <Card title="古いアプリバージョンのユーザーをターゲットにする" icon="rotate" href="./app-version-update">
    ユーザーにアプリのアップデートを促します。
  </Card>

  <Card title="バナーアプリ内メッセージでユーザーをオンボードする" icon="hand-wave" href="./example-create-a-tutorial">
    アプリのUIをブロックしないコンテキスト対応の上部・下部バナーアプリ内メッセージでユーザーをガイドします。
  </Card>
</Columns>

***

## FAQ

### 1つの要素に複数のクリックアクションを追加できますか？

いいえ。各要素（ボタン、画像、背景）はクリックアクションを1つのみサポートします。複数の動作をトリガーするには、**Custom Action ID** を使用して、[SDK IAM Click Listener](./mobile-sdk-reference#addclicklistener-in-app) を通じてアプリ内でロジックを処理してください。

### アプリ内の画面にディープリンクするにはどうすればよいですか？

**Custom Action ID** クリックアクションを使用して、[SDK IAM Click Listener](./mobile-sdk-reference#addclicklistener-in-app) を通じてアプリでルーティングを処理します。**URL** アクションはリンクをブラウザで開くため、アプリ内では使用できません。詳細なセットアップについては [Deep Linking](./deep-linking) を参照してください。

### プッシュ権限プロンプトが表示されないのはなぜですか？

デバイスがすでにプッシュ通知にサブスクライブされている場合、プッシュ権限プロンプトのクリックアクションを持つアプリ内メッセージは表示されません。テスト前に OneSignal ダッシュボードでユーザーのプッシュサブスクリプションステータスを確認してください。