プッシュ通知の作成と送信

次の手順は、Adobe Experience Cloud固有のものではなく、APNの設定をガイドするように設計されています。

1. Apple デベロッパーポータルで、Keys​に移動します。

2. キーを作成するには、+​を選択します。

   {modal="regular"}

3. キー名​を入力してください。

4. Apple プッシュ通知サービス ​ （APN）​を選択し、Configure​を選択します。

   1. キー​の設定画面で、環境 ドロップダウンメニューから​ サンドボックスと実稼動 ​を選択します。
   2. 「保存」を選択します。

5. 続行​を選択します。

   {modal="regular"}

6. 設定を確認し、登録​を選択します。

7. .p8秘密鍵をダウンロードします。 これは、Journey Optimizer プッシュ資格情報を設定する際の次の演習で使用されます。

8. キーID​をメモします。 これは、Journey Optimizer プッシュ資格情報を設定する際の次の演習で使用されます。

9. チーム ID​をメモします。 これは、Journey Optimizer プッシュ資格情報を設定する際の次の演習で使用されます。 チーム IDは、画面の右上、ログイン名の横にあります。
   {modal="regular"}

追加のドキュメントはこちらにあります。

次の手順は、Adobe Experience Cloud固有のものではなく、Firebaseの設定をガイドするように設計されています。

1. Firebase コンソールにアクセスします。

2. Firebase プロジェクトを作成​を選択します。

   1. プロジェクト名​を入力します。
   2. 「プロジェクトを作成 - で​​続行​​を選択します。プロジェクトの名前から始めましょう。 例：Luma Android App.
   3. Firebase で Geminiを無効にし、で​​続行​​を選択してプロジェクトを作成 - Firebase プロジェクトのAI支援​を行います。
   4. このプロジェクト の Google Analyticsを無効にし、プロジェクトの作成 - Firebase プロジェクトのGoogle Analytics​で​ 続行 ​を選択します。
   5. 「プロジェクトを作成」を選択します。
   6. プロジェクトの準備が整ったら、続行​を選択します。

3. Firebase コンソールに戻り、上部でプロジェクトが選択されていることを確認します。 例えば、Luma Android アプリ​とします。

   {modal="regular"}

4. > Project Settings​を選択します。

5. プロジェクト設定​で、アプリを追加​を選択します。

   1. アプリにFirebaseを追加する​で、Android​をプラットフォームとして選択します。

   2. Android アプリにFirebaseを追加：

      1. 手順1では、アプリを登録​します。

         1. アプリのIDと同様に、Android パッケージ名を入力します。 例：com.adobe.luma.tutorial.android。
         2. オプションの​ アプリのニックネーム ​を入力します。
         3. 「アプリを登録」を選択します。

      2. 手順2では、設定ファイルをダウンロードして追加します。

         1. 「 google-services.json​をダウンロード」を選択します。 独自のバージョンのAndroid アプリを構築する場合は、サンプルのAndroid Studio プロジェクトの現在のgoogle-services.json ファイルを、この新しいアプリ設定によって生成されたファイルのバージョンに置き換える必要があります。
            他の手順は、サンプルアプリ内ですでに処理されます。

   画面は次のようになります。

   {modal="regular"}

6. プロジェクト設定​で、サービスアカウント​を選択します。

7. 新しい秘密鍵を生成​を選択します。 luma-android-app-firebase-adminsdk-xxxx-xxxxxxxx.json ファイルが生成されます。 後の段階でファイルが必要になるので、このファイルを安全な場所に保存します。

詳しくは、Firebase開発者ドキュメント ​を参照してください。

1. Xcodeで、ターゲット リストから​ Luma ​を選択し、署名と機能 タブを選択し、+機能 ボタンを選択してから、プッシュ通知​を選択します。 この選択により、アプリはプッシュ通知を受信できるようになります。

2. 次に、アプリに通知拡張機能を追加する必要があります。 General タブに戻り、ターゲット セクションの下部にある​+ アイコンを選択します。

