プラットフォームを接続する
どのコネクタにも共通すること。各プラットフォームが求めるもの、最初の同期、再接続、切断、そして接続エラーの解決について。
各プラットフォームが求めるもの
どれも同じ手間ではありません。始める前に知っておいたほうがよいでしょう。
| プラットフォーム | 必要なもの | 手間 |
|---|---|---|
| Apple App Store | Admin または App Manager のアクセス権を持つ App Store Connect の API キー: Issuer ID、Key ID、.p8 ファイル |
手間のかかる存在、10分 |
| Google Play | Google サインイン、アプリの選択、加えて Play Console での Reply to reviews 権限 | 数分 |
| Google Business Profile | ロケーションのオーナーまたはマネージャーとしての Google サインイン、ロケーションの選択 | 数分 |
| Facebook、Instagram、TikTok | まだ利用できません | 近日対応予定 |
すべては AI Review Sensor の Integrations で行います。接続は AI Review Sensor だけのものです。ScaleSensor の他のセンサーは、それぞれ独自の認証情報で独自のソースを接続します。
どのアプリやロケーションを追加するかはあなたが選びます。1つ接続して同期させ、それから次を追加します。すべてのソースから一度に受信トレイが埋まらないほうが、どのレビューがどこから来たのか判別しやすくなります。
認証情報は保存され再利用される
すでに接続済みのプラットフォームで2つ目のアプリを追加すると、同じキーや同意を再び求められる代わりに、保存済みの認証情報が提示されます(Apple では Use a saved API key、Google ではすでにサインインしたアカウント)。
チームごとに1つのキーのほうが、各コネクタにコピーが散らばっているよりもローテーションが簡単です。保存済みの認証情報は名前で一覧表示され、Key ID やメールアドレスは一部がマスクされます。秘密鍵やトークンそのものは二度と表示されません。あなた自身に対してもです。
最初の同期
最初の取り込みでは、あなたが見て回っている間に受信トレイが空にならないよう、各アプリの最新のレビュー(最大100件)を取り込みます。これは一部であり、履歴のすべてではありません。
その後、各コネクタはおよそ30分ごとに確認されます。新しいレビューは到着時に分類・翻訳され、自動化モードが AI Drafts または Auto-send なら下書きされます。
タイマーを待つ必要はありません。Sync now ですぐに取り込めます。同期で新しいものが見つからなければ、なかった成功を装うのではなく、その旨(「Up to date」)を伝えます。
接続が壊れたとき
コネクタはありふれた理由で無効になります。App Store Connect でキーが取り消される、Google アカウントがアクセス権を失う、プラットフォーム側で権限が変わる、などです。
そうなったら、コネクタの Reconnect を使います。Google アカウントの場合、再接続するとサインインがもう一度行われ、そのアカウントのすべてのアプリがまとめて復旧し、テスト同期で動作が確認されます。すでに収集済みのレビューはすべてつながったまま残ります。
削除して再追加する方法でも直りますが、履歴は捨てられます。毎回、まず再接続してください。
切断と削除の違い
意図的に区別された2つの異なる操作です。
Disconnect(切断) は、そのソースからの新しいレビューの同期を止めます。既存のデータはそのまま残り、後でもう一度サインインすることなく再接続できます。
Delete(削除) は、そのアプリとそのすべてのレビューおよび下書きを AI Review Sensor から削除します。アカウント全体(保存済みの認証情報)を削除すると、その配下のすべてのアプリも削除されます。請求記録は保持されますが、レビューデータは保持されません。こちらは元に戻せず、実行できるのは Owner だけです。
どちらにするか迷ったら、切断してください。元に戻せるのはそちらです。
チームの誰がこれを行えるか
Owner、Manager、Developer は統合を接続・管理できます。Sales & Marketing のロールはできません。このロールは受信トレイ、分析、返信に限定されており、それは終日顧客に対応する人に通常必要な範囲です。完全な削除は Owner のみが行えます。
プラットフォーム側でも十分なアクセス権が必要です。自分が持っていないアクセス権を当社に付与することはできません。
接続エラーのトラブルシューティング
同期や返信が失敗すると、コネクタとレビューにわかりやすい言葉で理由が表示されます。それぞれの意味と対処法は次のとおりです。
| 表示される内容 | 意味 | 対処法 |
|---|---|---|
| 接続の有効期限が切れています | プラットフォームが保存済みのアクセス権を受け付けなくなっています | コネクタを Reconnect してから、返信をもう一度送信します |
| レビューの読み取りや返信が許可されていません | アカウントまたはキーに、プラットフォーム上の権限がありません | プラットフォームでそのアクセス権を確認し(たとえば Play Console の Reply to reviews)、再接続します |
| レビューまたはアプリが見つかりません | レビューが削除されたか、アプリが公開されていないか、このアカウントから見えなくなっています | アプリがまだ公開されていて、接続済みのアカウントから見えることを確認します |
| プラットフォームが投稿の速度を制限しています | プラットフォーム側のレート制限です | 対処は不要です。自動的に再試行し続けます。数分後に返信を再試行してください |
| プラットフォームに接続できませんでした | ネットワークまたはプラットフォームの障害です | 対処は不要です。自動的に再試行し続けます |
| 返信の受付期間が終了しています | プラットフォームがこの項目への返信を受け付けなくなっています | この項目には何も送信できません |
Apple のアプリでストアフロントに関するメッセージが出た場合は、そのアプリがその国の App Store に掲載されていないか、そのストアフロントの Apple のレビューフィードを読み込めなかったことを意味します。アプリに選んだストアフロントを確認してください。
エラーが繰り返し発生する場合は、コネクタを再接続してください。それでも解消しない場合は、[email protected] までメールでお問い合わせください。
Last updated