Assuranceの設定

iOSでアプリケーションのAssurance セッションを開始するには、0}SDKの一般的なインストール } に加えて、次のコードが必要です。

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

2. 次のコードを 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) }

   このコードは、アプリがバックグラウンドにあり、ディープリンクを使用して開かれたときに、アシュランスセッションを開始します。

AndroidでアプリケーションのAssurance セッションを開始するには、0}SDKの一般的なインストール } に加えて、次のコードが必要です。

1. Android Studio の Android ビューで、app/kotlin+java/com.adobe.luma.tutorial.android/LumaApplication に移動します。

2. 次のコードを fun handleDeeplink(deeplink: String?) に追加します。

   code language-kotlin
   // Called when the app in background is opened with a deep link. if (deeplink.isNullOrEmpty()) { Log.w("Luma", "Deeplink is null or empty") return } Log.i("Luma", "Handling deeplink: $deeplink") Assurance.startSession(deeplink)

   このコードは、アプリがバックグラウンドにあり、ディープリンクを使用して開かれたときに、アシュランスセッションを開始します。

1. Xcode でプロジェクトを開きます。
2. プロジェクト ナビゲータで [Luma] を選択します。
3. Luma ターゲットを選択します。
4. 「署名と機能」タブを選択します。
5. バンドル識別子 を定義します。

各バンドル ID は一意である必要があるので、unique バンドル ID を使用し、com.adobe.luma.tutorial.swiftui バンドル ID を置き換えてください。 通常は、バンドル ID 文字列（com.organization.brand.uniqueidentifier など）に逆 DNS 形式を使用します。 たとえば、このチュートリアルの完成バージョンでは com.adobe.luma.tutorial.swiftui を使用します。

{modal="regular"}

1. Android Studio でプロジェクトを開きます。
2. ナビゲーターで build.gradle.kts （Module :app） を選択します。
3. 必ず unique バンドル ID を使用し、com.adobe.luma.tutorial.android の namespace の android 値を
4. 必ず、同じ 一意の バンドル ID を使用し、com.adobe.luma.tutorial.android の applicationId の defaultConfig の android を置き換えてください

通常は、バンドル ID 文字列（com.organization.brand.uniqueidentifier など）に逆 DNS 形式を使用します。 たとえば、このチュートリアルの完成バージョンでは com.adobe.luma.tutorial.android を使用します。

{modal="regular"}

1. Xcode のプロジェクトに移動します。

2. プロジェクト ナビゲータで [Luma] を選択します。

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

4. 「情報」タブを選択します。

5. ベース URL を追加するには、下にスクロールして URL タイプ を表示し、「+」ボタンを選択します。

6. 識別子 を任意のバンドル識別子に設定し、任意の URL スキーム を設定します。

   {modal="regular"}

各バンドル 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 で始まり、追加のパラメーターが含まれています。 これらの一意のパラメーターは、セッションへの接続に使用されます。 サンプルアプリでは、ディープリンクは lumatutorialswiftui:// です。

1. Android Studio のプロジェクトの 0}Android} ビューに移動します。

2. ナビゲーターで app/manifest/AndroidManifest.xml を選択します。

3. manifest/application/activity XML 要素が次のようになっていることを確認します。

   code language-xml

   <activity android:name=".MainActivity" android:exported="true" android:theme="@style/Theme.LumaAndroid"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> <intent-filter android:label="@string/app_name"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="lumatutorialandroid" android:host="default" /> </intent-filter> </activity>

必ず android:scheme （例：）を指定します。 lumatutorialandroid）と android:host （例：default）を使用して、ベース URL を定義します。

Androidのディープリンクについて詳しくは、​ アプリコンテンツへのディープリンクの作成 ​ を参照してください。

Assuranceは、ブラウザーまたは QR コードを使用して URL を開くことで機能します。 その URL はベース URL で始まり、アプリが開き、追加のパラメーターが含まれます。 これらの一意のパラメーターは、セッションへの接続に使用されます。 サンプルアプリでは、ディープリンクは lumatutorialandroid://default です。

Xcode で：

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

   必要に応じて、特に予期しない結果が発生した場合に、ビルドを クリーン する必要がある場合があります。 Xcode 製品 メニューから「ビルドフォルダーをクリーン」を選択します。

2. Luma アプリが場所を使用することを許可する ダイアログで、「アプリの使用中に許可 を選択し す。

   {width="300"}

3. Luma アプリ」が通知を送信したい ダイアログで、「許可」を選択します。

   {width="300"}

4. 「続行…」を選択し、アプリがアクティビティを追跡できるようにします。

   {width="300"}

5. 「Luma アプリ」が他社のアプリや web サイトをまたいだアクティビティを追跡することを許可する」ダイアログで 「許可」を選択します。

   {width="300"}

