> ## 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.
# 開発者
> OneSignalをモバイルおよびWebアプリケーションに統合するための開発者ガイド：SDKセットアップ、APIリファレンス、ユーザーID、モバイルとWeb全体のテスト。
このガイドでは、開発者がOneSignalをモバイルおよびWebアプリケーションに統合する方法を説明します。初回セットアップの場合はセクションを順番に実行するか、必要な箇所に直接移動してください。
1. [**はじめに**](#get-started) — OneSignal Appにアクセスし、APIキーを取得する
2. [**メッセージングチャネルの設定**](#set-up-messaging-channels) — SDKをインストールし、チャネルを設定する
3. [**SDKとAPIリファレンス**](#sdk-and-api-reference) — メソッド、クラス、エンドポイントの詳細ドキュメント
4. [**ユーザーとアイデンティティ**](#users-and-identity) — ユーザーを識別し、サブスクリプションを管理し、アクセスを保護する
5. [**チュートリアル**](#tutorials) — 一般的なユースケースのステップバイステップガイド
6. [**テストとデバッグ**](#testing-and-debugging) — 本番稼動前に統合を確認する
7. [**アナリティクスとWebhook**](#analytics-and-webhooks) — パフォーマンスを追跡し、サーバー側でメッセージイベントを受信する
***
## はじめに
チームがすでにOneSignalアカウントを持っている場合は、管理者に[招待を依頼](./manage-team-members)してOrganizationに参加してください。それ以外の場合は、[アカウントを作成](https://onesignal.com)して開始してください。
OneSignal Appは、ユーザーとメッセージデータが保存される場所です。各AppにはApp ID、APIキー、メッセージングチャネルがあります。異なるプロジェクトや環境に対応するために、1つのOrganizationに複数のAppを持つことができます。
Apps、Organizations、アカウントの相互関係。
認証用のApp ID、REST APIキー、Organization IDを確認します。
開発者を招待し、Organizationでロールを割り当てます。
請求、請求書、使用量の詳細。
***
## メッセージングチャネルの設定
OneSignal SDKをインストールして、プラットフォーム全体のユーザーエンゲージメントを作成・追跡します。各メッセージチャネルには、認証情報、SDK初期化、チュートリアルをカバーする独自のセットアップガイドがあります。
iOS、Android、Huawei、AmazonのSDKセットアップ。プッシュ通知、アプリ内メッセージ、Live Activitiesが有効になります。
Web SDKインストールとブラウザプッシュ通知のセットアップ。
メールチャネルの設定と送信元ドメインの確認。
モバイルアプリ内にリッチでインタラクティブなメッセージを表示します。
SMSチャネルのセットアップとキャリア登録。
ブランドコンテンツと既読確認を備えたリッチメッセージ。
iOSの動的ロック画面更新。Androidでも同様の機能が利用可能。
***
## SDKとAPIリファレンス
クライアントSDK、サーバーSDK、REST APIの詳細ドキュメント。
iOS、Android、クロスプラットフォームSDKのメソッド、クラス、イベントフック。
初期化、ユーザー管理、サブスクリプションメソッド、カスタムトリガー。
Node.js、Python、Java、Go、PHP、Ruby、C#、Rust用のサーバーSDKのインストールと設定。
エンドポイント、認証、レート制限、リクエスト/レスポンス形式。
パーソナライズされたデータでOTP、レシート、時間に敏感なアラートをAPIで送信します。
すべてのサーバーSDKライブラリのソースコードと例。
***
## ユーザーとアイデンティティ
OneSignalは各人に**OneSignal ID**を割り当て、デバイス、メールアドレス、電話番号を**サブスクリプション**として追跡します。ユーザーは匿名のまま、**External ID**を使用して`login`を呼び出すことで識別されます。ユーザーを識別すると、チャネルとデバイス全体のサブスクリプションが統合されます。
ユーザーモデル、External ID、匿名ユーザーと識別済みユーザー、ログイン/ログアウト。
メッセージを受信するデバイス、メールアドレス、電話番号。
ユーザーなりすましを防ぐためにサーバー生成JWTを要求します。
クロスプラットフォーム追跡と統合のためにカスタム識別子をユーザーにマッピングします。
パーソナライゼーションとセグメンテーションのためにユーザーにキー値データを設定します。
Journeysをトリガーするか分析を支援するためにユーザーアクションを追跡します。
***
## チュートリアル
OneSignalで一般的なメッセージングユースケースを実装するためのステップバイステップガイド。
放棄カート、オンボーディングフロー、再エンゲージメントキャンペーンなどの実装ガイドを参照してください。
***
## テストとデバッグ
全オーディエンスへの送信前に、統合が機能していることを確認します。
常に[テストサブスクリプション](./test-users)で最初にテストしてください。これにより、実際のユーザーに影響を与えることなく、配信、レンダリング、ディープリンクを検証できます。
プッシュ、メール、SMS用のテストサブスクリプションを見つけて設定します。
トラブルシューティングのためにモバイルアプリから詳細なSDKログをキャプチャします。
一般的なプッシュ配信、APNS、アプリ内メッセージングの問題を解決します。
Service Worker、ブラウザ互換性、Webプッシュの問題を修正します。
***
## アナリティクスとWebhook
メッセージのパフォーマンスを追跡し、分析、自動化、または外部システムとの同期のために、サーバー側でメッセージイベントを受信します。
クリック、開封、受信などのメッセージイベントをリアルタイムでデータウェアハウスにストリーミングします。
JourneyのステップからサーバーにHTTPリクエストを送信します。
Webプッシュの表示、クリック、閉じるイベントのHTTPコールバック。
***
## よくある質問
### REST APIリクエストはどのように認証しますか？
`Authorization`ヘッダーにREST APIキーをベアラートークンとして含めます：`Authorization: Key YOUR_REST_API_KEY`。OneSignalダッシュボードの**設定 > キーとID**でキーを確認してください。詳細は[キーとID](./keys-and-ids)を参照してください。
### クライアントSDKとサーバーSDKの違いは何ですか？
**クライアントSDK**（モバイルとWeb）はユーザーのデバイス上のアプリで動作します。サブスクリプション登録、権限プロンプト、アプリ内メッセージ、`login`によるユーザー識別を処理します。**サーバーSDK**はバックエンドで動作し、REST APIを呼び出してメッセージの送信、ユーザーの管理、データのエクスポートを行います。
### デバイス間でユーザーを識別するにはどうすればよいですか？
ユーザーがサインインした後、各デバイスで`OneSignal.login("your_external_id")`を呼び出します。OneSignalは同じExternal IDを持つすべてのサブスクリプションを1つのユーザーの下に統合します。実装の詳細については[ユーザー](./users#external-id)を参照してください。
### 本人確認の設定は必要ですか？
本人確認はオプションですが、本番アプリでは強くお勧めします。設定しないと、任意のクライアントが任意のExternal IDで`login`を呼び出すことができます。[本人確認](./identity-verification)を有効にするには、サーバー生成JWTを使用するようにOneSignal SDKを更新する必要があり、なりすましを防止できます。
***
需要帮助？
与我们的支持团队聊天或发送邮件至 `support@onesignal.com`
请包含以下信息：
* 您遇到的问题详情以及复现步骤（如有）
* 您的 OneSignal 应用 ID
* 外部 ID 或订阅 ID（如适用）
* 您在 OneSignal 控制台中测试的消息 URL（如适用）
* 任何相关的[日志或错误信息](/docs/cn/capturing-a-debug-log)
我们很乐意为您提供帮助！