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 のドキュメントでプロジェクトのディペンデンシーモジュールを更新する方法を参照してください。