6. 「続行」を選択します。

ブラウザーで以下を実行します。

1. データ収集 UI に移動します。

2. 左パネルから 0}Assurance} を選択します。

3. 「新規セッションを作成」を選択し、「ディープリンク接続」オプションを選択します。

4. 開始 を選択します。

5. などの セッション名 Luma Mobile App Session と ベース URL を指定します。これは、Xcode で入力した URL スキームであり、:// の後に続きます。例：lumatutorialswiftui://

6. 「次へ」を選択します。
   {modal="regular"}

7. 新規セッションを作成 モーダルダイアログで、次の操作を行います。

   物理デバイスを使用している場合：

   • 「QR コードをスキャン」を選択します。 アプリを開くには、物理デバイスのカメラを使用して QR コードをスキャンし、リンクをタップします。

     {modal="regular"}

   シミュレーターを使用する場合：

   1. リンクをコピー を選択します。
   2. を使用してディープリンクをコピーし、ディープリンクを使用してシミュレーターの Safari でアプリを開きます。
      {modal="regular"}

8. アプリが読み込まれると、手順 7 に示すように、PIN を入力するよう求めるモーダルダイアログが表示されます。

   {width="300"}

   PIN を入力し、「接続」を選択します。

9. 接続に成功した場合は、次のように表示されます。

   • アプリの上に浮かぶAssurance アイコン。

     {width="300"}

   • Assurance UI でのExperience Cloudの更新点は次のとおりです。

     1. アプリから発生するエクスペリエンスイベント。

     2. 選択したイベントの詳細。

     3. デバイスとタイムライン。

        {modal="regular"}

10. 「続行」を選択して、ホーム画面に移動します。

Android Studio で以下を行います。

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

   必要に応じて、特に予期しない結果が発生した場合に、ビルドを クリーン する必要がある場合があります。 Android Studio の ビルド メニューから プロジェクトをクリーン を選択します。

2. Luma Androidが通知を送信することを許可する ダイアログで、「許可」を選択します。

   {width="300"}

3. 権限ダイアログを表示 を選択します。

   {width="300"}

4. Luma Androidがこのデバイスの場所にアクセスすることを許可しますか？…

   {width="300"}

   • 正確 を選択します。
   • 「アプリの使用中」を選択します。

5. アプリの紹介画面に戻り、「デバイス設定を開く」を選択します。

6. ロケーション権限 画面で、「常に許可」を選択します。 次に、「←」を選択して、アプリの紹介画面に戻ります。

   {width="300"}

7. 「続行」を選択して、ホーム画面に移動します。

ブラウザーで以下を実行します。

1. データ収集 UI に移動します。

2. 左パネルから 0}Assurance} を選択します。

3. 「新規セッションを作成」を選択し、「ディープリンク接続」オプションを選択します。

4. 開始 を選択します。

5. などの セッション名 Luma Mobile App Session と、ベース URL を指定します。これは、Android Studio の android:schemeAndroidManifest.xmlandroid:host で定義した と です（:// で区切ります）。例：lumatutorialandroid://default

6. 「次へ」を選択します。
   {modal="regular"}

7. 新規セッションを作成 モーダルダイアログで、次の操作を行います。

   物理デバイスを使用している場合：

   • 「QR コードをスキャン」を選択します。 アプリを開くには、物理デバイスのカメラを使用して QR コードをスキャンし、リンクをタップします。

     {modal="regular"}

   シミュレーターを使用する場合：

   1. リンクをコピー を選択します。
   2. を使用してディープリンクをコピーし、ディープリンクを使用してシミュレーターのChromeでアプリを開きます。

   {modal="regular"}

   Chromeで Luma Androidを続行 するように求められたら、続行 を選択します。

8. アプリが読み込まれると、手順 7 に示すように、PIN を入力するよう求めるモーダルダイアログが表示されます。

   {width="300"}

   PIN を入力し、「接続」を選択します。

9. 接続に成功した場合は、次のように表示されます。

   • アプリの上に浮かぶAssurance アイコン。

     {width="300"}

   • Assurance UI でのExperience Cloudの更新点は次のとおりです。

     1. アプリから発生するエクスペリエンスイベント。

     2. 選択したイベントの詳細。

     3. デバイスとタイムライン。

        {modal="regular"}

{modal="regular"}

拡張機能のバージョン（例：Messaging および Optimize）を更新するには、パッケージの依存関係 （例：AEPMessaging）からパッケージ（拡張機能）を選択し、コンテキストメニューから「パッケージを更新」を選択します。 Xcode はパッケージの依存関係を更新します。

{modal="regular"}

古い拡張機能が表示される場合は、Android Studio のドキュメント ​ でプロジェクトのディペンデンシーモジュールを更新する方法を参照してください。