Assurance の設定
モバイルアプリでAdobe Experience Platform Assurance を設定する方法を説明します。
Assurance (旧称:プロジェクトグリフォン)は、モバイルアプリでデータを収集したりエクスペリエンスを提供したりする方法の検査、配達確認、シミュレートおよび検証を支援することを目的としています。
Assurance は、Adobe Experience Platform Mobile SDK で生成された生の SDK イベントを調べるのに役立ちます。 SDK で収集されたすべてのイベントは、検査に使用できます。 SDK イベントは、時間順に並べ替えられたリスト表示で読み込まれます。 各イベントには、詳細を提供する詳細ビューがあります。 SDK 設定、データ要素、共有状態、SDK 拡張機能のバージョンを参照するための追加のビューも提供されます。 Assurance について詳しくは、製品ドキュメントを参照してください。
前提条件
- SDK がインストールおよび設定された状態で、アプリが正常にセットアップされました。
学習目標
このレッスンでは、次の操作を行います。
- 組織がアクセス権を持っていることを確認します(持っていない場合はリクエストします)。
- ベース URL を設定します。
- iOS固有の必須コードを追加します。
- セッションに接続します。
アクセスを確認
組織が Assurance へのアクセス権を持っていることを確認します。 ユーザーとして、Adobe Experience Platformのプロファイルに追加される必要があります。 詳しくは、Assurance ガイドの ユーザーアクセスを参照してください。
実装方法
前のレッスンで完了した SDK の一般的なインストールに加えて、iOSでは、アプリの Assurance セッションを開始するために、以下の追加も必要です。
-
Xcode のプロジェクトナビゲーターで 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) }
このコードは、アプリがバックグラウンドにあり、ディープリンクを使用して開かれたときに、アシュランスセッションを開始します。
詳しくは、 こちらを参照してください。
バンドル識別子の定義
アプリに一意のバンドル ID を指定する必要があります。
-
Xcode でプロジェクトを開きます。
-
プロジェクト ナビゲータで [Luma] を選択します。
-
Luma ターゲットを選択します。
-
「署名と機能」タブを選択します。
-
バンドル識別子 を定義します。
note important IMPORTANT 各バンドル ID は一意である必要があるので、unique バンドル ID を使用し、 com.adobe.luma.tutorial.swiftui
バンドル ID を置き換えてください。 通常は、バンドル ID 文字列(com.organization.brand.uniqueidentifier
など)に逆 DNS 形式を使用します。 たとえば、このチュートリアルの完成バージョンではcom.adobe.luma.tutorial.swiftui
を使用します。{modal="regular"}
ベース URL の設定
-
Xcode のプロジェクトに移動します。
-
プロジェクト ナビゲータで [Luma] を選択します。
-
Luma ターゲットを選択します。
-
「情報」タブを選択します。
-
ベース URL を追加するには、下にスクロールして URL タイプ を表示し、「+」ボタンを選択します。
-
識別子 を任意のバンドル識別子に設定し、任意の URL スキーム を設定します。
note important IMPORTANT 各バンドル ID は一意である必要があるので、unique バンドル ID を使用し、 com.adobe.luma.tutorial.swiftui
バンドル ID を置き換えてください。 通常は、バンドル ID 文字列(com.organization.brand.uniqueidentifier
など)に逆 DNS 形式を使用します。 バンドル識別子の定義で使用したのと同じバンドル識別子を使用できます。
同様に、一意の URL スキームを使用し、既に提供されているlumatutorialswiftui
を一意の URL スキームに置き換えます。
iOSの URL スキームについて詳しくは、Appleのドキュメントを参照してください。
Assurance は、ブラウザーまたは QR コードを介して URL を開くことで機能します。 この URL は、アプリを開くベース URL で始まり、追加のパラメーターが含まれています。 これらの一意のパラメーターは、セッションへの接続に使用されます。
セッションへの接続
Xcode で:
-
を使用して、シミュレータまたは Xcode の物理デバイスでアプリを構築または再構築して実行します。
note tip TIP 必要に応じて、特に予期しない結果が発生した場合に、ビルドを「クリーンアップ」する必要がある場合があります。 これを行うには、Xcode 製品 メニューから「ビルドフォルダーをクリーンアップ…」を選択します。 -
Luma アプリが場所を使用することを許可する ダイアログで、「アプリの使用中に許可 を選択し す。
{width="300"}
-
Luma アプリ」が通知を送信したい ダイアログで、「許可」を選択します。
{width="300"}
-
「続行…」を選択し、アプリがアクティビティを追跡できるようにします。
{width="300"}
-
「Luma アプリ」が他社のアプリや web サイトをまたいだアクティビティを追跡することを許可する」ダイアログで 「許可」を選択します。
{width="300"}
ブラウザーで以下を実行します。
-
データ収集 UI に移動します。
-
左パネルから「Assurance」を選択します。
-
セッションを作成 を選択します。
-
開始 を選択します。
-
Luma Mobile App Session
などの セッション名 と ベース URL を指定します。これは、Xcode で入力した URL スキームであり、://
の後に続きます。例:lumatutorialswiftui://
-
「次へ」を選択します。
-
新規セッションを作成 モーダルダイアログで、次の操作を行います。
物理デバイスを使用している場合:
-
「QR コードをスキャン」を選択します。 アプリを開くには、物理デバイスのカメラを使用して QR コードをスキャンし、リンクをタップします。
シミュレーターを使用する場合:
-
リンクをコピー を選択します。
-
を使用してディープリンクをコピーし、ディープリンクを使用してシミュレーターの Safari でアプリを開きます。
-
-
アプリが読み込まれると、手順 7 に示すように、PIN を入力するよう求めるモーダルダイアログが表示されます。
{width="300"}
PIN を入力し、「接続」を選択します。
-
接続に成功した場合は、次のように表示されます。
-
Assurance アイコンがアプリの上に浮かんでいます。
{width="300"}
-
Assurance UI を使用して行われる次を示すExperience Cloudの更新。
-
アプリから発生するエクスペリエンスイベント。
-
選択したイベントの詳細。
-
デバイスとタイムライン。
-
-
拡張機能の検証
アプリが最新の拡張機能を使用しているかどうかを確認するには:
-
設定 を選択します。
-
拡張機能バージョン の場合は ![ 追加] を選択します。
-
「保存」を選択します。
-
拡張機能のバージョン を選択すると、使用可能な最新の拡張機能と、お使いのバージョンのアプリで使用されている拡張機能の概要が表示されます。
-
拡張機能のバージョン(例:Messaging および Optimize)を更新するには、パッケージの依存関係 (例:AEPMessaging)からパッケージ(拡張機能)を選択し、コンテキストメニューから「パッケージを更新」を選択します。 Xcode はパッケージの依存関係を更新します。
次のトピック:同意の実装