Skip to main content
OneSignal SDKをインストールして、最初の統合を動作させましょう。初回セットアップの場合はセクションを順番に実行するか、必要な箇所に直接移動してください。
  1. はじめに:App IDとAPIキーを確認する
  2. SDKのインストール:モバイルまたはWeb SDKをインストールする
  3. ユーザーとアイデンティティ:ユーザーを識別し、サブスクリプションを管理し、アクセスを保護する
  4. 統合をテストする:公開前に配信を確認する
  5. トラブルシューティング:配信の問題をデバッグする

はじめに

チームがすでにOneSignalアカウントを持っている場合は、管理者に招待を依頼してOrganizationに参加してください。それ以外の場合は、アカウントを作成して開始してください。 OneSignal Appには、SDKセットアップに必要なApp IDやAPIキーを含む、ユーザーとメッセージのデータが保存されます。複数のプロジェクトや環境を管理する場合は、Apps、Organizations、アカウントの相互関係を学んでください。

キーとID

認証用のApp ID、REST APIキー、Organization IDを確認します。

SDKのインストール

お使いのプラットフォーム用のOneSignal SDKをインストールします。

モバイルSDKセットアップ

iOS、Android、Huawei、AmazonのSDKセットアップ。プッシュ通知、アプリ内メッセージ、Live Activitiesが有効になります。

Web SDKセットアップ

Web SDKインストールとブラウザプッシュ通知のセットアップ。
以下のプラットフォームも、REST API経由でサポートされています:

ユーザーとアイデンティティ

OneSignalは各人にOneSignal IDを割り当て、デバイス、メールアドレス、電話番号をサブスクリプションとして追跡します。ユーザーは匿名のまま、External IDを使用してloginを呼び出すことで識別されます。ユーザーを識別すると、チャネルとデバイス全体のサブスクリプションが統合されます。

ユーザー

ユーザーモデル、External ID、匿名ユーザーと識別済みユーザー、ログイン/ログアウト。

サブスクリプション

メッセージを受信するデバイス、メールアドレス、電話番号。

タグ

パーソナライゼーションとセグメンテーションのために、ユーザーにカスタムプロパティを追加します。

カスタムイベント

Journeysをトリガーするか分析を支援するためにユーザーアクションを追跡します。

統合をテストする

全オーディエンスに送信する前に、テストユーザーで配信、レンダリング、ディープリンクを確認します。

テストユーザー

プッシュ、メール、SMS用のテストユーザーを見つけて設定します。

トラブルシューティング

まずデバッグログから始め、次に統合に合ったプラットフォームガイドを使用してください。

モバイルトラブルシューティング

一般的なプッシュ配信、APNs、アプリ内メッセージの問題を解決します。

Web SDKトラブルシューティング

サービスワーカーエラー、オリジンの不一致、通知が表示されない問題を修正します。

デバッグログ

詳細ログを有効にし、問題を再現し、ログをサポートと共有します。

Webプッシュ許可のリセット

クリーンなテストのために、ブラウザキャッシュ、サービスワーカー、通知許可をクリアします。

セットアップ後

一般的なユースケースを探索し、開発しながらSDKメソッドやREST APIエンドポイントを調べてください。

チュートリアルとユースケース

放棄カート、オンボーディングフロー、再エンゲージメントキャンペーンなどの実装ガイドを参照してください。

タグ

パーソナライゼーションとセグメンテーションのために、ユーザーにカスタムプロパティを追加します。

カスタムイベント

Journeysをトリガーするか分析を支援するためにユーザーアクションを追跡します。

モバイルSDKリファレンス

iOS、Android、クロスプラットフォームSDKのメソッド、クラス、イベントフック。

Web SDKリファレンス

初期化、ユーザー管理、サブスクリプションメソッド、カスタムトリガー。

サーバーSDKリファレンス

Node.js、Python、Java、Go、PHP、Ruby、C#、Rust用のサーバーSDKのインストールと設定。

REST API概要

エンドポイント、認証、レート制限、リクエスト/レスポンス形式。

よくある質問

デバイス間でユーザーを識別するにはどうすればよいですか?

ユーザーがサインインした後、各デバイスでOneSignal.login("your_external_id")を呼び出します。OneSignalは同じExternal IDを持つすべてのサブスクリプションを1つのユーザーの下に統合します。実装の詳細についてはユーザーを参照してください。

本人確認の設定は必要ですか?

本人確認はオプションですが、本番アプリでは強くお勧めします。設定しないと、任意のクライアントが任意のExternal IDでloginを呼び出すことができます。本人確認を有効にするには、サーバー生成JWTを使用するようにOneSignal SDKを更新する必要があり、なりすましを防止できます。

モバイルまたはWeb SDKなしでOneSignalを使用できますか?

はい。REST APIまたはサーバーSDKを使用して、メールやSMSの送信、ユーザーの管理、メッセージのトリガーができます。プッシュ通知、アプリ内メッセージ、クライアント側のユーザー識別には、モバイルおよびWeb SDKが必要です。

サーバーからメッセージを送信するにはどうすればよいですか?

REST APIまたはサーバーSDKを使用します。キーとIDのREST APIキーで認証します。REST APIキーをモバイルまたはWebクライアントに埋め込まないでください。