Apps Kit SDK logoApps Kit SDK
ドキュメント · Apps Kit SDK ポータル

はじめに

アカウントの作成

新規ユーザーは /register から登録します。画面は、左側のプロモーションパネルと右側の登録フォームに分かれています。左側には、アニメーション付きの「Apps Kit SDK へようこそ」という見出し、1 行の製品説明、アニメーション付きの 3 枚の統計カード(収益向上、マッチ率、クラッシュと ANR)が表示されます。これらはプロモーション用の表示であり、アカウントの実際のデータではありません。

1782301701768-REGISTER_SCREEN_IMAGE.png

登録フォームでは、以下の情報を入力します。

  • 氏名 — 必須。
  • メールアドレス — 必須。有効なメールアドレスを入力してください。
  • パスワード — 必須。8 文字以上で、大文字、小文字、特殊文字(例:!@#$%^&*)をそれぞれ 1 文字以上含める必要があります。

アカウントを作成をクリックすると、Firebase のメールアドレスとパスワードによるアカウントが作成され、Firebase からメールアドレス確認用のメールが直ちに送信されます。その後、Apps Kit SDK バックエンドにユーザーが登録されます(POST /oauth/login、oauthProvider: "email" を指定)。完了すると /login にリダイレクトされます。登録後に自動でログインすることはなく、メールアドレスの確認が完了するまでログインできません(後述の「ログイン」を参照)。

また、Google で登録では、Firebase の Google ポップアップ(signInWithPopup)を使用し、oauthProvider: "gmail" でアカウントを登録します。Google で登録した場合は別途メールアドレスを確認する必要がなく、アカウントの種類に応じて /(マイアプリ)または /users に直接移動します。

**「すでにアカウントをお持ちですか?こちらからログイン」**リンクをクリックすると、/login に戻ります。

ログイン

ログイン画面(/login)は登録画面と同じ 2 パネル構成で、左側にプロモーションパネル、右側にログイン用のカードが表示されます。

LOGIN_SCREEN_IMAGE

ログインフォームには、以下の項目があります。

  • メールアドレス — 必須。有効なメールアドレス形式で入力してください。
  • パスワード — 必須。
  • パスワード欄の表示/非表示切り替え(目のアイコン)。
  • 続行 — 送信ボタン。フォームの入力内容が有効になるまで無効になっています。
  • ログイン情報を保存 — チェックすると、メールアドレス(パスワードではありません)をブラウザに保存し、次回のアクセス時に自動入力するチェックボックスです。
  • パスワードをお忘れですか? — /forget-password へのリンクです。
  • **「Google でログイン」**ボタン — Google での登録と同じ Firebase ポップアップフローを使用しますが、既存アカウント向けです。
  • 「初めてご利用ですか?こちらから登録」 — /register へのリンクです。

メールアドレスとパスワードでログインする場合は、Firebase アカウントのメールアドレスが確認済みかどうかもチェックされます。未確認の場合は「先にメールアドレスを確認してください。」というメッセージが表示され、ログインできません。どちらの方法でも、ログインに成功すると、一般ユーザーのアカウントは /(マイアプリ)に、内部ユーザー/管理者のアカウントは /users に移動します。

パスワードを忘れた場合

/forget-password は、メールアドレスのみを入力する単一フィールドのフォームです。送信すると Firebase の sendPasswordResetEmail が呼び出されます。ポータル内でパスワードを再設定するフローはなく、再設定用のリンクがメールで届きます。「パスワード再設定メールを送信しました。受信トレイを確認してください。」というトースト通知が表示された後、/login に戻ります。ページには「ログインに戻る」リンクもあります。

1782301803832-FORGOT_PASSWORD_IMAGE.png

上部ナビゲーションバー

ログイン後は、認証画面を除くすべてのページに上部ナビゲーションバーが表示されます。右側にはアカウントメニューがあり、マイアプリページに限り、その隣に通知ベルが表示されます。

アカウントメニュー。 右上のアバター/名前/メールアドレスをクリックすると、以下の項目を含むドロップダウンが開きます。

  • 自分のアカウントを表す**「マイアカウント」**行。選択中は青い点が表示され、現在の操作対象であることを示します。
  • **「自分と共有」*セクション — 他のチームからの共有招待を 1 件以上承諾した場合にのみ表示されます。各招待者の名前、メールアドレス、アバターが一覧表示されます。いずれかをクリックすると、ポータル全体の操作対象がそのアカウントに切り替わります(技術的には switchAccount() がディスパッチされます)。以降、マイアプリ、ブランド、キャンペーンなどに表示される内容はすべて、付与された権限の範囲に絞り込まれたそのアカウントの*リソースになります。
  • 操作対象に応じて変わるフッター。自分のアカウントを表示している場合は、**「プロフィール」リンクが表示されます。切り替え先の共有アカウントを表示している場合は、代わりに赤い「終了 → 自分と共有」**ボタンが表示されます。このボタンをクリックすると自分のアカウントに戻り、「自分と共有」ページに移動します。

切り替え先のアカウントを表示している間は、ナビゲーションバーの表示名の隣に小さな**「共有」**バッジも表示され、誰のデータを閲覧しているかを常に確認できます。

1782301838331-NAVBAR_ACCOUNT_DROPDOWN_IMAGE.png

通知ベル。 / と /apps のルート(マイアプリのダッシュボード)にのみ表示され、ポータルの他のページには表示されません。バッジの数字は、すべての通知グループに含まれる通知の合計数です。クリックすると「通知」というタイトルのドロップダウンが開き、種類別にグループ化された通知が、それぞれ短いメッセージとともに一覧表示されます。

個々の通知をクリックしたときの動作は、通知の種類によって異なります。

  • 通知の種類が upatedSdkVersion(「SDK バージョン更新」の通知)の場合、クリックするとそのアプリのアプリ詳細ページ(/app/:id)に直接移動し、通知は既読になりません。
  • それ以外のすべての種類の通知は、クリックすると SDK ダウンロードページに移動し、既読になります(既読にするエンドポイントを呼び出し、「通知を既読にしました」というトースト通知を表示します)。

1782301875830-NAVBAR_NOTIFICATIONS_DROPDOWN_IMAGE.png

このベルは、通知をすばやく確認するためのドロップダウンです。このガイドで後述する専用のマイ通知ページとは別の、よりシンプルな UI であり、どちらも自分と共有の招待一覧とは独立しています。つまり、ポータルには招待や通知を表示する場所が 3 つあります。それぞれの違いについては、アカウントのセクションを参照してください。