アシュランスの設定
モバイルアプリでAdobe Experience Platform Assurance を設定する方法を説明します。
アシュランス(正式には Project Griffon と呼ばれます)は、データ収集やモバイルアプリでのエクスペリエンス提供の方法を調査、配達確認、シミュレーション、検証するのに役立つように設計されています。
保証は、Adobe Experience Platform Mobile SDK で生成された生の SDK イベントを調べるのに役立ちます。 SDK で収集されたすべてのイベントを調査できます。 SDK イベントは、時間順に並べ替えられたリストビューに読み込まれます。 各イベントには、詳細を示す詳細ビューがあります。 SDK 設定、データ要素、共有状態、SDK 拡張機能のバージョンを参照するための追加のビューも提供されます。 詳しくは、 アシュランス (製品ドキュメント内)。
前提条件
- SDK を使用したアプリが正常にセットアップされ、設定されました。
学習内容
このレッスンでは、次の操作を実行します。
- 組織がアクセス権を持っていることを確認します(持っていない場合はリクエストします)。
- ベース URL を設定します。
- 必要なiOS固有のコードを追加します。
- セッションに接続します。
アクセスを確認
組織がアシュランスにアクセスできることを確認します。 ユーザーは、Adobe Experience Platformのプロファイルに追加される必要があります。 詳しくは、 ユーザーアクセス (アシュランスガイド)を参照してください。
実装方法
一般 SDK のインストール前のレッスンで完了したiOSでは、アプリのアシュランスセッションを開始するために、以下の追加も必要です。
-
に移動します。 Luma > Luma > SceneDelegate をクリックします。
-
次のコードを
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>
に追加します。code language-swift // Called when the app in background is opened with a deep link. if let deepLinkURL = URLContexts.first?.url { // Start the Assurance session Assurance.startSession(url: deepLinkURL) }
このコードは、アプリがバックグラウンドになっていて、ディープリンクを使用して開いたときに、保証セッションを開始します。
詳細はこちらをご覧ください ここ.
バンドル識別子を定義
アプリに一意のバンドル識別子を提供する必要があります。
-
Xcode でプロジェクトを開きます。
-
選択 Luma をクリックします。
-
を選択します。 Luma ターゲット。
-
を選択します。 署名と機能 タブをクリックします。
-
を定義 バンドル識別子.
note important IMPORTANT 必ず ユニーク バンドル識別子を置き換えます。 com.adobe.luma.tutorial.swiftui
バンドル識別子。各バンドル識別子は一意である必要があります。 通常、バンドル ID 文字列には逆引き DNS 形式を使用します ( 例:com.organization.brand.uniqueidentifier
. このチュートリアルの完成版(例: )は、を使用します。com.adobe.luma.tutorial.swiftui
.{zoomable="yes"}
ベース URL の設定
-
Xcode でプロジェクトに移動します。
-
選択 Luma をクリックします。
-
を選択します。 Luma ターゲット。
-
を選択します。 情報 タブをクリックします。
-
ベース URL を追加するには、下にスクロールして URL タイプ をクリックし、 + 」ボタンをクリックします。
-
設定 識別子 を任意のバンドル識別子に追加し、 URL スキーム を選択します。
note important IMPORTANT 必ず ユニーク バンドル識別子を置き換えます。 com.adobe.luma.tutorial.swiftui
バンドル識別子。各バンドル識別子は一意である必要があります。 通常、バンドル ID 文字列には逆引き DNS 形式を使用します ( 例:com.organization.brand.uniqueidentifier
. 以前に使用したのと同じバンドル識別子を使用できます。 バンドル識別子を定義.
同様に、一意の URL スキームを使用し、既に指定されているlumatutorialswiftui
を使用して、一意の URL スキームを設定します。
iOSでの URL スキームについて詳しくは、 Appleドキュメント.
アシュランスは、ブラウザーまたは QR コードを介して URL を開くことで機能します。 この URL は、アプリを開くベース URL で始まり、追加のパラメーターが含まれています。 これらの一意のパラメーターは、セッションの接続に使用されます。
セッションへの接続
Xcode の場合:
-
を使用して、シミュレーターまたは Xcode の物理デバイスで、アプリをビルドまたはリビルドして実行します。 .
note tip TIP 必要に応じて、特に予期しない結果が表示された場合に、ビルドを「クリーンアップ」することができます。 それには、「 」を選択します。 ビルドフォルダーをクリーンアップ… Xcode から 製品 メニュー。 -
Adobe Analytics の 「Luma アプリ」でロケーションを使用することを許可 ダイアログ、選択 アプリの使用中に許可.
img-md w-300 -
Adobe Analytics の 「Luma アプリ」が通知を送信します ダイアログ、選択 許可.
img-md w-300 -
選択 続行… :アプリがアクティビティを追跡できるようにします。
img-md w-300 -
Adobe Analytics の 「Luma アプリ」で、他の会社のアプリや Web サイトをまたいでアクティビティを追跡できるようにします ダイアログ、選択 許可.
img-md w-300
ブラウザーで、以下の操作を実行します。
-
データ収集 UI に移動します。
-
選択 アシュランス をクリックします。
-
選択 セッションを作成.
-
選択 開始.
-
次を提供: セッション名 例:
Luma Mobile App Session
そして ベース URL:Xcode で入力した URL スキームで、その後に://
例:lumatutorialswiftui://
-
「次へ」を選択します。
-
Adobe Analytics の 新しいセッションを作成 モーダルダイアログ:
物理デバイスを使用している場合:
-
選択 QR コードをスキャン. アプリを開くには、物理デバイスのカメラを使用して QR コードをスキャンし、リンクをタップします。
シミュレーターを使用している場合は、次の手順に従います。
-
選択 リンクをコピー.
-
を使用してディープリンクをコピーする ディープリンクを使用して、シミュレーターで Safari でアプリを開きます。
-
-
アプリが読み込まれると、手順 7 で示す PIN を入力するよう求めるモーダルダイアログが表示されます。
img-md w-300 PIN を入力し、を選択します。 接続.
-
接続に成功した場合は、次のように表示されます。
-
アプリの上に浮かぶアシュランスアイコン。
img-md w-300 -
Assurance UI でのExperience Cloudの更新で、次の内容が表示されます。
-
アプリからのエクスペリエンスイベント。
-
選択したイベントの詳細。
-
デバイスとタイムライン。
-
-
問題が発生した場合は、 技術 and general documentation.
拡張機能の検証
アプリが最新の拡張機能を使用しているかどうかを確認するには:
-
選択 設定.
-
選択 対象: 拡張機能のバージョン.
-
「保存」を選択します。
-
選択 拡張機能のバージョン を参照して、利用可能な最新の拡張機能と、アプリのバージョンで使用される拡張機能の概要を確認してください。
-
拡張機能のバージョンを更新するには ( 例: メッセージ および 最適化) パッケージ(拡張)を次の中から選択します。 パッケージの依存関係 ( 例: AEPMessaging) を選択し、コンテキストメニューから「 」を選択します。 パッケージを更新. Xcode はパッケージの依存関係を更新します。
次へ: 同意の実装