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

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

1. Apple開発者ポータルで、「キー」に移動します。

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

   {modal="regular"}

3. キー名 を入力します。

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

   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. /プロジェクト設定 を選択します。

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

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

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

      1. 手順 1 の アプリを登録:

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

      2. 手順 2 の 設定ファイルをダウンロードして追加する。

         1. Download 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 TARGETS 」リストから「」を選択し、「署名と機能」タブを選択します。次に、「+機能」ボタンを選択し、「プッシュ通知」を選択します。 これを選択すると、アプリがプッシュ通知を受信できるようになります。

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

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-messing-android が Android:app ChevronDown ​ ​Gradle Scripts build.gradle.kts （Module ） の依存関係に含まれていることを確認します。 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 を override fun onCreate() の class LumaAplication : Application 関数に FirebaseMessaging.getInstance().token.addOnCompleteListener で追加します。

   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() ?? [:] ) }

   このコードは、関数（testPushPayload および applicationId）に提供されたパラメーターを使用して eventType インスタンスを作成し、ペイロードをディクショナリに変換する際に 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())

   このコードは、関数（testPushPayload および applicationId）に提供されたパラメーターを使用して eventType インスタンスを作成し、ペイロードをマップに変換しながら 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"}