- はじめに:App IDとAPIキーを確認する
- SDKのインストール:モバイルまたはWeb SDKをインストールする
- ユーザーとアイデンティティ:ユーザーを識別し、サブスクリプションを管理し、アクセスを保護する
- 統合をテストする:公開前に配信を確認する
- トラブルシューティング:配信の問題をデバッグする
はじめに
チームがすでに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インストールとブラウザプッシュ通知のセットアップ。
- Windows
- macOS(Mac CatalystアプリはiOS SDK経由でサポートされます)
- watchOSとWear OS
ユーザーとアイデンティティ
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を更新する必要があり、なりすましを防止できます。