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

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

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

次を提供： キー名.

を選択します。 Apple Push Notification service (APNs) チェックボックス。

「続行」を選択します。

設定を確認し、「 」を選択します。 登録.

をダウンロードします。 .p8 秘密鍵。 このレッスンの後半では、App Surface 設定で使用します。

次の項目をメモします。 キー ID. これは、App Surface 設定で使用されます。

次の項目をメモします。 チーム ID. これは、App Surface 設定で使用されます。

次から： データ収集インターフェイスを選択します。 アプリのサーフェス をクリックします。

設定を作成するには、「 」を選択します。 アプリサーフェスを作成.

を入力します。 名前 設定の場合、例： Luma App Tutorial .

送信者 モバイルアプリケーション設定 ​を選択します。 Apple iOS.

にモバイルアプリのバンドル ID を入力します。 アプリ ID (iOS Bundle ID) フィールドに入力します。 例： com.adobe.luma.tutorial.swiftui.

をオンにします。 プッシュ認証情報 を切り替えて、資格情報を追加します。

をドラッグ&ドロップします。 .p8 Appleプッシュ通知認証キー ファイル。

次を提供： キー ID: p8 認証キー。 これは、 キー 」タブをクリックします。 証明書、識別子、およびプロファイル Apple Developer Portal ページのページ。 関連トピック 秘密鍵の作成.

チーム ID を指定します。チーム ID は、 メンバーシップ 」タブまたはApple Developer Portal ページの上部に表示されます。 関連トピック 秘密鍵の作成.

「保存」を選択します。

データ収集 UI で、「 」を選択します。 データストリーム ​を選択し、例えば、データストリームを選択します。 Luma Mobile App.

選択 対象： Experience Platform を選択し、 編集 を選択します。

Adobe Analytics の データストリーム > > Adobe Experience Platform 画面：

1. まだ選択していない場合は、「 」を選択します。 AJO プッシュプロファイルデータセット から プロファイルデータセット. このプロファイルデータセットは、 MobileCore.setPushIdentifier API 呼び出し ( プッシュ通知用のデバイストークンの登録) と呼ばれ、プッシュ通知の一意の識別子（プッシュ識別子）が、ユーザーのプロファイルの一部として保存されます。

2. Adobe Journey Optimizer が選択されている。 詳しくは、 Adobe Experience Platform設定 を参照してください。

3. データストリーム設定を保存するには、 保存.

に移動します。 タグ > 拡張機能 > カタログ,

プロパティを開きます（例： ）。 Luma Mobile App Tutorial.

選択 カタログ.

を検索します。 Adobe Journey Optimizer 拡張子。

拡張機能をインストールします。

Adobe Analytics の 拡張機能のインストール ダイアログ

1. 環境を選択します（例： ）。 開発.

2. を選択します。 AJO プッシュトラッキングエクスペリエンスイベントデータセット データセット イベントデータセット リスト。

3. 選択 ライブラリに保存してビルドする.

   

以下を確認します。 設定手順 シミュレーターまたはデバイスを Assurance に接続するには、「 」セクションを参照してください。

Assurance UI で、 設定.

選択 次の プッシュデバッグ.

「保存」を選択します。

選択 プッシュデバッグ をクリックします。

を選択します。 設定の検証 タブをクリックします。

次の場所からデバイスを選択します。 クライアント リスト。

エラーが表示されていないことを確認します。

を選択します。 テストプッシュの送信 タブをクリックします。

（オプション）次のデフォルトの詳細を変更します： タイトル および 本文

選択 テストプッシュ通知の送信.

次を確認します。 テスト結果.

アプリにテストプッシュ通知が表示されます。

img-md
w-300

Xcode でアプリに移動します。

選択 Luma をクリックします。

を選択します。 Luma ターゲット。

を選択します。 署名と機能 タブをクリックします。

設定 署名を自動管理, チーム、および バンドル識別子 ​または、特定のApple開発プロビジョニングの詳細を使用します。

{zoomable="yes"}

Xcode で、「 Luma から ターゲット リストで、 署名と機能 タブで、 +機能 「 」ボタンをクリックし、「 プッシュ通知. これにより、アプリがプッシュ通知を受け取れるようになります。

次に、通知拡張機能をアプリに追加する必要があります。 に戻ります。 General 」タブで「 + アイコン ターゲット 」セクションに入力します。

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

次のウィンドウで、 NotificationExtension 拡張機能の名前として追加し、「 完了 」ボタンをクリックします。

Xcode で、 AEP メッセージ は、パッケージの依存関係にパッケージのリストに追加されます。 詳しくは、 Swift Package Manager.

に移動します。 Luma > Luma > AppDelegate 」をクリックします。

確認 AEPMessaging は、インポートのリストの一部です。

import AEPMessaging

確認 Messaging.self は、登録する拡張機能の配列の一部です。

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
]

次を追加： MobileCore.setPushIdentifier への API func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) 関数に置き換えます。

// Send push token to Mobile SDK
MobileCore.setPushIdentifier(deviceToken)

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

Journey Optimizer UI で、 スキーマ をクリックします。

選択 参照 」をクリックします。

スキーマを選択します（例： ）。 Luma Mobile App Event Schema をクリックして開きます。

スキーマエディターで、次の操作を実行します。

1. を選択します。 eventType フィールドに入力します。