3. 新しいターゲットのテンプレートを選択するよう求められます。 通知サービス拡張機能​を選択し、次へ​を選択します。

4. 次のウィンドウで、拡張機能の名前としてNotificationExtensionを使用し、「終了」ボタンをクリックします。

次の画面のように、プッシュ通知の拡張機能がアプリに追加されます。

{modal="regular"}

Android Studio プロジェクトは、すでにプッシュ通知用に設定されています。 プッシュ通知用のLuma アプリのAndroid バージョンを有効にするために、追加の手順を実行する必要はありません。 詳しくは、通知についてを参照してください。

Android プッシュ通知では、アプリ内およびプッシュ通知の送信時に、通知チャネル idを定義する必要があります。 Android Luma アプリで使用されるチャネル通知IDはLUMA_CHANNEL IDです。

1. Xcodeで、AEP Messagingがパッケージ依存関係のパッケージのリストに追加されていることを確認します。 Swift パッケージマネージャーを参照してください。

2. Xcode プロジェクトナビゲーターで​Luma > Luma > AppDelegate​に移動します。

3. AEPMessagingがインポートのリストに含まれていることを確認してください。

   import AEPMessaging

4. Messaging.selfが登録中の拡張機能の配列の一部であることを確認してください。

   code language-swift
   let extensions = [ AEPIdentity.Identity.self, Lifecycle.self, Signal.self, Edge.self, AEPEdgeIdentity.Identity.self, Consent.self, UserProfile.self, Places.self, Messaging.self, Optimize.self, Assurance.self ]

1. Android Studioで、aepsdk-messaing-androidが​Android Gradle Scripts​の​ build.gradle.kts （モジュール :app） ​の依存関係の一部であることを確認します。 Gradleを参照してください。

2. Android Studio プロジェクトナビゲーターで、Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication​に移動します。

3. com.adobe.marketing.mobile.Messagingがインポートのリストに含まれていることを確認してください。

   import import com.adobe.marketing.mobile.Messaging

4. Messaging.EXTENSIONが登録中の拡張機能の配列の一部であることを確認してください。

   code language-kotlin
   val extensions = listOf( Identity.EXTENSION, Lifecycle.EXTENSION, Signal.EXTENSION, Edge.EXTENSION, Consent.EXTENSION, UserProfile.EXTENSION, Places.EXTENSION, Messaging.EXTENSION, Optimize.EXTENSION, Assurance.EXTENSION )

1. Xcode プロジェクトナビゲーターで​Luma > Luma > AppDelegate​に移動します。

2. MobileCore.setPushIdentifier APIをfunc application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data)関数に追加します。

   code language-swift
   // Send push token to Mobile SDK MobileCore.setPushIdentifier(deviceToken)

   この関数は、アプリがインストールされているデバイスに固有のデバイストークンを取得します。 次に、Appleのプッシュ通知サービス（APN）に依存して設定した設定を使用して、プッシュ通知配信のトークンを設定します。

1. Android Studio プロジェクトナビゲーターで、Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication​に移動します。

2. MobileCore.setPushIdentifier APIをFirebaseMessaging.getInstance().token.addOnCompleteListenerのclass LumaAplication : Applicationのoverride fun onCreate()関数に追加します。

   code language-kotlin
   // Send push token to Mobile SDK MobileCore.setPushIdentifier(token)

   この関数は、アプリがインストールされているデバイスに固有のデバイストークンを取得します。 次に、設定した設定と、Firebase Cloud Messaging （FCM）に依存する設定を使用して、プッシュ通知配信のトークンを設定します。

1. Xcode プロジェクトナビゲーターで​Luma > Luma > モデル > XDM > TestPushPayload​に移動し、コードを調べます。

   code language-swift
   import Foundation // MARK: - TestPush struct TestPushPayload: Codable { let application: Application let eventType: String } // MARK: - Application struct Application: Codable { let id: String }

   このコードは、テストプッシュ通知ジャーニーをトリガーに送信する次の単純なペイロードを表しています。

   code language-json
   { "eventType": string, "application" : [ "id": string ] }

