# 最初のステップ

> Set up Push Notifications for your project.

使用を開始するには、以下を行う必要があります。

* Analytics を含め、UGS にサインアップします。
* Unity エディターのプロジェクトにダッシュボードプロジェクトをリンクします。
* ゲームコード内で UGS を初期化します。

## サインアップ##sign-up

Push Notifications を使用するには、Unity Gaming Services (UGS) の一部である Unity Analytics にサインアップする必要があります。Analytics の価格設定の詳細については、[こちら](https://unity.com/solutions/gaming-services/pricing) を参照してください。

Unity アカウントをお持ちでない場合は、[アカウントを作成](/services/getting-started.md) し、[新しいプロジェクトを作成](/services/getting-started.md#create-a-project-in-the-unity-dashboard) してから、Unity Gaming Services にサインアップしてください。

> **Note:**
>
> 重要: Analytics にサインアップできるのは [組織のオーナー](/cloud/organizations/members-groups-roles.md) のみです。

1. [Unity Services ダッシュボード](https://dashboard.unity3d.com/) にサインインします。
2. サイドパネルの **Explore Services** (サービスを探す) を選択します。
3. 上部のバナーの **Sign Up** (サインアップ) を選択し、その後の指示に従います。
4. [Analytics のドキュメント](/analytics.md) を確認します。

## プロジェクトのリンク##link-your-project

Unity Push Notifications サービスを使用するには、プロジェクト ID を通じて、Unity エディター内のクラウドプロジェクトにプロジェクトをリンクする必要があります。プロジェクト ID を取得するには、以下のステップに従います。

1. Unity エディターメニューで、**Edit** (編集) > **Project Settings** (プロジェクト設定) に移動し、**Services** (サービス) タブを開きます。
2. まだ Unity ID でサインインしていない場合は、新しい Unity ID を作成するか、サインインします。
3. 新しいプロジェクトを作成する場合は、組織を選択し、**Create** (作成) を選択します。既存のプロジェクトにリンクする場合は、**I already have a Unity Project ID** (すでに Unity Project ID を持っています) を選択します。
4. ドロップダウンから組織とプロジェクトを選択し、**Link** (リンク) を選択します。

Services (サービス) ウィンドウの **Settings** (設定) タブでプロジェクト ID を見つけられます。

## インテグレーション##integration

> **Note:**
>
> Push Notifications SDK では、iOS 10+ および Android SDK >= 26 (Oreo) の両方がサポートされます。

インテグレーションステップのサマリー:

1. **SDK の統合**: パッケージを統合し、Push Notifications に対して登録し、設定/キーを入力します。
2. **キーのアップロード**: 秘密鍵 (Firebase および Apple) を見つけて、Unity Dashboard にアップロードします。
3. **インテグレーションのテスト**: デバイスにテスト通知を送信して、インテグレーションが正しく行われたことを確認します。
4. **通知キャンペーンの作成**: Unity Dashboard で最初の通知を作成してスケジュール設定します。

### 1. Push Notifications SDK の統合##1-integrate-the-push-notifications-sdk

#### Push Notifications SDK のインストール##install-the-push-notifications-sdk

> **Note:**
>
> Push Notifications SDK は、Unity エディターバージョンの Package Manager 内で、デフォルトでは表示されない場合があります。

以下の 3 つの方法のどれかで、Push Notifications SDK を Unity プロジェクトにインストールできます。

##### 1. Unity Registry を使用してインポート##1-import-using-the-unity-registry

1. **Edit** (編集) > **Project Settings** (プロジェクト設定) から **Project Settings** (プロジェクト設定) を開きます。
2. **Package Manager** (パッケージマネージャー) > **Advanced Settings** (詳細設定) > **Enable Pre-release Packages** (プレリリースパッケージの有効化) で、プレリリースパッケージを有効にします。


   **Frame:**
   ![](/api/media?file=/push-notifications/media/images/enable-prerelease.png)
3. **Component** (コンポーネント) > **Package Manager** (パッケージマネージャー) で、Package Manager を開きます。
4. **Packages** (パッケージ) ドロップダウンで、`Unity Registry` を選択します。
5. 右上の検索バーで `Push Notifications` を検索し、Push Notifications パッケージを表示します。


   **Frame:**
   ![](/api/media?file=/push-notifications/media/images/package-manager-sdk.png)
6. 右上の `Install` (インストール) を選択します。

##### 2. 名前でインポート##2-import-by-name

1. **Component** (コンポーネント) > **Package Manager** (パッケージマネージャー) で、Package Manager を開きます。
2. 新しいパッケージを追加するために左上の **Add** (追加) (**+**) ボタンを選択し、**Add package by name** (名前を指定してパッケージを追加) を選択します。


   **Frame:**
   ![](/api/media?file=/push-notifications/media/images/package-manager.png)
3. Git URL として com.unity.services.push-notifications を入力して、追加します。


   **Frame:**
   ![](/api/media?file=/push-notifications/media/images/unity-services.png)

##### 3. "manifest.json" ファイルを使用してインポート##3-import-using-the-manifestjson-file

1. 以下のコードスニペットをコピーし、パッケージのバージョンを調整します。
   ```json
   "com.unity.services.push-notifications": "4.0.0-pre.1"
   ```

2. ファイルエクスプローラーでプロジェクトフォルダーのルートに移動し、さらにパッケージフォルダー `Packages/manifest.json` に移動します。

3. コピーしたコードを `manifest.json` ファイルの末尾に追加し、必要であれば最後に `,` を付けます。

#### Push Notifications への登録##register-for-push-notifications

Push Notifications を受け取るには、アプリを Push Notifications に登録する必要があります。詳しい手順は、[Push Notifications への登録](./sdk.md#registering-for-push-notifications) に従ってください。

### 2. サービスキーのアップロード##2-upload-your-service-keys

Unity Gaming Services ダッシュボードから通知を送信するには、**Firebase** (Android) および **Apple Developer アカウント** (iOS) からサービスキーをアップロードする必要があります。

#### Google##google

Android デバイスに通知を送信するには、事前に Firebase サービスアカウントキーを Unity プロジェクト設定に追加する必要があります。これは、通知のテストや使用を行うゲームの **すべて** の UGS 環境について行う必要があります。

1. [Firebase コンソール](https://console.firebase.google.com/) に移動して、プロジェクトを選択します。
2. Project Settings に移動し、上の **Service accounts** を選択します。
3. **Create service account** を選択します。


   **Frame:**
   ![](/api/media?file=/push-notifications/media/images/create-service-account.png)
4. **Generate new private key** を選択します。


   **Frame:**
   ![](/api/media?file=/push-notifications/media/images/private-key.png)
5. **Generate key** を選択して、キーファイルをダウンロードします。


   **Frame:**
   ![](/api/media?file=/push-notifications/media/images/generate-key.png)
6. Unity Dashboard でプロジェクトの **Liveops** > **Push Notifications** > **Settings** (設定) に移動してから、Google Keys (Google キー) に移動し、`Add Key` (キーを追加) を選択するか、Google Key (Google キー) 行の Edit (編集) アイコンを選択します。
7. 前のステップで作成された秘密鍵をアップロードし、**Finish** (終了) を選択します。

> **Note:**
>
> 設定の編集ページを再び開くと、このファイルはセキュリティの理由から表示されなくなります。


**Frame:**
![](/api/media?file=/push-notifications/media/images/google-key-upload.png)

#### Apple##apple

Apple デバイスに通知を送信するには、事前に Apple キー、プロジェクトおよびアカウントの詳細を Unity プロジェクト設定に追加する必要があります。Unity Dashboard においてゲーム、環境、開発ビルド、プロダクションビルドで、同じ Apple キーを再利用できます (すでにキーがある場合はステップ 8 に進みます)。これは、通知のテストや使用を行うゲームの **すべて** の UGS 環境について行う必要があります。

1. [Apple Developer](https://developer.apple.com/) コンソールにサインインします。

2. Certificates, Identifiers & Profiles ページに移動し、**Keys** を選択します。

3. **+** を選択して新しいキーを作成します。

4. キーに名前を付け、通知を有効にするために Apple Push Notifications service (APNs) オプションを有効にしてから、**Continue** を選択します。この機能を有効にできるのは、アカウントあたり 2 つのキーのみであることに注意してください。


   **Frame:**
   ![](/api/media?file=/push-notifications/media/images/apple-register-key.png)

5. 次のページの **Register** を選択して、確定します。

6. 生成されたキーをダウンロードし、表示されているキー ID を書き留めます。これは後で必要になります。キーファイルは 1 回しかダウンロードできません。なくした場合には取り消して再生成する必要があります。


   **Frame:**
   ![](/api/media?file=/push-notifications/media/images/apple-key.png)

7. Unity Dashboard でプロジェクトの **Player Engagement** (プレイヤーのエンゲージメント) > **Notifications** (通知) > **Settings** (設定) に移動し、上部の Setup (設定) バナーの `Set Up Keys` (キーを設定) リンクをクリックし、Apple Key (Apple キー) 行の `Add Key` (キーを追加) または Edit (編集) アイコンを選択します。

8. 値を設定する必要があるフィールドが 5 つあります。

* **Key** (キー): 前のステップで作成されたキーをアップロードします。
* **Key ID** (キー ID): これはキーを登録すると設定されます。Apple Developer コンソールでキーを選択して取得することもできます。
* **Team ID** (チーム ID): これは、Apple Developer コンソールでアカウント名の下に表示されるチーム ID です。
* **Topic ID** (トピック ID): ゲームのバンドル識別子を入力します。これは、Apple Developer コンソールの Certificates, Identifiers & Profiles ページの Identifiers 内のものと正確に一致する必要があります。
* **Sandbox** (サンドボックス): ゲームの開発/デバッグビルドからプレイヤーにメッセージを送りたい場合は、Sandbox (サンドボックス) の値を **True** に設定します。プロダクションビルドのユーザーにメッセージを送りたい場合は、**False** に設定します。


  **Frame:**
  ![](/api/media?file=/push-notifications/media/images/apple-sandbox.png)

9. **Finish** (終了) を選択します。設定の編集ページを再び開くと、このファイルはセキュリティの理由から表示されなくなります。

10. XCODE 内でアプリケーションをビルドしているときは、そのアプリが通知を受け取ることができるように必ず Remote Notification (リモート通知) 機能を設定してください。


**Frame:**
![](/api/media?file=/push-notifications/media/images/xcode-build.png)

これを行わないと、実行時に以下のエラーメッセージを受け取ります。

`Failed to register for remote notifications: no valid “aps-environment” entitlement string found for application` (リモート通知に登録できません: アプリケーションの有効な "aps-environment" エンタイトルメント文字列が見つかりませんでした)

### 3. インテグレーションのテスト##3-test-your-integration

[テストガイド](./sdk.md#testing-the-sdk-integration) に従って、アプリ内の Push Notification とのインテグレーションをテストします。

テスト時に問題が発生した場合は、一般的な問題のデバッグ方法について [トラブルシューティングガイド](./troubleshooting.md) に従ってください。

### 4. 通知キャンペーンの作成##4-create-a-notification-campaign

これで、[最初の通知キャンペーンを作成](./use-push-notifications.md) できるようになり、Push Notifications の使用を開始できます。