2. Adobe Analytics の フィールドのプロパティ ウィンドウ領域を下にスクロールして、イベントタイプに使用可能な値のリストを表示します。 選択 行を追加、を追加します。 application.test として 値 および Test event for push notification として DISPLAY NAME.

3. 「適用」を選択します。

4. 「保存」を選択します。

   

Journey Optimizer UI で、 設定 をクリックします。

Adobe Analytics の ダッシュボード 画面で、 管理 ボタン イベント タイル。

Adobe Analytics の イベント 画面、選択 イベントを作成.

Adobe Analytics の event1 を編集 ペイン：

1. 入力 LumaTestEvent として 名前 イベントの。

2. 次を提供： 説明 ​例： Test event to trigger push notifications in Luma app.

3. 前の手順で作成したモバイルアプリエクスペリエンスイベントスキーマを選択します。 XDM スキーマの作成 から スキーマ 例えば、リスト Luma Mobile App Event Schema v.1.

4. 選択 の横 フィールド リスト。

   

   Adobe Analytics の フィールド ダイアログで、次のフィールドが選択されていることを確認します ( 常に選択されているデフォルトのフィールドの上部 (_id, id、および timestamp)) を参照してください。 ドロップダウンリストを使用して、次の間で切り替えることができます。 選択済み, すべて および プライマリ または フィールドに入力します。

   • 特定されたアプリケーション (id),
   • イベントタイプ (eventType),
   • プライマリ（プライマリ）.

   

   次に、 OK.

5. 選択 の横 イベント ID 条件 フィールドに入力します。

   1. Adobe Analytics の イベント ID 条件の追加 ダイアログ、ドラッグ&ドロップ イベントタイプ (eventType) 次に対して ここに要素をドラッグ&ドロップ.

   2. ポップオーバーで、下までスクロールし、「 」を選択します。 application.test ( これは、 スキーマを更新) をクリックします。 次に、上までスクロールし、「 」を選択します。 OK.

   3. 選択 OK をクリックして条件を保存します。

      

6. 選択 ECID (ECID) から 名前空間 リスト。 自動的に プロファイル識別子 フィールドに マップ identityMap のキー ECID の最初の要素の ID。.

7. 「保存」を選択します。

   

Journey Optimizer UI で、 ジャーニー をクリックします。

選択 「作成」ジャーニー.

Adobe Analytics の ジャーニーのプロパティ パネル：

1. を入力します。 名前 ジャーニーの例 Luma - Test Push Notification Journey.

2. を入力します。 説明 ジャーニーの例 Journey for test push notifications in Luma mobile app.

3. 確認 再エントリを許可 が選択され、設定されている 再入場待機期間 から 30 秒.

4. 「OK」を選択します。

   

ジャーニーキャンバスに戻る、 イベント ​をドラッグ&ドロップし、 LumaTestEvent それが表示されるキャンバス上で エントリイベントまたはオーディエンスの閲覧アクティビティを選択.

• Adobe Analytics の イベント：LumaTestEvent パネル、 ラベル ​例： Luma Test Event.

次から： アクション ドロップダウン、ドラッグ&ドロップ プッシュ の あなたの右に現れて LumaTestEvent アクティビティ。 Adobe Analytics の アクション：プッシュ ペイン：

1. 次を提供： ラベル ​例： Luma Test Push Notification、 説明 ​例： Test push notification for Luma mobile appを選択します。 トランザクション から カテゴリ リストと選択 Luma から 押し出しサーフェス.

2. 選択 コンテンツを編集 実際のプッシュ通知の編集を開始する場合。

   

   Adobe Analytics の プッシュ通知 編集者：

   1. を入力します。 タイトル ​例： Luma Test Push Notification を入力し、 本文 ​例： Test push notification for Luma mobile app.

   2. オプションで、画像（.png または.jpg）へのリンクを メディアを追加. その場合、画像はプッシュ通知の一部になります。

   3. エディターを保存して終了するには、「 」を選択します。 .

      

3. プッシュ通知の定義を保存して終了するには、 OK.

ジャーニーは次のようになります。 選択 公開 ジャーニーを公開してアクティブ化する。

に移動します。 Luma > Luma > モデル > XDM > TestPushPayload をクリックし、コードを調べます。

import Foundation

// MARK: - TestPush
struct TestPushPayload: Codable {
   let application: Application
   let eventType: String
}

// MARK: - Application
struct Application: Codable {
   let id: String
}

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

{
   "eventType": string,
   "application" : [
       "id": string
   ]
}

に移動します。 Luma > Luma > Utils > MobileSDK をクリックし、次のコードをに追加します。 func sendTestPushEvent(applicationId: String, eventType: String):

// 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 ペイロードを辞書に変換する際に発生した問題を修正しました。 また、このコードは、今回は、に基づく Swift の同時実行モデルを使用してAdobe Experience Platform SDK を呼び出す際の非同期的な側面も考慮します await および async.

に移動します。 Luma > Luma > Views > General > ConfigView 」をクリックします。 プッシュ通知ボタンの定義で、次のコードを追加して、テストプッシュ通知エクスペリエンスイベントペイロードを、そのボタンがタップされるたびにジャーニーをトリガーに送信します。

// 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)
}

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

次に移動： 設定 タブをクリックします。

タップ プッシュ通知. アプリにプッシュ通知が表示されます。

img-md
w-300