Assuranceの設定

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

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

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

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

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. バンドル識別子​を定義します。

各バンドル識別子は一意である必要があるため、一意の バンドル識別子を使用し、com.adobe.luma.tutorial.swiftui バンドル識別子を置き換えることを確認してください。 通常、com.organization.brand.uniqueidentifierのようなバンドル ID文字列には逆引きDNS形式を使用します。 このチュートリアルの「完了」バージョンでは、例えばcom.adobe.luma.tutorial.swiftuiが使用されます。

{modal="regular"}

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

通常、com.organization.brand.uniqueidentifierのようなバンドル ID文字列には逆引きDNS形式を使用します。 このチュートリアルの「完了」バージョンでは、例えばcom.adobe.luma.tutorial.androidが使用されます。

{modal="regular"}

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

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

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

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

5. ベース URLを追加するには、URL タイプ​までスクロールし、+ ボタンを選択します。

6. 識別子​を選択したバンドル識別子に設定し、選択した​ URL スキーム ​を設定します。

   {modal="regular"}

各バンドル識別子は一意である必要があるため、一意の バンドル識別子を使用し、com.adobe.luma.tutorial.swiftui バンドル識別子を置き換えることを確認してください。 通常、com.organization.brand.uniqueidentifierのようなバンドル ID文字列には逆引きDNS形式を使用します。 ​ バンドル識別子で使用したのと同じバンドル識別子を使用できます。
同様に、一意のURL スキームを使用し、既に提供されているlumatutorialswiftuiを一意のURL スキームに置き換えます。

IOSのURL スキームについて詳しくは、Appleのドキュメント ​を参照してください。

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

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

2. ナビゲーターで​app > マニフェスト > 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でのディープリンクについて詳しくは、Android ドキュメントの​ ディープリンクの作成を参照してください。

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

Xcodeの場合：

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

   オプションとして、特に予期しない結果が表示された場合は、ビルドを​ クリーン ​する必要がある場合があります。 Xcode 製品 メニューから「クリーンビルドフォルダー…」を選択します。

2. 位置情報の使用を許可 ダイアログで、アプリの使用許可​を選択します。

   {width="300"}

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

   {width="300"}

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

   {width="300"}

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

   {width="300"}

6. 続行​を選択します。

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

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

2. 左側のパネルから「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を入力し、Connect​を選択します。

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

   • アプリの上に表示されているAssuranceアイコン。

     {width="300"}

   • Assurance UIに加えられた更新（以下を示す）。

     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. 左側のパネルから「Assurance」を選択します。

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

4. 開始​を選択します。

5. Luma Mobile App Sessionや​ 基本URL ​などの​ セッション名 ​を指定します。これは、AndroidManifest.xml​でAndroid Studioで定義したandroid:schemeとandroid: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を入力し、Connect​を選択します。

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

   • アプリの上に表示されているAssuranceアイコン。

     {width="300"}

   • Assurance UIに加えられた更新（以下を示す）。

     1. アプリから送信されるエクスペリエンスイベント。

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

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

        {modal="regular"}

{modal="regular"}

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

{modal="regular"}

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