2. Xcode プロジェクトナビゲーターで​Luma > Luma > Utils > MobileSDK​に移動し、次のコードをfunc sendTestPushEvent(applicationId: String, eventType: String)に追加します。

   code language-swift
   // Create payload and send experience event Task { let testPushPayload = TestPushPayload( application: Application( id: applicationId ), eventType: eventType ) // send the final experience event await sendExperienceEvent( xdm: testPushPayload.asDictionary() ?? [:] ) }

   このコードは、関数（applicationIdおよびeventType）に指定されたパラメーターを使用してtestPushPayload インスタンスを作成し、ペイロードを辞書に変換する際にsendExperienceEventを呼び出します。 このコードでは、awaitとasyncに基づいて、Swiftの同時実行モデルを使用して、Adobe Experience Platform SDKを呼び出す非同期機能も考慮しています。

3. Xcode プロジェクトナビゲーターで​Luma > Luma > Views > General > ConfigView​に移動します。 プッシュ通知ボタンの定義で、次のコードを追加して、そのボタンをタップするたびにテストのプッシュ通知エクスペリエンスイベント ペイロードをトリガーに送信します。

   code language-swift
   // Setting parameters and calling function to send push notification Task { let eventType = testPushEventType let applicationId = Bundle.main.bundleIdentifier ?? "No bundle id found" await MobileSDK.shared.sendTestPushEvent(applicationId: applicationId, eventType: eventType) }

1. Android Studio ナビゲーターで​Android > app > kotlin+java > com.adobe.luma.tutorial.android > xdm > TestPushPayload.kt​に移動し、コードを調べます。

   code language-kotlin

   import com.google.gson.annotations.SerializedName data class TestPushPayload( @SerializedName("application") val application: Application, @SerializedName("eventType") val eventType: String ) { fun asMap(): Map<String, Any> { return mapOf( "application" to application.asMap(), "eventType" to eventType ) } } data class Application( @SerializedName("id") val id: String ) { fun asMap(): Map<String, Any> { return mapOf( "id" to id ) } }

   このコードは、テストプッシュ通知ジャーニーをトリガーに送信する次の単純なペイロードを表しています。

   code language-json
   { "eventType": string, "application" : [ "id": string ] }

2. Android Studio ナビゲーターで​Android > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK​に移動し、次のコードをfunc sendTestPushEvent(applicationId: String, eventType: String)に追加します。

   code language-kotlin
   // Create payload and send experience event val testPushPayload = TestPushPayload( Application(applicationId), eventType ) sendExperienceEvent(testPushPayload.asMap())

   このコードは、関数（applicationIdおよびeventType）に指定されたパラメーターを使用してtestPushPayload インスタンスを作成し、ペイロードをマップに変換する際にsendExperienceEventを呼び出します。

3. Android Studio ナビゲーターの​Android > app > kotlin+java > com.adobe.luma.android.tutorial > views > ConfigView.kt​に移動します。 プッシュ通知ボタンの定義で、次のコードを追加して、そのボタンをタップするたびにテストのプッシュ通知エクスペリエンスイベント ペイロードをトリガーに送信します。

   code language-kotlin
   // Setting parameters and calling function to send push notification val eventType = testPushEventType val applicationId = context.packageName scope.launch { MobileSDK.shared.sendTestPushEvent( applicationId, eventType ) }

1. を使用して、シミュレーターまたはXcodeの物理デバイスでアプリを再構築して実行します。

2. 「設定」タブに移動します。

3. 「プッシュ通知」をタップします。

   プッシュ通知がアプリの上部に表示されます。

   {width="300"}

1. を使用して、シミュレーターまたはAndroid Studioの物理デバイスでアプリを再構築して実行します。

2. 「設定」タブに移動します。

3. 「プッシュ通知」をタップします。

   プッシュ通知がアプリの上部に表示されます。

   {width="300"}